[geos-commits] [SCM] GEOS branch main updated. 9915ef54ef2648a6d5e149c8e19f7e0f24be0bb9

[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 "GEOS".

The branch, main has been updated
       via  9915ef54ef2648a6d5e149c8e19f7e0f24be0bb9 (commit)
      from  f65bb355896a9bebc4a52a638c2c67df4959ffb7 (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 9915ef54ef2648a6d5e149c8e19f7e0f24be0bb9
Author: Paul Ramsey <pramsey at cleverelephant.ca>
Date:   Fri Oct 15 13:34:37 2021 -0700

    More detailed description of setPrecision options

diff --git a/capi/geos_c.h.in b/capi/geos_c.h.in
index 1e2171b..12f743f 100644
--- a/capi/geos_c.h.in
+++ b/capi/geos_c.h.in
@@ -1384,9 +1384,11 @@ extern int GEOS_DLL GEOSNormalize_r(
 * when altering the precision of a geometry.
 */
 enum GEOSPrecisionRules {
-    /** This option causes GEOSGeom_setPrecision() to not attempt at preserving the topology */
+    /** The output is always valid. Collapsed geometry elements (including both polygons and lines) are removed. */
+    GEOS_PREC_VALID_OUTPUT = 0,
+    /** Precision reduction is performed pointwise. Output geometry may be invalid due to collapse or self-intersection. (This might be better called "GEOS_PREC_POINTWISE" - the current name is historical.) */
     GEOS_PREC_NO_TOPO = 1,
-    /** This option causes GEOSGeom_setPrecision() to retain collapsed elements */
+    /** Like the default mode, except that collapsed linear geometry elements are preserved. Collapsed polygonal input elements are removed. */
     GEOS_PREC_KEEP_COLLAPSED = 2
 };
 
@@ -3759,6 +3761,15 @@ extern int GEOS_DLL GEOSNormalize(GEOSGeometry* g);
 * of the geometry with higher precision (smaller "gridSize").
 * That same precision will be attached to the operation outputs.
 *
+* In the Default and GEOS_PREC_KEEP_COLLAPSED modes invalid input
+* may cause an error to occur, unless the invalidity is below
+* the scale of the requested precision
+*
+* There are only 3 modes. The GEOS_PREC_NO_TOPO mode
+* takes precedence over GEOS_PREC_KEEP_COLLAPSED.
+* So the combination GEOS_PREC_NO_TOPO || GEOS_PREC_KEEP_COLLAPSED
+* has the same semantics as GEOS_PREC_NO_TOPO
+*
 * \param g Input geometry
 * \param gridSize cell size of grid to round coordinates to,
 *        or 0 for FLOATING precision

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

Summary of changes:
 capi/geos_c.h.in | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)


hooks/post-receive
-- 
GEOS