Main Content

PreviewFullBitDepth

Configure preview data to display in full bit depth

Description

The PreviewFullBitDepth property indicates whether the image data in the Preview window is being displayed in full bit depth.

Note

The Image Acquisition Toolbox™ Preview window and the Preview window that is built into the Image Acquisition Tool support the display of up to 16-bit image data. The Preview window was designed to only show 8-bit data, but many cameras return 10-, 12-, 14-, or 16-bit data. The Preview window display supports these higher bit-depth cameras. However, larger bit data is scaled to 8-bit for the purpose of displaying previewed data. To capture the image data in the Preview window in its full bit depth for grayscale images, set the PreviewFullBitDepth property to 'on'.

If you set this property to 'off', image data in the preview window is scaled down from its bit depth to 8-bit. If you set this property to 'on', the image data in the preview window is being captured in its full bit depth.

This property can be set to 'on' only when the value of the ReturnedColorspace property is set to 'grayscale' and for video formats higher than 8-bit depth.

Characteristics

Default value is enclosed in braces ({}).

Access

Read/write

Data type

Character vector

Values

[ {'off'} | 'on' ]