gserialized_datum_get_box2df_p()

int gserialized_datum_get_box2df_p	(	Datum	gsdatum,
		BOX2DF *	box2df
	)

Peak into a GSERIALIZED datum to find the bounding box.

If the box is there, copy it out and return it. If not, calculate the box from the full object and return the box based on that. If no box is available, return LW_FAILURE, otherwise LW_SUCCESS.

Definition at line 450 of file gserialized_gist_2d.c.

{
        GSERIALIZED *gpart;
        int result = LW_SUCCESS;
 
        POSTGIS_DEBUG(4, "entered function");
 
        /*
        ** Because geometry is declared as "storage = main" anything large
        ** enough to take serious advantage of PG_DETOAST_DATUM_SLICE will have
        ** already been compressed, which means the entire object will be
        ** fetched and decompressed before a slice is taken, thus removing
        ** any efficiencies gained from slicing.
        ** As of Pg12 we can partially decompress a toasted object
        ** (though we still need to fully retrieve it from TOAST)
        ** which makes slicing worthwhile.
        */
        gpart = (GSERIALIZED*)PG_DETOAST_DATUM(gsdatum);
 
        POSTGIS_DEBUGF(4, "got flags %d", gpart->gflags);
 
        /* Do we even have a serialized bounding box? */
        if (gserialized_has_bbox(gpart))
        {
                /* Yes! Copy it out into the box! */
                size_t box_ndims;
                const float *f = gserialized_get_float_box_p(gpart, &box_ndims);
 
                POSTGIS_DEBUG(4, "copying box out of serialization");
                memcpy(box2df, f, sizeof(BOX2DF));
                result = LW_SUCCESS;
        }
        else
        {
                /* No, we need to calculate it from the full object. */
                GBOX gbox;
                gbox_init(&gbox);
 
                result = gserialized_get_gbox_p(gpart, &gbox);
                if ( result == LW_SUCCESS )
                {
                        result = box2df_from_gbox_p(&gbox, box2df);
                }
                else
                {
                        POSTGIS_DEBUG(4, "could not calculate bbox");
                }
        }
 
        POSTGIS_FREE_IF_COPY_P(gpart, gsdatum);
        POSTGIS_DEBUGF(4, "result = %d, got box2df %s", result, result == LW_SUCCESS ? box2df_to_string(box2df) : "NONE");
 
        return result;
}

References box2df_from_gbox_p(), box2df_to_string(), gbox_init(), GSERIALIZED::gflags, gserialized_get_float_box_p(), gserialized_get_gbox_p(), gserialized_has_bbox(), LW_SUCCESS, and POSTGIS_FREE_IF_COPY_P.

Referenced by geom2d_brin_inclusion_add_value(), gserialized_datum_predicate_2d(), gserialized_datum_predicate_box2df_geom_2d(), gserialized_distance_box_2d(), gserialized_distance_centroid_2d(), gserialized_gist_compress_2d(), gserialized_gist_consistent_2d(), gserialized_gist_distance_2d(), gserialized_spgist_compress_2d(), gserialized_spgist_inner_consistent_2d(), and gserialized_spgist_leaf_consistent_2d().

Here is the call graph for this function:

Here is the caller graph for this function: