DATASERV (kappserv) library
LIBRARY NAME
kappserv - (no short description specified)
DESCRIPTION
The upper level of data services is organized into a series of
application-specific services, each with its own data model. Each
data model covers the needs of either a specific domain or of a number
of similar domains. Note that even though the data models of each
application service differ, the underlying philosophy, design, and API
of every service is similar. This means that once you've learned one
application service, you should be able to easily learn the other
application services simply by understanding their data models.
There are currently three application data services;
polymorphic services, \fPgeometry services\fP, and color
services. Polymorphic services is designed to cover the majority
of application-domains; the polymorphic data model can store anything
from signals to images and from animations to volumes. Geometry
services is designed to cover the specific needs of the geometry
domain; the geometry model provides a range of geometric primitives
such as triangles and spheres, in addition to a number of volumetric
primitives. Color services is an extension to polymorphic services
with very specific functionality relating to colormaps. Note that the
data models of these services overlap wherever possible. This overlap
allows processing routines written to one service to operate
transparently on data from the other services.
The kappserv library contains the functions associated with all
three of polymorphic services, \fPgeometry services\fP, and color
services.
LIST OF LIBRARY FUNCTIONS
- kcolor_get_attribute
- get the values of a color attribute from a data object.
- kcolor_get_attributes
- get multiple color attributes from a data object.
- kcolor_set_attribute
- set the value of a color attribute in a data object.
- kcolor_set_attributes
- set multiple color attributes in a data object.
- kcolor_match_attribute
- compare a color attribute between two data objects.
- kcolor_match_attributes
- compare multiple attributes between two objects.
- kcolor_copy_attribute
- copy a color attribute from one data object to another.
- kcolor_copy_attributes
- copy multiple attributes from one object to another.
- kcolor_query_attribute
- query characteristics of a color attribute.
- kcolor_print_attribute
- print the value of a color attribute from a data object.
- lkcolorconvert
- The routine lkcolorconvert() is used to perform a colorspace conversion on an input object. Currently, this routine is invoked when the KCOLOR_ COLORSPACE attribute is called, however, is setup so that it can be called if needed. Currently, this routine enforces data ranges which correspond to the converted colormodel. This means that the output image may not be in the correct range for viewing.
- kcolor_gamut_object
- perform color quantization of 1..4 plane images
- kpds_create_location
- create a location segment within a data object.
- kpds_query_location
- determine if the location segment exists in a data object.
- kpds_destroy_location
- destroy the location segment in a data object.
- kpds_initialize_location
- preset location segment to constant
- kpds_copy_location_data
- copy all location data from one object to another object.
- kpds_copy_location_attr
- copy all location attributes from one object to another object.
- kpds_copy_location
- copy the location segment from one object to another.
- kpds_create_map
- create a map segment within a data object.
- kpds_query_map
- determine if the map segment exists in a data object.
- kpds_destroy_map
- destroy the map segment in a data object.
- kpds_initialize_map
- preset map segment to constant
- kpds_copy_map_data
- copy all map data from one object to another object.
- kpds_copy_map_attr
- copy all map attributes from one object to another object.
- kpds_copy_map
- copy the map segment from one object to another.
- kpds_create_mask
- create a mask segment within a data object.
- kpds_query_mask
- determine if the mask segment exists in a data object.
- kpds_destroy_mask
- destroy the mask segment in a data object.
- kpds_initialize_mask
- preset mask segment to constant
- kpds_copy_mask_data
- copy all mask data from one object to another object.
- kpds_copy_mask_attr
- copy all mask attributes from one object to another object.
- kpds_copy_mask
- copy the mask segment from one object to another.
- kpds_create_time
- create a time segment within a data object.
- kpds_query_time
- determine if the time segment exists in a data object.
- kpds_destroy_time
- destroy the time segment in a data object.
- kpds_initialize_time
- preset time segment to constant
- kpds_copy_time_data
- copy all time data from one object to another object.
- kpds_copy_time_attr
- copy all time attributes from one object to another object.
- kpds_copy_time
- copy the time segment from one object to another.
- kpds_create_value
- create a value segment within a data object.
- kpds_query_value
- determine if the value segment exists in a data object.
- kpds_destroy_value
- destroy the value segment in a data object.
- kpds_initialize_value
- preset value segment to constant
- kpds_copy_value_data
- copy all value data from one object to another object.
- kpds_copy_value_attr
- copy all value attributes from one object to another object.
- kpds_copy_value
- copy the value segment from one object to another.
- kpds_get_attribute
- get the value of an attribute from a data object
- kpds_get_attributes
- get the values of multiple attributes from a data object
- kpds_set_attribute
- set the values of an attribute in a data object
- kpds_set_attributes
- set the values of multiple attributes in a data object.
- kpds_match_attribute
- returns TRUE if the same attribute in two objects match.
- kpds_match_attributes
- returns true if the list of segment attributes in two objects match.
- kpds_copy_attribute
- copy an attribute from one object to another
- kpds_copy_attributes
- copy multiple attributes from one object to another.
- kpds_query_attribute
- get information about an attribute
- kpds_print_attribute
- print the value of an attribute from a data object.
- kpds_open_object
- create an object associated with an input or output transport.
- kpds_reference_object
- create a reference of a data object.
- kpds_copy_global_attr
- copy all global attributes from one data object to another.
- kpds_copy_object_attr
- copy all presentation attributes from one data object to another.
- kpds_list_output_formats
- list all polymorphic output formats
- kpds_get_data
- retrieve data from a segment in a data object.
- kpds_put_data
- store a unit of data to a segment in a data object.
- kpds_open_input_object
- open an input object for reading
- kpds_open_output_object
- open an output object for writing
- kpds_create_object
- create a temporary data object.
- kpds_close_object
- close an open data object.
- kpds_sync_object
- synchronize physical and presentation layers of a data object.
- kpds_copy_object_data
- copy all data from one object to another object.
- kpds_create_object_attr
- create an attribute associated the data object.
- kpds_destroy_object_attr
- destroy an attribute associated with the data object.
- kpds_copy_object
- copy all data and attributes from one object to another.
- kpds_copy_remaining_data
- copy remaining data from source to destination
- kpds_history_string
- get the command line arguments
ADDITIONAL INFORMATION
LOCATION OF SOURCE FILES
$DATASERV/objects/library/kappserv/src
LOCATION OF PUBLIC INCLUDE FILE
$DATASERV/include/kappserv/kappserv.h
YOU MUST INCLUDE
#include <dataserv.h>
SEE ALSO
Also see the documentation for the kdataman library.
SEE MANUAL
The kappserv library is documented as Polymorphic Data Services,
Geometry Services, and Color Services in Volume II of the Programming
Services Manuals.
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.