[SCM] PostGIS branch master updated. 3.4.0rc1-795-gd333bf1f6

[git at osgeo.org]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "PostGIS".

The branch, master has been updated
       via  d333bf1f667b35f683ef59691326d38ae711214e (commit)
      from  6db05647f6e11cfe4c1b4f2f457eb20fdc23e194 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit d333bf1f667b35f683ef59691326d38ae711214e
Author: Regina Obe <lr at pcorp.us>
Date:   Sat Nov 25 18:03:21 2023 -0500

    Add another example for ST_TriangulatePolygon
    that is same example as ST_Tesselate for easy compare
    Add link to ST_TriangulatePolygon from ST_Tesselate

diff --git a/doc/html/images/Makefile.in b/doc/html/images/Makefile.in
index 4232d5ba0..f34c48bab 100644
--- a/doc/html/images/Makefile.in
+++ b/doc/html/images/Makefile.in
@@ -186,6 +186,7 @@ GENERATED_IMAGES= \
 	st_polygonize01.png \
 	st_polygonize02.png \
 	st_triangulatepolygon01.png \
+	st_triangulatepolygon02.png \
 	st_segmentize01.png \
 	st_sharedpaths01.png \
 	st_sharedpaths02.png \
diff --git a/doc/html/images/wkt/st_triangulatepolygon02.wkt b/doc/html/images/wkt/st_triangulatepolygon02.wkt
new file mode 100644
index 000000000..52d248249
--- /dev/null
+++ b/doc/html/images/wkt/st_triangulatepolygon02.wkt
@@ -0,0 +1,5 @@
+Result-thin;POLYGON((50 160,120 190,120 160,50 160))
+Result-thin;POLYGON((10 70,80 130,80 70,10 70))
+Result-thin;POLYGON((50 160,10 70,10 190,50 160))
+Result-thin;POLYGON((120 190,50 160,10 190,120 190))
+Result-thin;POLYGON((80 130,10 70,50 160,80 130))
\ No newline at end of file
diff --git a/doc/reference_processing.xml b/doc/reference_processing.xml
index 796f08413..5c7f6fcc9 100644
--- a/doc/reference_processing.xml
+++ b/doc/reference_processing.xml
@@ -3036,12 +3036,50 @@ SELECT ST_AsText(
             </mediaobject>
             </informalfigure>
         </refsection>
+        <refsection><title>Same example as ST_Tesselate</title>
+            <programlisting>SELECT ST_TriangulatePolygon(
+                'POLYGON (( 10 190, 10 70, 80 70, 80 130, 50 160, 120 160, 120 190, 10 190 ))'::geometry
+                );</programlisting>
+<para>ST_AsText output</para>
+<screen>GEOMETRYCOLLECTION(POLYGON((50 160,120 190,120 160,50 160))
+    ,POLYGON((10 70,80 130,80 70,10 70))
+    ,POLYGON((50 160,10 70,10 190,50 160))
+    ,POLYGON((120 190,50 160,10 190,120 190))
+    ,POLYGON((80 130,10 70,50 160,80 130)))</screen>
+            <informaltable>
+                <tgroup cols="2">
+                <tbody>
+                      <row>
+                      <entry><para>
+                      <informalfigure>
+                        <mediaobject>
+                          <imageobject>
+                          <imagedata fileref="images/st_tesselate03.png"/>
+                          </imageobject>
+                          <caption><para>Original polygon</para></caption>
+                        </mediaobject>
+                        </informalfigure></para>
+                      </entry>
+                      <entry>
+                      <para><informalfigure>
+                        <mediaobject>
+                          <imageobject>
+                          <imagedata fileref="images/st_triangulatepolygon02.png"/>
+                          </imageobject>
+                          <caption><para>Triangulated Polygon</para></caption>
+                        </mediaobject>
+                        </informalfigure></para>
+                      </entry>
+                      </row>
+                  </tbody>
+                  </tgroup>
+            </informaltable>
+        </refsection>
 
           <refsection>
             <title>See Also</title>
-            <para>
+            <para><xref linkend="ST_ConstrainedDelaunayTriangles"/>,
 				<xref linkend="ST_DelaunayTriangles"/>,
-				<xref linkend="ST_ConstrainedDelaunayTriangles"/>,
 				<xref linkend="ST_Tesselate"/>
             </para>
           </refsection>
diff --git a/doc/reference_sfcgal.xml b/doc/reference_sfcgal.xml
index d81db4a25..a0de2bbe0 100644
--- a/doc/reference_sfcgal.xml
+++ b/doc/reference_sfcgal.xml
@@ -1288,6 +1288,7 @@ MULTIPOLYGON(
 	  <refsection>
 		<title>Description</title>
 		<para>Takes as input a surface such a  MULTI(POLYGON) or POLYHEDRALSURFACE and returns a TIN representation via the process of tessellation using triangles.</para>
+		<note><para><xref linkend="ST_TriangulatePolygon" /> does similar to this function except that it returns a geometry collection of polygons instead of a TIN and also only works with 2D geometries.</para></note>
 		<para role="availability" conformance="2.1.0">Availability: 2.1.0</para>
 		<para>&sfcgal_required;</para>
 		<para>&Z_support;</para>
@@ -1376,7 +1377,7 @@ MULTIPOLYGON(
 		<refsection>
                 <title>See Also</title>
 
-                <para><xref linkend="ST_ConstrainedDelaunayTriangles"/>, <xref linkend="ST_DelaunayTriangles"/></para>
+                <para><xref linkend="ST_ConstrainedDelaunayTriangles"/>, <xref linkend="ST_DelaunayTriangles"/>, <xref linkend="ST_TriangulatePolygon"/></para>
           </refsection>
 
 

-----------------------------------------------------------------------

Summary of changes:
 doc/html/images/Makefile.in                     |  1 +
 doc/html/images/wkt/st_triangulatepolygon02.wkt |  5 +++
 doc/reference_processing.xml                    | 42 +++++++++++++++++++++++--
 doc/reference_sfcgal.xml                        |  3 +-
 4 files changed, 48 insertions(+), 3 deletions(-)
 create mode 100644 doc/html/images/wkt/st_triangulatepolygon02.wkt


hooks/post-receive
-- 
PostGIS