STable property (Main Control)

Visual Basic example
Visual C++ 4.0 example

Overview: Refer to Changing Brightness and Contrast.

Remarks

Saturation lookup table. The saturation indicates the amount of white present in a color. This is one of the four tables that the RemapHue method uses to change the bitmap's hue, saturation and value. This property is used only if the bUseSTable parameter is set to TRUE when the RemapHue method is called. Hue, Saturation, and Value levels range from 0 to 255. Therefore, the lookup tables each have 256 entries. The current hue, saturation and value of a pixel correspond to the table indexes.

If the bUseMaskTable and bUseSTable parameters are set to TRUE when the RemapHue method is called and the MaskTable(i) entry for a particular hue is not zero, then the saturation is changed to the saturation in STable(i). If MaskTable(i) is 0 then STable(i) is ignored. For example, if RemapHue is called with both bUseMaskTable and bUseSTable set to TRUE, then if a pixel has a hue of 85 and the MaskTable(85) is not 0, the saturation of the pixel is changed to STable(85).

If the bUseMaskTable parameter is FALSE and the bUseSTable parameter is TRUE when the RemapHue method is called, then the Saturation for each color present in the image will be changed to STable(i). For example, if a pixel has a hue of 70, the saturation of the pixel is changed to STable(70). If the next pixel has a hue of 75, the saturation of that pixel is changed to STable(75).

Saturation entries range from 0 to 255 where

Saturation 0 contains the most white.

Saturation 255 contains no white.