DATASERV (kgeom) functions


LIBRARY ROUTINE

kgeom_new_location_dim - cast a geometry object to one with a new location dimensionality

LIBRARY CALL

kgeom_object *
kgeom_new_location_dim(
   kgeom_object *object, 
   int           new_location_dim)

INPUT

OUTPUT

none

RETURN VALUE

a pointer to the cast object on success, NULL on failure

DESCRIPTION

This function will "cast" an existing geometry object to have a new location dimensionality. If the requested location dimensionality is different than the location dimensionality of the provided object, then a new object is returned which matches the original object, but has the requested location dimensionality.

Specifically, this routine will adjust the size of the location vectors in each primitive of the given object to the requested location dimensionailty.

This function is intended to simplify processing. For example, a routine which only wants 2D location data can use this function to guarantee that the geometry it will process has only 2D data.

The cast geometry object is a distinct from the original geometry object; it is constructed by first making a copy of the original geometry object and then resizing all the location vectors. The original object will be destroyed after the copy. If there are no changes necessary, then the original object will be returned.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATASERV/objects/library/kgeom/src/cast.c

SEE ALSO

kgeom(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.