imaqSetWindowDisplayMapping

NI Vision for LabWindows/CVI Function

imaqSetWindowDisplayMapping

Usage

int imaqSetWindowDisplayMapping(int windowNumber, const DisplayMapping* mapping);

Purpose

Sets the pixel mapping policy for displaying 16-bit images of an unspecified bit depth. Because 16-bit grayscale images cannot be displayed with their full resolution on 32-bit color displays using common video adapters limited to 8-bit resolution/per pixel/color, 16-bit images need to be mapped to the 8-bit range (0 to 255).

Parameters

Name

Type

Description

windowNumber int The number of the window the function sets the pixel mapping policy for.
mapping const DisplayMapping* Describes the mapping policy the function sets for the windows.

Return Value

Type

Description

int On success, this function returns a non-zero value. On failure, this function returns 0. To get extended error information, call imaqGetLastError().

Parameter Discussion

mapping—Set mapping to NULL to use the default options, as follows:

conversionMethod IMAQ_FULL_DYNAMIC
minimumValue 0
maximumValue 0
shiftCount 0