DATASERV (koldgeom) functions


LIBRARY ROUTINE

kgeom_copy_data - copy all the data from one data object to another.

LIBRARY CALL

int kgeom_copy_data(
   kobject source_object,
   kobject destination_object)

INPUT

OUTPUT

RETURN VALUE

TRUE (1) on success, FALSE (0) otherwise

DESCRIPTION

kgeom_copy_data is part of Geometry Data Services. This function copies all the data associated with source_object to the destination_object. This means that all the data will be copied not just the value, mask and map data. For example, the source object may contain data that one of the other services (geometry, numerical, etc.) use. These will also be copied.

This routine will create all the data in the destination_object that do not exist. It will initialize some of the presentation and physical attributes to those of the copied data. It will remove and replace any source object that already exist in the destination object. In this case, the copy will not change the physical attributes of the data, but will automatically translate the data. For example, if the original size of the data in the destination_object is different than the size in the source_object then subsampling or supersampling will be performed to resize the data so that it fits.

Geometry Services attempts to minimize the number of attributes that are copied with the data, as there is another function for that purpose (kgeom_copy_attributes). However, as mentioned above, there are cases when it is necessary to copy certain attributes that are critical to the interpretation of the data. However, this will only occur when the destination does not have the data being copied.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATASERV/include/koldgeom/kgeometry.h

SEE ALSO

koldgeom(3)

COPYRIGHT

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