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.