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

OUTPUT

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.