PostGIS  3.2.2dev-r@@SVN_REVISION@@

◆ coveredby()

Datum coveredby ( PG_FUNCTION_ARGS  )

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

2111 {
2112  SHARED_GSERIALIZED *shared_geom1 = ToastCacheGetGeometry(fcinfo, 0);
2113  SHARED_GSERIALIZED *shared_geom2 = ToastCacheGetGeometry(fcinfo, 1);
2114  const GSERIALIZED *geom1 = shared_gserialized_get(shared_geom1);
2115  const GSERIALIZED *geom2 = shared_gserialized_get(shared_geom2);
2116  GEOSGeometry *g1, *g2;
2117  int result;
2118  GBOX box1, box2;
2119  char *patt = "**F**F***";
2120 
2121  gserialized_error_if_srid_mismatch(geom1, geom2, __func__);
2122 
2123  /* A.CoveredBy(Empty) == FALSE */
2124  if ( gserialized_is_empty(geom1) || gserialized_is_empty(geom2) )
2125  PG_RETURN_BOOL(false);
2126 
2127  /*
2128  * short-circuit 1: if geom1 bounding box is not completely inside
2129  * geom2 bounding box we can return FALSE.
2130  */
2131  if ( gserialized_get_gbox_p(geom1, &box1) &&
2132  gserialized_get_gbox_p(geom2, &box2) )
2133  {
2134  if ( ! gbox_contains_2d(&box2, &box1) )
2135  {
2136  PG_RETURN_BOOL(false);
2137  }
2138 
2139  POSTGIS_DEBUG(3, "bounding box short-circuit missed.");
2140  }
2141  /*
2142  * short-circuit 2: if geom1 is a point and geom2 is a polygon
2143  * call the point-in-polygon function.
2144  */
2145  if (is_point(geom1) && is_poly(geom2))
2146  {
2147  SHARED_GSERIALIZED *shared_gpoly = is_poly(geom1) ? shared_geom1 : shared_geom2;
2148  SHARED_GSERIALIZED *shared_gpoint = is_point(geom1) ? shared_geom1 : shared_geom2;
2149  const GSERIALIZED *gpoly = shared_gserialized_get(shared_gpoly);
2150  const GSERIALIZED *gpoint = shared_gserialized_get(shared_gpoint);
2151  RTREE_POLY_CACHE *cache = GetRtreeCache(fcinfo, shared_gpoly);
2152  int retval;
2153 
2154  POSTGIS_DEBUG(3, "Point in Polygon test requested...short-circuiting.");
2155  if (gserialized_get_type(gpoint) == POINTTYPE)
2156  {
2157  LWGEOM* point = lwgeom_from_gserialized(gpoint);
2158  int pip_result = pip_short_circuit(cache, lwgeom_as_lwpoint(point), gpoly);
2159  lwgeom_free(point);
2160 
2161  retval = (pip_result != -1); /* not outside */
2162  }
2163  else if (gserialized_get_type(gpoint) == MULTIPOINTTYPE)
2164  {
2166  uint32_t i;
2167 
2168  retval = LW_TRUE;
2169  for (i = 0; i < mpoint->ngeoms; i++)
2170  {
2171  LWPOINT *pt = mpoint->geoms[i];
2172  if (lwpoint_is_empty(pt)) continue;
2173  if (pip_short_circuit(cache, pt, gpoly) == -1)
2174  {
2175  retval = LW_FALSE;
2176  break;
2177  }
2178  }
2179 
2180  lwmpoint_free(mpoint);
2181  }
2182  else
2183  {
2184  /* Never get here */
2185  elog(ERROR,"Type isn't point or multipoint!");
2186  PG_RETURN_NULL();
2187  }
2188 
2189  PG_RETURN_BOOL(retval);
2190  }
2191  else
2192  {
2193  POSTGIS_DEBUGF(3, "CoveredBy: type1: %d, type2: %d", gserialized_get_type(geom1), gserialized_get_type(geom2));
2194  }
2195 
2196  initGEOS(lwpgnotice, lwgeom_geos_error);
2197 
2198  g1 = POSTGIS2GEOS(geom1);
2199 
2200  if (!g1)
2201  HANDLE_GEOS_ERROR("First argument geometry could not be converted to GEOS");
2202 
2203  g2 = POSTGIS2GEOS(geom2);
2204 
2205  if (!g2)
2206  {
2207  GEOSGeom_destroy(g1);
2208  HANDLE_GEOS_ERROR("Second argument geometry could not be converted to GEOS");
2209  }
2210 
2211  result = GEOSRelatePattern(g1,g2,patt);
2212 
2213  GEOSGeom_destroy(g1);
2214  GEOSGeom_destroy(g2);
2215 
2216  if (result == 2) HANDLE_GEOS_ERROR("GEOSCoveredBy");
2217 
2218  PG_RETURN_BOOL(result);
2219 }
char result[OUT_DOUBLE_BUFFER_SIZE]
Definition: cu_print.c:267
int gbox_contains_2d(const GBOX *g1, const GBOX *g2)
Return LW_TRUE if the first GBOX contains the second on the 2d plane, LW_FALSE otherwise.
Definition: gbox.c:339
void gserialized_error_if_srid_mismatch(const GSERIALIZED *g1, const GSERIALIZED *g2, const char *funcname)
Definition: gserialized.c:404
int gserialized_get_gbox_p(const GSERIALIZED *g, GBOX *gbox)
Read the box from the GSERIALIZED or calculate it if necessary.
Definition: gserialized.c:65
LWGEOM * lwgeom_from_gserialized(const GSERIALIZED *g)
Allocate a new LWGEOM from a GSERIALIZED.
Definition: gserialized.c:239
int gserialized_is_empty(const GSERIALIZED *g)
Check if a GSERIALIZED is empty without deserializing first.
Definition: gserialized.c:152
uint32_t gserialized_get_type(const GSERIALIZED *g)
Extract the geometry type from the serialized form (it hides in the anonymous data area,...
Definition: gserialized.c:89
void lwgeom_geos_error(const char *fmt,...)
#define LW_FALSE
Definition: liblwgeom.h:108
void lwmpoint_free(LWMPOINT *mpt)
Definition: lwmpoint.c:72
LWMPOINT * lwgeom_as_lwmpoint(const LWGEOM *lwgeom)
Definition: lwgeom.c:225
void lwgeom_free(LWGEOM *geom)
Definition: lwgeom.c:1138
#define MULTIPOINTTYPE
Definition: liblwgeom.h:119
#define POINTTYPE
LWTYPE numbers, used internally by PostGIS.
Definition: liblwgeom.h:116
#define LW_TRUE
Return types for functions with status returns.
Definition: liblwgeom.h:107
int lwpoint_is_empty(const LWPOINT *point)
RTREE_POLY_CACHE * GetRtreeCache(FunctionCallInfo fcinfo, SHARED_GSERIALIZED *g1)
Checks for a cache hit against the provided geometry and returns a pre-built index structure (RTREE_P...
Definition: lwgeom_rtree.c:432
static LWPOINT * lwgeom_as_lwpoint(const LWGEOM *lwgeom)
Definition: lwinline.h:131
#define HANDLE_GEOS_ERROR(label)
static char is_point(const GSERIALIZED *g)
static int pip_short_circuit(RTREE_POLY_CACHE *poly_cache, LWPOINT *point, const GSERIALIZED *gpoly)
static char is_poly(const GSERIALIZED *g)
GEOSGeometry * POSTGIS2GEOS(const GSERIALIZED *pglwgeom)
uint32_t ngeoms
Definition: liblwgeom.h:552
LWPOINT ** geoms
Definition: liblwgeom.h:547
The tree structure used for fast P-i-P tests by point_in_multipolygon_rtree()
Definition: lwgeom_rtree.h:59

References gbox_contains_2d(), LWMPOINT::geoms, GetRtreeCache(), gserialized_error_if_srid_mismatch(), gserialized_get_gbox_p(), gserialized_get_type(), gserialized_is_empty(), HANDLE_GEOS_ERROR, is_point(), is_poly(), LW_FALSE, LW_TRUE, lwgeom_as_lwmpoint(), lwgeom_as_lwpoint(), lwgeom_free(), lwgeom_from_gserialized(), lwgeom_geos_error(), lwmpoint_free(), lwpoint_is_empty(), MULTIPOINTTYPE, LWMPOINT::ngeoms, pip_short_circuit(), POINTTYPE, POSTGIS2GEOS(), and result.

Referenced by rt_raster_coveredby().

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