Add ST_3DUnion example to complete the ST_3DDifference, ST_3DIntersection, ST_3DUnion...

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

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

diff --git a/doc/reference_sfcgal.xml b/doc/reference_sfcgal.xml
index 81a0c3f1ad2a8fcb2127e981a4152cbb597b2601..d00ba7e7682646149c3d980c99537bf3de3d222f 100644 (file)
--- a/doc/reference_sfcgal.xml
+++ b/doc/reference_sfcgal.xml
@@ -701,6 +701,60 @@ FROM ( SELECT ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),
                <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_3ddifference01.png" />
+                      </imageobject>
+                      <caption><para>Original 3D geometries overlaid. geom2 is the one with transparency.</para></caption>
+                    </mediaobject>
+                  </informalfigure></para>
+              </entry>
+              <entry><para>
+              <programlisting>SELECT ST_3DUnion(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_3dunion01.png" />
+                      </imageobject>
+                      <caption><para>Union of geom1 and 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_3DIntersection" />
+            <xref linkend="ST_3DDifference" />
+        </para>
+      </refsection>
        </refentry>