DISPDATA(3)

PACKAGE
dispdata - Routines to manage display-able data

PURPOSE
These routines are meant to provide a high level mechanism to manage the display of data. NOTE: THIS PACKAGE IS WORK IN PROGRESS. THE INTERFACE MAY CHANGE IN THE NEXT RELEASE, POSSIBLY WITHOUT NOTICE.

LIBRARY
karmagraphics

LINK WITH
-lkarmagraphics

FUNCTIONS

dispdata_array_create_dataclass
    Initialise array data support for the package.

dispdata_array_clone_data
    Clone an array dataset.

dispdata_array_register_irange_change_func
    Register a function to be called the image itensity range changes

dispdata_array_convert_3coord
    Convert canvas co-ordinate to 3D dataset co-ordinate.

dispdata_init
    Initialise the package.

dispdata_get_classlist
    Get the list of supported dataclasses.

dispdata_register_data_create_func
    Register a function to be called when a dataobject is created.

dispdata_register_data_destroy_func
    Register a function to be called when a dataobject is destroyed.

dispdata_register_dataobject_destroy_func
    Register a function to be called when a dataobject is destroyed.

dispdata_set_dataclass_attributes
    Set global attributes for the a dataclass.

dispdata_get_dataclass_attributes
    Get global attributes for the a dataclass.

dispdata_create_window
    Create a display data window.

dispdata_destroy_window
    Destroy a display data window.

dispdata_register_window_destroy_func
    Register destroy callback.

dispdata_set_window_attributes
    Set the attributes for a window.

dispdata_get_window_attributes
    Get the attributes for a window object.

dispdata_get_num_windows
    Get the number of windows.

dispdata_refresh_window
    Refresh a window.

dispdata_get_num_blinkstates
    Get the number of blinkstates for a window.

dispdata_get_active_blinkstate
    Get the active KDisplayDataBlinkState for a window.

dispdata_get_first_window
    Get first window.

dispdata_get_prev_window
    Get previous window.

dispdata_get_next_window
    Get next window.

dispdata_get_window_index
    Get the index for a window.

dispdata_register_window_renumber_func
    Register renumber callback.

dispdata_create_dataobject
    Create a display data object (i.e. array, overlay, etc.).

dispdata_destroy_dataobject
    Destroy a display data object (i.e. array, overlay, etc.).

dispdata_get_dataobject_subclass
    Get the subclass for a KDisplayDataObject.

dispdata_set_data_attributes
    Set the attributes for a data object.

dispdata_get_data_attributes
    Get the attributes for a data object.

dispdata_associate_data_object
    Associate a named object with a data object.

dispdata_get_associated_data_object
    Get an associated named object for a data object.

dispdata_get_first_dataobject
    Get first data object for a dataclass.

dispdata_get_next_dataobject
    Get next data object.

dispdata_create_blinkstate
    Create a blink state object.

dispdata_destroy_blinkstate
    Destroy a blink state object.

dispdata_get_blinkstate_class
    Get the dataclass-specific object for a blink state.

dispdata_activate_blinkstate
    Make a blinkstate active (change window contents).

dispdata_test_blinkstate_active
    Test if blinkstate is the active one for its window.

dispdata_get_blinkstate_index
    Get the index for a blinkstate.

dispdata_copy_blinkstate
    Copy blink state.

dispdata_refresh_blinkstate
    Refresh the user interface for a blink state.

dispdata_get_blinkstate_info
    Get the arbitrary pointer for a blinkstate.

dispdata_register_blinkstate_funcs
    Register callback functions for a blinkstate.

dispdata_get_first_blinkstate
    Get first blinkstate for a window.

dispdata_get_last_blinkstate
    Get last blinkstate for a window.

dispdata_get_prev_blinkstate
    Get previous blinkstate for a window.

dispdata_get_next_blinkstate
    Get next blinkstate for a window.

dispdata_get_window_from_blinkstate
    Get the windor for a blinkstate.

dispdata_get_namelist
    Get the list of (sorted) data names for a dataclass.

dispdata_get_objectlist
    Get the list of (sorted) data objects for a dataclass.

dispdata_regenerate_namelist
    Regenerate the list of (sorted) data names for a dataclass.

dispdata_free_namelist
    Free the list of (sorted) data names for a dataclass.

dispdata_get_first_blinkentry
    Get the first blink entry for a blink state.

dispdata_get_next_blinkentry
    Get the next blink entry after a specified entry.

dispdata_get_blinkentry_info
    Get the application-specific information for a blink entry.

dispdata_set_blinkentry_attributes
    Set attributes for a blink entry.

dispdata_get_blinkentry_attributes
    Get attributes for a blink entry.

dispdata_regenerate_blinkentry_list
    Regenerate a list of blink entries for a blink state.

dispdata_get_dataobject_from_blinkentry
    Get the dataobject for a blinkentry.

dispdata_overlay_create_dataclass
    Initialise overlay data support for the package.

dispdata_overlay_create_dataobject
    Create an overlay data object.

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/