DATASERV (kappserv) functions
LIBRARY ROUTINE
kpds_destroy_map - destroy the map segment in a data object.
LIBRARY CALL
int kpds_destroy_map(
kobject object)
INPUT
- object - object from which to remove the map segment.
OUTPUT
none
RETURN VALUE
TRUE if the map segment is successfully destroyed,
FALSE otherwise
DESCRIPTION
This function is used to destroy the map segment
contained within an object. Once the map segment
has been destroyed, any data or attributes associated
with the map data will be lost forever. A new
map segment can be created in its place with the
function kpds_create_map.
If the mapping mode is set to map the data.
then this function will not destroy the map. This is
because destroying the map when operating in this
mode would cause an inconsistency in the
interpretation of the value data. KPDS_MAPPING_MODE
is an attribute which, when set to KMAPPED, causes
the map data to be unmapped into the value data. For
example, if you are operating on a pseudo-colored
image, and set mapping mode, the result will be that
the value data will appear to be a true-color image.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$DATASERV/objects/library/kappserv/src/pds_map.c
SEE ALSO
kappserv(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.