PostGIS  2.4.9dev-r@@SVN_REVISION@@

◆ coveredby()

Datum coveredby ( PG_FUNCTION_ARGS  )

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

References crosses(), error_if_srid_mismatch(), errorIfGeometryCollection(), FALSE, gbox_contains_2d(), LWMPOINT::geoms, GetRtreeCache(), gserialized_get_gbox_p(), gserialized_get_srid(), 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(), MULTIPOINTTYPE, LWMPOINT::ngeoms, PG_FUNCTION_INFO_V1(), pip_short_circuit(), POINTTYPE, and POSTGIS2GEOS().

Referenced by covers().

2172 {
2173  GSERIALIZED *geom1;
2174  GSERIALIZED *geom2;
2175  GEOSGeometry *g1, *g2;
2176  int result;
2177  GBOX box1, box2;
2178  char *patt = "**F**F***";
2179 
2180  geom1 = PG_GETARG_GSERIALIZED_P(0);
2181  geom2 = PG_GETARG_GSERIALIZED_P(1);
2182 
2183  errorIfGeometryCollection(geom1,geom2);
2185 
2186  /* A.CoveredBy(Empty) == FALSE */
2187  if ( gserialized_is_empty(geom1) || gserialized_is_empty(geom2) )
2188  PG_RETURN_BOOL(false);
2189 
2190  /*
2191  * short-circuit 1: if geom1 bounding box is not completely inside
2192  * geom2 bounding box we can prematurely return FALSE.
2193  */
2194  if ( gserialized_get_gbox_p(geom1, &box1) &&
2195  gserialized_get_gbox_p(geom2, &box2) )
2196  {
2197  if ( ! gbox_contains_2d(&box2, &box1) )
2198  {
2199  PG_RETURN_BOOL(FALSE);
2200  }
2201 
2202  POSTGIS_DEBUG(3, "bounding box short-circuit missed.");
2203  }
2204  /*
2205  * short-circuit 2: if geom1 is a point and geom2 is a polygon
2206  * call the point-in-polygon function.
2207  */
2208  if (is_point(geom1) && is_poly(geom2))
2209  {
2210  GSERIALIZED* gpoly = is_poly(geom1) ? geom1 : geom2;
2211  GSERIALIZED* gpoint = is_point(geom1) ? geom1 : geom2;
2212  RTREE_POLY_CACHE* cache = GetRtreeCache(fcinfo, gpoly);
2213  int retval;
2214 
2215  POSTGIS_DEBUG(3, "Point in Polygon test requested...short-circuiting.");
2216  if (gserialized_get_type(gpoint) == POINTTYPE)
2217  {
2218  LWGEOM* point = lwgeom_from_gserialized(gpoint);
2219  int pip_result = pip_short_circuit(cache, lwgeom_as_lwpoint(point), gpoly);
2220  lwgeom_free(point);
2221 
2222  retval = (pip_result != -1); /* not outside */
2223  }
2224  else if (gserialized_get_type(gpoint) == MULTIPOINTTYPE)
2225  {
2227  uint32_t i;
2228 
2229  retval = LW_TRUE;
2230  for (i = 0; i < mpoint->ngeoms; i++)
2231  {
2232  int pip_result = pip_short_circuit(cache, mpoint->geoms[i], gpoly);
2233  if (pip_result == -1)
2234  {
2235  retval = LW_FALSE;
2236  break;
2237  }
2238  }
2239 
2240  lwmpoint_free(mpoint);
2241  }
2242  else
2243  {
2244  /* Never get here */
2245  elog(ERROR,"Type isn't point or multipoint!");
2246  PG_RETURN_NULL();
2247  }
2248 
2249  PG_FREE_IF_COPY(geom1, 0);
2250  PG_FREE_IF_COPY(geom2, 1);
2251  PG_RETURN_BOOL(retval);
2252  }
2253  else
2254  {
2255  POSTGIS_DEBUGF(3, "CoveredBy: type1: %d, type2: %d", gserialized_get_type(geom1), gserialized_get_type(geom2));
2256  }
2257 
2258  initGEOS(lwpgnotice, lwgeom_geos_error);
2259 
2260  g1 = (GEOSGeometry *)POSTGIS2GEOS(geom1);
2261 
2262  if ( 0 == g1 ) /* exception thrown at construction */
2263  {
2264  HANDLE_GEOS_ERROR("First argument geometry could not be converted to GEOS");
2265  PG_RETURN_NULL();
2266  }
2267 
2268  g2 = (GEOSGeometry *)POSTGIS2GEOS(geom2);
2269 
2270  if ( 0 == g2 ) /* exception thrown at construction */
2271  {
2272  HANDLE_GEOS_ERROR("Second argument geometry could not be converted to GEOS");
2273  GEOSGeom_destroy(g1);
2274  PG_RETURN_NULL();
2275  }
2276 
2277  result = GEOSRelatePattern(g1,g2,patt);
2278 
2279  GEOSGeom_destroy(g1);
2280  GEOSGeom_destroy(g2);
2281 
2282  if (result == 2)
2283  {
2284  HANDLE_GEOS_ERROR("GEOSCoveredBy");
2285  PG_RETURN_NULL(); /* never get here */
2286  }
2287 
2288  PG_FREE_IF_COPY(geom1, 0);
2289  PG_FREE_IF_COPY(geom2, 1);
2290 
2291  PG_RETURN_BOOL(result);
2292 }
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:642
uint32_t gserialized_get_type(const GSERIALIZED *s)
Extract the geometry type from the serialized form (it hides in the anonymous data area...
Definition: g_serialized.c:86
static char is_poly(const GSERIALIZED *g)
LWGEOM * lwgeom_from_gserialized(const GSERIALIZED *g)
Allocate a new LWGEOM from a GSERIALIZED.
void lwgeom_free(LWGEOM *geom)
Definition: lwgeom.c:1099
#define MULTIPOINTTYPE
Definition: liblwgeom.h:88
The tree structure used for fast P-i-P tests by point_in_multipolygon_rtree()
Definition: lwgeom_rtree.h:57
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: g_box.c:351
void error_if_srid_mismatch(int srid1, int srid2)
Definition: lwutil.c:371
LWPOINT * lwgeom_as_lwpoint(const LWGEOM *lwgeom)
Definition: lwgeom.c:129
static char is_point(const GSERIALIZED *g)
int gserialized_is_empty(const GSERIALIZED *g)
Check if a GSERIALIZED is empty without deserializing first.
Definition: g_serialized.c:179
unsigned int uint32_t
Definition: uthash.h:78
void lwmpoint_free(LWMPOINT *mpt)
Definition: lwmpoint.c:72
void lwgeom_geos_error(const char *fmt,...)
#define LW_FALSE
Definition: liblwgeom.h:77
#define LW_TRUE
Return types for functions with status returns.
Definition: liblwgeom.h:76
LWPOINT ** geoms
Definition: liblwgeom.h:470
#define FALSE
Definition: dbfopen.c:168
GEOSGeometry * POSTGIS2GEOS(GSERIALIZED *pglwgeom)
#define POINTTYPE
LWTYPE numbers, used internally by PostGIS.
Definition: liblwgeom.h:85
LWMPOINT * lwgeom_as_lwmpoint(const LWGEOM *lwgeom)
Definition: lwgeom.c:201
#define HANDLE_GEOS_ERROR(label)
RTREE_POLY_CACHE * GetRtreeCache(FunctionCallInfo fcinfo, 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
int ngeoms
Definition: liblwgeom.h:468
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
static int pip_short_circuit(RTREE_POLY_CACHE *poly_cache, LWPOINT *point, GSERIALIZED *gpoly)
void errorIfGeometryCollection(GSERIALIZED *g1, GSERIALIZED *g2)
Throws an ereport ERROR if either geometry is a COLLECTIONTYPE.
Here is the call graph for this function:
Here is the caller graph for this function: