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

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.