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