This function allows applications to apply pseudo-color to 8-16-bit grayscale images.

Declaration:

AT_ERRCOUNT ACCUAPI MED_display_color_set(
        HIGEAR hIGear, 
        const DWORD dwGrpID,        
        const LPAT_PIXEL lpRLUT, 
        const LPAT_PIXEL lpGLUT, 
        const LPAT_PIXEL lpBLUT
);

Arguments:

Return Value:

Returns the number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++.

Example:

AT_ERRCOUNT nErrcount;
HIGEAR          hIGear;
{
AT_PIXEL                RLUT[256];
AT_PIXEL                GLUT[256];
AT_PIXEL                BLUT[256];
MED_display_color_create(DCM_PSEUDOCOLOR_SCHEME_6, 0, 0, 0, RLUT, GLUT, BLUT);
MED_display_color_set(hIGear, 0, RLUT, GLUT, BLUT);
repaint_image_and_error_check(hWnd);
}

Remarks:

The 3 LUTs can be user-defined or they can be filled by calling MED_display_color_create(). Each LUT must either be 256 bytes each or set to NULL. If a NULL is passed in as one of the LUTs, a linear 0-255 grayscale LUT is used. If a NULL is not passed in, the LUT points to an array of 256 bytes. The entries from this LUT are used to color the output of the 16x8 LUT.

The pseudo-coloring is not altered by any functions that update the 16x8 LUT. This function alters the display of a grayscale image only and does not change the pixel values of the image or any entries in the 16x8 LUT.

To turn off the pseudo-color, simply pass in NULLs for all of the LUT parameters. These three color channels will be reset to their default linear ramps.

This function does not cause the image to be displayed or repainted. It only fills the 16x8 LUT. To display the results of this function, use IG_dspl_image_draw().