DATASERV (kgeom) functions


LIBRARY ROUTINE

kgeom_read_object - read a geometry object

LIBRARY CALL

kgeom_object *
kgeom_read_object(char *filename)

INPUT

OUTPUT

none

RETURN VALUE

pointer to a new geometry object containing the geometry data contained in the file, NULL otherwise

DESCRIPTION

This function will read an entire geometry object object from the specified file.

If the file does not contain a valid geometry object, then it will be closed and nothing will be returned. If it does contain a valid header, then a new object containing the geometry data from the file will be returned.

ADDITIONAL INFORMATION

If the geometry set being read is too large to fit into memory, a series of incremental calls can be made to read in an object one primitive at a time. See the kgeom_read_primitive() man page for more details on this capability.

EXAMPLES

The following code would be used to read in a geometry object from the file "data.kgm":

kgeom_object *geom;

geom = kgeom_read_object("data.kgm");

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

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

SEE ALSO

kgeom(3), kgeom_write_object, kgeom_new_object, kgeom_blast_object

COPYRIGHT

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