]> granicus.if.org Git - postgis/commitdiff
Clarify behavior of ST_IsPolygon{CW,CCW} with closed linestrings
authorSandro Santilli <strk@kbt.io>
Mon, 20 Mar 2017 15:59:16 +0000 (15:59 +0000)
committerSandro Santilli <strk@kbt.io>
Mon, 20 Mar 2017 15:59:16 +0000 (15:59 +0000)
git-svn-id: http://svn.osgeo.org/postgis/trunk@15341 b70326c6-7e19-0410-871a-916f4a2858ee

doc/reference_accessor.xml

index 7083235fa6b5f35f451e66a0187d83d00c23d373..4480cbae6f2c49adb7133d1d7e0f8b884759eb2c 100644 (file)
@@ -901,8 +901,8 @@ FROM (SELECT ST_BuildArea(
                        <title>Description</title>
 
                        <para>
-                               Returns true if all polygonal components of the input geometry use a counter-clockwise 
-                               orientation for their exterior ring, and a clockwise direction 
+                               Returns true if all polygonal components of the input geometry use a counter-clockwise
+                               orientation for their exterior ring, and a clockwise direction
                                for all interior rings.
                        </para>
 
@@ -912,17 +912,18 @@ FROM (SELECT ST_BuildArea(
 
                        <note>
                                <para>
-                                       If a polygonal geometry does not use reversed orientation
-                                       for interior rings (i.e., if one or more interior rings
-                                       are oriented in the same direction as an exterior ring)
-                                       then both ST_IsPolygonCW and ST_IsPolygonCCW will return false.
+                                       Closed linestrings are not considered polygonal components,
+                                       so you would still get a true return by passing
+          a single closed linestring no matter its orientation.
                                </para>
                        </note>
 
                        <note>
                                <para>
-                                       This function does not consider closed linestrings as polygons,
-                                       and does not check their orientation.
+                                       If a polygonal geometry does not use reversed orientation
+                                       for interior rings (i.e., if one or more interior rings
+                                       are oriented in the same direction as an exterior ring)
+                                       then both ST_IsPolygonCW and ST_IsPolygonCCW will return false.
                                </para>
                        </note>
 
@@ -970,8 +971,8 @@ FROM (SELECT ST_BuildArea(
                        <title>Description</title>
 
                        <para>
-                               Returns true if all polygonal components of the input geometry use a clockwise 
-                               orientation for their exterior ring, and a counter-clockwise direction 
+                               Returns true if all polygonal components of the input geometry use a clockwise
+                               orientation for their exterior ring, and a counter-clockwise direction
                                for all interior rings.
                        </para>
 
@@ -981,17 +982,18 @@ FROM (SELECT ST_BuildArea(
 
                        <note>
                                <para>
-                                       If a polygonal geometry does not use reversed orientation
-                                       for interior rings (i.e., if one or more interior rings
-                                       are oriented in the same direction as an exterior ring)
-                                       then both ST_IsPolygonCW and ST_IsPolygonCCW will return false.
+                                       Closed linestrings are not considered polygonal components,
+                                       so you would still get a true return by passing
+          a single closed linestring no matter its orientation.
                                </para>
                        </note>
 
                        <note>
                                <para>
-                                       This function does not consider closed linestrings as polygons,
-                                       and does not check their orientation.
+                                       If a polygonal geometry does not use reversed orientation
+                                       for interior rings (i.e., if one or more interior rings
+                                       are oriented in the same direction as an exterior ring)
+                                       then both ST_IsPolygonCW and ST_IsPolygonCCW will return false.
                                </para>
                        </note>