This property sets the scan brightness. This property is only enabled when using a custom-built user interface (UiMode=2).
Property Value
From -1000 to 1000
The Brightness property default value is 0
Important:
When using a Canon DR scan driver with the PixelType property set to 0
(ikScanPixelBW), the BitDepthReduction property set
to 0 (ikBitDepthReductionThreshold), the TextEnhancement property set 1 or
more, then the range of acceptable values for the Brightness
property is from 1 to 255 (default value 128).
When using a PFU scan driver with the PixelType property set to 1000
(ikScanPixelAutomation), 1001 (ikScanPixelGrayAndBW), or 1002
(ikScanPixelRGBAndBW), then the range of acceptable values for the
Brightness property is from -127 to 127 (default 0).
Explanation
The Brightness property sets the scan brightness. This property is only enabled when using a custom-built user interface (UiMode=2).
Note: There are cases when the PixelType property is 0 (ikScanPixelBW) and depending on the BitDepthReduction property value the Brightness property has no affect. See below.
The Brightness property is okay
When PixelType = 0 (ikScanPixelBW) and the BitDepthReduction = 0 (*) or 1.
When the PixelType = 1 (ikScanPixelGray), 2 (ikScanPixelRGB), or 3 (ikScanPixelPalette)
(*) This is only for scan devices that do not support Threshold and use uses Brightness instead.
Note: This property is disabled for digital cameras and scanners that do not support these functions. The possible setting values supported by a scan device can be retrieved using the GetCapRange (GetCapRangeVariant) method or the GetCapEnum (GetCapEnumVariant) method.
Setting this value
This value can be set at runtime.
Retrieving this value
This value cannot be retrieved.