KCMAP(3)

PACKAGE
kcmap - Routines to manipulate colourmaps

PURPOSE
These routines are meant to provide a high level mechanism to create and manipulate colourmaps, complete with colourmap sharing, dynamic allocation and event management.

LIBRARY
karma

LINK WITH
-lkarma

FUNCTIONS

kcmap_initialise
    This routine will initialise the package.

kcmap_va_create
    Create a high level colourmap.

kcmap_destroy
    Destroy a colourmap.

kcmap_register_destroy_func
    Register destroy callback.

kcmap_add_RGB_func
    Register a new colourmap function.

kcmap_add_grey_func
    Register a new colourmap function.

kcmap_register_resize_func
    Register a colourmap resize function.

kcmap_register_modify_func
    Register a colourmap modify function.

kcmap_change
    Change active colourmap function.

kcmap_modify
    Change colours in a colourmap.

kcmap_modify_direct_type
    Change colours in a colourmap.

kcmap_list_funcs
    Get list of colourmap functions.

kcmap_get_funcs_for_cmap
    Get list of colourmap functions compatible with a colourmap.

kcmap_get_active_func
    Get active colourmap function.

kcmap_get_pixels
    Get pixel values in a colourmap.

kcmap_notify_pixels_changed
    Notify that pixel values have been changed.

kcmap_get_pixel
    This routine will get a numbered pixel value from a colourmap.

kcmap_prepare_for_slavery
    Allow colourmap to be slaved.

kcmap_prepare_for_mastery
    Allow colourmap to be slaved.

kcmap_copy_to_struct
    Copy colour data from a colourmap.

kcmap_copy_from_struct
    Copy colour data into a colourmap.

kcmap_get_rgb_value
    Get colour data from a colourmap.

kcmap_get_rgb_values
    Get colour data from a colourmap.

kcmap_read_rgb_values
    Get RGB values in a colourmap.

kcmap_write_rgb_values
    Write RGB values to a colourmap.

kcmap_get_attributes
    This routine will get the attributes for a colourmap.

kcmap_set_attributes
    This routine will set the attributes for a colourmap.

kcmap_register_att_notify_func
    Register an attribute change function.

kcmap_get_dpy_handle
    Get the Kdisplay object for a colourmap.

kcmap_PROTO_alloc_func
    Allocate colourcells.

kcmap_PROTO_free_func
    Free colourcells.

kcmap_PROTO_store_func
    This routine will store colours into a low level colourmap.

kcmap_PROTO_location_func
    Get location of display.

kcmap_PROTO_colour_func
    Modify colour values.

kcmap_PROTO_grey_func
    Modify greyscale colour values.

kcmap_PROTO_destroy_func
    Process a destroy event for an object.

kcmap_PROTO_modify_func
    This routine registers a change in the colourmap values.

kcmap_PROTO_att_notify_func
    This routine registers a change in the attributes of a colourmap.

TABLE kcmap_ATTRIBUTES
List of attributes for Kcolourmap objects
Name Get Type Set Type Meaning
KCMAP_ATT_END End of varargs list
KCMAP_ATT_REVERSE flag * flag Reverse pixel order
KCMAP_ATT_INVERT flag * flag Invert intensities
KCMAP_ATT_SOFTWARE flag * Test if software
colourmap
KCMAP_ATT_DPY_HANDLE Kdisplay * Get display handle
KCMAP_ATT_DIRECT_VISUAL flag * flag Handle colourmap as for
a direct visual type
KCMAP_ATT_RED_SCALE unsigned int * unsigned int Red scale
KCMAP_ATT_GREEN_SCALE unsigned int * unsigned int Green scale
KCMAP_ATT_BLUE_SCALE unsigned int * unsigned int Blue scale
KCMAP_ATT_STEAL_COLOURS_FROM unsigned int * unsigned int Colourmap to steal colours from

AUTHOR
Richard Gooch (rgooch@atnf.csiro.au)

AVAILABLITY
The Karma Distribution is available for anonymous ftp from: ftp://ftp.atnf.csiro.au/pub/software/karma/ ftp://wuarchive.wustl.edu/graphics/graphics/packages/karma/ ftp://ftp.pwr.wroc.pl/pub/karma/ The Karma Home Page is: http://www.atnf.csiro.au/karma/