ImageGear Professional DLL v17.1 for Windows Accusoft
MED_display_color_limits
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > MD Component API Reference > MD Component Functions Reference > Display Functions > MED_display_color_limits

Glossary Item Box

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 INT thresh_low, 
        const INT low_red,
        const INT low_green, 
        INT low_blue, 
        const INT thresh_high, 
        const INT high_red, 
        const INT high_green, 
        const INT high_blue);

Arguments:

hIGear HIGEAR handle to the image.
thresh_low Set to an INT value for the lower pixel value limit. All pixels at or below this value will be pseudo-colored.
low_red 8-16 Set to an INT for the red component of the RGB color that will be used for all pixels below thresh_low
low_green Set to an INT for the green component of the RGB color that will be used for all pixels below thresh_low
low_blue Set to an INT for the blue component of the RGB color that will be used for all pixels below thresh_low
thresh_high Set to an INT value for the upper pixel value limit. All pixels at or above this value will be pseudo-colored.
high_red Set to an INT for the red component of the RGB color that will be used for all pixels above thresh_high
high_green Set to an INT for the green component of the RGB color that will be used for all pixels above thresh_high
high_blue 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 Professional.

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

©2012. Accusoft Corporation. All Rights Reserved.