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.
IG_ISIS_TAG_TYPE_SHORT
All scanner drivers.
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. |