DATASERV (kgeom) functions
LIBRARY ROUTINE
kgeom_read_object - read a geometry object
LIBRARY CALL
kgeom_object *
kgeom_read_object(char *filename)
INPUT
- filename - filename to read geometry from
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.