MED_display_color

This function can be used to pseudo-color the brightest and the darkest pixels in a 16-bit grayscale image.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI MED_display_color_limits( HIGEAR hIGear, const DWORD dwGrpID, const INT thresh_low, const INT low_red, const INT low_green, const INT low_blue, const INT thresh_high, const INT high_red, const INT high_green, const INT high_blue );

Copy Code

AT_ERRCOUNT ACCUAPI MED_display_color_limits(
        HIGEAR hIGear, 
        const DWORD dwGrpID,
        const INT thresh_low, 
        const INT low_red,
        const INT low_green, 
        const INT low_blue, 
        const INT thresh_high, 
        const INT high_red, 
        const INT high_green, 
        const INT high_blue
);

Arguments:

Name	Type	Description
hIGear	HIGEAR	HIGEAR handle to the image.
dwGrpID	const DWORD	Display group identifier that should be used for display operations.
thresh_low	const INT	Set to an INT value for the lower pixel value limit. All pixels at or below this value will be pseudo-colored.
low_red	const INT	Set to an INT for the red component of the RGB color that will be used for all pixels below thresh_low.
low_green	const INT	Set to an INT for the green component of the RGB color that will be used for all pixels below thresh_low.
low_blue	const INT	Set to an INT for the blue component of the RGB color that will be used for all pixels below thresh_low.
thresh_high	const INT	Set to an INT value for the upper pixel value limit. All pixels at or above this value will be pseudo-colored.
high_red	const INT	Set to an INT for the red component of the RGB color that will be used for all pixels above thresh_high.
high_green	const INT	Set to an INT for the green component of the RGB color that will be used for all pixels above thresh_high.
high_blue	const INT	Set to an INT for the blue component of the RGB color that will be used for all pixels above thresh_high.

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++.

Remarks:

This is typically used to clearly see pixel values that are over-saturated (255 and up) or under-saturated (0 and below). However, this function lets you customize the settings for the upper and lower pixel value limits with thresh_low and thresh_high.

The color is applied after the 16x8 display LUT is applied to the image and is not affected by altering this LUT.

Pixels having values at or below thresh_low are colored by low_color and pixels having values at or above thresh_high are colored by high_color. All pixels having values within the 2 limits are set to normal linear gray.

To turn off this effect, set thresh_low to -1 and thresh_high to 256.

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().