GEOS  3.11.0dev
Typedefs | Enumerations | Functions
geos_c.h File Reference

C API for the GEOS geometry algorithms library. More...

#include <stddef.h>
#include <geos/export.h>

Go to the source code of this file.

Typedefs

typedef struct GEOSContextHandle_HS * GEOSContextHandle_t
 
typedef void(* GEOSMessageHandler) (const char *fmt,...)
 
typedef void(* GEOSMessageHandler_r) (const char *message, void *userdata)
 
typedef struct GEOSGeom_t GEOSGeometry
 
typedef struct GEOSPrepGeom_t GEOSPreparedGeometry
 
typedef struct GEOSCoordSeq_t GEOSCoordSequence
 
typedef struct GEOSSTRtree_t GEOSSTRtree
 
typedef struct GEOSBufParams_t GEOSBufferParams
 
typedef struct GEOSMakeValidParams_t GEOSMakeValidParams
 
typedef void(* GEOSQueryCallback) (void *item, void *userdata)
 
typedef int(* GEOSDistanceCallback) (const void *item1, const void *item2, double *distance, void *userdata)
 
typedef void() GEOSInterruptCallback(void)
 
typedef struct GEOSWKTReader_t GEOSWKTReader
 
typedef struct GEOSWKTWriter_t GEOSWKTWriter
 
typedef struct GEOSWKBReader_t GEOSWKBReader
 
typedef struct GEOSWKBWriter_t GEOSWKBWriter
 
typedef struct GEOSGeoJSONReader_t GEOSGeoJSONReader
 
typedef struct GEOSGeoJSONWriter_t GEOSGeoJSONWriter
 

Enumerations

enum  GEOSGeomTypes {
  GEOS_POINT, GEOS_LINESTRING, GEOS_LINEARRING, GEOS_POLYGON,
  GEOS_MULTIPOINT, GEOS_MULTILINESTRING, GEOS_MULTIPOLYGON, GEOS_GEOMETRYCOLLECTION
}
 
enum  GEOSWKBByteOrders { GEOS_WKB_XDR = 0, GEOS_WKB_NDR = 1 }
 
enum  GEOSWKBFlavors { GEOS_WKB_EXTENDED = 1, GEOS_WKB_ISO = 2 }
 
enum  GEOSBufCapStyles { GEOSBUF_CAP_ROUND = 1, GEOSBUF_CAP_FLAT = 2, GEOSBUF_CAP_SQUARE = 3 }
 
enum  GEOSBufJoinStyles { GEOSBUF_JOIN_ROUND = 1, GEOSBUF_JOIN_MITRE = 2, GEOSBUF_JOIN_BEVEL = 3 }
 
enum  GEOSRelateBoundaryNodeRules {
  GEOSRELATE_BNR_MOD2 = 1, GEOSRELATE_BNR_OGC = 1, GEOSRELATE_BNR_ENDPOINT = 2, GEOSRELATE_BNR_MULTIVALENT_ENDPOINT = 3,
  GEOSRELATE_BNR_MONOVALENT_ENDPOINT = 4
}
 
enum  GEOSValidFlags { GEOSVALID_ALLOW_SELFTOUCHING_RING_FORMING_HOLE = 1 }
 
enum  GEOSMakeValidMethods { GEOS_MAKE_VALID_LINEWORK = 0, GEOS_MAKE_VALID_STRUCTURE = 1 }
 
enum  GEOSPrecisionRules { GEOS_PREC_VALID_OUTPUT = 0, GEOS_PREC_NO_TOPO = 1, GEOS_PREC_KEEP_COLLAPSED = 2 }
 

Functions

GEOSInterruptCallbackGEOS_interruptRegisterCallback (GEOSInterruptCallback *cb)
 
void GEOS_interruptRequest (void)
 
void GEOS_interruptCancel (void)
 
GEOSContextHandle_t GEOS_init_r (void)
 
void GEOS_finish_r (GEOSContextHandle_t handle)
 
GEOSMessageHandler GEOSContext_setNoticeHandler_r (GEOSContextHandle_t extHandle, GEOSMessageHandler nf)
 
GEOSMessageHandler GEOSContext_setErrorHandler_r (GEOSContextHandle_t extHandle, GEOSMessageHandler ef)
 
GEOSMessageHandler_r GEOSContext_setNoticeMessageHandler_r (GEOSContextHandle_t extHandle, GEOSMessageHandler_r nf, void *userData)
 
GEOSMessageHandler_r GEOSContext_setErrorMessageHandler_r (GEOSContextHandle_t extHandle, GEOSMessageHandler_r ef, void *userData)
 
GEOSCoordSequenceGEOSCoordSeq_create_r (GEOSContextHandle_t handle, unsigned int size, unsigned int dims)
 
GEOSCoordSequenceGEOSCoordSeq_copyFromBuffer_r (GEOSContextHandle_t handle, const double *buf, unsigned int size, int hasZ, int hasM)
 
GEOSCoordSequenceGEOSCoordSeq_copyFromArrays_r (GEOSContextHandle_t handle, const double *x, const double *y, const double *z, const double *m, unsigned int size)
 
int GEOSCoordSeq_copyToBuffer_r (GEOSContextHandle_t handle, const GEOSCoordSequence *s, double *buf, int hasZ, int hasM)
 
int GEOSCoordSeq_copyToArrays_r (GEOSContextHandle_t handle, const GEOSCoordSequence *s, double *x, double *y, double *z, double *m)
 
GEOSCoordSequenceGEOSCoordSeq_clone_r (GEOSContextHandle_t handle, const GEOSCoordSequence *s)
 
void GEOSCoordSeq_destroy_r (GEOSContextHandle_t handle, GEOSCoordSequence *s)
 
int GEOSCoordSeq_setX_r (GEOSContextHandle_t handle, GEOSCoordSequence *s, unsigned int idx, double val)
 
int GEOSCoordSeq_setY_r (GEOSContextHandle_t handle, GEOSCoordSequence *s, unsigned int idx, double val)
 
int GEOSCoordSeq_setZ_r (GEOSContextHandle_t handle, GEOSCoordSequence *s, unsigned int idx, double val)
 
int GEOSCoordSeq_setXY_r (GEOSContextHandle_t handle, GEOSCoordSequence *s, unsigned int idx, double x, double y)
 
int GEOSCoordSeq_setXYZ_r (GEOSContextHandle_t handle, GEOSCoordSequence *s, unsigned int idx, double x, double y, double z)
 
int GEOSCoordSeq_setOrdinate_r (GEOSContextHandle_t handle, GEOSCoordSequence *s, unsigned int idx, unsigned int dim, double val)
 
int GEOSCoordSeq_getX_r (GEOSContextHandle_t handle, const GEOSCoordSequence *s, unsigned int idx, double *val)
 
int GEOSCoordSeq_getY_r (GEOSContextHandle_t handle, const GEOSCoordSequence *s, unsigned int idx, double *val)
 
int GEOSCoordSeq_getZ_r (GEOSContextHandle_t handle, const GEOSCoordSequence *s, unsigned int idx, double *val)
 
int GEOSCoordSeq_getXY_r (GEOSContextHandle_t handle, const GEOSCoordSequence *s, unsigned int idx, double *x, double *y)
 
int GEOSCoordSeq_getXYZ_r (GEOSContextHandle_t handle, const GEOSCoordSequence *s, unsigned int idx, double *x, double *y, double *z)
 
int GEOSCoordSeq_getOrdinate_r (GEOSContextHandle_t handle, const GEOSCoordSequence *s, unsigned int idx, unsigned int dim, double *val)
 
int GEOSCoordSeq_getSize_r (GEOSContextHandle_t handle, const GEOSCoordSequence *s, unsigned int *size)
 
int GEOSCoordSeq_getDimensions_r (GEOSContextHandle_t handle, const GEOSCoordSequence *s, unsigned int *dims)
 
int GEOSCoordSeq_isCCW_r (GEOSContextHandle_t handle, const GEOSCoordSequence *s, char *is_ccw)
 
double GEOSProject_r (GEOSContextHandle_t handle, const GEOSGeometry *line, const GEOSGeometry *point)
 
GEOSGeometryGEOSInterpolate_r (GEOSContextHandle_t handle, const GEOSGeometry *line, double d)
 
double GEOSProjectNormalized_r (GEOSContextHandle_t handle, const GEOSGeometry *g, const GEOSGeometry *p)
 
GEOSGeometryGEOSInterpolateNormalized_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double d)
 
GEOSGeometryGEOSBuffer_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double width, int quadsegs)
 
GEOSBufferParamsGEOSBufferParams_create_r (GEOSContextHandle_t handle)
 
void GEOSBufferParams_destroy_r (GEOSContextHandle_t handle, GEOSBufferParams *parms)
 
int GEOSBufferParams_setEndCapStyle_r (GEOSContextHandle_t handle, GEOSBufferParams *p, int style)
 
int GEOSBufferParams_setJoinStyle_r (GEOSContextHandle_t handle, GEOSBufferParams *p, int joinStyle)
 
int GEOSBufferParams_setMitreLimit_r (GEOSContextHandle_t handle, GEOSBufferParams *p, double mitreLimit)
 
int GEOSBufferParams_setQuadrantSegments_r (GEOSContextHandle_t handle, GEOSBufferParams *p, int quadSegs)
 
int GEOSBufferParams_setSingleSided_r (GEOSContextHandle_t handle, GEOSBufferParams *p, int singleSided)
 
GEOSGeometryGEOSBufferWithParams_r (GEOSContextHandle_t handle, const GEOSGeometry *g, const GEOSBufferParams *p, double width)
 
GEOSGeometryGEOSBufferWithStyle_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double width, int quadsegs, int endCapStyle, int joinStyle, double mitreLimit)
 
GEOSGeometryGEOSDensify_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double tolerance)
 
GEOSGeometryGEOSOffsetCurve_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double width, int quadsegs, int joinStyle, double mitreLimit)
 
GEOSGeometryGEOSGeom_createPoint_r (GEOSContextHandle_t handle, GEOSCoordSequence *s)
 
GEOSGeometryGEOSGeom_createPointFromXY_r (GEOSContextHandle_t handle, double x, double y)
 
GEOSGeometryGEOSGeom_createEmptyPoint_r (GEOSContextHandle_t handle)
 
GEOSGeometryGEOSGeom_createLinearRing_r (GEOSContextHandle_t handle, GEOSCoordSequence *s)
 
GEOSGeometryGEOSGeom_createLineString_r (GEOSContextHandle_t handle, GEOSCoordSequence *s)
 
GEOSGeometryGEOSGeom_createEmptyLineString_r (GEOSContextHandle_t handle)
 
GEOSGeometryGEOSGeom_createEmptyPolygon_r (GEOSContextHandle_t handle)
 
GEOSGeometryGEOSGeom_createPolygon_r (GEOSContextHandle_t handle, GEOSGeometry *shell, GEOSGeometry **holes, unsigned int nholes)
 
GEOSGeometryGEOSGeom_createCollection_r (GEOSContextHandle_t handle, int type, GEOSGeometry **geoms, unsigned int ngeoms)
 
GEOSGeometryGEOSGeom_createEmptyCollection_r (GEOSContextHandle_t handle, int type)
 
GEOSGeometryGEOSGeom_clone_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
void GEOSGeom_destroy_r (GEOSContextHandle_t handle, GEOSGeometry *g)
 
GEOSGeometryGEOSEnvelope_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
GEOSGeometryGEOSIntersection_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2)
 
GEOSGeometryGEOSIntersectionPrec_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2, double gridSize)
 
GEOSGeometryGEOSConvexHull_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
GEOSGeometryGEOSMinimumRotatedRectangle_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
GEOSGeometryGEOSMaximumInscribedCircle_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double tolerance)
 
GEOSGeometryGEOSLargestEmptyCircle_r (GEOSContextHandle_t handle, const GEOSGeometry *g, const GEOSGeometry *boundary, double tolerance)
 
GEOSGeometryGEOSMinimumWidth_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
GEOSGeometryGEOSMinimumClearanceLine_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
int GEOSMinimumClearance_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double *distance)
 
GEOSGeometryGEOSDifference_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2)
 
GEOSGeometryGEOSDifferencePrec_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2, double gridSize)
 
GEOSGeometryGEOSSymDifference_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2)
 
GEOSGeometryGEOSSymDifferencePrec_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2, double gridSize)
 
GEOSGeometryGEOSBoundary_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
GEOSGeometryGEOSUnion_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2)
 
GEOSGeometryGEOSUnionPrec_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2, double gridSize)
 
GEOSGeometryGEOSUnaryUnion_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
GEOSGeometryGEOSUnaryUnionPrec_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double gridSize)
 
GEOSGeometryGEOSCoverageUnion_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
GEOSGeometryGEOSPointOnSurface_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
GEOSGeometryGEOSGetCentroid_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
GEOSGeometryGEOSMinimumBoundingCircle_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double *radius, GEOSGeometry **center)
 
GEOSGeometryGEOSNode_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
GEOSGeometryGEOSClipByRect_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double xmin, double ymin, double xmax, double ymax)
 
GEOSGeometryGEOSPolygonize_r (GEOSContextHandle_t handle, const GEOSGeometry *const geoms[], unsigned int ngeoms)
 
GEOSGeometryGEOSPolygonize_valid_r (GEOSContextHandle_t handle, const GEOSGeometry *const geoms[], unsigned int ngems)
 
GEOSGeometryGEOSPolygonizer_getCutEdges_r (GEOSContextHandle_t handle, const GEOSGeometry *const geoms[], unsigned int ngeoms)
 
GEOSGeometryGEOSPolygonize_full_r (GEOSContextHandle_t handle, const GEOSGeometry *input, GEOSGeometry **cuts, GEOSGeometry **dangles, GEOSGeometry **invalidRings)
 
GEOSGeometryGEOSBuildArea_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
GEOSGeometryGEOSLineMerge_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
GEOSGeometryGEOSReverse_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
GEOSGeometryGEOSSimplify_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double tolerance)
 
GEOSGeometryGEOSTopologyPreserveSimplify_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double tolerance)
 
GEOSGeometryGEOSGeom_extractUniquePoints_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
GEOSGeometryGEOSSharedPaths_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2)
 
GEOSGeometryGEOSSnap_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2, double tolerance)
 
GEOSGeometryGEOSDelaunayTriangulation_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double tolerance, int onlyEdges)
 
GEOSGeometryGEOSConstrainedDelaunayTriangulation_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
GEOSGeometryGEOSVoronoiDiagram_r (GEOSContextHandle_t extHandle, const GEOSGeometry *g, const GEOSGeometry *env, double tolerance, int onlyEdges)
 
int GEOSSegmentIntersection_r (GEOSContextHandle_t extHandle, double ax0, double ay0, double ax1, double ay1, double bx0, double by0, double bx1, double by1, double *cx, double *cy)
 
char GEOSDisjoint_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSTouches_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSIntersects_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSCrosses_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSWithin_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSContains_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSOverlaps_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSEquals_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSEqualsExact_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2, double tolerance)
 
char GEOSCovers_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSCoveredBy_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2)
 
const GEOSPreparedGeometryGEOSPrepare_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
void GEOSPreparedGeom_destroy_r (GEOSContextHandle_t handle, const GEOSPreparedGeometry *g)
 
char GEOSPreparedContains_r (GEOSContextHandle_t handle, const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedContainsProperly_r (GEOSContextHandle_t handle, const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedCoveredBy_r (GEOSContextHandle_t handle, const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedCovers_r (GEOSContextHandle_t handle, const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedCrosses_r (GEOSContextHandle_t handle, const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedDisjoint_r (GEOSContextHandle_t handle, const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedIntersects_r (GEOSContextHandle_t handle, const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedOverlaps_r (GEOSContextHandle_t handle, const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedTouches_r (GEOSContextHandle_t handle, const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedWithin_r (GEOSContextHandle_t handle, const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
GEOSCoordSequenceGEOSPreparedNearestPoints_r (GEOSContextHandle_t handle, const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
int GEOSPreparedDistance_r (GEOSContextHandle_t handle, const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2, double *dist)
 
char GEOSPreparedDistanceWithin_r (GEOSContextHandle_t handle, const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2, double dist)
 
GEOSSTRtreeGEOSSTRtree_create_r (GEOSContextHandle_t handle, size_t nodeCapacity)
 
void GEOSSTRtree_insert_r (GEOSContextHandle_t handle, GEOSSTRtree *tree, const GEOSGeometry *g, void *item)
 
void GEOSSTRtree_query_r (GEOSContextHandle_t handle, GEOSSTRtree *tree, const GEOSGeometry *g, GEOSQueryCallback callback, void *userdata)
 
const GEOSGeometryGEOSSTRtree_nearest_r (GEOSContextHandle_t handle, GEOSSTRtree *tree, const GEOSGeometry *geom)
 
const void * GEOSSTRtree_nearest_generic_r (GEOSContextHandle_t handle, GEOSSTRtree *tree, const void *item, const GEOSGeometry *itemEnvelope, GEOSDistanceCallback distancefn, void *userdata)
 
void GEOSSTRtree_iterate_r (GEOSContextHandle_t handle, GEOSSTRtree *tree, GEOSQueryCallback callback, void *userdata)
 
char GEOSSTRtree_remove_r (GEOSContextHandle_t handle, GEOSSTRtree *tree, const GEOSGeometry *g, void *item)
 
void GEOSSTRtree_destroy_r (GEOSContextHandle_t handle, GEOSSTRtree *tree)
 
char GEOSisEmpty_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
char GEOSisSimple_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
char GEOSisRing_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
char GEOSHasZ_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
char GEOSisClosed_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
char GEOSRelatePattern_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2, const char *pat)
 
char * GEOSRelate_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSRelatePatternMatch_r (GEOSContextHandle_t handle, const char *mat, const char *pat)
 
char * GEOSRelateBoundaryNodeRule_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2, int bnr)
 
char GEOSisValid_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
char * GEOSisValidReason_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
char GEOSisValidDetail_r (GEOSContextHandle_t handle, const GEOSGeometry *g, int flags, char **reason, GEOSGeometry **location)
 
GEOSMakeValidParamsGEOSMakeValidParams_create_r (GEOSContextHandle_t extHandle)
 
void GEOSMakeValidParams_destroy_r (GEOSContextHandle_t handle, GEOSMakeValidParams *parms)
 
int GEOSMakeValidParams_setKeepCollapsed_r (GEOSContextHandle_t handle, GEOSMakeValidParams *p, int style)
 
int GEOSMakeValidParams_setMethod_r (GEOSContextHandle_t handle, GEOSMakeValidParams *p, enum GEOSMakeValidMethods method)
 
GEOSGeometryGEOSMakeValid_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
GEOSGeometryGEOSMakeValidWithParams_r (GEOSContextHandle_t handle, const GEOSGeometry *g, const GEOSMakeValidParams *makeValidParams)
 
char * GEOSGeomType_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
int GEOSGeomTypeId_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
int GEOSGetSRID_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
void GEOSSetSRID_r (GEOSContextHandle_t handle, GEOSGeometry *g, int SRID)
 
void * GEOSGeom_getUserData_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
void GEOSGeom_setUserData_r (GEOSContextHandle_t handle, GEOSGeometry *g, void *userData)
 
int GEOSGetNumGeometries_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
const GEOSGeometryGEOSGetGeometryN_r (GEOSContextHandle_t handle, const GEOSGeometry *g, int n)
 
int GEOSNormalize_r (GEOSContextHandle_t handle, GEOSGeometry *g)
 
GEOSGeometryGEOSGeom_setPrecision_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double gridSize, int flags)
 
double GEOSGeom_getPrecision_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
int GEOSGetNumInteriorRings_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
int GEOSGeomGetNumPoints_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
int GEOSGeomGetX_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double *x)
 
int GEOSGeomGetY_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double *y)
 
int GEOSGeomGetZ_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double *z)
 
const GEOSGeometryGEOSGetInteriorRingN_r (GEOSContextHandle_t handle, const GEOSGeometry *g, int n)
 
const GEOSGeometryGEOSGetExteriorRing_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
int GEOSGetNumCoordinates_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
const GEOSCoordSequenceGEOSGeom_getCoordSeq_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
int GEOSGeom_getDimensions_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
int GEOSGeom_getCoordinateDimension_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
int GEOSGeom_getXMin_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double *value)
 
int GEOSGeom_getYMin_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double *value)
 
int GEOSGeom_getXMax_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double *value)
 
int GEOSGeom_getYMax_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double *value)
 
GEOSGeometryGEOSGeomGetPointN_r (GEOSContextHandle_t handle, const GEOSGeometry *g, int n)
 
GEOSGeometryGEOSGeomGetStartPoint_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
GEOSGeometryGEOSGeomGetEndPoint_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
int GEOSArea_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double *area)
 
int GEOSLength_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double *length)
 
int GEOSDistance_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2, double *dist)
 
char GEOSDistanceWithin_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2, double dist)
 
int GEOSDistanceIndexed_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2, double *dist)
 
int GEOSHausdorffDistance_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2, double *dist)
 
int GEOSHausdorffDistanceDensify_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2, double densifyFrac, double *dist)
 
int GEOSFrechetDistance_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2, double *dist)
 
int GEOSFrechetDistanceDensify_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2, double densifyFrac, double *dist)
 
int GEOSGeomGetLength_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double *length)
 
GEOSCoordSequenceGEOSNearestPoints_r (GEOSContextHandle_t handle, const GEOSGeometry *g1, const GEOSGeometry *g2)
 
int GEOSOrientationIndex_r (GEOSContextHandle_t handle, double Ax, double Ay, double Bx, double By, double Px, double Py)
 
GEOSWKTReaderGEOSWKTReader_create_r (GEOSContextHandle_t handle)
 
void GEOSWKTReader_destroy_r (GEOSContextHandle_t handle, GEOSWKTReader *reader)
 
GEOSGeometryGEOSWKTReader_read_r (GEOSContextHandle_t handle, GEOSWKTReader *reader, const char *wkt)
 
GEOSWKTWriterGEOSWKTWriter_create_r (GEOSContextHandle_t handle)
 
void GEOSWKTWriter_destroy_r (GEOSContextHandle_t handle, GEOSWKTWriter *writer)
 
char * GEOSWKTWriter_write_r (GEOSContextHandle_t handle, GEOSWKTWriter *writer, const GEOSGeometry *g)
 
void GEOSWKTWriter_setTrim_r (GEOSContextHandle_t handle, GEOSWKTWriter *writer, char trim)
 
void GEOSWKTWriter_setRoundingPrecision_r (GEOSContextHandle_t handle, GEOSWKTWriter *writer, int precision)
 
void GEOSWKTWriter_setOutputDimension_r (GEOSContextHandle_t handle, GEOSWKTWriter *writer, int dim)
 
int GEOSWKTWriter_getOutputDimension_r (GEOSContextHandle_t handle, GEOSWKTWriter *writer)
 
void GEOSWKTWriter_setOld3D_r (GEOSContextHandle_t handle, GEOSWKTWriter *writer, int useOld3D)
 
GEOSWKBReaderGEOSWKBReader_create_r (GEOSContextHandle_t handle)
 
void GEOSWKBReader_destroy_r (GEOSContextHandle_t handle, GEOSWKBReader *reader)
 
GEOSGeometryGEOSWKBReader_read_r (GEOSContextHandle_t handle, GEOSWKBReader *reader, const unsigned char *wkb, size_t size)
 
GEOSGeometryGEOSWKBReader_readHEX_r (GEOSContextHandle_t handle, GEOSWKBReader *reader, const unsigned char *hex, size_t size)
 
GEOSWKBWriterGEOSWKBWriter_create_r (GEOSContextHandle_t handle)
 
void GEOSWKBWriter_destroy_r (GEOSContextHandle_t handle, GEOSWKBWriter *writer)
 
unsigned char * GEOSWKBWriter_write_r (GEOSContextHandle_t handle, GEOSWKBWriter *writer, const GEOSGeometry *g, size_t *size)
 
unsigned char * GEOSWKBWriter_writeHEX_r (GEOSContextHandle_t handle, GEOSWKBWriter *writer, const GEOSGeometry *g, size_t *size)
 
int GEOSWKBWriter_getOutputDimension_r (GEOSContextHandle_t handle, const GEOSWKBWriter *writer)
 
void GEOSWKBWriter_setOutputDimension_r (GEOSContextHandle_t handle, GEOSWKBWriter *writer, int newDimension)
 
int GEOSWKBWriter_getByteOrder_r (GEOSContextHandle_t handle, const GEOSWKBWriter *writer)
 
void GEOSWKBWriter_setByteOrder_r (GEOSContextHandle_t handle, GEOSWKBWriter *writer, int byteOrder)
 
int GEOSWKBWriter_getFlavor_r (GEOSContextHandle_t handle, const GEOSWKBWriter *writer)
 
void GEOSWKBWriter_setFlavor_r (GEOSContextHandle_t handle, GEOSWKBWriter *writer, int flavor)
 
char GEOSWKBWriter_getIncludeSRID_r (GEOSContextHandle_t handle, const GEOSWKBWriter *writer)
 
void GEOSWKBWriter_setIncludeSRID_r (GEOSContextHandle_t handle, GEOSWKBWriter *writer, const char writeSRID)
 
GEOSGeoJSONReaderGEOSGeoJSONReader_create_r (GEOSContextHandle_t handle)
 
void GEOSGeoJSONReader_destroy_r (GEOSContextHandle_t handle, GEOSGeoJSONReader *reader)
 
GEOSGeometryGEOSGeoJSONReader_readGeometry_r (GEOSContextHandle_t handle, GEOSGeoJSONReader *reader, const char *geojson)
 
GEOSGeoJSONWriterGEOSGeoJSONWriter_create_r (GEOSContextHandle_t handle)
 
void GEOSGeoJSONWriter_destroy_r (GEOSContextHandle_t handle, GEOSGeoJSONWriter *writer)
 
char * GEOSGeoJSONWriter_writeGeometry_r (GEOSContextHandle_t handle, GEOSGeoJSONWriter *writer, const GEOSGeometry *g, int indent)
 
void GEOSFree_r (GEOSContextHandle_t handle, void *buffer)
 
const char * GEOSversion (void)
 
void initGEOS (GEOSMessageHandler notice_function, GEOSMessageHandler error_function)
 
void finishGEOS (void)
 
GEOSCoordSequenceGEOSCoordSeq_create (unsigned int size, unsigned int dims)
 
GEOSCoordSequenceGEOSCoordSeq_copyFromBuffer (const double *buf, unsigned int size, int hasZ, int hasM)
 
GEOSCoordSequenceGEOSCoordSeq_copyFromArrays (const double *x, const double *y, const double *z, const double *m, unsigned int size)
 
int GEOSCoordSeq_copyToBuffer (const GEOSCoordSequence *s, double *buf, int hasZ, int hasM)
 
int GEOSCoordSeq_copyToArrays (const GEOSCoordSequence *s, double *x, double *y, double *z, double *m)
 
GEOSCoordSequenceGEOSCoordSeq_clone (const GEOSCoordSequence *s)
 
void GEOSCoordSeq_destroy (GEOSCoordSequence *s)
 
int GEOSCoordSeq_setX (GEOSCoordSequence *s, unsigned int idx, double val)
 
int GEOSCoordSeq_setY (GEOSCoordSequence *s, unsigned int idx, double val)
 
int GEOSCoordSeq_setZ (GEOSCoordSequence *s, unsigned int idx, double val)
 
int GEOSCoordSeq_setXY (GEOSCoordSequence *s, unsigned int idx, double x, double y)
 
int GEOSCoordSeq_setXYZ (GEOSCoordSequence *s, unsigned int idx, double x, double y, double z)
 
int GEOSCoordSeq_setOrdinate (GEOSCoordSequence *s, unsigned int idx, unsigned int dim, double val)
 
int GEOSCoordSeq_getX (const GEOSCoordSequence *s, unsigned int idx, double *val)
 
int GEOSCoordSeq_getY (const GEOSCoordSequence *s, unsigned int idx, double *val)
 
int GEOSCoordSeq_getZ (const GEOSCoordSequence *s, unsigned int idx, double *val)
 
int GEOSCoordSeq_getXY (const GEOSCoordSequence *s, unsigned int idx, double *x, double *y)
 
int GEOSCoordSeq_getXYZ (const GEOSCoordSequence *s, unsigned int idx, double *x, double *y, double *z)
 
int GEOSCoordSeq_getOrdinate (const GEOSCoordSequence *s, unsigned int idx, unsigned int dim, double *val)
 
int GEOSCoordSeq_getSize (const GEOSCoordSequence *s, unsigned int *size)
 
int GEOSCoordSeq_getDimensions (const GEOSCoordSequence *s, unsigned int *dims)
 
int GEOSCoordSeq_isCCW (const GEOSCoordSequence *s, char *is_ccw)
 
double GEOSProject (const GEOSGeometry *line, const GEOSGeometry *point)
 
GEOSGeometryGEOSInterpolate (const GEOSGeometry *line, double d)
 
double GEOSProjectNormalized (const GEOSGeometry *line, const GEOSGeometry *point)
 
GEOSGeometryGEOSInterpolateNormalized (const GEOSGeometry *line, double proportion)
 
GEOSGeometryGEOSBuffer (const GEOSGeometry *g, double width, int quadsegs)
 
GEOSBufferParamsGEOSBufferParams_create (void)
 
void GEOSBufferParams_destroy (GEOSBufferParams *parms)
 
int GEOSBufferParams_setEndCapStyle (GEOSBufferParams *p, int style)
 
int GEOSBufferParams_setJoinStyle (GEOSBufferParams *p, int joinStyle)
 
int GEOSBufferParams_setMitreLimit (GEOSBufferParams *p, double mitreLimit)
 
int GEOSBufferParams_setQuadrantSegments (GEOSBufferParams *p, int quadSegs)
 
int GEOSBufferParams_setSingleSided (GEOSBufferParams *p, int singleSided)
 
GEOSGeometryGEOSBufferWithParams (const GEOSGeometry *g, const GEOSBufferParams *p, double width)
 
GEOSGeometryGEOSBufferWithStyle (const GEOSGeometry *g, double width, int quadsegs, int endCapStyle, int joinStyle, double mitreLimit)
 
GEOSGeometryGEOSDensify (const GEOSGeometry *g, double tolerance)
 
GEOSGeometryGEOSOffsetCurve (const GEOSGeometry *g, double width, int quadsegs, int joinStyle, double mitreLimit)
 
GEOSGeometryGEOSGeom_createPoint (GEOSCoordSequence *s)
 
GEOSGeometryGEOSGeom_createPointFromXY (double x, double y)
 
GEOSGeometryGEOSGeom_createEmptyPoint (void)
 
GEOSGeometryGEOSGeom_createLinearRing (GEOSCoordSequence *s)
 
GEOSGeometryGEOSGeom_createLineString (GEOSCoordSequence *s)
 
GEOSGeometryGEOSGeom_createEmptyLineString (void)
 
GEOSGeometryGEOSGeom_createEmptyPolygon (void)
 
GEOSGeometryGEOSGeom_createPolygon (GEOSGeometry *shell, GEOSGeometry **holes, unsigned int nholes)
 
GEOSGeometryGEOSGeom_createCollection (int type, GEOSGeometry **geoms, unsigned int ngeoms)
 
GEOSGeometryGEOSGeom_createEmptyCollection (int type)
 
GEOSGeometryGEOSGeom_clone (const GEOSGeometry *g)
 
void GEOSGeom_destroy (GEOSGeometry *g)
 
GEOSGeometryGEOSEnvelope (const GEOSGeometry *g)
 
GEOSGeometryGEOSIntersection (const GEOSGeometry *g1, const GEOSGeometry *g2)
 
GEOSGeometryGEOSIntersectionPrec (const GEOSGeometry *g1, const GEOSGeometry *g2, double gridSize)
 
GEOSGeometryGEOSDifference (const GEOSGeometry *ga, const GEOSGeometry *gb)
 
GEOSGeometryGEOSDifferencePrec (const GEOSGeometry *ga, const GEOSGeometry *gb, double gridSize)
 
GEOSGeometryGEOSSymDifference (const GEOSGeometry *ga, const GEOSGeometry *gb)
 
GEOSGeometryGEOSSymDifferencePrec (const GEOSGeometry *ga, const GEOSGeometry *gb, double gridSize)
 
GEOSGeometryGEOSUnion (const GEOSGeometry *ga, const GEOSGeometry *gb)
 
GEOSGeometryGEOSUnionPrec (const GEOSGeometry *ga, const GEOSGeometry *gb, double gridSize)
 
GEOSGeometryGEOSUnaryUnion (const GEOSGeometry *g)
 
GEOSGeometryGEOSUnaryUnionPrec (const GEOSGeometry *g, double gridSize)
 
GEOSGeometryGEOSBoundary (const GEOSGeometry *g)
 
GEOSGeometryGEOSConvexHull (const GEOSGeometry *g)
 
GEOSGeometryGEOSMinimumRotatedRectangle (const GEOSGeometry *g)
 
GEOSGeometryGEOSMaximumInscribedCircle (const GEOSGeometry *g, double tolerance)
 
GEOSGeometryGEOSLargestEmptyCircle (const GEOSGeometry *obstacles, const GEOSGeometry *boundary, double tolerance)
 
GEOSGeometryGEOSMinimumWidth (const GEOSGeometry *g)
 
int GEOSMinimumClearance (const GEOSGeometry *g, double *d)
 
GEOSGeometryGEOSMinimumClearanceLine (const GEOSGeometry *g)
 
GEOSGeometryGEOSCoverageUnion (const GEOSGeometry *g)
 
GEOSGeometryGEOSPointOnSurface (const GEOSGeometry *g)
 
GEOSGeometryGEOSGetCentroid (const GEOSGeometry *g)
 
GEOSGeometryGEOSMinimumBoundingCircle (const GEOSGeometry *g, double *radius, GEOSGeometry **center)
 
GEOSGeometryGEOSNode (const GEOSGeometry *g)
 
GEOSGeometryGEOSClipByRect (const GEOSGeometry *g, double xmin, double ymin, double xmax, double ymax)
 
GEOSGeometryGEOSPolygonize (const GEOSGeometry *const geoms[], unsigned int ngeoms)
 
GEOSGeometryGEOSPolygonize_valid (const GEOSGeometry *const geoms[], unsigned int ngeoms)
 
GEOSGeometryGEOSPolygonizer_getCutEdges (const GEOSGeometry *const geoms[], unsigned int ngeoms)
 
GEOSGeometryGEOSPolygonize_full (const GEOSGeometry *input, GEOSGeometry **cuts, GEOSGeometry **dangles, GEOSGeometry **invalid)
 
GEOSGeometryGEOSBuildArea (const GEOSGeometry *g)
 
GEOSGeometryGEOSLineMerge (const GEOSGeometry *g)
 
GEOSGeometryGEOSReverse (const GEOSGeometry *g)
 
GEOSGeometryGEOSSimplify (const GEOSGeometry *g, double tolerance)
 
GEOSGeometryGEOSTopologyPreserveSimplify (const GEOSGeometry *g, double tolerance)
 
GEOSGeometryGEOSGeom_extractUniquePoints (const GEOSGeometry *g)
 
GEOSGeometryGEOSSharedPaths (const GEOSGeometry *g1, const GEOSGeometry *g2)
 
GEOSGeometryGEOSSnap (const GEOSGeometry *input, const GEOSGeometry *snap_target, double tolerance)
 
GEOSGeometryGEOSDelaunayTriangulation (const GEOSGeometry *g, double tolerance, int onlyEdges)
 
GEOSGeometryGEOSConstrainedDelaunayTriangulation (const GEOSGeometry *g)
 
GEOSGeometryGEOSVoronoiDiagram (const GEOSGeometry *g, const GEOSGeometry *env, double tolerance, int onlyEdges)
 
int GEOSSegmentIntersection (double ax0, double ay0, double ax1, double ay1, double bx0, double by0, double bx1, double by1, double *cx, double *cy)
 
char GEOSDisjoint (const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSTouches (const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSIntersects (const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSCrosses (const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSWithin (const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSContains (const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSOverlaps (const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSEquals (const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSCovers (const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSCoveredBy (const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSEqualsExact (const GEOSGeometry *g1, const GEOSGeometry *g2, double tolerance)
 
const GEOSPreparedGeometryGEOSPrepare (const GEOSGeometry *g)
 
void GEOSPreparedGeom_destroy (const GEOSPreparedGeometry *g)
 
char GEOSPreparedContains (const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedContainsProperly (const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedCoveredBy (const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedCovers (const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedCrosses (const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedDisjoint (const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedIntersects (const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedOverlaps (const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedTouches (const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
char GEOSPreparedWithin (const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
GEOSCoordSequenceGEOSPreparedNearestPoints (const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2)
 
int GEOSPreparedDistance (const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2, double *dist)
 
char GEOSPreparedDistanceWithin (const GEOSPreparedGeometry *pg1, const GEOSGeometry *g2, double dist)
 
GEOSSTRtreeGEOSSTRtree_create (size_t nodeCapacity)
 
void GEOSSTRtree_insert (GEOSSTRtree *tree, const GEOSGeometry *g, void *item)
 
void GEOSSTRtree_query (GEOSSTRtree *tree, const GEOSGeometry *g, GEOSQueryCallback callback, void *userdata)
 
const GEOSGeometryGEOSSTRtree_nearest (GEOSSTRtree *tree, const GEOSGeometry *geom)
 
const void * GEOSSTRtree_nearest_generic (GEOSSTRtree *tree, const void *item, const GEOSGeometry *itemEnvelope, GEOSDistanceCallback distancefn, void *userdata)
 
void GEOSSTRtree_iterate (GEOSSTRtree *tree, GEOSQueryCallback callback, void *userdata)
 
char GEOSSTRtree_remove (GEOSSTRtree *tree, const GEOSGeometry *g, void *item)
 
void GEOSSTRtree_destroy (GEOSSTRtree *tree)
 
char GEOSisEmpty (const GEOSGeometry *g)
 
char GEOSisSimple (const GEOSGeometry *g)
 
char GEOSisRing (const GEOSGeometry *g)
 
char GEOSHasZ (const GEOSGeometry *g)
 
char GEOSisClosed (const GEOSGeometry *g)
 
char GEOSRelatePattern (const GEOSGeometry *g1, const GEOSGeometry *g2, const char *pat)
 
char * GEOSRelate (const GEOSGeometry *g1, const GEOSGeometry *g2)
 
char GEOSRelatePatternMatch (const char *mat, const char *pat)
 
char * GEOSRelateBoundaryNodeRule (const GEOSGeometry *g1, const GEOSGeometry *g2, int bnr)
 
char GEOSisValid (const GEOSGeometry *g)
 
char * GEOSisValidReason (const GEOSGeometry *g)
 
char GEOSisValidDetail (const GEOSGeometry *g, int flags, char **reason, GEOSGeometry **location)
 
GEOSGeometryGEOSMakeValid (const GEOSGeometry *g)
 
GEOSGeometryGEOSMakeValidWithParams (const GEOSGeometry *g, const GEOSMakeValidParams *makeValidParams)
 
GEOSMakeValidParamsGEOSMakeValidParams_create (void)
 
void GEOSMakeValidParams_destroy (GEOSMakeValidParams *parms)
 
int GEOSMakeValidParams_setMethod (GEOSMakeValidParams *p, enum GEOSMakeValidMethods method)
 
int GEOSMakeValidParams_setKeepCollapsed (GEOSMakeValidParams *p, int keepCollapsed)
 
char * GEOSGeomType (const GEOSGeometry *g)
 
int GEOSGeomTypeId (const GEOSGeometry *g)
 
int GEOSGetSRID (const GEOSGeometry *g)
 
void GEOSSetSRID (GEOSGeometry *g, int SRID)
 
void * GEOSGeom_getUserData (const GEOSGeometry *g)
 
void GEOSGeom_setUserData (GEOSGeometry *g, void *userData)
 
int GEOSGetNumGeometries (const GEOSGeometry *g)
 
const GEOSGeometryGEOSGetGeometryN (const GEOSGeometry *g, int n)
 
int GEOSNormalize (GEOSGeometry *g)
 
GEOSGeometryGEOSGeom_setPrecision (const GEOSGeometry *g, double gridSize, int flags)
 
double GEOSGeom_getPrecision (const GEOSGeometry *g)
 
int GEOSGetNumInteriorRings (const GEOSGeometry *g)
 
int GEOSGeomGetNumPoints (const GEOSGeometry *g)
 
int GEOSGeomGetX (const GEOSGeometry *g, double *x)
 
int GEOSGeomGetY (const GEOSGeometry *g, double *y)
 
int GEOSGeomGetZ (const GEOSGeometry *g, double *z)
 
const GEOSGeometryGEOSGetInteriorRingN (const GEOSGeometry *g, int n)
 
const GEOSGeometryGEOSGetExteriorRing (const GEOSGeometry *g)
 
int GEOSGetNumCoordinates (const GEOSGeometry *g)
 
const GEOSCoordSequenceGEOSGeom_getCoordSeq (const GEOSGeometry *g)
 
int GEOSGeom_getDimensions (const GEOSGeometry *g)
 
int GEOSGeom_getCoordinateDimension (const GEOSGeometry *g)
 
int GEOSGeom_getXMin (const GEOSGeometry *g, double *value)
 
int GEOSGeom_getYMin (const GEOSGeometry *g, double *value)
 
int GEOSGeom_getXMax (const GEOSGeometry *g, double *value)
 
int GEOSGeom_getYMax (const GEOSGeometry *g, double *value)
 
GEOSGeometryGEOSGeomGetPointN (const GEOSGeometry *g, int n)
 
GEOSGeometryGEOSGeomGetStartPoint (const GEOSGeometry *g)
 
GEOSGeometryGEOSGeomGetEndPoint (const GEOSGeometry *g)
 
int GEOSArea (const GEOSGeometry *g, double *area)
 
int GEOSLength (const GEOSGeometry *g, double *length)
 
int GEOSDistance (const GEOSGeometry *g1, const GEOSGeometry *g2, double *dist)
 
char GEOSDistanceWithin (const GEOSGeometry *g1, const GEOSGeometry *g2, double dist)
 
int GEOSDistanceIndexed (const GEOSGeometry *g1, const GEOSGeometry *g2, double *dist)
 
int GEOSHausdorffDistance (const GEOSGeometry *g1, const GEOSGeometry *g2, double *dist)
 
int GEOSHausdorffDistanceDensify (const GEOSGeometry *g1, const GEOSGeometry *g2, double densifyFrac, double *dist)
 
int GEOSFrechetDistance (const GEOSGeometry *g1, const GEOSGeometry *g2, double *dist)
 
int GEOSFrechetDistanceDensify (const GEOSGeometry *g1, const GEOSGeometry *g2, double densifyFrac, double *dist)
 
int GEOSGeomGetLength (const GEOSGeometry *g, double *length)
 
GEOSCoordSequenceGEOSNearestPoints (const GEOSGeometry *g1, const GEOSGeometry *g2)
 
int GEOSOrientationIndex (double Ax, double Ay, double Bx, double By, double Px, double Py)
 
GEOSWKTReaderGEOSWKTReader_create (void)
 
void GEOSWKTReader_destroy (GEOSWKTReader *reader)
 
GEOSGeometryGEOSWKTReader_read (GEOSWKTReader *reader, const char *wkt)
 
GEOSWKTWriterGEOSWKTWriter_create (void)
 
void GEOSWKTWriter_destroy (GEOSWKTWriter *writer)
 
char * GEOSWKTWriter_write (GEOSWKTWriter *writer, const GEOSGeometry *g)
 
void GEOSWKTWriter_setTrim (GEOSWKTWriter *writer, char trim)
 
void GEOSWKTWriter_setRoundingPrecision (GEOSWKTWriter *writer, int precision)
 
void GEOSWKTWriter_setOutputDimension (GEOSWKTWriter *writer, int dim)
 
int GEOSWKTWriter_getOutputDimension (GEOSWKTWriter *writer)
 
void GEOSWKTWriter_setOld3D (GEOSWKTWriter *writer, int useOld3D)
 
GEOSWKBReaderGEOSWKBReader_create (void)
 
void GEOSWKBReader_destroy (GEOSWKBReader *reader)
 
GEOSGeometryGEOSWKBReader_read (GEOSWKBReader *reader, const unsigned char *wkb, size_t size)
 
GEOSGeometryGEOSWKBReader_readHEX (GEOSWKBReader *reader, const unsigned char *hex, size_t size)
 
GEOSWKBWriterGEOSWKBWriter_create (void)
 
void GEOSWKBWriter_destroy (GEOSWKBWriter *writer)
 
unsigned char * GEOSWKBWriter_write (GEOSWKBWriter *writer, const GEOSGeometry *g, size_t *size)
 
unsigned char * GEOSWKBWriter_writeHEX (GEOSWKBWriter *writer, const GEOSGeometry *g, size_t *size)
 
int GEOSWKBWriter_getOutputDimension (const GEOSWKBWriter *writer)
 
void GEOSWKBWriter_setOutputDimension (GEOSWKBWriter *writer, int newDimension)
 
int GEOSWKBWriter_getByteOrder (const GEOSWKBWriter *writer)
 
void GEOSWKBWriter_setByteOrder (GEOSWKBWriter *writer, int byteOrder)
 
int GEOSWKBWriter_getFlavor (const GEOSWKBWriter *writer)
 
void GEOSWKBWriter_setFlavor (GEOSWKBWriter *writer, int flavor)
 
char GEOSWKBWriter_getIncludeSRID (const GEOSWKBWriter *writer)
 
void GEOSWKBWriter_setIncludeSRID (GEOSWKBWriter *writer, const char writeSRID)
 
void GEOSFree (void *buffer)
 
GEOSGeoJSONReaderGEOSGeoJSONReader_create (void)
 
void GEOSGeoJSONReader_destroy (GEOSGeoJSONReader *reader)
 
GEOSGeometryGEOSGeoJSONReader_readGeometry (GEOSGeoJSONReader *reader, const char *geojson)
 
GEOSGeoJSONWriterGEOSGeoJSONWriter_create (void)
 
void GEOSGeoJSONWriter_destroy (GEOSGeoJSONWriter *writer)
 
char * GEOSGeoJSONWriter_writeGeometry (GEOSGeoJSONWriter *writer, const GEOSGeometry *g, int indent)
 
GEOSGeometryGEOSSingleSidedBuffer (const GEOSGeometry *g, double width, int quadsegs, int joinStyle, double mitreLimit, int leftSide)
 
GEOSGeometryGEOSSingleSidedBuffer_r (GEOSContextHandle_t handle, const GEOSGeometry *g, double width, int quadsegs, int joinStyle, double mitreLimit, int leftSide)
 
GEOSContextHandle_t initGEOS_r (GEOSMessageHandler notice_function, GEOSMessageHandler error_function)
 
void finishGEOS_r (GEOSContextHandle_t handle)
 
GEOSGeometryGEOSGeomFromWKT_r (GEOSContextHandle_t handle, const char *wkt)
 
char * GEOSGeomToWKT_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 
int GEOS_getWKBOutputDims_r (GEOSContextHandle_t handle)
 
int GEOS_setWKBOutputDims_r (GEOSContextHandle_t handle, int newDims)
 
int GEOS_getWKBByteOrder_r (GEOSContextHandle_t handle)
 
int GEOS_setWKBByteOrder_r (GEOSContextHandle_t handle, int byteOrder)
 
GEOSGeometryGEOSGeomFromWKB_buf_r (GEOSContextHandle_t handle, const unsigned char *wkb, size_t size)
 
unsigned char * GEOSGeomToWKB_buf_r (GEOSContextHandle_t handle, const GEOSGeometry *g, size_t *size)
 
GEOSGeometryGEOSGeomFromHEX_buf_r (GEOSContextHandle_t handle, const unsigned char *hex, size_t size)
 
unsigned char * GEOSGeomToHEX_buf_r (GEOSContextHandle_t handle, const GEOSGeometry *g, size_t *size)
 
GEOSGeometryGEOSGeomFromWKT (const char *wkt)
 
char * GEOSGeomToWKT (const GEOSGeometry *g)
 
int GEOS_getWKBOutputDims (void)
 
int GEOS_setWKBOutputDims (int newDims)
 
int GEOS_getWKBByteOrder (void)
 
int GEOS_setWKBByteOrder (int byteOrder)
 
GEOSGeometryGEOSGeomFromWKB_buf (const unsigned char *wkb, size_t size)
 
unsigned char * GEOSGeomToWKB_buf (const GEOSGeometry *g, size_t *size)
 
GEOSGeometryGEOSGeomFromHEX_buf (const unsigned char *hex, size_t size)
 
unsigned char * GEOSGeomToHEX_buf (const GEOSGeometry *g, size_t *size)
 
GEOSGeometryGEOSUnionCascaded (const GEOSGeometry *g)
 
GEOSGeometryGEOSUnionCascaded_r (GEOSContextHandle_t handle, const GEOSGeometry *g)
 

Detailed Description

C API for the GEOS geometry algorithms library.

The C API is the preferred API to use when integration GEOS into you program/language/etc. While the C++ API is available, the ABI will not be stable between versions, and the API may also change. The GEOS team makes an effort to keep the C API stable, and to deprecate function signatures only over a long time period to allow transition time.

Important programming notes:

Typedef Documentation

◆ GEOSBufferParams

typedef struct GEOSBufParams_t GEOSBufferParams

Parameter object for buffering.

See also
GEOSBufferParams_create()
GEOSBufferParams_destroy()

◆ GEOSContextHandle_t

typedef struct GEOSContextHandle_HS* GEOSContextHandle_t

Type returned by GEOS_init_r(), for use in multi-threaded applications.

There should be only one GEOSContextHandle_t per thread.

◆ GEOSCoordSequence

typedef struct GEOSCoordSeq_t GEOSCoordSequence

Coordinate sequence.

See also
GEOSCoordSeq_create()
GEOSCoordSeq_destroy()

◆ GEOSDistanceCallback

typedef int(* GEOSDistanceCallback) (const void *item1, const void *item2, double *distance, void *userdata)

Callback function for use in spatial index nearest neighbor calculations. Allows custom distance to be calculated between items in the index. Is passed two items, and sets the calculated distance between the items into the distance pointer. Extra data for the calculation can be passed via the userdata.

Parameters
item1first of the pair of items to calculate distance between
item2second of the pair of items to calculate distance between
distancethe distance between the items here
userdataextra data for the calculation
Returns
zero if distance calculation succeeded, non-zero otherwise
See also
GEOSSTRtree_nearest_generic
GEOSSTRtree_iterate

◆ GEOSGeoJSONReader

typedef struct GEOSGeoJSONReader_t GEOSGeoJSONReader

Reader object to read GeoJSON format and construct a Geometry.

See also
GEOSGeoJSONReader_create
GEOSGeoJSONReader_create_r

◆ GEOSGeoJSONWriter

typedef struct GEOSGeoJSONWriter_t GEOSGeoJSONWriter

Writer object to turn a Geometry into GeoJSON.

See also
GEOSGeoJSONReader_create
GEOSGeoJSONReader_create_r

◆ GEOSGeometry

typedef struct GEOSGeom_t GEOSGeometry

Geometry generic type. Geometry can be a point, linestring, polygon, multipoint, multilinestring, multipolygon, or geometrycollection. Geometry type can be read with GEOSGeomTypeId. Most functions in GEOS either have GEOSGeometry* as a parameter or a return type.

See also
GEOSGeom_createPoint
GEOSGeom_createLineString
GEOSGeom_createPolygon
GEOSGeom_createCollection
GEOSGeom_destroy

◆ GEOSInterruptCallback

typedef void() GEOSInterruptCallback(void)

Callback function for use in interruption. The callback will be invoked before checking for interruption, so can be used to request it.

See also
GEOS_interruptRegisterCallback
GEOS_interruptRequest
GEOS_interruptCancel

◆ GEOSMakeValidParams

typedef struct GEOSMakeValidParams_t GEOSMakeValidParams

Parameter object for validity enforcement.

See also
GEOSMakeValidParams_create()
GEOSMakeValidParams_destroy()

◆ GEOSMessageHandler

typedef void(* GEOSMessageHandler) (const char *fmt,...)

Callback function for passing GEOS error messages to parent process.

Set the GEOSMessageHandler for error and notice messages in initGEOS for single-threaded programs, or using initGEOS_r for threaded programs

Parameters
fmtthe message format template

◆ GEOSMessageHandler_r

typedef void(* GEOSMessageHandler_r) (const char *message, void *userdata)

A GEOS message handler function.

Parameters
messagethe message contents
userdatathe user data pointer that was passed to GEOS when registering this message handler.
See also
GEOSContext_setErrorMessageHandler
GEOSContext_setNoticeMessageHandler

◆ GEOSPreparedGeometry

typedef struct GEOSPrepGeom_t GEOSPreparedGeometry

Prepared geometry type.

See also
GEOSPrepare()
GEOSPreparedGeom_destroy()

◆ GEOSQueryCallback

typedef void(* GEOSQueryCallback) (void *item, void *userdata)

Callback function for use in spatial index search calls. Pass into the query function and handle query results as the index returns them.

See also
GEOSSTRtree_query

◆ GEOSSTRtree

typedef struct GEOSSTRtree_t GEOSSTRtree

◆ GEOSWKBReader

typedef struct GEOSWKBReader_t GEOSWKBReader

Reader object to read Well-Known Binary (WKB) format and construct Geometry.

See also
GEOSWKBReader_create
GEOSWKBReader_create_r

◆ GEOSWKBWriter

typedef struct GEOSWKBWriter_t GEOSWKBWriter

Writer object to turn Geometry into Well-Known Binary (WKB).

See also
GEOSWKBWriter_create
GEOSWKBWriter_create_r

◆ GEOSWKTReader

typedef struct GEOSWKTReader_t GEOSWKTReader

Reader object to read Well-Known Text (WKT) format and construct Geometry.

See also
GEOSWKTReader_create
GEOSWKTReader_create_r

◆ GEOSWKTWriter

typedef struct GEOSWKTWriter_t GEOSWKTWriter

Writer object to turn Geometry into Well-Known Text (WKT).

See also
GEOSWKTWriter_create
GEOSWKTWriter_create_r

Enumeration Type Documentation

◆ GEOSBufCapStyles

Cap styles control the ends of buffered lines.

See also
GEOSBuffer
Enumerator
GEOSBUF_CAP_ROUND 

End is rounded, with end point of original line in the centre of the round cap.

GEOSBUF_CAP_FLAT 

End is flat, with end point of original line at the end of the buffer

GEOSBUF_CAP_SQUARE 

End is flat, with end point of original line in the middle of a square enclosing that point

◆ GEOSBufJoinStyles

Join styles control the buffer shape at bends in a line.

See also
GEOSBuffer
Enumerator
GEOSBUF_JOIN_ROUND 

Join is rounded, essentially each line is terminated in a round cap. Form round corner.

GEOSBUF_JOIN_MITRE 

Join is flat, with line between buffer edges, through the join point. Forms flat corner.

GEOSBUF_JOIN_BEVEL 

Join is the point at which the two buffer edges intersect. Forms sharp corner.

◆ GEOSGeomTypes

Geometry type number, used by functions returning or consuming geometry types.

See also
GEOSGeomType
GEOSGeomTypeId
Enumerator
GEOS_POINT 

Point

GEOS_LINESTRING 

Linestring

GEOS_LINEARRING 

Linear ring, used within polygons

GEOS_POLYGON 

Polygon

GEOS_MULTIPOINT 

Multipoint, a homogeneous collection of points

GEOS_MULTILINESTRING 

Multilinestring, a homogeneous collection of linestrings

GEOS_MULTIPOLYGON 

Multipolygon, a homogeneous collection of polygons

GEOS_GEOMETRYCOLLECTION 

Geometry collection, a heterogeneous collection of geometry

◆ GEOSMakeValidMethods

Algorithm to use when repairing invalid geometries.

See also
GEOSMakeValidWithParams
Enumerator
GEOS_MAKE_VALID_LINEWORK 

Original method, combines all rings into a set of noded lines and then extracts valid polygons from that linework.

GEOS_MAKE_VALID_STRUCTURE 

Structured method, first makes all rings valid then merges shells and subtracts holes from shells to generate valid result. Assumes that holes and shells are correctly categorized.

◆ GEOSPrecisionRules

Controls the behavior of GEOSGeom_setPrecision() when altering the precision of a geometry.

Enumerator
GEOS_PREC_VALID_OUTPUT 

The output is always valid. Collapsed geometry elements (including both polygons and lines) are removed.

GEOS_PREC_NO_TOPO 

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_KEEP_COLLAPSED 

Like the default mode, except that collapsed linear geometry elements are preserved. Collapsed polygonal input elements are removed.

◆ GEOSRelateBoundaryNodeRules

Controls the behavior of the result of GEOSRelate when returning DE9IM results for two geometries.

Enumerator
GEOSRELATE_BNR_MOD2 

See geos::algorithm::BoundaryNodeRule::getBoundaryRuleMod2()

GEOSRELATE_BNR_OGC 

Same as GEOSRELATE_BNR_MOD2

GEOSRELATE_BNR_ENDPOINT 

See geos::algorithm::BoundaryNodeRule::getBoundaryEndPoint()

GEOSRELATE_BNR_MULTIVALENT_ENDPOINT 

See geos::algorithm::BoundaryNodeRule::getBoundaryMultivalentEndPoint()

GEOSRELATE_BNR_MONOVALENT_ENDPOINT 

See geos::algorithm::BoundaryNodeRule::getBoundaryMonovalentEndPoint()

◆ GEOSValidFlags

Change behaviour of validity testing in GEOSisValidDetail

Enumerator
GEOSVALID_ALLOW_SELFTOUCHING_RING_FORMING_HOLE 

Allow self-touching rings to form a hole in a polygon.

◆ GEOSWKBByteOrders

Well-known binary byte orders used when writing to WKB.

See also
GEOSWKBWriter_setByteOrder
Enumerator
GEOS_WKB_XDR 

Big Endian

GEOS_WKB_NDR 

Little Endian

◆ GEOSWKBFlavors

Well-known binary flavors to use when writing to WKB. ISO flavour is more standard. Extended flavour supports 3D and SRID embedding. GEOS reads both transparently.

See also
GEOSWKBWriter_setFlavor
Enumerator
GEOS_WKB_EXTENDED 

Extended

GEOS_WKB_ISO 

ISO

Function Documentation

◆ finishGEOS()

void finishGEOS ( void  )

For non-reentrant code, call when all GEOS operations are complete, cleans up global resources.

◆ finishGEOS_r()

void finishGEOS_r ( GEOSContextHandle_t  handle)
Deprecated:
in 3.5.0, replaced by GEOS_finish_r()

◆ GEOS_finish_r()

void GEOS_finish_r ( GEOSContextHandle_t  handle)

Free the memory associated with a GEOSContextHandle_t when you are finished calling GEOS functions.

Parameters
handleto be freed

◆ GEOS_getWKBByteOrder()

int GEOS_getWKBByteOrder ( void  )

◆ GEOS_getWKBByteOrder_r()

int GEOS_getWKBByteOrder_r ( GEOSContextHandle_t  handle)

◆ GEOS_getWKBOutputDims()

int GEOS_getWKBOutputDims ( void  )

◆ GEOS_getWKBOutputDims_r()

int GEOS_getWKBOutputDims_r ( GEOSContextHandle_t  handle)

◆ GEOS_init_r()

GEOSContextHandle_t GEOS_init_r ( void  )

Initialize a context for this thread. Pass this context into your other calls of *_r functions.

Returns
a GEOS context for this thread

◆ GEOS_interruptCancel()

void GEOS_interruptCancel ( void  )

Cancel a pending interruption request

◆ GEOS_interruptRegisterCallback()

GEOSInterruptCallback* GEOS_interruptRegisterCallback ( GEOSInterruptCallback cb)

Register a function to be called when processing is interrupted.

Parameters
cbCallback function to invoke
Returns
the previously configured callback
See also
GEOSInterruptCallback

◆ GEOS_interruptRequest()

void GEOS_interruptRequest ( void  )

Request safe interruption of operations

◆ GEOS_setWKBByteOrder()

int GEOS_setWKBByteOrder ( int  byteOrder)

◆ GEOS_setWKBByteOrder_r()

int GEOS_setWKBByteOrder_r ( GEOSContextHandle_t  handle,
int  byteOrder 
)

◆ GEOS_setWKBOutputDims()

int GEOS_setWKBOutputDims ( int  newDims)

◆ GEOS_setWKBOutputDims_r()

int GEOS_setWKBOutputDims_r ( GEOSContextHandle_t  handle,
int  newDims 
)

◆ GEOSArea()

int GEOSArea ( const GEOSGeometry g,
double *  area 
)

Calculate the area of a geometry.

Parameters
[in]gInput geometry
[out]areaPointer to be filled in with area result
Returns
1 on success, 0 on exception.

◆ GEOSArea_r()

int GEOSArea_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double *  area 
)
See also
GEOSArea

◆ GEOSBoundary()

GEOSGeometry* GEOSBoundary ( const GEOSGeometry g)

Returns the "boundary" of a geometry, as defined by the DE9IM:

  • the boundary of a polygon is the linear rings dividing the exterior from the interior
  • the boundary of a linestring is the end points
  • the boundary of a point is the point
Parameters
gThe input geometry
Returns
A newly allocated geometry of the boundary. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSBoundary_r()

GEOSGeometry* GEOSBoundary_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSBoundary

◆ GEOSBuffer()

GEOSGeometry* GEOSBuffer ( const GEOSGeometry g,
double  width,
int  quadsegs 
)

Buffer a geometry.

Parameters
gThe input geometry to be buffered.
widthThe distance by which to expand the geometry (or contract) if the value is negative.
quadsegsThe number of segments per quadrant to generate. More segments provides a more "precise" buffer at the expense of size.
Returns
A GEOSGeometry of the buffered result. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSBuffer_r()

GEOSGeometry* GEOSBuffer_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double  width,
int  quadsegs 
)
See also
GEOSBuffer

◆ GEOSBufferParams_create()

GEOSBufferParams* GEOSBufferParams_create ( void  )

Create a default GEOSBufferParams object for controlling the shape of buffered generated by GEOSBuffer.

Returns
A newly allocated GEOSBufferParams. NULL on exception. Caller is responsible for freeing with GEOSBufferParams_destroy().

◆ GEOSBufferParams_create_r()

GEOSBufferParams* GEOSBufferParams_create_r ( GEOSContextHandle_t  handle)

◆ GEOSBufferParams_destroy()

void GEOSBufferParams_destroy ( GEOSBufferParams parms)

Destroy a GEOSBufferParams and free all associated memory.

Parameters
parmsThe object to destroy.

◆ GEOSBufferParams_destroy_r()

void GEOSBufferParams_destroy_r ( GEOSContextHandle_t  handle,
GEOSBufferParams parms 
)

◆ GEOSBufferParams_setEndCapStyle()

int GEOSBufferParams_setEndCapStyle ( GEOSBufferParams p,
int  style 
)

Set the end cap type of a GEOSBufferParams to the desired style, which must be one enumerated in GEOSBufCapStyles.

Returns
0 on exception, 1 on success.

◆ GEOSBufferParams_setEndCapStyle_r()

int GEOSBufferParams_setEndCapStyle_r ( GEOSContextHandle_t  handle,
GEOSBufferParams p,
int  style 
)

◆ GEOSBufferParams_setJoinStyle()

int GEOSBufferParams_setJoinStyle ( GEOSBufferParams p,
int  joinStyle 
)

Set the join type of a GEOSBufferParams to the desired style, which must be one enumerated in GEOSBufJoinStyles.

Returns
0 on exception, 1 on success.

◆ GEOSBufferParams_setJoinStyle_r()

int GEOSBufferParams_setJoinStyle_r ( GEOSContextHandle_t  handle,
GEOSBufferParams p,
int  joinStyle 
)

◆ GEOSBufferParams_setMitreLimit()

int GEOSBufferParams_setMitreLimit ( GEOSBufferParams p,
double  mitreLimit 
)

Set the mitre limit of a GEOSBufferParams to the desired size. For acute angles, a mitre join can extend very very far from the input geometry, which is probably not desired. The mitre limit places an upper bound on that.

Parameters
pThe GEOSBufferParams to operate on
mitreLimitThe limit to set
Returns
0 on exception, 1 on success.

◆ GEOSBufferParams_setMitreLimit_r()

int GEOSBufferParams_setMitreLimit_r ( GEOSContextHandle_t  handle,
GEOSBufferParams p,
double  mitreLimit 
)

◆ GEOSBufferParams_setQuadrantSegments()

int GEOSBufferParams_setQuadrantSegments ( GEOSBufferParams p,
int  quadSegs 
)

Set the number of segments to use to stroke each quadrant of circular arcs generated by the buffering process. More segments means a smoother output, but with larger size.

Parameters
pThe GEOSBufferParams to operate on
quadSegsNumber of segments per quadrant
Returns
0 on exception, 1 on success.

◆ GEOSBufferParams_setQuadrantSegments_r()

int GEOSBufferParams_setQuadrantSegments_r ( GEOSContextHandle_t  handle,
GEOSBufferParams p,
int  quadSegs 
)

◆ GEOSBufferParams_setSingleSided()

int GEOSBufferParams_setSingleSided ( GEOSBufferParams p,
int  singleSided 
)

Sets whether the computed buffer should be single-sided. A single-sided buffer is constructed on only one side of each input line.

See also
geos::operation::buffer::BufferParameters::setSingleSided
Parameters
pThe GEOSBufferParams to operate on
singleSidedSet to 1 for single-sided output 0 otherwise
Returns
0 on exception, 1 on success.

◆ GEOSBufferParams_setSingleSided_r()

int GEOSBufferParams_setSingleSided_r ( GEOSContextHandle_t  handle,
GEOSBufferParams p,
int  singleSided 
)

◆ GEOSBufferWithParams()

GEOSGeometry* GEOSBufferWithParams ( const GEOSGeometry g,
const GEOSBufferParams p,
double  width 
)

Generates a buffer using the special parameters in the GEOSBufferParams

Parameters
gThe geometry to buffer
pThe parameters to apply to the buffer process
widthThe buffer distance
Returns
The buffered geometry, or NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSBufferWithParams_r()

GEOSGeometry* GEOSBufferWithParams_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
const GEOSBufferParams p,
double  width 
)

◆ GEOSBufferWithStyle()

GEOSGeometry* GEOSBufferWithStyle ( const GEOSGeometry g,
double  width,
int  quadsegs,
int  endCapStyle,
int  joinStyle,
double  mitreLimit 
)

Generate a buffer using the provided style parameters.

Parameters
gThe geometry to buffer
widthWidth of the buffer
quadsegsNumber of segments per quadrant
endCapStyleSee GEOSBufCapStyles
joinStyleSee GEOSBufJoinStyles
mitreLimitSee GEOSBufferParams_setMitreLimit
Returns
The buffered geometry, or NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSBufferWithStyle_r()

GEOSGeometry* GEOSBufferWithStyle_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double  width,
int  quadsegs,
int  endCapStyle,
int  joinStyle,
double  mitreLimit 
)

◆ GEOSBuildArea()

GEOSGeometry* GEOSBuildArea ( const GEOSGeometry g)

Perform a polygonization using all the linework, assuming that rings contained within rings are empty holes, rather then extra polygons.

Parameters
gThe input linework
Returns
The polygonal output Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::polygonize::BuildArea

◆ GEOSBuildArea_r()

GEOSGeometry* GEOSBuildArea_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSBuildArea

◆ GEOSClipByRect()

GEOSGeometry* GEOSClipByRect ( const GEOSGeometry g,
double  xmin,
double  ymin,
double  xmax,
double  ymax 
)

Intersection optimized for a rectangular clipping polygon. Supposed to be faster than using GEOSIntersection(). Not guaranteed to return valid results.

Parameters
gThe input geometry to be clipped
xminLeft bound of clipping rectangle
yminLower bound of clipping rectangle
xmaxRight bound of clipping rectangle
ymaxUpper bound of clipping rectangle
Returns
The clipped geometry or NULL on exception Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::intersection::RectangleIntersection

◆ GEOSClipByRect_r()

GEOSGeometry* GEOSClipByRect_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double  xmin,
double  ymin,
double  xmax,
double  ymax 
)
See also
GEOSClipByRect

◆ GEOSConstrainedDelaunayTriangulation()

GEOSGeometry* GEOSConstrainedDelaunayTriangulation ( const GEOSGeometry g)

Return a constrained Delaunay triangulation of the vertices of the given polygon(s). For non-polygonal inputs, returns an empty geometry collection.

Parameters
gthe input geometry whose rings will be used as input
Returns
A newly allocated geometry. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSConstrainedDelaunayTriangulation_r()

GEOSGeometry* GEOSConstrainedDelaunayTriangulation_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSContains()

char GEOSContains ( const GEOSGeometry g1,
const GEOSGeometry g2 
)

True if geometry g2 is completely within g1.

Parameters
g1Input geometry
g2Input geometry
Returns
1 on true, 0 on false, 2 on exception
See also
geos::geom::Geometry::contains

◆ GEOSContains_r()

char GEOSContains_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2 
)
See also
GEOSContains

◆ GEOSContext_setErrorHandler_r()

GEOSMessageHandler GEOSContext_setErrorHandler_r ( GEOSContextHandle_t  extHandle,
GEOSMessageHandler  ef 
)

Set the notice handler callback function for run-time error messages.

Parameters
extHandlethe GEOS context from GEOS_init_r
efthe handler callback
Returns
the previously configured message handler or NULL if no message handler was configured

◆ GEOSContext_setErrorMessageHandler_r()

GEOSMessageHandler_r GEOSContext_setErrorMessageHandler_r ( GEOSContextHandle_t  extHandle,
GEOSMessageHandler_r  ef,
void *  userData 
)

Sets an error message handler on the given GEOS context.

Parameters
extHandlethe GEOS context
efthe message handler
userDataoptional user data pointer that will be passed to the message handler
Returns
the previously configured message handler or NULL if no message handler was configured

◆ GEOSContext_setNoticeHandler_r()

GEOSMessageHandler GEOSContext_setNoticeHandler_r ( GEOSContextHandle_t  extHandle,
GEOSMessageHandler  nf 
)

Set the notice handler callback function for run-time notice messages.

Parameters
extHandlethe context returned by GEOS_init_r.
nfthe handler callback
Returns
the previously configured message handler or NULL if no message handler was configured

◆ GEOSContext_setNoticeMessageHandler_r()

GEOSMessageHandler_r GEOSContext_setNoticeMessageHandler_r ( GEOSContextHandle_t  extHandle,
GEOSMessageHandler_r  nf,
void *  userData 
)

Sets a notice message handler on the given GEOS context.

Parameters
extHandlethe GEOS context from GEOS_init_r
nfthe message handler
userDataoptional user data pointer that will be passed to the message handler
Returns
the previously configured message handler or NULL if no message handler was configured

◆ GEOSConvexHull()

GEOSGeometry* GEOSConvexHull ( const GEOSGeometry g)

Returns convex hull of a geometry. The smallest convex Geometry that contains all the points in the input Geometry

Parameters
gThe input geometry
Returns
A newly allocated geometry of the convex hull. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::overlayng::OverlayNG

◆ GEOSConvexHull_r()

GEOSGeometry* GEOSConvexHull_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSConvexHull

◆ GEOSCoordSeq_clone()

GEOSCoordSequence* GEOSCoordSeq_clone ( const GEOSCoordSequence s)

Clone a coordinate sequence.

Parameters
sthe coordinate sequence to clone
Returns
a copy of the coordinate sequence or NULL on exception

◆ GEOSCoordSeq_clone_r()

GEOSCoordSequence* GEOSCoordSeq_clone_r ( GEOSContextHandle_t  handle,
const GEOSCoordSequence s 
)

◆ GEOSCoordSeq_copyFromArrays()

GEOSCoordSequence* GEOSCoordSeq_copyFromArrays ( const double *  x,
const double *  y,
const double *  z,
const double *  m,
unsigned int  size 
)

Create a coordinate sequence by copying from arrays of doubles

Parameters
xarray of x coordinates
yarray of y coordinates
zarray of z coordinates, or NULL
marray of m coordinates, (must be NULL)
sizelength of each array
Returns
the sequence or NULL on exception

◆ GEOSCoordSeq_copyFromArrays_r()

GEOSCoordSequence* GEOSCoordSeq_copyFromArrays_r ( GEOSContextHandle_t  handle,
const double *  x,
const double *  y,
const double *  z,
const double *  m,
unsigned int  size 
)

◆ GEOSCoordSeq_copyFromBuffer()

GEOSCoordSequence* GEOSCoordSeq_copyFromBuffer ( const double *  buf,
unsigned int  size,
int  hasZ,
int  hasM 
)

Create a coordinate sequence by copying from a buffer of doubles (XYXY or XYZXYZ)

Parameters
bufpointer to buffer
sizenumber of coordinates in the sequence
hasZdoes buffer have Z values?
hasMdoes buffer have M values? (they will be ignored)
Returns
the sequence or NULL on exception

◆ GEOSCoordSeq_copyFromBuffer_r()

GEOSCoordSequence* GEOSCoordSeq_copyFromBuffer_r ( GEOSContextHandle_t  handle,
const double *  buf,
unsigned int  size,
int  hasZ,
int  hasM 
)

◆ GEOSCoordSeq_copyToArrays()

int GEOSCoordSeq_copyToArrays ( const GEOSCoordSequence s,
double *  x,
double *  y,
double *  z,
double *  m 
)

Copy the contents of a coordinate sequence to a buffer of doubles (XYZY or XYZXYZ)

Parameters
ssequence to copy
xarray to which x values should be copied
yarray to which y values should be copied
zarray to which z values should be copied, or NULL
marray to which m values should be copied (will all be NAN)
Returns
1 on success, 0 on error

◆ GEOSCoordSeq_copyToArrays_r()

int GEOSCoordSeq_copyToArrays_r ( GEOSContextHandle_t  handle,
const GEOSCoordSequence s,
double *  x,
double *  y,
double *  z,
double *  m 
)

◆ GEOSCoordSeq_copyToBuffer()

int GEOSCoordSeq_copyToBuffer ( const GEOSCoordSequence s,
double *  buf,
int  hasZ,
int  hasM 
)

Copy the contents of a coordinate sequence to a buffer of doubles (XYXY or XYZXYZ)

Parameters
ssequence to copy
bufbuffer to which coordinates should be copied
hasZcopy Z values to buffer?
hasMcopy M values to buffer? (will be NaN)
Returns
1 on success, 0 on error

◆ GEOSCoordSeq_copyToBuffer_r()

int GEOSCoordSeq_copyToBuffer_r ( GEOSContextHandle_t  handle,
const GEOSCoordSequence s,
double *  buf,
int  hasZ,
int  hasM 
)

◆ GEOSCoordSeq_create()

GEOSCoordSequence* GEOSCoordSeq_create ( unsigned int  size,
unsigned int  dims 
)

Create a coordinate sequence.

Parameters
sizenumber of coordinates in the sequence
dimsdimensionality of the coordinates (2 or 3)
Returns
the sequence or NULL on exception

◆ GEOSCoordSeq_create_r()

GEOSCoordSequence* GEOSCoordSeq_create_r ( GEOSContextHandle_t  handle,
unsigned int  size,
unsigned int  dims 
)

◆ GEOSCoordSeq_destroy()

void GEOSCoordSeq_destroy ( GEOSCoordSequence s)

Destroy a coordinate sequence, freeing all memory.

Parameters
sthe coordinate sequence to destroy

◆ GEOSCoordSeq_destroy_r()

void GEOSCoordSeq_destroy_r ( GEOSContextHandle_t  handle,
GEOSCoordSequence s 
)

◆ GEOSCoordSeq_getDimensions()

int GEOSCoordSeq_getDimensions ( const GEOSCoordSequence s,
unsigned int *  dims 
)

Get dimension info from a coordinate sequence.

Parameters
[in]sthe coordinate sequence
[out]dimspointer where dimension value will be placed
Returns
0 on exception

◆ GEOSCoordSeq_getDimensions_r()

int GEOSCoordSeq_getDimensions_r ( GEOSContextHandle_t  handle,
const GEOSCoordSequence s,
unsigned int *  dims 
)

◆ GEOSCoordSeq_getOrdinate()

int GEOSCoordSeq_getOrdinate ( const GEOSCoordSequence s,
unsigned int  idx,
unsigned int  dim,
double *  val 
)

Read Nth ordinate value from a coordinate sequence.

Parameters
[in]sthe coordinate sequence
[in]idxthe index of the coordinate to alter, zero based
[in]dimthe dimension number of the ordinate to read, zero based
[out]valpointer where ordinate value will be placed
Returns
0 on exception

◆ GEOSCoordSeq_getOrdinate_r()

int GEOSCoordSeq_getOrdinate_r ( GEOSContextHandle_t  handle,
const GEOSCoordSequence s,
unsigned int  idx,
unsigned int  dim,
double *  val 
)

◆ GEOSCoordSeq_getSize()

int GEOSCoordSeq_getSize ( const GEOSCoordSequence s,
unsigned int *  size 
)

Get size info from a coordinate sequence.

Parameters
[in]sthe coordinate sequence
[out]sizepointer where size value will be placed
Returns
0 on exception

◆ GEOSCoordSeq_getSize_r()

int GEOSCoordSeq_getSize_r ( GEOSContextHandle_t  handle,
const GEOSCoordSequence s,
unsigned int *  size 
)

◆ GEOSCoordSeq_getX()

int GEOSCoordSeq_getX ( const GEOSCoordSequence s,
unsigned int  idx,
double *  val 
)

Read X ordinate values from a coordinate sequence.

Parameters
sthe coordinate sequence
idxthe index of the coordinate to alter, zero based
valpointer where ordinate value will be placed
Returns
0 on exception

◆ GEOSCoordSeq_getX_r()

int GEOSCoordSeq_getX_r ( GEOSContextHandle_t  handle,
const GEOSCoordSequence s,
unsigned int  idx,
double *  val 
)

◆ GEOSCoordSeq_getXY()

int GEOSCoordSeq_getXY ( const GEOSCoordSequence s,
unsigned int  idx,
double *  x,
double *  y 
)

Read X and Y ordinate values from a coordinate sequence.

Parameters
sthe coordinate sequence
idxthe index of the coordinate to alter, zero based
xpointer where ordinate X value will be placed
ypointer where ordinate Y value will be placed
Returns
0 on exception

◆ GEOSCoordSeq_getXY_r()

int GEOSCoordSeq_getXY_r ( GEOSContextHandle_t  handle,
const GEOSCoordSequence s,
unsigned int  idx,
double *  x,
double *  y 
)

◆ GEOSCoordSeq_getXYZ()

int GEOSCoordSeq_getXYZ ( const GEOSCoordSequence s,
unsigned int  idx,
double *  x,
double *  y,
double *  z 
)

Read X and Y ordinate values from a coordinate sequence.

Parameters
sthe coordinate sequence
idxthe index of the coordinate to alter, zero based
xpointer where ordinate X value will be placed
ypointer where ordinate Y value will be placed
zpointer where ordinate Z value will be placed
Returns
0 on exception

◆ GEOSCoordSeq_getXYZ_r()

int GEOSCoordSeq_getXYZ_r ( GEOSContextHandle_t  handle,
const GEOSCoordSequence s,
unsigned int  idx,
double *  x,
double *  y,
double *  z 
)

◆ GEOSCoordSeq_getY()

int GEOSCoordSeq_getY ( const GEOSCoordSequence s,
unsigned int  idx,
double *  val 
)

Read Y ordinate values from a coordinate sequence.

Parameters
sthe coordinate sequence
idxthe index of the coordinate to alter, zero based
valpointer where ordinate value will be placed
Returns
0 on exception

◆ GEOSCoordSeq_getY_r()

int GEOSCoordSeq_getY_r ( GEOSContextHandle_t  handle,
const GEOSCoordSequence s,
unsigned int  idx,
double *  val 
)

◆ GEOSCoordSeq_getZ()

int GEOSCoordSeq_getZ ( const GEOSCoordSequence s,
unsigned int  idx,
double *  val 
)

Read Z ordinate values from a coordinate sequence.

Parameters
sthe coordinate sequence
idxthe index of the coordinate to alter, zero based
valpointer where ordinate value will be placed
Returns
0 on exception

◆ GEOSCoordSeq_getZ_r()

int GEOSCoordSeq_getZ_r ( GEOSContextHandle_t  handle,
const GEOSCoordSequence s,
unsigned int  idx,
double *  val 
)

◆ GEOSCoordSeq_isCCW()

int GEOSCoordSeq_isCCW ( const GEOSCoordSequence s,
char *  is_ccw 
)

Check orientation of a coordinate sequence. Closure of the sequence is assumed. Invalid (collapsed) sequences will return false. Short (less than 4 points) sequences will return exception.

Parameters
sthe coordinate sequence
is_ccwpointer for ccw value, 1 if counter-clockwise orientation, 0 otherwise
Returns
0 on exception, 1 on success

◆ GEOSCoordSeq_isCCW_r()

int GEOSCoordSeq_isCCW_r ( GEOSContextHandle_t  handle,
const GEOSCoordSequence s,
char *  is_ccw 
)

◆ GEOSCoordSeq_setOrdinate()

int GEOSCoordSeq_setOrdinate ( GEOSCoordSequence s,
unsigned int  idx,
unsigned int  dim,
double  val 
)

Set Nth ordinate value in a coordinate sequence.

Parameters
sthe coordinate sequence
idxthe index of the coordinate to alter, zero based
dimthe dimension number of the ordinate to alter, zero based
valthe value to set the ordinate to
Returns
0 on exception

◆ GEOSCoordSeq_setOrdinate_r()

int GEOSCoordSeq_setOrdinate_r ( GEOSContextHandle_t  handle,
GEOSCoordSequence s,
unsigned int  idx,
unsigned int  dim,
double  val 
)

◆ GEOSCoordSeq_setX()

int GEOSCoordSeq_setX ( GEOSCoordSequence s,
unsigned int  idx,
double  val 
)

Set X ordinate values in a coordinate sequence.

Parameters
sthe coordinate sequence
idxthe index of the coordinate to alter, zero based
valthe value to set the ordinate to
Returns
0 on exception

◆ GEOSCoordSeq_setX_r()

int GEOSCoordSeq_setX_r ( GEOSContextHandle_t  handle,
GEOSCoordSequence s,
unsigned int  idx,
double  val 
)

◆ GEOSCoordSeq_setXY()

int GEOSCoordSeq_setXY ( GEOSCoordSequence s,
unsigned int  idx,
double  x,
double  y 
)

Set X and Y ordinate values in a coordinate sequence simultaneously.

Parameters
sthe coordinate sequence
idxthe index of the coordinate to alter, zero based
xthe value to set the X ordinate to
ythe value to set the Y ordinate to
Returns
0 on exception

◆ GEOSCoordSeq_setXY_r()

int GEOSCoordSeq_setXY_r ( GEOSContextHandle_t  handle,
GEOSCoordSequence s,
unsigned int  idx,
double  x,
double  y 
)

◆ GEOSCoordSeq_setXYZ()

int GEOSCoordSeq_setXYZ ( GEOSCoordSequence s,
unsigned int  idx,
double  x,
double  y,
double  z 
)

Set X, Y and Z ordinate values in a coordinate sequence simultaneously.

Parameters
sthe coordinate sequence
idxthe index of the coordinate to alter, zero based
xthe value to set the X ordinate to
ythe value to set the Y ordinate to
zthe value to set the Z ordinate to
Returns
0 on exception

◆ GEOSCoordSeq_setXYZ_r()

int GEOSCoordSeq_setXYZ_r ( GEOSContextHandle_t  handle,
GEOSCoordSequence s,
unsigned int  idx,
double  x,
double  y,
double  z 
)

◆ GEOSCoordSeq_setY()

int GEOSCoordSeq_setY ( GEOSCoordSequence s,
unsigned int  idx,
double  val 
)

Set Y ordinate values in a coordinate sequence.

Parameters
sthe coordinate sequence
idxthe index of the coordinate to alter, zero based
valthe value to set the ordinate to
Returns
0 on exception

◆ GEOSCoordSeq_setY_r()

int GEOSCoordSeq_setY_r ( GEOSContextHandle_t  handle,
GEOSCoordSequence s,
unsigned int  idx,
double  val 
)

◆ GEOSCoordSeq_setZ()

int GEOSCoordSeq_setZ ( GEOSCoordSequence s,
unsigned int  idx,
double  val 
)

Set Z ordinate values in a coordinate sequence.

Parameters
sthe coordinate sequence
idxthe index of the coordinate to alter, zero based
valthe value to set the ordinate to
Returns
0 on exception

◆ GEOSCoordSeq_setZ_r()

int GEOSCoordSeq_setZ_r ( GEOSContextHandle_t  handle,
GEOSCoordSequence s,
unsigned int  idx,
double  val 
)

◆ GEOSCoverageUnion()

GEOSGeometry* GEOSCoverageUnion ( const GEOSGeometry g)

Optimized union algorithm for polygonal inputs that are correctly noded and do not overlap. It will generate an error (return NULL) for inputs that do not satisfy this constraint.

Parameters
gThe input geometry
Returns
A geometry that covers all the points of the input geometry. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSCoverageUnion_r()

GEOSGeometry* GEOSCoverageUnion_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSCoveredBy()

char GEOSCoveredBy ( const GEOSGeometry g1,
const GEOSGeometry g2 
)

True if geometry g2 is completely within g1, including possibly touching the boundary of g1.

Parameters
g1Input geometry
g2Input geometry
Returns
1 on true, 0 on false, 2 on exception
See also
geos::geom::Geometry::coveredby

◆ GEOSCoveredBy_r()

char GEOSCoveredBy_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2 
)
See also
GEOSCoveredBy

◆ GEOSCovers()

char GEOSCovers ( const GEOSGeometry g1,
const GEOSGeometry g2 
)

True if geometry g1 is completely within g2, including possibly touching the boundary of g2.

Parameters
g1Input geometry
g2Input geometry
Returns
1 on true, 0 on false, 2 on exception
See also
geos::geom::Geometry::covers

◆ GEOSCovers_r()

char GEOSCovers_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2 
)
See also
GEOSCovers

◆ GEOSCrosses()

char GEOSCrosses ( const GEOSGeometry g1,
const GEOSGeometry g2 
)

True if geometries interiors interact but their boundares do not. Most useful for finding line crosses cases.

Parameters
g1Input geometry
g2Input geometry
Returns
1 on true, 0 on false, 2 on exception
See also
geos::geom::Geometry::crosses

◆ GEOSCrosses_r()

char GEOSCrosses_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2 
)
See also
GEOSCrosses

◆ GEOSDelaunayTriangulation()

GEOSGeometry* GEOSDelaunayTriangulation ( const GEOSGeometry g,
double  tolerance,
int  onlyEdges 
)

Return a Delaunay triangulation of the vertices of the given geometry.

Parameters
gthe input geometry whose vertices will be used as "sites"
toleranceoptional snapping tolerance to use for improved robustness
onlyEdgesif non-zero will return a MultiLineString, otherwise it will return a GeometryCollection containing triangular Polygons.
Returns
A newly allocated geometry. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSDelaunayTriangulation_r()

GEOSGeometry* GEOSDelaunayTriangulation_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double  tolerance,
int  onlyEdges 
)

◆ GEOSDensify()

GEOSGeometry* GEOSDensify ( const GEOSGeometry g,
double  tolerance 
)

Densifies a geometry using a given distance tolerance. Additional vertices will be added to every line segment that is greater this tolerance; these vertices will evenly subdivide that segment. Only linear components of input geometry are densified.

Parameters
gThe geometry to densify
tolerancethe distance tolerance to densify
Returns
The densified geometry, or NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSDensify_r()

GEOSGeometry* GEOSDensify_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double  tolerance 
)
See also
GEOSDensify

◆ GEOSDifference()

GEOSGeometry* GEOSDifference ( const GEOSGeometry ga,
const GEOSGeometry gb 
)

Returns the difference of two geometries A and B: the set of points that fall within A but not within B.

Parameters
gathe base geometry
gbthe geometry to subtract from it
Returns
A newly allocated geometry of the difference. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::overlayng::OverlayNG

◆ GEOSDifference_r()

GEOSGeometry* GEOSDifference_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2 
)
See also
GEOSDifference

◆ GEOSDifferencePrec()

GEOSGeometry* GEOSDifferencePrec ( const GEOSGeometry ga,
const GEOSGeometry gb,
double  gridSize 
)

Returns the difference of two geometries A and B: the set of points that fall within A but not within B. All the vertices of the output geometry must fall on the grid defined by the gridSize, and the output will be a valid geometry.

Parameters
gaone of the geometries
gbthe other geometry
gridSizethe cell size of the precision grid
Returns
A newly allocated geometry of the difference. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::overlayng::OverlayNG

◆ GEOSDifferencePrec_r()

GEOSGeometry* GEOSDifferencePrec_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2,
double  gridSize 
)

◆ GEOSDisjoint()

char GEOSDisjoint ( const GEOSGeometry g1,
const GEOSGeometry g2 
)

True if no point of either geometry touchess or is within the other.

Parameters
g1Input geometry
g2Input geometry
Returns
1 on true, 0 on false, 2 on exception
See also
geos::geom::Geometry::disjoint

◆ GEOSDisjoint_r()

char GEOSDisjoint_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2 
)
See also
GEOSDisjoint

◆ GEOSDistance()

int GEOSDistance ( const GEOSGeometry g1,
const GEOSGeometry g2,
double *  dist 
)

Calculate the distance between two geometries.

Parameters
[in]g1Input geometry
[in]g2Input geometry
[out]distPointer to be filled in with distance result
Returns
1 on success, 0 on exception.

◆ GEOSDistance_r()

int GEOSDistance_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2,
double *  dist 
)
See also
GEOSDistance

◆ GEOSDistanceIndexed()

int GEOSDistanceIndexed ( const GEOSGeometry g1,
const GEOSGeometry g2,
double *  dist 
)

Calculate the distance between two geometries, using the indexed facet distance, which first indexes the geometries internally, then calculates the distance. Useful when one or both geometries is very large.

Parameters
[in]g1Input geometry
[in]g2Input geometry
[out]distPointer to be filled in with distance result
Returns
1 on success, 0 on exception.
See also
geos::operation::distance:;IndexedFacetDistance

◆ GEOSDistanceIndexed_r()

int GEOSDistanceIndexed_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2,
double *  dist 
)

◆ GEOSDistanceWithin()

char GEOSDistanceWithin ( const GEOSGeometry g1,
const GEOSGeometry g2,
double  dist 
)

Test whether the distance between two geometries is within the given dist.

Parameters
g1Input geometry
g2Input geometry
distThe max distance
Returns
1 on true, 0 on false, 2 on exception

◆ GEOSDistanceWithin_r()

char GEOSDistanceWithin_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2,
double  dist 
)

◆ GEOSEnvelope()

GEOSGeometry* GEOSEnvelope ( const GEOSGeometry g)

Returns minimum rectangular polygon that contains the geometry.

Parameters
gThe geometry to calculate an envelope for
Returns
A newly allocated polygonal envelope. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSEnvelope_r()

GEOSGeometry* GEOSEnvelope_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSEnvelope

◆ GEOSEquals()

char GEOSEquals ( const GEOSGeometry g1,
const GEOSGeometry g2 
)

True if geometries cover the same space on the place.

Parameters
g1Input geometry
g2Input geometry
Returns
1 on true, 0 on false, 2 on exception
See also
geos::geom::Geometry::equals

◆ GEOSEquals_r()

char GEOSEquals_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2 
)
See also
GEOSEquals

◆ GEOSEqualsExact()

char GEOSEqualsExact ( const GEOSGeometry g1,
const GEOSGeometry g2,
double  tolerance 
)

Determine pointwise equivalence of two geometries, by checking if each vertex of g2 is within tolerance of the corresponding vertex in g1. Unlike GEOSEquals(), geometries that are topologically equivalent but have different representations (e.g., LINESTRING (0 0, 1 1) and MULTILINESTRING ((0 0, 1 1)) ) are not considered equivalent by GEOSEqualsExact().

Parameters
g1Input geometry
g2Input geometry
toleranceTolerance to determine vertex equality
Returns
1 on true, 0 on false, 2 on exception

◆ GEOSEqualsExact_r()

char GEOSEqualsExact_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2,
double  tolerance 
)
See also
GEOSEqualsExact

◆ GEOSFrechetDistance()

int GEOSFrechetDistance ( const GEOSGeometry g1,
const GEOSGeometry g2,
double *  dist 
)

Calculate the Frechet distance between two geometries, a similarity measure for linear features.

Parameters
[in]g1Input geometry
[in]g2Input geometry
[out]distPointer to be filled in with distance result
Returns
1 on success, 0 on exception.
See also
geos::algorithm::distance::DiscreteFrechetDistance

◆ GEOSFrechetDistance_r()

int GEOSFrechetDistance_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2,
double *  dist 
)

◆ GEOSFrechetDistanceDensify()

int GEOSFrechetDistanceDensify ( const GEOSGeometry g1,
const GEOSGeometry g2,
double  densifyFrac,
double *  dist 
)

Calculate the Frechet distance between two geometries, a similarity measure for linear features. For more precision, first densify the inputs.

Parameters
[in]g1Input geometry
[in]g2Input geometry
[in]densifyFracThe largest % of the overall line length that any given two-point segment should be
[out]distPointer to be filled in with distance result
Returns
1 on success, 0 on exception.
See also
geos::algorithm::distance::DiscreteFrechetDistance

◆ GEOSFrechetDistanceDensify_r()

int GEOSFrechetDistanceDensify_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2,
double  densifyFrac,
double *  dist 
)

◆ GEOSFree()

void GEOSFree ( void *  buffer)

Free strings and byte buffers returned by functions such as GEOSWKBWriter_write(), GEOSWKBWriter_writeHEX() and GEOSWKTWriter_write(), etc.

Parameters
bufferThe memory to free

◆ GEOSFree_r()

void GEOSFree_r ( GEOSContextHandle_t  handle,
void *  buffer 
)
See also
GEOSFree

◆ GEOSGeoJSONReader_create()

GEOSGeoJSONReader* GEOSGeoJSONReader_create ( void  )

Allocate a new GEOSGeoJSONReader.

Returns
a new reader. Caller must free with GEOSGeoJSONReader_destroy()

◆ GEOSGeoJSONReader_create_r()

GEOSGeoJSONReader* GEOSGeoJSONReader_create_r ( GEOSContextHandle_t  handle)

◆ GEOSGeoJSONReader_destroy()

void GEOSGeoJSONReader_destroy ( GEOSGeoJSONReader reader)

Free the memory associated with a GEOSGeoJSONReader.

Parameters
readerThe reader to destroy.

◆ GEOSGeoJSONReader_destroy_r()

void GEOSGeoJSONReader_destroy_r ( GEOSContextHandle_t  handle,
GEOSGeoJSONReader reader 
)

◆ GEOSGeoJSONReader_readGeometry()

GEOSGeometry* GEOSGeoJSONReader_readGeometry ( GEOSGeoJSONReader reader,
const char *  geojson 
)

Use a reader to parse a GeoJSON. A single geometry or feature is converted into a geometry. A featurecollection is converted into a geometrycollection. Feature properties are not read.

Parameters
readerA GeoJSON reader object, caller retains ownership
geojsonThe json string to parse, caller retains ownership
Returns
A GEOSGeometry, caller to free with GEOSGeom_destroy())

◆ GEOSGeoJSONReader_readGeometry_r()

GEOSGeometry* GEOSGeoJSONReader_readGeometry_r ( GEOSContextHandle_t  handle,
GEOSGeoJSONReader reader,
const char *  geojson 
)

◆ GEOSGeoJSONWriter_create()

GEOSGeoJSONWriter* GEOSGeoJSONWriter_create ( void  )

Allocate a new GEOSGeoJSONWriter.

Returns
a new writer. Caller must free with GEOSGeoJSONWriter_destroy()

◆ GEOSGeoJSONWriter_create_r()

GEOSGeoJSONWriter* GEOSGeoJSONWriter_create_r ( GEOSContextHandle_t  handle)

◆ GEOSGeoJSONWriter_destroy()

void GEOSGeoJSONWriter_destroy ( GEOSGeoJSONWriter writer)

Free the memory associated with a GEOSGeoJSONWriter.

Parameters
writerThe writer to destroy.

◆ GEOSGeoJSONWriter_destroy_r()

void GEOSGeoJSONWriter_destroy_r ( GEOSContextHandle_t  handle,
GEOSGeoJSONWriter writer 
)

◆ GEOSGeoJSONWriter_writeGeometry()

char* GEOSGeoJSONWriter_writeGeometry ( GEOSGeoJSONWriter writer,
const GEOSGeometry g,
int  indent 
)

Write out the GeoJSON representation of a geometry. Note that writing a GeoJSON Feature or FeatureCollection is unsupported through the GEOS C API.

Parameters
writerA GeoJSON reader object, caller retains ownership.
gThe geometry to convert, caller retains ownership.
indentThe indentation used. Use -1 for no formatting.
Returns
A char pointer, caller to free with GEOSFree())

◆ GEOSGeoJSONWriter_writeGeometry_r()

char* GEOSGeoJSONWriter_writeGeometry_r ( GEOSContextHandle_t  handle,
GEOSGeoJSONWriter writer,
const GEOSGeometry g,
int  indent 
)

◆ GEOSGeom_clone()

GEOSGeometry* GEOSGeom_clone ( const GEOSGeometry g)

Create a new copy of the input geometry.

Parameters
gThe geometry to copy
Returns
A newly allocated geometry. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSGeom_clone_r()

GEOSGeometry* GEOSGeom_clone_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSGeom_clone

◆ GEOSGeom_createCollection()

GEOSGeometry* GEOSGeom_createCollection ( int  type,
GEOSGeometry **  geoms,
unsigned int  ngeoms 
)

Create a geometry collection.

Parameters
typeThe geometry type, enumerated by GEOSGeomTypes
geomsA list of geometries that will form the collection
ngeomsThe number of geometries in the geoms list
Returns
A newly allocated geometry collection. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().
Note
The holes argument is an array of GEOSGeometry* objects. The caller retains ownership of the containing array, but the ownership of the pointed-to objects is transferred to the returned GEOSGeometry.

◆ GEOSGeom_createCollection_r()

GEOSGeometry* GEOSGeom_createCollection_r ( GEOSContextHandle_t  handle,
int  type,
GEOSGeometry **  geoms,
unsigned int  ngeoms 
)

◆ GEOSGeom_createEmptyCollection()

GEOSGeometry* GEOSGeom_createEmptyCollection ( int  type)

Create an empty geometry collection.

Parameters
typeThe geometry type, enumerated by GEOSGeomTypes
Returns
A newly allocated empty geometry collection. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSGeom_createEmptyCollection_r()

GEOSGeometry* GEOSGeom_createEmptyCollection_r ( GEOSContextHandle_t  handle,
int  type 
)

◆ GEOSGeom_createEmptyLineString()

GEOSGeometry* GEOSGeom_createEmptyLineString ( void  )

Creates an emptylinestring geometry.

Returns
A newly allocated linestring geometry. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSGeom_createEmptyLineString_r()

GEOSGeometry* GEOSGeom_createEmptyLineString_r ( GEOSContextHandle_t  handle)

◆ GEOSGeom_createEmptyPoint()

GEOSGeometry* GEOSGeom_createEmptyPoint ( void  )

Creates an empty point.

Returns
A newly allocated empty point geometry. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSGeom_createEmptyPoint_r()

GEOSGeometry* GEOSGeom_createEmptyPoint_r ( GEOSContextHandle_t  handle)

◆ GEOSGeom_createEmptyPolygon()

GEOSGeometry* GEOSGeom_createEmptyPolygon ( void  )

Creates an empty polygon geometry.

Returns
A newly allocated empty polygon geometry. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSGeom_createEmptyPolygon_r()

GEOSGeometry* GEOSGeom_createEmptyPolygon_r ( GEOSContextHandle_t  handle)

◆ GEOSGeom_createLinearRing()

GEOSGeometry* GEOSGeom_createLinearRing ( GEOSCoordSequence s)

Creates a linear ring geometry, for use in a polygon.

Parameters
sInput coordinate sequence, ownership passes to the geometry
Returns
A newly allocated linear ring geometry. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSGeom_createLinearRing_r()

GEOSGeometry* GEOSGeom_createLinearRing_r ( GEOSContextHandle_t  handle,
GEOSCoordSequence s 
)

◆ GEOSGeom_createLineString()

GEOSGeometry* GEOSGeom_createLineString ( GEOSCoordSequence s)

Creates a linestring geometry.

Parameters
sInput coordinate sequence, ownership passes to the geometry
Returns
A newly allocated linestring geometry. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSGeom_createLineString_r()

GEOSGeometry* GEOSGeom_createLineString_r ( GEOSContextHandle_t  handle,
GEOSCoordSequence s 
)

◆ GEOSGeom_createPoint()

GEOSGeometry* GEOSGeom_createPoint ( GEOSCoordSequence s)

Creates a point geometry from a coordinate sequence.

Parameters
sInput coordinate sequence, ownership passes to the geometry
Returns
A newly allocated point geometry. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSGeom_createPoint_r()

GEOSGeometry* GEOSGeom_createPoint_r ( GEOSContextHandle_t  handle,
GEOSCoordSequence s 
)

◆ GEOSGeom_createPointFromXY()

GEOSGeometry* GEOSGeom_createPointFromXY ( double  x,
double  y 
)

Creates a point geometry from a pair of coordinates.

Parameters
xThe X coordinate
yThe Y coordinate
Returns
A newly allocated point geometry. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSGeom_createPointFromXY_r()

GEOSGeometry* GEOSGeom_createPointFromXY_r ( GEOSContextHandle_t  handle,
double  x,
double  y 
)

◆ GEOSGeom_createPolygon()

GEOSGeometry* GEOSGeom_createPolygon ( GEOSGeometry shell,
GEOSGeometry **  holes,
unsigned int  nholes 
)

Creates a polygon geometry from line ring geometries.

Parameters
shellA linear ring that is the exterior ring of the polygon.
holesAn array of linear rings that are the holes.
nholesThe number of rings in the holes array.
Returns
A newly allocated geometry. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().
Note
The holes argument is an array of GEOSGeometry* objects. The caller retains ownership of the containing array, but the ownership of the pointed-to objects is transferred to the returned GEOSGeometry.

◆ GEOSGeom_createPolygon_r()

GEOSGeometry* GEOSGeom_createPolygon_r ( GEOSContextHandle_t  handle,
GEOSGeometry shell,
GEOSGeometry **  holes,
unsigned int  nholes 
)

◆ GEOSGeom_destroy()

void GEOSGeom_destroy ( GEOSGeometry g)

Release the memory associated with a geometry.

Parameters
gThe geometry to be destroyed.

◆ GEOSGeom_destroy_r()

void GEOSGeom_destroy_r ( GEOSContextHandle_t  handle,
GEOSGeometry g 
)

◆ GEOSGeom_extractUniquePoints()

GEOSGeometry* GEOSGeom_extractUniquePoints ( const GEOSGeometry g)

Return all distinct vertices of input geometry as a MultiPoint. Note that only 2 dimensions of the vertices are considered when testing for equality.

Parameters
gThe input geometry
Returns
The distinct points Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSGeom_extractUniquePoints_r()

GEOSGeometry* GEOSGeom_extractUniquePoints_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSGeom_getCoordinateDimension()

int GEOSGeom_getCoordinateDimension ( const GEOSGeometry g)

Return the cartesian dimension of the geometry.

  • 2 for XY data
  • 3 for XYZ data
Parameters
gInput geometry
Returns
The dimension

◆ GEOSGeom_getCoordinateDimension_r()

int GEOSGeom_getCoordinateDimension_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSGeom_getCoordSeq()

const GEOSCoordSequence* GEOSGeom_getCoordSeq ( const GEOSGeometry g)

Return the coordinate sequence underlying the given geometry (Must be a LineString, LinearRing or Point). Do not directly free the coordinate sequence, it is owned by the parent geometry.

Parameters
gInput geometry
Returns
Coordinate sequence or NULL on exception.

◆ GEOSGeom_getCoordSeq_r()

const GEOSCoordSequence* GEOSGeom_getCoordSeq_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSGeom_getDimensions()

int GEOSGeom_getDimensions ( const GEOSGeometry g)

Return the planar dimensionality of the geometry.

  • 0 for point, multipoint
  • 1 for linestring, multilinestring
  • 2 for polygon, multipolygon
See also
geos::geom::Dimension::DimensionType
Parameters
gInput geometry
Returns
The dimensionality

◆ GEOSGeom_getDimensions_r()

int GEOSGeom_getDimensions_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSGeom_getPrecision()

double GEOSGeom_getPrecision ( const GEOSGeometry g)

Read the currently set precision value from the geometry and returns the grid size if it is a fixed precision or 0.0 if it is full floating point precision.

Parameters
gInput geometry
Returns
The grid size, or -1 on exception

◆ GEOSGeom_getPrecision_r()

double GEOSGeom_getPrecision_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSGeom_getUserData()

void* GEOSGeom_getUserData ( const GEOSGeometry g)

Return the anonymous "user data" for this geometry. User data must be managed by the caller, and freed before the geometry is freed.

Parameters
gInput geometry
Returns
A void* to the user data, caller is responsible for casting to the appropriate type and freeing.

◆ GEOSGeom_getUserData_r()

void* GEOSGeom_getUserData_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSGeom_getXMax()

int GEOSGeom_getXMax ( const GEOSGeometry g,
double *  value 
)

Finds the maximum X value in the geometry.

Parameters
[in]gInput geometry
[out]valuePointer to place result
Returns
0 on exception

◆ GEOSGeom_getXMax_r()

int GEOSGeom_getXMax_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double *  value 
)

◆ GEOSGeom_getXMin()

int GEOSGeom_getXMin ( const GEOSGeometry g,
double *  value 
)

Finds the minimum X value in the geometry.

Parameters
[in]gInput geometry
[out]valuePointer to place result
Returns
0 on exception

◆ GEOSGeom_getXMin_r()

int GEOSGeom_getXMin_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double *  value 
)

◆ GEOSGeom_getYMax()

int GEOSGeom_getYMax ( const GEOSGeometry g,
double *  value 
)

Finds the maximum Y value in the geometry.

Parameters
[in]gInput geometry
[out]valuePointer to place result
Returns
0 on exception

◆ GEOSGeom_getYMax_r()

int GEOSGeom_getYMax_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double *  value 
)

◆ GEOSGeom_getYMin()

int GEOSGeom_getYMin ( const GEOSGeometry g,
double *  value 
)

Finds the minimum Y value in the geometry.

Parameters
[in]gInput geometry
[out]valuePointer to place result
Returns
0 on exception

◆ GEOSGeom_getYMin_r()

int GEOSGeom_getYMin_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double *  value 
)

◆ GEOSGeom_setPrecision()

GEOSGeometry* GEOSGeom_setPrecision ( const GEOSGeometry g,
double  gridSize,
int  flags 
)

Change the rounding precision on a geometry. This will affect the precision of the existing geometry as well as any geometries derived from this geometry using overlay functions. The output will be a valid GEOSGeometry.

Note that operations will always be performed in the precision 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

Parameters
gInput geometry
gridSizecell size of grid to round coordinates to, or 0 for FLOATING precision
flagsThe bitwise OR of members of the GEOSPrecisionRules enum
Returns
The precision reduced result. Caller must free with GEOSGeom_destroy() NULL on exception.

◆ GEOSGeom_setPrecision_r()

GEOSGeometry* GEOSGeom_setPrecision_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double  gridSize,
int  flags 
)

◆ GEOSGeom_setUserData()

void GEOSGeom_setUserData ( GEOSGeometry g,
void *  userData 
)

Set the anonymous "user data" for this geometry. Don't forget to free the user data before freeing the geometry.

Parameters
gInput geometry
userDataVoid pointer to user data

◆ GEOSGeom_setUserData_r()

void GEOSGeom_setUserData_r ( GEOSContextHandle_t  handle,
GEOSGeometry g,
void *  userData 
)

◆ GEOSGeomFromHEX_buf()

GEOSGeometry* GEOSGeomFromHEX_buf ( const unsigned char *  hex,
size_t  size 
)
Deprecated:
use GEOSWKBReader and GEOSWKBWriter_readHEX()

◆ GEOSGeomFromHEX_buf_r()

GEOSGeometry* GEOSGeomFromHEX_buf_r ( GEOSContextHandle_t  handle,
const unsigned char *  hex,
size_t  size 
)

◆ GEOSGeomFromWKB_buf()

GEOSGeometry* GEOSGeomFromWKB_buf ( const unsigned char *  wkb,
size_t  size 
)
Deprecated:
use GEOSWKBReader and GEOSWKBWriter_read()

◆ GEOSGeomFromWKB_buf_r()

GEOSGeometry* GEOSGeomFromWKB_buf_r ( GEOSContextHandle_t  handle,
const unsigned char *  wkb,
size_t  size 
)

◆ GEOSGeomFromWKT()

GEOSGeometry* GEOSGeomFromWKT ( const char *  wkt)

◆ GEOSGeomFromWKT_r()

GEOSGeometry* GEOSGeomFromWKT_r ( GEOSContextHandle_t  handle,
const char *  wkt 
)

◆ GEOSGeomGetEndPoint()

GEOSGeometry* GEOSGeomGetEndPoint ( const GEOSGeometry g)

Return the last point of a LineString

Parameters
gInput geometry, must be a LineString
Returns
A Point geometry. Caller must free with GEOSGeom_destroy() NULL on exception.

◆ GEOSGeomGetEndPoint_r()

GEOSGeometry* GEOSGeomGetEndPoint_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSGeomGetLength()

int GEOSGeomGetLength ( const GEOSGeometry g,
double *  length 
)

Calculate the length of a LineString. Only works for LineString inputs, returns exception otherwise.

Parameters
[in]gInput geometry
[out]lengthPointer to be filled in with length result
Returns
1 on success, 0 on exception.

◆ GEOSGeomGetLength_r()

int GEOSGeomGetLength_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double *  length 
)

◆ GEOSGeomGetNumPoints()

int GEOSGeomGetNumPoints ( const GEOSGeometry g)

Returns the number of points, for a LineString input, or an exception otherwise.

Parameters
gInput LineString geometry
Returns
Number of points, -1 on exception

◆ GEOSGeomGetNumPoints_r()

int GEOSGeomGetNumPoints_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSGeomGetPointN()

GEOSGeometry* GEOSGeomGetPointN ( const GEOSGeometry g,
int  n 
)

Return the N'th point of a LineString

Parameters
gInput geometry, must be a LineString
nIndex of desired point (zero based)
Returns
A Point geometry. Caller must free with GEOSGeom_destroy() NULL on exception.

◆ GEOSGeomGetPointN_r()

GEOSGeometry* GEOSGeomGetPointN_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
int  n 
)

◆ GEOSGeomGetStartPoint()

GEOSGeometry* GEOSGeomGetStartPoint ( const GEOSGeometry g)

Return the first point of a LineString

Parameters
gInput geometry, must be a LineString
Returns
A Point geometry. Caller must free with GEOSGeom_destroy() NULL on exception.

◆ GEOSGeomGetStartPoint_r()

GEOSGeometry* GEOSGeomGetStartPoint_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSGeomGetX()

int GEOSGeomGetX ( const GEOSGeometry g,
double *  x 
)

Returns the X coordinate, for a Point input, or an exception otherwise.

Parameters
[in]gInput Point geometry
[out]xPointer to hold return value
Returns
1 on success, 0 on exception

◆ GEOSGeomGetX_r()

int GEOSGeomGetX_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double *  x 
)
See also
GEOSGeomGetX

◆ GEOSGeomGetY()

int GEOSGeomGetY ( const GEOSGeometry g,
double *  y 
)

Returns the Y coordinate, for a Point input, or an exception otherwise.

Parameters
[in]gInput Point geometry
[out]yPointer to hold return value
Returns
1 on success, 0 on exception

◆ GEOSGeomGetY_r()

int GEOSGeomGetY_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double *  y 
)
See also
GEOSGeomGetY

◆ GEOSGeomGetZ()

int GEOSGeomGetZ ( const GEOSGeometry g,
double *  z 
)

Returns the Z coordinate, for a Point input, or an exception otherwise.

Parameters
[in]gInput Point geometry
[out]zPointer to hold return value
Returns
1 on success, 0 on exception

◆ GEOSGeomGetZ_r()

int GEOSGeomGetZ_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double *  z 
)
See also
GEOSGeomGetZ

◆ GEOSGeomToHEX_buf()

unsigned char* GEOSGeomToHEX_buf ( const GEOSGeometry g,
size_t *  size 
)

◆ GEOSGeomToHEX_buf_r()

unsigned char* GEOSGeomToHEX_buf_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
size_t *  size 
)

◆ GEOSGeomToWKB_buf()

unsigned char* GEOSGeomToWKB_buf ( const GEOSGeometry g,
size_t *  size 
)

◆ GEOSGeomToWKB_buf_r()

unsigned char* GEOSGeomToWKB_buf_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
size_t *  size 
)

◆ GEOSGeomToWKT()

char* GEOSGeomToWKT ( const GEOSGeometry g)

◆ GEOSGeomToWKT_r()

char* GEOSGeomToWKT_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSGeomType()

char* GEOSGeomType ( const GEOSGeometry g)

Returns the geometry type string for this geometry. eg: "GeometryCollection", "LineString"

Parameters
gInput geometry
Returns
A string with the geometry type. Caller must free with GEOSFree(). NULL on exception.

◆ GEOSGeomType_r()

char* GEOSGeomType_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSGeomType

◆ GEOSGeomTypeId()

int GEOSGeomTypeId ( const GEOSGeometry g)

Returns the GEOSGeomTypeId number for this geometry.

Parameters
gInput geometry
Returns
The geometry type number, or -1 on exception.

◆ GEOSGeomTypeId_r()

int GEOSGeomTypeId_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSGeomTypeId

◆ GEOSGetCentroid()

GEOSGeometry* GEOSGetCentroid ( const GEOSGeometry g)

Returns a point at the center of mass of the input.

Parameters
gThe input geometry
Returns
A point at the center of mass of the input Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::algorithm::Centroid

◆ GEOSGetCentroid_r()

GEOSGeometry* GEOSGetCentroid_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSGetCentroid

◆ GEOSGetExteriorRing()

const GEOSGeometry* GEOSGetExteriorRing ( const GEOSGeometry g)

Get the external ring of a Polygon.

Note
Returned object is a pointer to internal storage: it must NOT be destroyed directly.
Parameters
gInput Polygon geometry
Returns
LinearRing geometry. Owned by parent geometry, do not free. NULL on exception.

◆ GEOSGetExteriorRing_r()

const GEOSGeometry* GEOSGetExteriorRing_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSGetGeometryN()

const GEOSGeometry* GEOSGetGeometryN ( const GEOSGeometry g,
int  n 
)

Returns the specified sub-geometry of a collection. For a simple geometry, returns a pointer to the input. Returned object is a pointer to internal storage: it must NOT be destroyed directly.

Parameters
gInput geometry
nSub-geometry index, zero-base
Returns
A const GEOSGeometry, do not free! It will be freed when the parent is freed. Returns NULL on exception.
Note
Up to GEOS 3.2.0 the input geometry must be a Collection, in later versions it doesn't matter (getGeometryN(0) for a single will return the input).

◆ GEOSGetGeometryN_r()

const GEOSGeometry* GEOSGetGeometryN_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
int  n 
)

◆ GEOSGetInteriorRingN()

const GEOSGeometry* GEOSGetInteriorRingN ( const GEOSGeometry g,
int  n 
)

Returns the N'th ring for a Polygon input.

Note
Returned object is a pointer to internal storage: it must NOT be destroyed directly.
Parameters
gInput Polygon geometry
nIndex of the desired ring
Returns
LinearRing geometry. Owned by parent geometry, do not free. NULL on exception.

◆ GEOSGetInteriorRingN_r()

const GEOSGeometry* GEOSGetInteriorRingN_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
int  n 
)

◆ GEOSGetNumCoordinates()

int GEOSGetNumCoordinates ( const GEOSGeometry g)

Get the total number of points in a geometry, of any type.

Parameters
gInput geometry
Returns
Number of points in the geometry. -1 on exception.

◆ GEOSGetNumCoordinates_r()

int GEOSGetNumCoordinates_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSGetNumGeometries()

int GEOSGetNumGeometries ( const GEOSGeometry g)

Returns the number of sub-geometries immediately under a multi-geometry or collection or 1 for a simple geometry. For nested collections, remember to check if returned sub-geometries are themselves also collections.

Parameters
gInput geometry
Returns
Number of direct children in this collection
Warning
For GEOS < 3.2 this function may crash when fed simple geometries

◆ GEOSGetNumGeometries_r()

int GEOSGetNumGeometries_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSGetNumInteriorRings()

int GEOSGetNumInteriorRings ( const GEOSGeometry g)

Returns the number of interior rings, for a Polygon input, or an exception otherwise.

Parameters
gInput Polygon geometry
Returns
Number of interior rings, -1 on exception

◆ GEOSGetNumInteriorRings_r()

int GEOSGetNumInteriorRings_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSGetSRID()

int GEOSGetSRID ( const GEOSGeometry g)

Returns the "spatial reference id" (SRID) for this geometry.

Parameters
gInput geometry
Returns
SRID number or 0 if unknown / not set.

◆ GEOSGetSRID_r()

int GEOSGetSRID_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSGetSRID

◆ GEOSHasZ()

char GEOSHasZ ( const GEOSGeometry g)

Tests whether the input geometry has z coordinates.

Parameters
gThe geometry to test
Returns
1 on true, 0 on false, 2 on exception

◆ GEOSHasZ_r()

char GEOSHasZ_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSHasZ

◆ GEOSHausdorffDistance()

int GEOSHausdorffDistance ( const GEOSGeometry g1,
const GEOSGeometry g2,
double *  dist 
)

Calculate the Hausdorff distance between two geometries. Hausdorff distance is the largest distance between two geometries.

Parameters
[in]g1Input geometry
[in]g2Input geometry
[out]distPointer to be filled in with distance result
Returns
1 on success, 0 on exception.
See also
geos::algorithm::distance::DiscreteHausdorffDistance

◆ GEOSHausdorffDistance_r()

int GEOSHausdorffDistance_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2,
double *  dist 
)

◆ GEOSHausdorffDistanceDensify()

int GEOSHausdorffDistanceDensify ( const GEOSGeometry g1,
const GEOSGeometry g2,
double  densifyFrac,
double *  dist 
)

Calculate a more precise Hausdorff distance between two geometries, by densifying the inputs before computation. Hausdorff distance is the largest distance between two geometries.

Parameters
[in]g1Input geometry
[in]g2Input geometry
[in]densifyFracThe largest % of the overall line length that any given two-point segment should be
[out]distPointer to be filled in with distance result
Returns
1 on success, 0 on exception.
See also
geos::algorithm::distance::DiscreteHausdorffDistance

◆ GEOSHausdorffDistanceDensify_r()

int GEOSHausdorffDistanceDensify_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2,
double  densifyFrac,
double *  dist 
)

◆ GEOSInterpolate()

GEOSGeometry* GEOSInterpolate ( const GEOSGeometry line,
double  d 
)

Measuring from start of line, return point that is distance the start. Line parameter must be a LineString.

Parameters
linelinear target of projection
ddistance from start of line to created point
Returns
The point GEOSGeometry that is distance from the start of line. Caller takes ownership of returned geometry.

◆ GEOSInterpolate_r()

GEOSGeometry* GEOSInterpolate_r ( GEOSContextHandle_t  handle,
const GEOSGeometry line,
double  d 
)
See also
GEOSInterpolate

◆ GEOSInterpolateNormalized()

GEOSGeometry* GEOSInterpolateNormalized ( const GEOSGeometry line,
double  proportion 
)

Measuring from start of line, return point that is a proportion the start. Line parameter must be a LineString.

Parameters
linelinear target of projection
proportionThe proportion from the start of line to created point
Returns
The point GEOSGeometry that is distance from the start of line. Caller takes ownership of returned geometry.

◆ GEOSInterpolateNormalized_r()

GEOSGeometry* GEOSInterpolateNormalized_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double  d 
)

◆ GEOSIntersection()

GEOSGeometry* GEOSIntersection ( const GEOSGeometry g1,
const GEOSGeometry g2 
)

Returns the intersection of two geometries: the set of points that fall within both geometries.

Parameters
g1one of the geometries
g2the other geometry
Returns
A newly allocated geometry of the intersection. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::overlayng::OverlayNG

◆ GEOSIntersection_r()

GEOSGeometry* GEOSIntersection_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2 
)

◆ GEOSIntersectionPrec()

GEOSGeometry* GEOSIntersectionPrec ( const GEOSGeometry g1,
const GEOSGeometry g2,
double  gridSize 
)

Returns the intersection of two geometries: the set of points that fall within both geometries. All the vertices of the output geometry must fall on the grid defined by the gridSize, and the output will be a valid geometry.

Parameters
g1one of the geometries
g2the other geometry
gridSizethe cell size of the precision grid
Returns
A newly allocated geometry of the intersection. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::overlayng::OverlayNG

◆ GEOSIntersectionPrec_r()

GEOSGeometry* GEOSIntersectionPrec_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2,
double  gridSize 
)

◆ GEOSIntersects()

char GEOSIntersects ( const GEOSGeometry g1,
const GEOSGeometry g2 
)

True if geometries are not disjoint.

Parameters
g1Input geometry
g2Input geometry
Returns
1 on true, 0 on false, 2 on exception
See also
geos::geom::Geometry::intersects

◆ GEOSIntersects_r()

char GEOSIntersects_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2 
)
See also
GEOSIntersects

◆ GEOSisClosed()

char GEOSisClosed ( const GEOSGeometry g)

Tests whether the input geometry is closed. A closed geometry is a linestring or multilinestring with the start and end points being the same.

Parameters
gThe geometry to test
Returns
1 on true, 0 on false, 2 on exception

◆ GEOSisClosed_r()

char GEOSisClosed_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSisClosed

◆ GEOSisEmpty()

char GEOSisEmpty ( const GEOSGeometry g)

Tests whether the input geometry is empty. If the geometry or any component is non-empty, the geometry is non-empty. An empty geometry has no boundary or interior.

Parameters
gThe geometry to test
Returns
1 on true, 0 on false, 2 on exception

◆ GEOSisEmpty_r()

char GEOSisEmpty_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSisEmpty

◆ GEOSisRing()

char GEOSisRing ( const GEOSGeometry g)

Tests whether the input geometry is a ring. Rings are linestrings, without self-intersections, with start and end point being identical.

Parameters
gThe geometry to test
Returns
1 on true, 0 on false, 2 on exception

◆ GEOSisRing_r()

char GEOSisRing_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSisRing

◆ GEOSisSimple()

char GEOSisSimple ( const GEOSGeometry g)

Tests whether the input geometry is "simple". Mostly relevant for linestrings. A "simple" linestring has no self-intersections.

Parameters
gThe geometry to test
Returns
1 on true, 0 on false, 2 on exception

◆ GEOSisSimple_r()

char GEOSisSimple_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSisSimple

◆ GEOSisValid()

char GEOSisValid ( const GEOSGeometry g)

Check the validity of the provided geometry.

  • All points are valid.
  • All non-zero-length linestrings are valid.
  • Polygon rings must be non-self-intersecting, and interior rings contained within exterior rings.
  • Multi-polygon components may not touch or overlap.
Parameters
gThe geometry to test
Returns
1 on true, 0 on false, 2 on exception
See also
geos::operation::valid::isValidOp

◆ GEOSisValid_r()

char GEOSisValid_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSisValid

◆ GEOSisValidDetail()

char GEOSisValidDetail ( const GEOSGeometry g,
int  flags,
char **  reason,
GEOSGeometry **  location 
)

In one step, calculate and return the validity, the human readable validity reason and a point at which validity rules are broken. Caller has the responsibility to destroy 'reason' with GEOSFree() and 'location' with GEOSGeom_destroy()

Parameters
gThe geometry to test
flagsA value from the GEOSValidFlags enum
reasonA pointer in which the reason string will be places
locationA pointer in which the location GEOSGeometry will be placed
Returns
1 when valid, 0 when invalid, 2 on exception

◆ GEOSisValidDetail_r()

char GEOSisValidDetail_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
int  flags,
char **  reason,
GEOSGeometry **  location 
)

◆ GEOSisValidReason()

char* GEOSisValidReason ( const GEOSGeometry g)

Return the human readable reason a geometry is invalid, "Valid Geometry" string otherwise, or NULL on exception.

Parameters
gThe geometry to test
Returns
A string with the reason, NULL on exception. Caller must GEOSFree() their result.

◆ GEOSisValidReason_r()

char* GEOSisValidReason_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSLargestEmptyCircle()

GEOSGeometry* GEOSLargestEmptyCircle ( const GEOSGeometry obstacles,
const GEOSGeometry boundary,
double  tolerance 
)

Constructs the "largest empty circle" (LEC) for a set of obstacle geometries, up to a specified tolerance. The obstacles are point and line geometries. Polygonal obstacles willl be treated as linear features. The LEC is the largest circle which has its center inside the boundary, and whose interior does not intersect with any obstacle. If no boundary is provided, the convex hull of the obstacles is used as the boundary. The LEC center is the point in the interior of the boundary which has the farthest distance from the obstacles (up to tolerance). The LEC is determined by the center point and a point lying on an obstacle indicating the circle radius. The implementation uses a successive-approximation technique over a grid of square cells covering the obstacles and boundary. The grid is refined using a branch-and-bound algorithm. Point containment and distance are computed in a performant way by using spatial indexes. Returns a two-point linestring, with the start point at the center of the inscribed circle and the end on the boundary of the inscribed circle.

Parameters
obstaclesThe geometries that the LEC must fit within without covering
boundaryThe area within which the LEC must reside
toleranceStop the algorithm when the search area is smaller than this tolerance
Returns
A newly allocated geometry of the LEC. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::algorithm::construct::LargestEmptyCircle

◆ GEOSLargestEmptyCircle_r()

GEOSGeometry* GEOSLargestEmptyCircle_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
const GEOSGeometry boundary,
double  tolerance 
)

◆ GEOSLength()

int GEOSLength ( const GEOSGeometry g,
double *  length 
)

Calculate the length of a geometry.

Parameters
[in]gInput geometry
[out]lengthPointer to be filled in with length result
Returns
1 on success, 0 on exception.

◆ GEOSLength_r()

int GEOSLength_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double *  length 
)
See also
GEOSLength

◆ GEOSLineMerge()

GEOSGeometry* GEOSLineMerge ( const GEOSGeometry g)

Sews together a set of fully noded LineStrings removing any cardinality 2 nodes in the linework.

Parameters
gThe input linework
Returns
The merged linework Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::linemerge::LineMerger

◆ GEOSLineMerge_r()

GEOSGeometry* GEOSLineMerge_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSLineMerge

◆ GEOSMakeValid()

GEOSGeometry* GEOSMakeValid ( const GEOSGeometry g)

Repair an invalid geometry, returning a valid output.

Parameters
gThe geometry to repair
Returns
The repaired geometry. Caller must free with GEOSGeom_destroy().

◆ GEOSMakeValid_r()

GEOSGeometry* GEOSMakeValid_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSMakeValid

◆ GEOSMakeValidParams_create()

GEOSMakeValidParams* GEOSMakeValidParams_create ( void  )

Create a GEOSMakeValidParams to hold the desired parameters to control the algorithm and behavior of the validation process.

Returns
a parameter object
See also
GEOSMakeValidWithParams

◆ GEOSMakeValidParams_create_r()

GEOSMakeValidParams* GEOSMakeValidParams_create_r ( GEOSContextHandle_t  extHandle)

◆ GEOSMakeValidParams_destroy()

void GEOSMakeValidParams_destroy ( GEOSMakeValidParams parms)

Destroy a GEOSMakeValidParams.

Parameters
parmsthe object to destroy
See also
GEOSMakeValidWithParams

◆ GEOSMakeValidParams_destroy_r()

void GEOSMakeValidParams_destroy_r ( GEOSContextHandle_t  handle,
GEOSMakeValidParams parms 
)

◆ GEOSMakeValidParams_setKeepCollapsed()

int GEOSMakeValidParams_setKeepCollapsed ( GEOSMakeValidParams p,
int  keepCollapsed 
)

When this parameter is not set to 0, the GEOS_MAKE_VALID_STRUCTURE method will drop any component that has collapsed into a lower dimensionality. For example, a ring collapsing to a line, or a line collapsing to a point.

Returns
0 on exception, 1 on success.
See also
GEOSMakeValidWithParams

◆ GEOSMakeValidParams_setKeepCollapsed_r()

int GEOSMakeValidParams_setKeepCollapsed_r ( GEOSContextHandle_t  handle,
GEOSMakeValidParams p,
int  style 
)

◆ GEOSMakeValidParams_setMethod()

int GEOSMakeValidParams_setMethod ( GEOSMakeValidParams p,
enum GEOSMakeValidMethods  method 
)

Set the GEOSMakeValidMethods to use in making the geometry valid.

Returns
0 on exception, 1 on success.
See also
GEOSMakeValidWithParams

◆ GEOSMakeValidParams_setMethod_r()

int GEOSMakeValidParams_setMethod_r ( GEOSContextHandle_t  handle,
GEOSMakeValidParams p,
enum GEOSMakeValidMethods  method 
)

◆ GEOSMakeValidWithParams()

GEOSGeometry* GEOSMakeValidWithParams ( const GEOSGeometry g,
const GEOSMakeValidParams makeValidParams 
)

Repair an invalid geometry, returning a valid output, using the indicated GEOSMakeValidMethods algorithm and options.

Parameters
gis the geometry to test.
makeValidParamsis a GEOSMakeValidParams with the desired parameters set on it.
Returns
A repaired geometry. Caller must free with GEOSGeom_destroy().
See also
GEOSMakeValidParams_create
GEOSMakeValidParams_destroy
GEOSMakeValidParams_setMethod
GEOSMakeValidParams_setKeepCollapsed

◆ GEOSMakeValidWithParams_r()

GEOSGeometry* GEOSMakeValidWithParams_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
const GEOSMakeValidParams makeValidParams 
)

◆ GEOSMaximumInscribedCircle()

GEOSGeometry* GEOSMaximumInscribedCircle ( const GEOSGeometry g,
double  tolerance 
)

Constructs the "maximum inscribed circle" (MIC) for a polygonal geometry, up to a specified tolerance. The MIC is determined by a point in the interior of the area which has the farthest distance from the area boundary, along with a boundary point at that distance. In the context of geography the center of the MIC is known as the "pole of inaccessibility". A cartographic use case is to determine a suitable point to place a map label within a polygon. The radius length of the MIC is a measure of how "narrow" a polygon is. It is the distance at which the negative buffer becomes empty. The class supports polygons with holes and multipolygons. The implementation uses a successive-approximation technique over a grid of square cells covering the area geometry. The grid is refined using a branch-and-bound algorithm. Point containment and distance are computed in a performant way by using spatial indexes. Returns a two-point linestring, with one point at the center of the inscribed circle and the other on the boundary of the inscribed circle.

Parameters
gInput geometry
toleranceStop the algorithm when the search area is smaller than this tolerance
Returns
A newly allocated geometry of the MIC. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::algorithm::construct::MaximumInscribedCircle

◆ GEOSMaximumInscribedCircle_r()

GEOSGeometry* GEOSMaximumInscribedCircle_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double  tolerance 
)

◆ GEOSMinimumBoundingCircle()

GEOSGeometry* GEOSMinimumBoundingCircle ( const GEOSGeometry g,
double *  radius,
GEOSGeometry **  center 
)

Returns a geometry which represents the "minimum bounding circle", the smallest circle that contains the input.

Parameters
[in]gThe input geometry
[out]radiusPointer will be filled with output radius.
[out]centerPointer will be filled with output circle center. Caller must free.
Returns
The circle geometry or NULL on exception Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::algorithm::MinimumBoundingCircle::getCircle

◆ GEOSMinimumBoundingCircle_r()

GEOSGeometry* GEOSMinimumBoundingCircle_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double *  radius,
GEOSGeometry **  center 
)

◆ GEOSMinimumClearance()

int GEOSMinimumClearance ( const GEOSGeometry g,
double *  d 
)

Computes the minimum clearance of a geometry. The minimum clearance is the smallest amount by which a vertex could be move to produce an invalid polygon, a non-simple linestring, or a multipoint with repeated points. If a geometry has a minimum clearance of 'eps', it can be said that:

  • No two distinct vertices in the geometry are separated by less than 'eps'
  • No vertex is closer than 'eps' to a line segment of which it is not an endpoint.

If the minimum clearance cannot be defined for a geometry (such as with a single point, or a multipoint whose points are identical, a value of Infinity will be calculated.

Parameters
gthe input geometry
da double to which the result can be stored
Returns
0 if no exception occurred. 2 if an exception occurred.
See also
geos::precision::MinimumClearance

◆ GEOSMinimumClearance_r()

int GEOSMinimumClearance_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double *  distance 
)

◆ GEOSMinimumClearanceLine()

GEOSGeometry* GEOSMinimumClearanceLine ( const GEOSGeometry g)

Returns a LineString whose endpoints define the minimum clearance of a geometry. If the geometry has no minimum clearance, an empty LineString will be returned.

Parameters
gthe input geometry
Returns
a linestring geometry, or NULL if an exception occurred. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::precision::MinimumClearance

◆ GEOSMinimumClearanceLine_r()

GEOSGeometry* GEOSMinimumClearanceLine_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSMinimumRotatedRectangle()

GEOSGeometry* GEOSMinimumRotatedRectangle ( const GEOSGeometry g)

Returns the minimum rotated rectangular POLYGON which encloses the input geometry. The rectangle has width equal to the minimum diameter, and a longer length. If the convex hill of the input is degenerate (a line or point) a linestring or point is returned. The minimum rotated rectangle can be used as an extremely generalized representation for the given geometry.

Parameters
gThe input geometry
Returns
A newly allocated geometry of the rotated envelope. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSMinimumRotatedRectangle_r()

GEOSGeometry* GEOSMinimumRotatedRectangle_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSMinimumWidth()

GEOSGeometry* GEOSMinimumWidth ( const GEOSGeometry g)

Returns a linestring geometry which represents the minimum diameter of the geometry. The minimum diameter is defined to be the width of the smallest band that contains the geometry, where a band is a strip of the plane defined by two parallel lines. This can be thought of as the smallest hole that the geometry can be moved through, with a single rotation.

Parameters
gThe input geometry
Returns
A newly allocated geometry of the LEC. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::algorithm::MinimumDiameter

◆ GEOSMinimumWidth_r()

GEOSGeometry* GEOSMinimumWidth_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSNearestPoints()

GEOSCoordSequence* GEOSNearestPoints ( const GEOSGeometry g1,
const GEOSGeometry g2 
)

The closest points of the two geometries. The first point comes from g1 geometry and the second point comes from g2.

Parameters
[in]g1Input geometry
[in]g2Input geometry
Returns
A coordinate sequence with the two points, or NULL on exception. Caller must free with GEOSCoordSeq_destroy().

◆ GEOSNearestPoints_r()

GEOSCoordSequence* GEOSNearestPoints_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2 
)

◆ GEOSNode()

GEOSGeometry* GEOSNode ( const GEOSGeometry g)

For linear inputs, returns a new geometry in which no lines cross each other, and all touching occurs at end points.

Parameters
gThe input geometry
Returns
The noded geometry or NULL on exception Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::noding::GeometryNoder::node

◆ GEOSNode_r()

GEOSGeometry* GEOSNode_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSNode

◆ GEOSNormalize()

int GEOSNormalize ( GEOSGeometry g)

Organize the sub-geometries, rings, and coordinate order of geometries, so that geometries that represent the same object can be easily compared. Starts rings from the same location, orients them in the same way, sorts geometry sub-components in the same way. Use before calling GEOSEqualsExact() to avoid false "not equal" results.

Parameters
gInput geometry
Returns
0 on success or -1 on exception

◆ GEOSNormalize_r()

int GEOSNormalize_r ( GEOSContextHandle_t  handle,
GEOSGeometry g 
)
See also
GEOSNormalize

◆ GEOSOffsetCurve()

GEOSGeometry* GEOSOffsetCurve ( const GEOSGeometry g,
double  width,
int  quadsegs,
int  joinStyle,
double  mitreLimit 
)

Generates offset curve for linear geometry. Only LineStrings accepted as input.

Parameters
gThe linear geometry to offset from
widthDistance to offset from the curve. Negative for a right-side offset. Positive for a left-side offset.
quadsegsNumber of segments per quadrant
joinStyleSee GEOSBufJoinStyles
mitreLimitSee GEOSBufferParams_setMitreLimit
Returns
The offset geometry. Returns NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::buffer::BufferBuilder::bufferLineSingleSided

◆ GEOSOffsetCurve_r()

GEOSGeometry* GEOSOffsetCurve_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double  width,
int  quadsegs,
int  joinStyle,
double  mitreLimit 
)
See also
GEOSOffsetCurve

◆ GEOSOrientationIndex()

int GEOSOrientationIndex ( double  Ax,
double  Ay,
double  Bx,
double  By,
double  Px,
double  Py 
)

For the points formed by the six input ordinates, walking from A to B and then to P.

Parameters
AxX coordinate of A
AyY coordinate of A
BxX coordinate of B
ByY coordinate of B
PxX coordinate of P
PyY coordinate of P
Returns
-1 if reaching P takes a counter-clockwise (left) turn, 1 if reaching P takes a clockwise (right) turn, 0 if P is collinear with A-B

◆ GEOSOrientationIndex_r()

int GEOSOrientationIndex_r ( GEOSContextHandle_t  handle,
double  Ax,
double  Ay,
double  Bx,
double  By,
double  Px,
double  Py 
)

◆ GEOSOverlaps()

char GEOSOverlaps ( const GEOSGeometry g1,
const GEOSGeometry g2 
)

True if geometries share interiors but are neither within nor contained.

Parameters
g1Input geometry
g2Input geometry
Returns
1 on true, 0 on false, 2 on exception
See also
geos::geom::Geometry::overlaps

◆ GEOSOverlaps_r()

char GEOSOverlaps_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2 
)
See also
GEOSOverlaps

◆ GEOSPointOnSurface()

GEOSGeometry* GEOSPointOnSurface ( const GEOSGeometry g)

Returns a point that is inside the boundary of a polygonal geometry.

Parameters
gThe input geometry
Returns
A point that is inside the input Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::algorithm::InteriorPointArea

◆ GEOSPointOnSurface_r()

GEOSGeometry* GEOSPointOnSurface_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)

◆ GEOSPolygonize()

GEOSGeometry* GEOSPolygonize ( const GEOSGeometry *const  geoms[],
unsigned int  ngeoms 
)

Polygonizes a set of Geometries which contain linework that represents the edges of a planar graph.

All types of Geometry are accepted as input; the constituent linework is extracted as the edges to be polygonized.

The edges must be correctly noded; that is, they must only meet at their endpoints. Polygonization will accept incorrectly noded input but will not form polygons from non-noded edges, and reports them as errors.

The Polygonizer reports the following kinds of errors:

  • Dangles - edges which have one or both ends which are not incident on another edge endpoint
  • Cut Edges - edges which are connected at both ends but which do not form part of a polygon
  • Invalid Ring Lines - edges which form rings which are invalid (e.g. the component lines contain a self-intersection)

Errors are reported to output parameters "cuts", "dangles" and "invalid" (if not-null). Formed polygons are returned as a collection. NULL is returned on exception. All returned geometries must be destroyed by caller.

The GEOSPolygonize_valid() variant allows extracting only polygons which form a valid polygonal result. The set of extracted polygons is guaranteed to be edge-disjoint. This is useful when it is known that the input lines form a valid polygonal geometry (which may include holes or nested polygons).

Parameters
geomsArray of linear geometries to polygons. Caller retains ownersihp of both array container and objects.
ngeomsSize of the geoms array.
Returns
The polygonal output geometry. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::polygonize::Polygonizer

◆ GEOSPolygonize_full()

GEOSGeometry* GEOSPolygonize_full ( const GEOSGeometry input,
GEOSGeometry **  cuts,
GEOSGeometry **  dangles,
GEOSGeometry **  invalid 
)

Perform the polygonization as GEOSPolygonize() and return the polygonal result as well as all extra ouputs.

Parameters
[in]inputA single geometry with all the input lines to polygonize.
[out]cutsPointer to hold "cut edges", connected on both ends but not part of output. Caller must free.
[out]danglesPointer to hold "dangles", connected one end but not part of output. Caller must free.
[out]invalidPointer to hold invalid outputs, polygons formed but not valid. Caller must free.
Returns
The polygonal valid output Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::polygonize::Polygonizer

◆ GEOSPolygonize_full_r()

GEOSGeometry* GEOSPolygonize_full_r ( GEOSContextHandle_t  handle,
const GEOSGeometry input,
GEOSGeometry **  cuts,
GEOSGeometry **  dangles,
GEOSGeometry **  invalidRings 
)

◆ GEOSPolygonize_r()

GEOSGeometry* GEOSPolygonize_r ( GEOSContextHandle_t  handle,
const GEOSGeometry *const  geoms[],
unsigned int  ngeoms 
)
See also
GEOSPolygonize

◆ GEOSPolygonize_valid()

GEOSGeometry* GEOSPolygonize_valid ( const GEOSGeometry *const  geoms[],
unsigned int  ngeoms 
)

Same polygonizing behavior as GEOSPolygonize(), but only returning results that are valid.

Parameters
geomsArray of linear geometries to polygons. Caller retains ownersihp of both array container and objects.
ngeomsSize of the geoms array.
Returns
The polygonal output geometry. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::polygonize::Polygonizer

◆ GEOSPolygonize_valid_r()

GEOSGeometry* GEOSPolygonize_valid_r ( GEOSContextHandle_t  handle,
const GEOSGeometry *const  geoms[],
unsigned int  ngems 
)

◆ GEOSPolygonizer_getCutEdges()

GEOSGeometry* GEOSPolygonizer_getCutEdges ( const GEOSGeometry *const  geoms[],
unsigned int  ngeoms 
)

Perform the polygonization as GEOSPolygonize() but return only the "cut edges", the linear features that are connected at both ends, do not participate in the final polygon.

Parameters
geomsArray of linear geometries to polygons. Caller retains ownersihp of both array container and objects.
ngeomsSize of the geoms array.
Returns
The "cut edges" Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::polygonize::Polygonizer

◆ GEOSPolygonizer_getCutEdges_r()

GEOSGeometry* GEOSPolygonizer_getCutEdges_r ( GEOSContextHandle_t  handle,
const GEOSGeometry *const  geoms[],
unsigned int  ngeoms 
)

◆ GEOSPrepare()

const GEOSPreparedGeometry* GEOSPrepare ( const GEOSGeometry g)

A GEOSPreparedGeometry is a wrapper around GEOSGeometry that adds in a spatial index on the edges of the geometry. This internal index allows spatial predicates to evaluate much faster, so for cases in which the same base geometry will be used over and over again for predicate tests, wrapping it in a GEOSPreparedGeometry is a best practice.

The caller retains ownership of the base geometry, and after processing is complete, must destroy both the prepared and the base geometry. (Ideally, destroy the prepared geometry first, as it has an internal reference to the base geometry.)

Parameters
gThe base geometry to wrap in a prepared geometry.
Returns
A prepared geometry. Caller is responsible for freeing with GEOSPreparedGeom_destroy()

◆ GEOSPrepare_r()

const GEOSPreparedGeometry* GEOSPrepare_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSPrepare

◆ GEOSPreparedContains()

char GEOSPreparedContains ( const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

Using a GEOSPreparedGeometry do a high performance calculation of whether the provided geometry is contained.

Parameters
pg1The prepared geometry
g2The geometry to test
Returns
1 on true, 0 on false, 2 on exception
See also
GEOSContains

◆ GEOSPreparedContains_r()

char GEOSPreparedContains_r ( GEOSContextHandle_t  handle,
const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

◆ GEOSPreparedContainsProperly()

char GEOSPreparedContainsProperly ( const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

Using a GEOSPreparedGeometry do a high performance calculation of whether the provided geometry is contained properly.

Parameters
pg1The prepared geometry
g2The geometry to test
Returns
1 on true, 0 on false, 2 on exception
See also
GEOSContainsProperly

◆ GEOSPreparedContainsProperly_r()

char GEOSPreparedContainsProperly_r ( GEOSContextHandle_t  handle,
const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

◆ GEOSPreparedCoveredBy()

char GEOSPreparedCoveredBy ( const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

Using a GEOSPreparedGeometry do a high performance calculation of whether the provided geometry is covered by.

Parameters
pg1The prepared geometry
g2The geometry to test
Returns
1 on true, 0 on false, 2 on exception
See also
GEOSCoveredBy

◆ GEOSPreparedCoveredBy_r()

char GEOSPreparedCoveredBy_r ( GEOSContextHandle_t  handle,
const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

◆ GEOSPreparedCovers()

char GEOSPreparedCovers ( const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

Using a GEOSPreparedGeometry do a high performance calculation of whether the provided geometry covers.

Parameters
pg1The prepared geometry
g2The geometry to test
Returns
1 on true, 0 on false, 2 on exception
See also
GEOSCovers

◆ GEOSPreparedCovers_r()

char GEOSPreparedCovers_r ( GEOSContextHandle_t  handle,
const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

◆ GEOSPreparedCrosses()

char GEOSPreparedCrosses ( const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

Using a GEOSPreparedGeometry do a high performance calculation of whether the provided geometry crosses.

Parameters
pg1The prepared geometry
g2The geometry to test
Returns
1 on true, 0 on false, 2 on exception
See also
GEOSCrosses

◆ GEOSPreparedCrosses_r()

char GEOSPreparedCrosses_r ( GEOSContextHandle_t  handle,
const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

◆ GEOSPreparedDisjoint()

char GEOSPreparedDisjoint ( const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

Using a GEOSPreparedDisjoint do a high performance calculation of whether the provided geometry is disjoint.

Parameters
pg1The prepared geometry
g2The geometry to test
Returns
1 on true, 0 on false, 2 on exception
See also
GEOSDisjoin

◆ GEOSPreparedDisjoint_r()

char GEOSPreparedDisjoint_r ( GEOSContextHandle_t  handle,
const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

◆ GEOSPreparedDistance()

int GEOSPreparedDistance ( const GEOSPreparedGeometry pg1,
const GEOSGeometry g2,
double *  dist 
)

Using a GEOSPreparedDistance do a high performance calculation to find the distance points between the prepared and provided geometry. Useful for situations where one geometry is large and static and needs to be tested against a large number of other geometries.

Parameters
[in]pg1The prepared geometry
[in]g2The geometry to test
[out]distPointer to store the result in
Returns
1 on success

◆ GEOSPreparedDistance_r()

int GEOSPreparedDistance_r ( GEOSContextHandle_t  handle,
const GEOSPreparedGeometry pg1,
const GEOSGeometry g2,
double *  dist 
)

◆ GEOSPreparedDistanceWithin()

char GEOSPreparedDistanceWithin ( const GEOSPreparedGeometry pg1,
const GEOSGeometry g2,
double  dist 
)

Using a GEOSPreparedDistanceWithin do a high performance calculation to find whether the prepared and provided geometry are within the given max distance. Useful for situations where one geometry is large and static and needs to be tested against a large number of other geometries.

Parameters
pg1The prepared geometry
g2The geometry to test
distThe max distance
Returns
1 on success

◆ GEOSPreparedDistanceWithin_r()

char GEOSPreparedDistanceWithin_r ( GEOSContextHandle_t  handle,
const GEOSPreparedGeometry pg1,
const GEOSGeometry g2,
double  dist 
)

◆ GEOSPreparedGeom_destroy()

void GEOSPreparedGeom_destroy ( const GEOSPreparedGeometry g)

Free the memory associated with a GEOSPreparedGeometry. Caller must separately free the base GEOSGeometry used to create the prepared geometry.

Parameters
gPrepared geometry to destroy.

◆ GEOSPreparedGeom_destroy_r()

void GEOSPreparedGeom_destroy_r ( GEOSContextHandle_t  handle,
const GEOSPreparedGeometry g 
)

◆ GEOSPreparedIntersects()

char GEOSPreparedIntersects ( const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

Using a GEOSPreparedDisjoint do a high performance calculation of whether the provided geometry is disjoint.

Parameters
pg1The prepared geometry
g2The geometry to test
Returns
1 on true, 0 on false, 2 on exception
See also
GEOSDisjoin

◆ GEOSPreparedIntersects_r()

char GEOSPreparedIntersects_r ( GEOSContextHandle_t  handle,
const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

◆ GEOSPreparedNearestPoints()

GEOSCoordSequence* GEOSPreparedNearestPoints ( const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

Using a GEOSPreparedDisjoint do a high performance calculation to find the nearest points between the prepared and provided geometry.

Parameters
pg1The prepared geometry
g2The geometry to test
Returns
A coordinate sequence containing the nearest points, or NULL on exception. The first point in the sequence is from the prepared geometry, and the seconds is from the other argument.

◆ GEOSPreparedNearestPoints_r()

GEOSCoordSequence* GEOSPreparedNearestPoints_r ( GEOSContextHandle_t  handle,
const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

◆ GEOSPreparedOverlaps()

char GEOSPreparedOverlaps ( const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

Using a GEOSPreparedDisjoint do a high performance calculation of whether the provided geometry overlaps.

Parameters
pg1The prepared geometry
g2The geometry to test
Returns
1 on true, 0 on false, 2 on exception
See also
GEOSOverlaps

◆ GEOSPreparedOverlaps_r()

char GEOSPreparedOverlaps_r ( GEOSContextHandle_t  handle,
const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

◆ GEOSPreparedTouches()

char GEOSPreparedTouches ( const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

Using a GEOSPreparedDisjoint do a high performance calculation of whether the provided geometry touches.

Parameters
pg1The prepared geometry
g2The geometry to test
Returns
1 on true, 0 on false, 2 on exception
See also
GEOSTouches

◆ GEOSPreparedTouches_r()

char GEOSPreparedTouches_r ( GEOSContextHandle_t  handle,
const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

◆ GEOSPreparedWithin()

char GEOSPreparedWithin ( const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

Using a GEOSPreparedDisjoint do a high performance calculation of whether the provided geometry is within.

Parameters
pg1The prepared geometry
g2The geometry to test
Returns
1 on true, 0 on false, 2 on exception
See also
GEOSWithin

◆ GEOSPreparedWithin_r()

char GEOSPreparedWithin_r ( GEOSContextHandle_t  handle,
const GEOSPreparedGeometry pg1,
const GEOSGeometry g2 
)

◆ GEOSProject()

double GEOSProject ( const GEOSGeometry line,
const GEOSGeometry point 
)

Distance of point projected onto line from the start of the line.

Parameters
linelinear target of projection
pointpoint to be projected onto 'g'
Returns
distance along line that point projects to, -1 on exception
Note
Line parameter must be a LineString.

◆ GEOSProject_r()

double GEOSProject_r ( GEOSContextHandle_t  handle,
const GEOSGeometry line,
const GEOSGeometry point 
)
See also
GEOSProject

◆ GEOSProjectNormalized()

double GEOSProjectNormalized ( const GEOSGeometry line,
const GEOSGeometry point 
)

Project point to line and calculate the proportion of the line the point is from the start. For example, a point that projects to the middle of a line would be return 0.5.

Parameters
linelinear target of projection
pointthe point to project
Returns
The proportion of the overall line length that the projected point falls at.

◆ GEOSProjectNormalized_r()

double GEOSProjectNormalized_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
const GEOSGeometry p 
)

◆ GEOSRelate()

char* GEOSRelate ( const GEOSGeometry g1,
const GEOSGeometry g2 
)

Calculate and return the DE9IM pattern for this geometry pair.

See also
geos::geom::Geometry::relate
Parameters
g1First geometry in pair
g2Second geometry in pair
Returns
DE9IM string. Caller is responsible for freeing with GEOSFree(). NULL on exception

◆ GEOSRelate_r()

char* GEOSRelate_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2 
)
See also
GEOSRelate

◆ GEOSRelateBoundaryNodeRule()

char* GEOSRelateBoundaryNodeRule ( const GEOSGeometry g1,
const GEOSGeometry g2,
int  bnr 
)

Calculate and return the DE9IM pattern for this geometry pair. Apply the supplied GEOSRelateBoundaryNodeRules.

See also
geos::geom::Geometry::relate
geos::algorithm::BoundaryNodeRule
Parameters
g1First geometry in pair
g2Second geometry in pair
bnrA member of the GEOSRelateBoundaryNodeRules enum
Returns
DE9IM string. Caller is responsible for freeing with GEOSFree(). NULL on exception

◆ GEOSRelateBoundaryNodeRule_r()

char* GEOSRelateBoundaryNodeRule_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2,
int  bnr 
)

◆ GEOSRelatePattern()

char GEOSRelatePattern ( const GEOSGeometry g1,
const GEOSGeometry g2,
const char *  pat 
)

Calculate the DE9IM pattern for this geometry pair and compare against the provided pattern to check for consistency. If the result and pattern are consistent return true. The pattern may include glob "*" characters for portions that are allowed to match any value.

See also
geos::geom::Geometry::relate
Parameters
g1First geometry in pair
g2Second geometry in pair
patDE9IM pattern to check
Returns
1 on true, 0 on false, 2 on exception

◆ GEOSRelatePattern_r()

char GEOSRelatePattern_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2,
const char *  pat 
)

◆ GEOSRelatePatternMatch()

char GEOSRelatePatternMatch ( const char *  mat,
const char *  pat 
)

Compare two DE9IM patterns and return true if they are consistent.

Parameters
matComplete DE9IM string (does not have "*")
patPattern to match to (may contain "*")
Returns
1 on true, 0 on false, 2 on exception

◆ GEOSRelatePatternMatch_r()

char GEOSRelatePatternMatch_r ( GEOSContextHandle_t  handle,
const char *  mat,
const char *  pat 
)

◆ GEOSReverse()

GEOSGeometry* GEOSReverse ( const GEOSGeometry g)

For geometries with coordinate sequences, reverses the order of the sequences. Converts CCW rings to CW. Reverses direction of LineStrings.

Parameters
gThe input geometry
Returns
The reversed geometry Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSReverse_r()

GEOSGeometry* GEOSReverse_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSReverse

◆ GEOSSegmentIntersection()

int GEOSSegmentIntersection ( double  ax0,
double  ay0,
double  ax1,
double  ay1,
double  bx0,
double  by0,
double  bx1,
double  by1,
double *  cx,
double *  cy 
)

Computes the coordinate where two line segments intersect, if any

Parameters
[in]ax0x-coordinate of 1st point in 1st segment
[in]ay0y-coordinate of 1st point in 1st segment
[in]ax1x-coordinate of 2nd point in 1st segment
[in]ay1y-coordinate of 2nd point in 1st segment
[in]bx0x-coordinate of 1st point in 2nd segment
[in]by0y-coordinate of 1st point in 2nd segment
[in]bx1x-coordinate of 2nd point in 2nd segment
[in]by1y-coordinate of 2nd point in 2nd segment
[out]cxx-coordinate of intersection point
[out]cyy-coordinate of intersection point
Returns
0 on error, 1 on success, -1 if segments do not intersect

◆ GEOSSegmentIntersection_r()

int GEOSSegmentIntersection_r ( GEOSContextHandle_t  extHandle,
double  ax0,
double  ay0,
double  ax1,
double  ay1,
double  bx0,
double  by0,
double  bx1,
double  by1,
double *  cx,
double *  cy 
)

◆ GEOSSetSRID()

void GEOSSetSRID ( GEOSGeometry g,
int  SRID 
)

Set the "spatial reference id" (SRID) for this geometry.

Parameters
gInput geometry
SRIDSRID number or 0 for unknown SRID.

◆ GEOSSetSRID_r()

void GEOSSetSRID_r ( GEOSContextHandle_t  handle,
GEOSGeometry g,
int  SRID 
)
See also
GEOSSetSRID

◆ GEOSSharedPaths()

GEOSGeometry* GEOSSharedPaths ( const GEOSGeometry g1,
const GEOSGeometry g2 
)

Find paths shared between the two given lineal geometries.

Returns a GeometryCollection having two elements:

  • first element is a MultiLineString containing shared paths having the same direction on both inputs
  • second element is a MultiLineString containing shared paths having the opposite direction on the two inputs
Parameters
g1An input geometry
g2An input geometry
Returns
The shared paths Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::sharedpaths::SharedPathsOp

◆ GEOSSharedPaths_r()

GEOSGeometry* GEOSSharedPaths_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2 
)
See also
GEOSSharedPaths

◆ GEOSSimplify()

GEOSGeometry* GEOSSimplify ( const GEOSGeometry g,
double  tolerance 
)

Apply the Douglas/Peucker algorithm to the coordinate sequences of the input geometry. Removes "unnecessary" vertices, vertices that are co-linear within the tolerance distance.

Parameters
gThe input geometry
toleranceThe tolerance to apply. Larger tolerance leads to simpler output.
Returns
The simplified geometry Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::simplify::DouglasPeuckerSimplifier

◆ GEOSSimplify_r()

GEOSGeometry* GEOSSimplify_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double  tolerance 
)
See also
GEOSSimplify

◆ GEOSSingleSidedBuffer()

GEOSGeometry* GEOSSingleSidedBuffer ( const GEOSGeometry g,
double  width,
int  quadsegs,
int  joinStyle,
double  mitreLimit,
int  leftSide 
)
Deprecated:
in 3.3.0, use GEOSOffsetCurve() instead

◆ GEOSSingleSidedBuffer_r()

GEOSGeometry* GEOSSingleSidedBuffer_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double  width,
int  quadsegs,
int  joinStyle,
double  mitreLimit,
int  leftSide 
)
Deprecated:
in 3.3.0, use GEOSOffsetCurve() instead

◆ GEOSSnap()

GEOSGeometry* GEOSSnap ( const GEOSGeometry input,
const GEOSGeometry snap_target,
double  tolerance 
)

Snap first geometry onto second within the given tolerance.

Parameters
inputAn input geometry
snap_targetA geometry to snap the input to
toleranceSnapping tolerance
Returns
The snapped verion of the input. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSSnap_r()

GEOSGeometry* GEOSSnap_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2,
double  tolerance 
)
See also
GEOSSnap

◆ GEOSSTRtree_create()

GEOSSTRtree* GEOSSTRtree_create ( size_t  nodeCapacity)

Create a new GEOSSTRtree using the Sort-Tile-Recursive algorithm (STRtree) for two-dimensional spatial data.

Parameters
nodeCapacityThe maximum number of child nodes that a node may have. The minimum recommended capacity value is 4. If unsure, use a default node capacity of 10.
Returns
a pointer to the created tree

◆ GEOSSTRtree_create_r()

GEOSSTRtree* GEOSSTRtree_create_r ( GEOSContextHandle_t  handle,
size_t  nodeCapacity 
)

◆ GEOSSTRtree_destroy()

void GEOSSTRtree_destroy ( GEOSSTRtree tree)

Frees all the memory associated with a GEOSSTRtree. Only the tree is freed. The geometries and items fed into GEOSSTRtree_insert() are not owned by the tree, and are still left to the caller to manage.

◆ GEOSSTRtree_destroy_r()

void GEOSSTRtree_destroy_r ( GEOSContextHandle_t  handle,
GEOSSTRtree tree 
)

◆ GEOSSTRtree_insert()

void GEOSSTRtree_insert ( GEOSSTRtree tree,
const GEOSGeometry g,
void *  item 
)

Insert an item into an GEOSSTRtree

Parameters
treethe GEOSSTRtree in which the item should be inserted
ga GEOSGeometry whose envelope corresponds to the extent of 'item'. As of GEOS 3.9, this envelope will be copied into the tree and the caller may destroy g while the tree is still in use. Before GEOS 3.9, g must be retained until the tree is destroyed.
itemthe item to insert into the tree
Note
The tree does not take ownership of the geometry or the item.

◆ GEOSSTRtree_insert_r()

void GEOSSTRtree_insert_r ( GEOSContextHandle_t  handle,
GEOSSTRtree tree,
const GEOSGeometry g,
void *  item 
)

◆ GEOSSTRtree_iterate()

void GEOSSTRtree_iterate ( GEOSSTRtree tree,
GEOSQueryCallback  callback,
void *  userdata 
)

Iterate over all items in the GEOSSTRtree.

Parameters
treethe STRtree over which to iterate
callbacka function to be executed for each item in the tree.
userdatapayload to pass the callback function.

◆ GEOSSTRtree_iterate_r()

void GEOSSTRtree_iterate_r ( GEOSContextHandle_t  handle,
GEOSSTRtree tree,
GEOSQueryCallback  callback,
void *  userdata 
)

◆ GEOSSTRtree_nearest()

const GEOSGeometry* GEOSSTRtree_nearest ( GEOSSTRtree tree,
const GEOSGeometry geom 
)

Returns the nearest item in the GEOSSTRtree to the supplied geometry. All items in the tree MUST be of type GEOSGeometry. If this is not the case, use GEOSSTRtree_nearest_generic() instead.

Parameters
treethe GEOSSTRtree to search
geomthe geometry with which the tree should be queried
Returns
a const pointer to the nearest GEOSGeometry in the tree to 'geom', or NULL in case of exception

◆ GEOSSTRtree_nearest_generic()

const void* GEOSSTRtree_nearest_generic ( GEOSSTRtree tree,
const void *  item,
const GEOSGeometry itemEnvelope,
GEOSDistanceCallback  distancefn,
void *  userdata 
)

Returns the nearest item in the GEOSSTRtree to the supplied item

Parameters
treethe STRtree to search
itemthe item with which the tree should be queried
itemEnvelopea GEOSGeometry having the bounding box of 'item'
distancefna function that can compute the distance between two items in the STRtree. The function should return zero in case of error, and should store the computed distance to the location pointed to by the 'distance' argument. The computed distance between two items must not exceed the Cartesian distance between their envelopes.
userdataoptional pointer to arbitrary data; will be passed to distancefn each time it is called.
Returns
a const pointer to the nearest item in the tree to 'item', or NULL in case of exception

◆ GEOSSTRtree_nearest_generic_r()

const void* GEOSSTRtree_nearest_generic_r ( GEOSContextHandle_t  handle,
GEOSSTRtree tree,
const void *  item,
const GEOSGeometry itemEnvelope,
GEOSDistanceCallback  distancefn,
void *  userdata 
)

◆ GEOSSTRtree_nearest_r()

const GEOSGeometry* GEOSSTRtree_nearest_r ( GEOSContextHandle_t  handle,
GEOSSTRtree tree,
const GEOSGeometry geom 
)

◆ GEOSSTRtree_query()

void GEOSSTRtree_query ( GEOSSTRtree tree,
const GEOSGeometry g,
GEOSQueryCallback  callback,
void *  userdata 
)

Query an GEOSSTRtree for items intersecting a specified envelope

Parameters
treethe GEOSSTRtree to search
ga GEOSGeomety from which a query envelope will be extracted
callbacka function to be executed for each item in the tree whose envelope intersects the envelope of 'g'. The callback function should take two parameters: a void pointer representing the located item in the tree, and a void userdata pointer.
userdataan optional pointer to pe passed to 'callback' as an argument

◆ GEOSSTRtree_query_r()

void GEOSSTRtree_query_r ( GEOSContextHandle_t  handle,
GEOSSTRtree tree,
const GEOSGeometry g,
GEOSQueryCallback  callback,
void *  userdata 
)

◆ GEOSSTRtree_remove()

char GEOSSTRtree_remove ( GEOSSTRtree tree,
const GEOSGeometry g,
void *  item 
)

Removes an item from the GEOSSTRtree

Parameters
treethe STRtree from which to remove an item
gthe envelope of the item to remove
itemthe item to remove
Returns
0 if the item was not removed; 1 if the item was removed; 2 if an exception occurred

◆ GEOSSTRtree_remove_r()

char GEOSSTRtree_remove_r ( GEOSContextHandle_t  handle,
GEOSSTRtree tree,
const GEOSGeometry g,
void *  item 
)

◆ GEOSSymDifference()

GEOSGeometry* GEOSSymDifference ( const GEOSGeometry ga,
const GEOSGeometry gb 
)

Returns the symmetric difference of two geometries A and B: the set of points that fall in A but not within B and the set of points that fall in B but not in A.

Parameters
gageometry A
gbgeometry B
Returns
A newly allocated geometry of the symmetric difference. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::overlayng::OverlayNG

◆ GEOSSymDifference_r()

GEOSGeometry* GEOSSymDifference_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2 
)

◆ GEOSSymDifferencePrec()

GEOSGeometry* GEOSSymDifferencePrec ( const GEOSGeometry ga,
const GEOSGeometry gb,
double  gridSize 
)

Returns the symmetric difference of two geometries A and B: the set of points that fall in A but not within B and the set of points that fall in B but not in A. All the vertices of the output geometry must fall on the grid defined by the gridSize, and the output will be a valid geometry.

Parameters
gaone of the geometries
gbthe other geometry
gridSizethe cell size of the precision grid
Returns
A newly allocated geometry of the symmetric difference. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::overlayng::OverlayNG

◆ GEOSSymDifferencePrec_r()

GEOSGeometry* GEOSSymDifferencePrec_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2,
double  gridSize 
)

◆ GEOSTopologyPreserveSimplify()

GEOSGeometry* GEOSTopologyPreserveSimplify ( const GEOSGeometry g,
double  tolerance 
)

Apply the Douglas/Peucker algorithm to the coordinate sequences of the input geometry. Removes "unnecessary" vertices, vertices that are co-linear within the tolerance distance. Returns a valid output geometry, checking for collapses, ring-intersections, etc and attempting to avoid. More computationally expensive than GEOSSimplify()

Parameters
gThe input geometry
toleranceThe tolerance to apply. Larger tolerance leads to simpler output.
Returns
The simplified geometry Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::simplify::DouglasPeuckerSimplifier

◆ GEOSTopologyPreserveSimplify_r()

GEOSGeometry* GEOSTopologyPreserveSimplify_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double  tolerance 
)

◆ GEOSTouches()

char GEOSTouches ( const GEOSGeometry g1,
const GEOSGeometry g2 
)

True if geometries share boundaries at one or more points, but do not have interior overlaps.

Parameters
g1Input geometry
g2Input geometry
Returns
1 on true, 0 on false, 2 on exception
See also
geos::geom::Geometry::touches

◆ GEOSTouches_r()

char GEOSTouches_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2 
)
See also
GEOSTouches

◆ GEOSUnaryUnion()

GEOSGeometry* GEOSUnaryUnion ( const GEOSGeometry g)

Returns the union of all components of a single geometry. Usually used to convert a collection into the smallest set of polygons that cover the same area.

Parameters
gThe input geometry
Returns
A newly allocated geometry of the union. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::overlayng::OverlayNG

◆ GEOSUnaryUnion_r()

GEOSGeometry* GEOSUnaryUnion_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
See also
GEOSUnaryUnion

◆ GEOSUnaryUnionPrec()

GEOSGeometry* GEOSUnaryUnionPrec ( const GEOSGeometry g,
double  gridSize 
)

Returns the union of all components of a single geometry. Usually used to convert a collection into the smallest set of polygons that cover the same area. All the vertices of the output geometry must fall on the grid defined by the gridSize, and the output will be a valid geometry.

Parameters
ginput geometry
gridSizethe cell size of the precision grid
Returns
A newly allocated geometry of the union. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::overlayng::OverlayNG

◆ GEOSUnaryUnionPrec_r()

GEOSGeometry* GEOSUnaryUnionPrec_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g,
double  gridSize 
)

◆ GEOSUnion()

GEOSGeometry* GEOSUnion ( const GEOSGeometry ga,
const GEOSGeometry gb 
)

Returns the union of two geometries A and B: the set of points that fall in A or within B.

Parameters
gageometry A
gbgeometry B
Returns
A newly allocated geometry of the union. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::overlayng::OverlayNG

◆ GEOSUnion_r()

GEOSGeometry* GEOSUnion_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2 
)
See also
GEOSUnion

◆ GEOSUnionCascaded()

GEOSGeometry* GEOSUnionCascaded ( const GEOSGeometry g)
Deprecated:
in 3.3.0: use GEOSUnaryUnion() instead

◆ GEOSUnionCascaded_r()

GEOSGeometry* GEOSUnionCascaded_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g 
)
Deprecated:
in 3.3.0: use GEOSUnaryUnion_r() instead

◆ GEOSUnionPrec()

GEOSGeometry* GEOSUnionPrec ( const GEOSGeometry ga,
const GEOSGeometry gb,
double  gridSize 
)

Returns the union of two geometries A and B: the set of points that fall in A or within B. All the vertices of the output geometry must fall on the grid defined by the gridSize, and the output will be a valid geometry.

Parameters
gaone of the geometries
gbthe other geometry
gridSizethe cell size of the precision grid
Returns
A newly allocated geometry of the union. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().
See also
geos::operation::overlayng::OverlayNG

◆ GEOSUnionPrec_r()

GEOSGeometry* GEOSUnionPrec_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2,
double  gridSize 
)
See also
GEOSUnionPrec

◆ GEOSversion()

const char* GEOSversion ( void  )

Returns the current GEOS version string. eg: "3.10.0" This function does not have a reentrant variant and is available if GEOS_USE_ONLY_R_API is defined.

Returns
version string

◆ GEOSVoronoiDiagram()

GEOSGeometry* GEOSVoronoiDiagram ( const GEOSGeometry g,
const GEOSGeometry env,
double  tolerance,
int  onlyEdges 
)

Returns the Voronoi polygons of the vertices of the given geometry.

Parameters
gthe input geometry whose vertices will be used as sites.
tolerancesnapping tolerance to use for improved robustness
onlyEdgeswhether to return only edges of the voronoi cells
envclipping envelope for the returned diagram, automatically determined if env is NULL. The diagram will be clipped to the larger of this envelope or an envelope surrounding the sites.
Returns
A newly allocated geometry. NULL on exception. Caller is responsible for freeing with GEOSGeom_destroy().

◆ GEOSVoronoiDiagram_r()

GEOSGeometry* GEOSVoronoiDiagram_r ( GEOSContextHandle_t  extHandle,
const GEOSGeometry g,
const GEOSGeometry env,
double  tolerance,
int  onlyEdges 
)

◆ GEOSWithin()

char GEOSWithin ( const GEOSGeometry g1,
const GEOSGeometry g2 
)

True if geometry g1 is completely within g2, and not touching the boundary of g2.

Parameters
g1Input geometry
g2Input geometry
Returns
1 on true, 0 on false, 2 on exception
See also
geos::geom::Geometry::within

◆ GEOSWithin_r()

char GEOSWithin_r ( GEOSContextHandle_t  handle,
const GEOSGeometry g1,
const GEOSGeometry g2 
)
See also
GEOSWithin

◆ GEOSWKBReader_create()

GEOSWKBReader* GEOSWKBReader_create ( void  )

Allocate a new GEOSWKBReader.

Returns
a new reader. Caller must free with GEOSWKBReader_destroy()

◆ GEOSWKBReader_create_r()

GEOSWKBReader* GEOSWKBReader_create_r ( GEOSContextHandle_t  handle)

◆ GEOSWKBReader_destroy()

void GEOSWKBReader_destroy ( GEOSWKBReader reader)

Free the memory associated with a GEOSWKBReader.

Parameters
readerThe reader to destroy.

◆ GEOSWKBReader_destroy_r()

void GEOSWKBReader_destroy_r ( GEOSContextHandle_t  handle,
GEOSWKBReader reader 
)

◆ GEOSWKBReader_read()

GEOSGeometry* GEOSWKBReader_read ( GEOSWKBReader reader,
const unsigned char *  wkb,
size_t  size 
)

Read a geometry from a well-known binary buffer.

Parameters
readerA GEOSWKBReader
wkbA pointer to the buffer to read from
sizeThe number of bytes of data in the buffer
Returns
A GEOSGeometry built from the WKB, or NULL on exception.

◆ GEOSWKBReader_read_r()

GEOSGeometry* GEOSWKBReader_read_r ( GEOSContextHandle_t  handle,
GEOSWKBReader reader,
const unsigned char *  wkb,
size_t  size 
)

◆ GEOSWKBReader_readHEX()

GEOSGeometry* GEOSWKBReader_readHEX ( GEOSWKBReader reader,
const unsigned char *  hex,
size_t  size 
)

Read a geometry from a hex encoded well-known binary buffer.

Parameters
readerA GEOSWKBReader
hexA pointer to the buffer to read from
sizeThe number of bytes of data in the buffer
Returns
A GEOSGeometry built from the HEX WKB, or NULL on exception.

◆ GEOSWKBReader_readHEX_r()

GEOSGeometry* GEOSWKBReader_readHEX_r ( GEOSContextHandle_t  handle,
GEOSWKBReader reader,
const unsigned char *  hex,
size_t  size 
)

◆ GEOSWKBWriter_create()

GEOSWKBWriter* GEOSWKBWriter_create ( void  )

Allocate a new GEOSWKBWriter.

Returns
a new writer. Caller must free with GEOSWKBWriter_destroy()

◆ GEOSWKBWriter_create_r()

GEOSWKBWriter* GEOSWKBWriter_create_r ( GEOSContextHandle_t  handle)

◆ GEOSWKBWriter_destroy()

void GEOSWKBWriter_destroy ( GEOSWKBWriter writer)

Free the memory associated with a GEOSWKBWriter.

Parameters
writerThe writer to destroy.

◆ GEOSWKBWriter_destroy_r()

void GEOSWKBWriter_destroy_r ( GEOSContextHandle_t  handle,
GEOSWKBWriter writer 
)

◆ GEOSWKBWriter_getByteOrder()

int GEOSWKBWriter_getByteOrder ( const GEOSWKBWriter writer)

Find whether the writer will use WKB byte order that is big or little endian. The return value is a member of GEOSWKBByteOrders.

Parameters
writerThe writer to read byte order from
Returns
The current byte order

◆ GEOSWKBWriter_getByteOrder_r()

int GEOSWKBWriter_getByteOrder_r ( GEOSContextHandle_t  handle,
const GEOSWKBWriter writer 
)

◆ GEOSWKBWriter_getFlavor()

int GEOSWKBWriter_getFlavor ( const GEOSWKBWriter writer)

Find whether the writer will use WKB that is ISO flavor or "extended" flavor. The flavor determines how extra dimensionality is encoded with the type number, and whether SRID can be included in the WKB. ISO flavor does not support SRID embedding. ISO flavor is "more standard" for 3D output. GEOS can read both flavors. The return value is a member of GEOSWKBFlavors.

Parameters
writerThe writer to read flavor from
Returns
The current flavor

◆ GEOSWKBWriter_getFlavor_r()

int GEOSWKBWriter_getFlavor_r ( GEOSContextHandle_t  handle,
const GEOSWKBWriter writer 
)

◆ GEOSWKBWriter_getIncludeSRID()

char GEOSWKBWriter_getIncludeSRID ( const GEOSWKBWriter writer)

Read the current SRID embedding value from the writer.

Parameters
writerThe writer to check SRID value on

◆ GEOSWKBWriter_getIncludeSRID_r()

char GEOSWKBWriter_getIncludeSRID_r ( GEOSContextHandle_t  handle,
const GEOSWKBWriter writer 
)

◆ GEOSWKBWriter_getOutputDimension()

int GEOSWKBWriter_getOutputDimension ( const GEOSWKBWriter writer)

Read the current output dimension of the writer. Either 2 or 3 dimensions. Return current number of dimensions.

Parameters
writerThe writer to read from.
Returns
Number of dimensions (2 or 3)

◆ GEOSWKBWriter_getOutputDimension_r()

int GEOSWKBWriter_getOutputDimension_r ( GEOSContextHandle_t  handle,
const GEOSWKBWriter writer 
)

◆ GEOSWKBWriter_setByteOrder()

void GEOSWKBWriter_setByteOrder ( GEOSWKBWriter writer,
int  byteOrder 
)

Set the output byte order of the writer, using a value from GEOSWKBByteOrders enum.

Parameters
writerThe writer to set byte order on
byteOrderDesired byte order

◆ GEOSWKBWriter_setByteOrder_r()

void GEOSWKBWriter_setByteOrder_r ( GEOSContextHandle_t  handle,
GEOSWKBWriter writer,
int  byteOrder 
)

◆ GEOSWKBWriter_setFlavor()

void GEOSWKBWriter_setFlavor ( GEOSWKBWriter writer,
int  flavor 
)

Set the output flavor of the writer, using a value from GEOSWKBFlavors enum.

Parameters
writerThe writer to set flavor on
flavorDesired flavor

◆ GEOSWKBWriter_setFlavor_r()

void GEOSWKBWriter_setFlavor_r ( GEOSContextHandle_t  handle,
GEOSWKBWriter writer,
int  flavor 
)

◆ GEOSWKBWriter_setIncludeSRID()

void GEOSWKBWriter_setIncludeSRID ( GEOSWKBWriter writer,
const char  writeSRID 
)

Specify whether SRID values should be output in WKB. Many WKB readers do not support SRID values, use with caution.

Parameters
writerThe writer to set SRID output on
writeSRIDSet to 1 to include SRID, 0 otherwise

◆ GEOSWKBWriter_setIncludeSRID_r()

void GEOSWKBWriter_setIncludeSRID_r ( GEOSContextHandle_t  handle,
GEOSWKBWriter writer,
const char  writeSRID 
)

◆ GEOSWKBWriter_setOutputDimension()

void GEOSWKBWriter_setOutputDimension ( GEOSWKBWriter writer,
int  newDimension 
)

Set the output dimensionality of the writer. Either 2 or 3 dimensions.

Parameters
writerThe writer to read from.
newDimensionThe dimensionality desired

◆ GEOSWKBWriter_setOutputDimension_r()

void GEOSWKBWriter_setOutputDimension_r ( GEOSContextHandle_t  handle,
GEOSWKBWriter writer,
int  newDimension 
)

◆ GEOSWKBWriter_write()

unsigned char* GEOSWKBWriter_write ( GEOSWKBWriter writer,
const GEOSGeometry g,
size_t *  size 
)

Write out the WKB representation of a geometry.

Parameters
writerThe GEOSWKBWriter controlling the writing.
gGeometry to convert to WKB
sizePointer to write the size of the final output WKB to
Returns
The WKB representation. Caller must free with GEOSFree()

◆ GEOSWKBWriter_write_r()

unsigned char* GEOSWKBWriter_write_r ( GEOSContextHandle_t  handle,
GEOSWKBWriter writer,
const GEOSGeometry g,
size_t *  size 
)

◆ GEOSWKBWriter_writeHEX()

unsigned char* GEOSWKBWriter_writeHEX ( GEOSWKBWriter writer,
const GEOSGeometry g,
size_t *  size 
)

Write out the hex WKB representation of a geometry.

Parameters
writerThe GEOSWKBWriter controlling the writing.
gGeometry to convert to WKB
sizePointer to write the size of the final output WKB to
Returns
The HEX WKB representation. Caller must free with GEOSFree()

◆ GEOSWKBWriter_writeHEX_r()

unsigned char* GEOSWKBWriter_writeHEX_r ( GEOSContextHandle_t  handle,
GEOSWKBWriter writer,
const GEOSGeometry g,
size_t *  size 
)

◆ GEOSWKTReader_create()

GEOSWKTReader* GEOSWKTReader_create ( void  )

Allocate a new GEOSWKTReader.

Returns
a new reader. Caller must free with GEOSWKTReader_destroy()

◆ GEOSWKTReader_create_r()

GEOSWKTReader* GEOSWKTReader_create_r ( GEOSContextHandle_t  handle)

◆ GEOSWKTReader_destroy()

void GEOSWKTReader_destroy ( GEOSWKTReader reader)

Free the memory associated with a GEOSWKTReader.

Parameters
readerThe reader to destroy.

◆ GEOSWKTReader_destroy_r()

void GEOSWKTReader_destroy_r ( GEOSContextHandle_t  handle,
GEOSWKTReader reader 
)

◆ GEOSWKTReader_read()

GEOSGeometry* GEOSWKTReader_read ( GEOSWKTReader reader,
const char *  wkt 
)

Use a reader to parse the well-known text representation of a geometry, and return an allocated geometry.

Parameters
readerA WKT reader object, caller retains ownership
wktThe WKT string to parse, caller retains ownership
Returns
A GEOSGeometry, caller to free with GEOSGeom_destroy())

◆ GEOSWKTReader_read_r()

GEOSGeometry* GEOSWKTReader_read_r ( GEOSContextHandle_t  handle,
GEOSWKTReader reader,
const char *  wkt 
)

◆ GEOSWKTWriter_create()

GEOSWKTWriter* GEOSWKTWriter_create ( void  )

Allocate a new GEOSWKTWriter.

Returns
a new writer. Caller must free with GEOSWKTWriter_destroy()

◆ GEOSWKTWriter_create_r()

GEOSWKTWriter* GEOSWKTWriter_create_r ( GEOSContextHandle_t  handle)

◆ GEOSWKTWriter_destroy()

void GEOSWKTWriter_destroy ( GEOSWKTWriter writer)

Free the memory associated with a GEOSWKTWriter.

Parameters
writerThe writer to destroy.

◆ GEOSWKTWriter_destroy_r()

void GEOSWKTWriter_destroy_r ( GEOSContextHandle_t  handle,
GEOSWKTWriter writer 
)

◆ GEOSWKTWriter_getOutputDimension()

int GEOSWKTWriter_getOutputDimension ( GEOSWKTWriter writer)

Reads the current output dimension from a GEOSWKTWriter.

Parameters
writerA GEOSWKTWriter.
Returns
The current dimension.

◆ GEOSWKTWriter_getOutputDimension_r()

int GEOSWKTWriter_getOutputDimension_r ( GEOSContextHandle_t  handle,
GEOSWKTWriter writer 
)

◆ GEOSWKTWriter_setOld3D()

void GEOSWKTWriter_setOld3D ( GEOSWKTWriter writer,
int  useOld3D 
)

Sets the format for 3D outputs. The "old 3D" format does not include a dimensionality tag, eg. "POINT(1 2 3)" while the new (ISO) format does includes a tag, eg "POINT Z (1 2 3)".

Parameters
writerA GEOSWKTWriter.
useOld3DTrue to use the old format, false is the default.

◆ GEOSWKTWriter_setOld3D_r()

void GEOSWKTWriter_setOld3D_r ( GEOSContextHandle_t  handle,
GEOSWKTWriter writer,
int  useOld3D 
)

◆ GEOSWKTWriter_setOutputDimension()

void GEOSWKTWriter_setOutputDimension ( GEOSWKTWriter writer,
int  dim 
)

Sets whether or not to write out XY or XYZ coordinates. Legal values are 2 or 3.

Parameters
writerA GEOSWKTWriter.
dimThe desired dimension, default 2.

◆ GEOSWKTWriter_setOutputDimension_r()

void GEOSWKTWriter_setOutputDimension_r ( GEOSContextHandle_t  handle,
GEOSWKTWriter writer,
int  dim 
)

◆ GEOSWKTWriter_setRoundingPrecision()

void GEOSWKTWriter_setRoundingPrecision ( GEOSWKTWriter writer,
int  precision 
)

Sets the number places after the decimal to output in WKT.

Parameters
writerA GEOSWKTWriter.
precisionThe desired precision, default 16.

◆ GEOSWKTWriter_setRoundingPrecision_r()

void GEOSWKTWriter_setRoundingPrecision_r ( GEOSContextHandle_t  handle,
GEOSWKTWriter writer,
int  precision 
)

◆ GEOSWKTWriter_setTrim()

void GEOSWKTWriter_setTrim ( GEOSWKTWriter writer,
char  trim 
)

Sets the number trimming option on a GEOSWKTWriter. With trim set to 1, the writer will strip trailing 0's from the output coordinates. With 0, all coordinates will be padded with 0's out to the rounding precision.

Parameters
writerA GEOSWKTWriter.
trimThe trimming behaviour to set, 1 for 'on', 0 for 'off', default 'off'

◆ GEOSWKTWriter_setTrim_r()

void GEOSWKTWriter_setTrim_r ( GEOSContextHandle_t  handle,
GEOSWKTWriter writer,
char  trim 
)

◆ GEOSWKTWriter_write()

char* GEOSWKTWriter_write ( GEOSWKTWriter writer,
const GEOSGeometry g 
)

Writes out the well-known text representation of a geometry, using the trim, rounding and dimension settings of the writer.

Parameters
writerA GEOSWKTWriter.
gInput geometry
Returns
A newly allocated string containing the WKT output or NULL on exception. Caller must free with GEOSFree()

◆ GEOSWKTWriter_write_r()

char* GEOSWKTWriter_write_r ( GEOSContextHandle_t  handle,
GEOSWKTWriter writer,
const GEOSGeometry g 
)

◆ initGEOS()

void initGEOS ( GEOSMessageHandler  notice_function,
GEOSMessageHandler  error_function 
)

For non-reentrant code, set up an execution contact, and associate GEOSMessageHandler functions with it, to pass error and notice messages back to the calling application.

typedef void (*GEOSMessageHandler)(const char *fmt, ...);
Parameters
notice_functionHandle notice messages
error_functionHandle error messages

◆ initGEOS_r()

GEOSContextHandle_t initGEOS_r ( GEOSMessageHandler  notice_function,
GEOSMessageHandler  error_function 
)
Deprecated:
in 3.5.0. Use GEOS_init_r() and set the message handlers using GEOSContext_setNoticeHandler_r() and/or GEOSContext_setErrorHandler_r()