Put in example of ST_3DDifference and fix a typo

git-svn-id: http://svn.osgeo.org/postgis/trunk@14186 b70326c6-7e19-0410-871a-916f4a2858ee

diff --git a/doc/html/images/st_3ddifference01.png b/doc/html/images/st_3ddifference01.png
new file mode 100644 (file)
index 0000000..c1e1f20
Binary files /dev/null and b/doc/html/images/st_3ddifference01.png differ

diff --git a/doc/html/images/st_3ddifference02.png b/doc/html/images/st_3ddifference02.png
new file mode 100644 (file)
index 0000000..25eabc9
Binary files /dev/null and b/doc/html/images/st_3ddifference02.png differ

diff --git a/doc/reference_sfcgal.xml b/doc/reference_sfcgal.xml
index 23795544dd7b547e698d7c98f10c08aed7294e32..47385e6641e8c79a3de7ba90097af2bcbac7483e 100644 (file)
--- a/doc/reference_sfcgal.xml
+++ b/doc/reference_sfcgal.xml
@@ -79,7 +79,7 @@
          </refsection>
          
          <refsection><title>Examples</title>
-                       <para>3D images were generated using the PostGIS <xref linkend="ST_AsX3D" /> and rendering in HTML using <ulink url="http://www.x3dom.org">X3Dom HTML Javascript redering library</ulink>.</para>
+               <para>3D images were generated using PostGIS <xref linkend="ST_AsX3D" /> and rendering in HTML using <ulink url="http://www.x3dom.org">X3Dom HTML Javascript rendering library</ulink>.</para>
                        
                 <informaltable>
                                  <tgroup cols="2">
@@ -570,13 +570,67 @@ FROM  ST_GeomFromText('LINESTRING Z (2 2 6,1.5 1.5 7,1 1 8,0.5 0.5 8,0 0 10)') A
 
          <refsection>
                <title>Description</title>
-
+               <para>Returns that part of geom1 that is not part of geom2.</para>
                <para>Availability: 2.2.0</para>
                <para>&sfcgal_required;</para>
                <para>&Z_support;</para>
                <para>&P_support;</para>
                <para>&T_support;</para>
          </refsection>
+         
+         <refsection>
+             <title>Examples</title>
+               <para>3D images were generated using PostGIS <xref linkend="ST_AsX3D" /> and rendering in HTML using <ulink url="http://www.x3dom.org">X3Dom HTML Javascript rendering library</ulink>.</para>
+            <informaltable>
+            <tgroup cols="2">
+            <tbody>
+              <row>
+                <entry><para>
+                <programlisting>SELECT ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),
+ 50, 'quad_segs=2'),0,0,30) AS geom1, 
+        ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(80 80)'),
+ 50, 'quad_segs=1'),0,0,30) AS geom2;
+                </programlisting>
+                <informalfigure>
+                    <mediaobject>
+                      <imageobject>
+                        <imagedata fileref="images/st_difference01.png" />
+                      </imageobject>
+                      <caption><para>Original 3D geometries overlaid. geom2 is the part that will be removed.</para></caption>
+                    </mediaobject>
+                  </informalfigure></para>
+              </entry>
+              <entry><para>
+              <programlisting>SELECT ST_3DDifference(geom1,geom2)
+FROM ( SELECT ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),
+ 50, 'quad_segs=2'),0,0,30) AS geom1, 
+        ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(80 80)'),
+ 50, 'quad_segs=1'),0,0,30) AS geom2 ) As t;</programlisting>
+              <informalfigure>
+                    <mediaobject>
+                      <imageobject>
+                        <imagedata fileref="images/st_difference02.png" />
+                      </imageobject>
+                      <caption><para>What's left after removing geom2</para></caption>
+                    </mediaobject>
+                  </informalfigure></para>
+              </entry>
+              </row>
+             </tbody>
+            </tgroup>
+            </informaltable>
+             
+         </refsection>
+         
+           <refsection>
+               <title>See Also</title>
+
+                <para>
+        <xref linkend="ST_Extrude" />,
+        <xref linkend="ST_AsX3D" />,
+        <xref linkend="ST_3DUnion" />
+                </para>
+        </refsection>
        </refentry>
 
        <refentry id="ST_3DUnion">
@@ -598,6 +652,7 @@ FROM  ST_GeomFromText('LINESTRING Z (2 2 6,1.5 1.5 7,1 1 8,0.5 0.5 8,0 0 10)') A
 
          <refsection>
                <title>Description</title>
+               
 
                <para>Availability: 2.2.0</para>
                <para>&sfcgal_required;</para>