mvt_geom()

LWGEOM* mvt_geom	(	LWGEOM *	lwgeom,
		const GBOX *	gbox,
		uint32_t	extent,
		uint32_t	buffer,
		bool	clip_geom
	)

Transform a geometry into vector tile coordinate space.

Makes best effort to keep validity. Might collapse geometry into lower dimension.

NOTE: modifies in place if possible (not currently possible for polygons)

Definition at line 933 of file mvt.c.

{
        AFFINE affine = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
        gridspec grid = {0, 0, 0, 0, 1, 1, 0, 0};
        double width = gbox->xmax - gbox->xmin;
        double height = gbox->ymax - gbox->ymin;
        double fx, fy;
        const uint8_t basic_type = lwgeom_get_basic_type(lwgeom);
        int preserve_collapsed = LW_FALSE;
        POSTGIS_DEBUG(2, "mvt_geom called");
 
        /* Simplify it as soon as possible */
        lwgeom = lwgeom_to_basic_type(lwgeom, basic_type);
 
        /* Short circuit out on EMPTY */
        if (lwgeom_is_empty(lwgeom))
                return NULL;
 
        fx = extent / width;
        fy = -(extent / height);
 
        /* If geometry has disappeared, you're done */
        if (lwgeom_is_empty(lwgeom))
                return NULL;
 
        /* transform to tile coordinate space */
        affine.afac = fx;
        affine.efac = fy;
        affine.ifac = 1;
        affine.xoff = -gbox->xmin * fx;
        affine.yoff = -gbox->ymax * fy;
        lwgeom_affine(lwgeom, &affine);
 
        /* Snap to integer precision, removing duplicate points */
        lwgeom_grid_in_place(lwgeom, &grid);
 
        /* Remove points on straight lines */
        lwgeom_simplify_in_place(lwgeom, 0, preserve_collapsed);
 
        /* Remove duplicates in multipoints */
        if (lwgeom->type == MULTIPOINTTYPE)
                lwgeom_remove_repeated_points_in_place(lwgeom, 0);
 
        if (!lwgeom || lwgeom_is_empty(lwgeom))
                return NULL;
 
        lwgeom = mvt_clip_and_validate(lwgeom, basic_type, extent, buffer, clip_geom);
        if (!lwgeom || lwgeom_is_empty(lwgeom))
                return NULL;
 
        return lwgeom;
}

References AFFINE::afac, buffer(), AFFINE::efac, AFFINE::ifac, LW_FALSE, lwgeom_affine(), lwgeom_get_basic_type(), lwgeom_grid_in_place(), lwgeom_is_empty(), lwgeom_remove_repeated_points_in_place(), lwgeom_simplify_in_place(), lwgeom_to_basic_type(), MULTIPOINTTYPE, mvt_clip_and_validate(), LWGEOM::type, GBOX::xmax, GBOX::xmin, AFFINE::xoff, GBOX::ymax, GBOX::ymin, and AFFINE::yoff.

Referenced by ST_AsMVTGeom().

Here is the call graph for this function:

Here is the caller graph for this function: