DATASERV (kgeom) functions


LIBRARY ROUTINE

kgeom_finish_writing_object - write the last part of a geometry object

LIBRARY CALL

int
kgeom_finish_writing_object(kgeom_object *object)

INPUT

OUTPUT

none

RETURN VALUE

TRUE on success, FALSE otherwise

DESCRIPTION

This routine will terminate the primitive list by writing a -1 to an open fid. It will then write out all the object specific information.

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.

The first part of a geometry object should have already been written by a call to kgeom_start_writing_object(). That call would have written any information which would be needed to later read the geometry primitive data. Specifically, the layout, location_dim, texture_coord_dim, and has_alpha fields of the object would already have been written out as the first part of the object.

All other information contained within the geometry object is written after the primitives by this call.

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.