DATASERV (kgeom) functions


LIBRARY ROUTINE

kgeom_write_object_and_primitives - write a geometry object and all of its primitives

LIBRARY CALL

int
kgeom_write_object_and_primitives(kgeom_object *object)

INPUT

OUTPUT

none

RETURN VALUE

TRUE on success, FALSE otherwise

DESCRIPTION

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

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

This function is equivalent to calling the function kgeom_start_writing_object(), followed by a call to kgeom_write_primitive() for each primitive on the object's primitive list, followed by a call to kgeom_finish_writing_object() to terminate the primitive list and write all the object-specific information.

The fid internal to the geometry object specifies the file to which the the object will be written. In general, this fid is set when the geometry header is written by the kgeom_write_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.