DATASERV (kgeom) functions


LIBRARY ROUTINE

kgeom_read_object_and_primitives - read a geometry object and all of its primitives

LIBRARY CALL

int
kgeom_read_object_and_primitives(kgeom_object *object)

INPUT

OUTPUT

none

RETURN VALUE

TRUE on success, FALSE otherwise

DESCRIPTION

This routine will read an object and all of its primitives from the open fid specified within the object.

In general, the kgeom_read_object() function should be used instead of this function. This function has been made public to provide complete flexibility for reading a geometry object. It should only be used when you wish to read a geometry object primitive-by-primitive. More information on this is available in the kgeom_read_primitive() man page.

This function is equivalent to calling the function kgeom_start_reading_object(), followed by a call to kgeom_read_primitive() for each primitive on the object's primitive list, followed by a call to kgeom_finish_reading_object() read all the object-specific information.

The fid internal to the geometry object specifies the file from which the the object will be read. In general, this fid is set when the geometry header is read by the kgeom_read_header() function.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

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

SEE ALSO

kgeom(3)

COPYRIGHT

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