covers()

Datum covers

(

PG_FUNCTION_ARGS

)

Definition at line 2023 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().

{
        GSERIALIZED *geom1;
        GSERIALIZED *geom2;
        int result;
        GBOX box1, box2;
        PrepGeomCache *prep_cache;

        geom1 = PG_GETARG_GSERIALIZED_P(0);
        geom2 = PG_GETARG_GSERIALIZED_P(1);

        /* A.Covers(Empty) == FALSE */
        if ( gserialized_is_empty(geom1) || gserialized_is_empty(geom2) )
                PG_RETURN_BOOL(false);

        errorIfGeometryCollection(geom1,geom2);
        error_if_srid_mismatch(gserialized_get_srid(geom1), gserialized_get_srid(geom2));

        /*
         * short-circuit 1: if geom2 bounding box is not completely inside
         * geom1 bounding box we can prematurely return FALSE.
         */
        if ( gserialized_get_gbox_p(geom1, &box1) &&
                gserialized_get_gbox_p(geom2, &box2) )
        {
                if ( ! gbox_contains_2d(&box1, &box2) )
                {
                        PG_RETURN_BOOL(FALSE);
                }
        }
        /*
         * short-circuit 2: if geom2 is a point and geom1 is a polygon
         * call the point-in-polygon function.
         */
        if (is_poly(geom1) && is_point(geom2))
        {
                GSERIALIZED* gpoly  = is_poly(geom1) ? geom1 : geom2;
                GSERIALIZED* gpoint = is_point(geom1) ? geom1 : geom2;
                RTREE_POLY_CACHE* cache = GetRtreeCache(fcinfo, gpoly);
                int retval;

                POSTGIS_DEBUG(3, "Point in Polygon test requested...short-circuiting.");
                if (gserialized_get_type(gpoint) == POINTTYPE)
                {
                        LWGEOM* point = lwgeom_from_gserialized(gpoint);
                        int pip_result = pip_short_circuit(cache, lwgeom_as_lwpoint(point), gpoly);
                        lwgeom_free(point);

                        retval = (pip_result != -1); /* not outside */
                }
                else if (gserialized_get_type(gpoint) == MULTIPOINTTYPE)
                {
                        LWMPOINT* mpoint = lwgeom_as_lwmpoint(lwgeom_from_gserialized(gpoint));
                        uint32_t i;

                        retval = LW_TRUE;
                        for (i = 0; i < mpoint->ngeoms; i++)
                        {
                                int pip_result = pip_short_circuit(cache, mpoint->geoms[i], gpoly);
                                if (pip_result == -1)
                                {
                                        retval = LW_FALSE;
                                        break;
                                }
                        }

                        lwmpoint_free(mpoint);
                }
                else
                {
                        /* Never get here */
                        elog(ERROR,"Type isn't point or multipoint!");
                        PG_RETURN_NULL();
                }

                PG_FREE_IF_COPY(geom1, 0);
                PG_FREE_IF_COPY(geom2, 1);
                PG_RETURN_BOOL(retval);
        }
        else
        {
                POSTGIS_DEBUGF(3, "Covers: type1: %d, type2: %d", gserialized_get_type(geom1), gserialized_get_type(geom2));
        }

        initGEOS(lwpgnotice, lwgeom_geos_error);

        prep_cache = GetPrepGeomCache( fcinfo, geom1, 0 );

        if ( prep_cache && prep_cache->prepared_geom && prep_cache->argnum == 1 )
        {
                GEOSGeometry *g1 = (GEOSGeometry *)POSTGIS2GEOS(geom2);
                if ( 0 == g1 )   /* exception thrown at construction */
                {
                        HANDLE_GEOS_ERROR("First argument geometry could not be converted to GEOS");
                        PG_RETURN_NULL();
                }
                result = GEOSPreparedCovers( prep_cache->prepared_geom, g1);
                GEOSGeom_destroy(g1);
        }
        else
        {
                GEOSGeometry *g1;
                GEOSGeometry *g2;

                g1 = (GEOSGeometry *)POSTGIS2GEOS(geom1);
                if ( 0 == g1 )   /* exception thrown at construction */
                {
                        HANDLE_GEOS_ERROR("First argument geometry could not be converted to GEOS");
                        PG_RETURN_NULL();
                }
                g2 = (GEOSGeometry *)POSTGIS2GEOS(geom2);
                if ( 0 == g2 )   /* exception thrown at construction */
                {
                        HANDLE_GEOS_ERROR("Second argument geometry could not be converted to GEOS");
                        GEOSGeom_destroy(g1);
                        PG_RETURN_NULL();
                }
                result = GEOSRelatePattern( g1, g2, "******FF*" );
                GEOSGeom_destroy(g1);
                GEOSGeom_destroy(g2);
        }

        if (result == 2)
        {
                HANDLE_GEOS_ERROR("GEOSCovers");
                PG_RETURN_NULL(); /* never get here */
        }

        PG_FREE_IF_COPY(geom1, 0);
        PG_FREE_IF_COPY(geom2, 1);

        PG_RETURN_BOOL(result);

}

Here is the call graph for this function:

Here is the caller graph for this function: