DATASERV (kgeom) functions
LIBRARY ROUTINE
kgeom_copy_object - copy a geometry object
LIBRARY CALL
kgeom_object *
kgeom_copy_object(kgeom_object *object, kgeom_object *new_object)
INPUT
- object - geometry object to copy
OUTPUT
- new_object - a pointer to geometry object that will
serve as a destination for the copy. If
NULL, then a new destination object will
be allocated.
RETURN VALUE
copy of object
DESCRIPTION
This function will copy the given geometry
object, creating a duplicate of the object as well as
of all the object's primitives. All the data contained in
each of the object's primitives will be copied as well.
If desired, a preallocated object can be provided as
the destination for the copy. Any data or primitives
which may have existed in the destination prior to
calling this routine will be destroyed.
If no destination object is provided, one will be
allocated and returned.
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_object, kgeom_new_object, kgeom_blast_object,
kgeom_write_object, kgeom_read_object, kgeom_primitive, kgeom_new_primitive,
kgeom_add_primitive, kgeom_get_primitive, kgeom_remove_primitive,
kgeom_number_primitives
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.