DATASERV (kgeom) functions


LIBRARY ROUTINE

kgeom_start_writing_object - write the first part of a geometry object

LIBRARY CALL

int
kgeom_start_writing_object(kgeom_object *object)

INPUT

OUTPUT

none

RETURN VALUE

TRUE on success, FALSE otherwise

DESCRIPTION

This routine will write the first part of a geometry object to the open fid. It should be followed by a write of all the primitives, and then by a finish of 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.

The first part of a geometry object contains information which will be needed to later read the geometry primitive data. Specifically, the layout, location_dim, texture_coord_dim, and has_alpha fields are written as the first part of the object.

All other information contained within the geometry object is written after the primitives by the kgeom_finish_writing_object() 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), kgeom_finish_writing_object, kgeom_write_primitive

COPYRIGHT

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