./_Man_Openwin_html/html3/xil_color

Manual page for xil_color_correct(3)

xil_color_correct - color corrects an XilImage given an XilColorspaceList of color spaces using KCMS (TM) color management

SYNOPSIS

#include <xil/xil.h>

void xil_color_correct (XilImage src,
XilImage dst,
XilColorspaceList* colorspacelist);

DESCRIPTION

This function color corrects the data of the source image into the destination image using the color spaces listed in colorspacelist. The correction is accomplished using KCMS color management. src is the source image's handle. dst is the destination image's handle. colorspacelist is a handle to a list of one or more color spaces.

Color spaces can be of three types: XIL_COLORSPACE_NAME, XIL_COLORSPACE_FILENAME, and XIL_COLORSPACE_KCS_ID.

If xil_color_correct () is called with two color spaces and these color spaces are of type XIL_COLORSPACE_NAME, xil_color_convert.3 is executed internally in the library.

Color spaces attached to the images will be ignored. Only the color spaces in the list will be used in this operation.

ERRORS

For a complete list of XIL error messages by number, consult Appendix B of the XIL Programmer's Guide.

EXAMPLES

This example color corrects an image using two color spaces that are in files in the current directory.

    #define SRC_PROFILE "kcmsEKphcdcn.inp"
    #define DST_PROFILE "kcmsEKsony20.mon"

    XilSystemState State;
    XilImage src, dst;
    XilColorspace cspaces[2];
    XilColorspaceList cspaceList;

    /*
     * Create the color space using a filename
     */
    cspaces[0] = xil_colorspace_create(state,
        XIL_COLORSPACE_FILENAME, SRC_PROFILE);
    cspaces[1] = xil_colorspace_create(state,
        XIL_COLORSPACE_FILENAME, DST_PROFILE);

    /* create the color space list */
    cspaceList = xil_colorspacelist_create(state, cspaces, 2);

    /* color correct the image */
    xil_color_correct(src, dst, cspaceList);

    /* Destroy the color space list, then the color spaces */
    xil_colorspacelist_destroy(cspaceList);
    xil_colorspace_destroy(cspaces[0]);
    xil_colorspace_destroy(cspaces[1]);

NOTES

The source and destination images must be of XIL_BYTE data type and have the same number of bands. This restriction is placed by KCMS and not by the XIL library. The only time this restriction is lifted is if xil_color_convert.3 is called (refer to DESCRIPTION). An application must destroy any created color spaces and color space lists. It should not destroy any color spaces in the list until after destroying the XilColorspaceList object. The XilColorspaceList object contains pointers to the color spaces in it.

xil_color_correct - color corrects an XilImage given an XilColorspaceList of color spaces using KCMS (TM) color management

SYNOPSIS

DESCRIPTION

ERRORS

EXAMPLES

NOTES

SEE ALSO