This property sets the scan brightness. This property is only enabled when using a custom-built user interface.
Property Value
Values range from -1000 to 1000
The default value is 0
Important:
When using a Canon DR scan driver with the PixelType property set to vikScanPixelBW, the BitDepthReduction property set to vikBitDepthReductionThreshold, 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 vikScanPixelAutomation, vikScanPixelGrayAndBW, or vikScanPixelRGBAndBW, 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 property is vikScanNONUI).
Note: There are cases when the PixelType property is vikScanPixelBW and depending on the BitDepthReduction property value the Brightness property has no affect. See below.
The Brightness property is okay
When PixelType = vikScanPixelBW and the BitDepthReduction = 0 (*) or 1.
When the PixelType = vikScanPixelGray, vikScanPixelRGB, or vikScanPixelPalette
(*) 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 method or the GetCapEnumToFloat method.
Setting this value
This value can be set at runtime.
Retrieving this value
This value cannot be retrieved.