PostGIS  2.5.7dev-r@@SVN_REVISION@@

◆ touches()

Datum touches ( PG_FUNCTION_ARGS  )

Definition at line 2267 of file postgis/lwgeom_geos.c.

2268 {
2269  GSERIALIZED *geom1;
2270  GSERIALIZED *geom2;
2271  GEOSGeometry *g1, *g2;
2272  char result;
2273  GBOX box1, box2;
2274 
2275  geom1 = PG_GETARG_GSERIALIZED_P(0);
2276  geom2 = PG_GETARG_GSERIALIZED_P(1);
2277 
2278  errorIfGeometryCollection(geom1,geom2);
2280 
2281  /* A.Touches(Empty) == FALSE */
2282  if ( gserialized_is_empty(geom1) || gserialized_is_empty(geom2) )
2283  PG_RETURN_BOOL(false);
2284 
2285  /*
2286  * short-circuit 1: if geom2 bounding box does not overlap
2287  * geom1 bounding box we can return FALSE.
2288  */
2289  if ( gserialized_get_gbox_p(geom1, &box1) &&
2290  gserialized_get_gbox_p(geom2, &box2) )
2291  {
2292  if ( gbox_overlaps_2d(&box1, &box2) == LW_FALSE )
2293  {
2294  PG_RETURN_BOOL(false);
2295  }
2296  }
2297 
2298  initGEOS(lwpgnotice, lwgeom_geos_error);
2299 
2300  g1 = POSTGIS2GEOS(geom1 );
2301  if (!g1)
2302  HANDLE_GEOS_ERROR("First argument geometry could not be converted to GEOS");
2303 
2304  g2 = POSTGIS2GEOS(geom2 );
2305  if (!g2)
2306  {
2307  GEOSGeom_destroy(g1);
2308  HANDLE_GEOS_ERROR("Second argument geometry could not be converted to GEOS");
2309  }
2310 
2311  result = GEOSTouches(g1,g2);
2312 
2313  GEOSGeom_destroy(g1);
2314  GEOSGeom_destroy(g2);
2315 
2316  if (result == 2) HANDLE_GEOS_ERROR("GEOSTouches");
2317 
2318  PG_FREE_IF_COPY(geom1, 0);
2319  PG_FREE_IF_COPY(geom2, 1);
2320 
2321  PG_RETURN_BOOL(result);
2322 }
int gbox_overlaps_2d(const GBOX *g1, const GBOX *g2)
Return LW_TRUE if the GBOX overlaps on the 2d plane, LW_FALSE otherwise.
Definition: g_box.c:330
int32_t gserialized_get_srid(const GSERIALIZED *s)
Extract the SRID from the serialized form (it is packed into three bytes so this is a handy function)...
Definition: g_serialized.c:100
int gserialized_is_empty(const GSERIALIZED *g)
Check if a GSERIALIZED is empty without deserializing first.
Definition: g_serialized.c:179
int gserialized_get_gbox_p(const GSERIALIZED *g, GBOX *box)
Read the bounding box off a serialization and calculate one if it is not already there.
Definition: g_serialized.c:640
void lwgeom_geos_error(const char *fmt,...)
#define LW_FALSE
Definition: liblwgeom.h:77
void error_if_srid_mismatch(int srid1, int srid2)
Definition: lwutil.c:338
#define HANDLE_GEOS_ERROR(label)
void errorIfGeometryCollection(GSERIALIZED *g1, GSERIALIZED *g2)
Throws an ereport ERROR if either geometry is a COLLECTIONTYPE.
GEOSGeometry * POSTGIS2GEOS(GSERIALIZED *pglwgeom)

References error_if_srid_mismatch(), errorIfGeometryCollection(), gbox_overlaps_2d(), gserialized_get_gbox_p(), gserialized_get_srid(), gserialized_is_empty(), HANDLE_GEOS_ERROR, LW_FALSE, lwgeom_geos_error(), and POSTGIS2GEOS().

Referenced by rt_raster_touches().

Here is the call graph for this function:
Here is the caller graph for this function: