From: Regina Obe <lr@pcorp.us>
Date: Mon, 5 Oct 2015 01:39:29 +0000 (+0000)
Subject: Add ST_3DUnion example to complete the ST_3DDifference, ST_3DIntersection, ST_3DUnion... 
X-Git-Tag: 2.2.0~21
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=cdfe09565865fdcb4b222e66289f8f3380730155;p=postgis

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

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
index 000000000..0ff4a14ff
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 81a0c3f1a..d00ba7e76 100644
--- 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>