ImageGear for C and C++ on Windows v19.4 - Updated
IG_ISIS_TAG_BRIGHTNESS
API Reference Guide > ISIS Component API Reference > ISIS Component Tags Reference > Image Quality Tags > IG_ISIS_TAG_BRIGHTNESS

Scanner's or displayed image's brightness setting. 0x0502  1282

IG_ISIS_TAG_BRIGHTNESS allows you to set or read the brightness setting of a scanner or displayed image.

Type:

IG_ISIS_TAG_TYPE_SHORT

Drivers

All scanner drivers.

Values:

The application must get choices (using IG_ISIS_choice_get_long) to be aware of the number of possible positive brightness settings as well as the following special values for IG_ISIS_TAG_BRIGHTNESS. Higher numbers produce lighter pages. These values were chosen so that all possible combinations of brightness can be represented by a single range of values. All scanners support values of at least -2 through 0, and many support, for example, 1 through 127 as well (providing 128 brightness steps).

Value Defined Constant Meaning
-3 IG_ISIS_BRIGHTNESS_AUTO Set brightness value automatically based on real-time sampling during scanning.
-2 IG_ISIS_BRIGHTNESS_DARKEN Lighten the page relative to IG_ISIS_BRIGHTNESS_NORM. This will result in a particular value being set based on tests conducted by the designer of the scanner driver. To determine this value, read the value of IG_ISIS_TAG_BRIGHTNESS.
-1 IG_ISIS_BRIGHTNESS_NORM Select a "normal" brightness. This will result in a particular value being set based on tests conducted when the scanner driver was designed. Each model of scanner may have a different IG_ISIS_BRIGHTNESS_ NORM value To determine this value, get the value of IG_ISIS_TAG_BRIGHTNESS.
0 IG_ISIS_BRIGHTNESS_LIGHTEN Darken the page relative to IG_ISIS_BRIGHTNESS_NORM. This will result in a particular value being set based on tests conducted by the designer of the scanner driver. To determine this value, read the value of IG_ISIS_TAG_BRIGHTNESS.

See Also

IG_ISIS_TAG_CONTRAST