DATAMANIP (ksegops) library


LIBRARY NAME

ksegops - the ksegops library

DESCRIPTION

The ksegops library (libksegops.a) contains general data segment operators. These functions do not enforce the relationships defined by the polymorphic data model. Operations include moving, copying, inserting and deleting segments, data conversion, ASCII and raw data import, and data object comparison. The ksegops operators are implemented using the data management services, which is a part of the Khoros 2.0 kdms library.

The function calls in ksegops should have no side effects on the source objects passed into them, and should only affect those segments and attributes of the destination object that the operation needs to modify. For example, if a destination object is passed in that already has value, mask, and geometry data, and a multiplication operation is performed on the source value data, the destination mask and geometry data will not be modified, and will remain intact.

Each function call frees all memory that has been allocated within the call, and closes all temporary objects that were opened within the call. The function call will not free memory or close objects that were passed into it.

ALL programs that utilize these function calls MUST include the statement:

#include <datamanip.h>

DISCLAIMER \(em WARNING The ksegops library is in its first prototype stage, therefore, the behavior and API of these functions may change in the future.

LIST OF LIBRARY FUNCTIONS

lkconvert
convert, offset, and/or scale data in specified segment
lkcpfromval
copy data from value into specified segment
lkcpseg
copy segments from source to destination object
lkcptoval
copy data from specified segment into value segment
lkimportasc
import ASCII data into specified segment of data object
lkimportraw
import raw binary data into a data segment
lkinsertseg
insert segment(s) from one object into another
lkrmseg
delete specified segments from an object creating new object
lksegcmp
compare two data segments
lksegcmp_attributes
compare segment and/or global attributes of two objects

ADDITIONAL INFORMATION

LOCATION OF SOURCE FILES

$DATAMANIP/objects/library/ksegops/src

LOCATION OF PUBLIC INCLUDE FILE

$DATAMANIP/include/ksegops/ksegops.h

YOU MUST INCLUDE

#include <datamanip.h>

SEE ALSO

Also see the documentation for the kdataserv library.

SEE MANUAL

The data services libraries are documented in Chapter 6, "Introduction To Data Services", Chapter 7, "Image Services", Chapter 8, "Numerical Services", Chapter 9, "Polymorphic Services", Chapter 10, "Geometry Services and Chapter 11, "Data Services" all in the Khoros Program Services Manual.

COPYRIGHT

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