PostGIS  2.3.8dev-r@@SVN_REVISION@@

◆ covers()

Datum covers ( PG_FUNCTION_ARGS  )

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

References PrepGeomCache::argnum, coveredby(), error_if_srid_mismatch(), errorIfGeometryCollection(), FALSE, gbox_contains_2d(), LWMPOINT::geoms, GetPrepGeomCache(), 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, POSTGIS2GEOS(), and PrepGeomCache::prepared_geom.

Referenced by containsproperly(), lwt_AddPolygon(), and rt_raster_compute_skewed_raster().

1953 {
1954  GSERIALIZED *geom1;
1955  GSERIALIZED *geom2;
1956  int result;
1957  GBOX box1, box2;
1958  PrepGeomCache *prep_cache;
1959 
1960  geom1 = PG_GETARG_GSERIALIZED_P(0);
1961  geom2 = PG_GETARG_GSERIALIZED_P(1);
1962 
1963  /* A.Covers(Empty) == FALSE */
1964  if ( gserialized_is_empty(geom1) || gserialized_is_empty(geom2) )
1965  PG_RETURN_BOOL(false);
1966 
1967  errorIfGeometryCollection(geom1,geom2);
1969 
1970  /*
1971  * short-circuit 1: if geom2 bounding box is not completely inside
1972  * geom1 bounding box we can prematurely return FALSE.
1973  */
1974  if ( gserialized_get_gbox_p(geom1, &box1) &&
1975  gserialized_get_gbox_p(geom2, &box2) )
1976  {
1977  if ( ! gbox_contains_2d(&box1, &box2) )
1978  {
1979  PG_RETURN_BOOL(FALSE);
1980  }
1981  }
1982  /*
1983  * short-circuit 2: if geom2 is a point and geom1 is a polygon
1984  * call the point-in-polygon function.
1985  */
1986  if (is_poly(geom1) && is_point(geom2))
1987  {
1988  GSERIALIZED* gpoly = is_poly(geom1) ? geom1 : geom2;
1989  GSERIALIZED* gpoint = is_point(geom1) ? geom1 : geom2;
1990  RTREE_POLY_CACHE* cache = GetRtreeCache(fcinfo, gpoly);
1991  int retval;
1992 
1993  POSTGIS_DEBUG(3, "Point in Polygon test requested...short-circuiting.");
1994  if (gserialized_get_type(gpoint) == POINTTYPE)
1995  {
1996  LWGEOM* point = lwgeom_from_gserialized(gpoint);
1997  int pip_result = pip_short_circuit(cache, lwgeom_as_lwpoint(point), gpoly);
1998  lwgeom_free(point);
1999 
2000  retval = (pip_result != -1); /* not outside */
2001  }
2002  else if (gserialized_get_type(gpoint) == MULTIPOINTTYPE)
2003  {
2005  uint32_t i;
2006 
2007  retval = LW_TRUE;
2008  for (i = 0; i < mpoint->ngeoms; i++)
2009  {
2010  int pip_result = pip_short_circuit(cache, mpoint->geoms[i], gpoly);
2011  if (pip_result == -1)
2012  {
2013  retval = LW_FALSE;
2014  break;
2015  }
2016  }
2017 
2018  lwmpoint_free(mpoint);
2019  }
2020  else
2021  {
2022  /* Never get here */
2023  elog(ERROR,"Type isn't point or multipoint!");
2024  PG_RETURN_NULL();
2025  }
2026 
2027  PG_FREE_IF_COPY(geom1, 0);
2028  PG_FREE_IF_COPY(geom2, 1);
2029  PG_RETURN_BOOL(retval);
2030  }
2031  else
2032  {
2033  POSTGIS_DEBUGF(3, "Covers: type1: %d, type2: %d", gserialized_get_type(geom1), gserialized_get_type(geom2));
2034  }
2035 
2036  initGEOS(lwpgnotice, lwgeom_geos_error);
2037 
2038  prep_cache = GetPrepGeomCache( fcinfo, geom1, 0 );
2039 
2040  if ( prep_cache && prep_cache->prepared_geom && prep_cache->argnum == 1 )
2041  {
2042  GEOSGeometry *g1 = (GEOSGeometry *)POSTGIS2GEOS(geom2);
2043  if ( 0 == g1 ) /* exception thrown at construction */
2044  {
2045  HANDLE_GEOS_ERROR("First argument geometry could not be converted to GEOS");
2046  PG_RETURN_NULL();
2047  }
2048  result = GEOSPreparedCovers( prep_cache->prepared_geom, g1);
2049  GEOSGeom_destroy(g1);
2050  }
2051  else
2052  {
2053  GEOSGeometry *g1;
2054  GEOSGeometry *g2;
2055 
2056  g1 = (GEOSGeometry *)POSTGIS2GEOS(geom1);
2057  if ( 0 == g1 ) /* exception thrown at construction */
2058  {
2059  HANDLE_GEOS_ERROR("First argument geometry could not be converted to GEOS");
2060  PG_RETURN_NULL();
2061  }
2062  g2 = (GEOSGeometry *)POSTGIS2GEOS(geom2);
2063  if ( 0 == g2 ) /* exception thrown at construction */
2064  {
2065  HANDLE_GEOS_ERROR("Second argument geometry could not be converted to GEOS");
2066  GEOSGeom_destroy(g1);
2067  PG_RETURN_NULL();
2068  }
2069  result = GEOSRelatePattern( g1, g2, "******FF*" );
2070  GEOSGeom_destroy(g1);
2071  GEOSGeom_destroy(g2);
2072  }
2073 
2074  if (result == 2)
2075  {
2076  HANDLE_GEOS_ERROR("GEOSCovers");
2077  PG_RETURN_NULL(); /* never get here */
2078  }
2079 
2080  PG_FREE_IF_COPY(geom1, 0);
2081  PG_FREE_IF_COPY(geom2, 1);
2082 
2083  PG_RETURN_BOOL(result);
2084 
2085 }
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:398
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:69
const GEOSPreparedGeometry * prepared_geom
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:1063
#define MULTIPOINTTYPE
Definition: liblwgeom.h:87
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:369
LWPOINT * lwgeom_as_lwpoint(const LWGEOM *lwgeom)
Definition: lwgeom.c:93
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:153
void lwmpoint_free(LWMPOINT *mpt)
Definition: lwmpoint.c:72
void lwgeom_geos_error(const char *fmt,...)
#define LW_FALSE
Definition: liblwgeom.h:76
#define LW_TRUE
Return types for functions with status returns.
Definition: liblwgeom.h:75
LWPOINT ** geoms
Definition: liblwgeom.h:469
#define FALSE
Definition: dbfopen.c:168
GEOSGeometry * POSTGIS2GEOS(GSERIALIZED *pglwgeom)
#define POINTTYPE
LWTYPE numbers, used internally by PostGIS.
Definition: liblwgeom.h:84
LWMPOINT * lwgeom_as_lwmpoint(const LWGEOM *lwgeom)
Definition: lwgeom.c:165
PrepGeomCache * GetPrepGeomCache(FunctionCallInfoData *fcinfo, GSERIALIZED *g1, GSERIALIZED *g2)
Given a couple potential geometries and a function call context, return a prepared structure for one ...
#define HANDLE_GEOS_ERROR(label)
RTREE_POLY_CACHE * GetRtreeCache(FunctionCallInfoData *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:467
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:83
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: