imgSessionSetUserLUT8bit

NI IMAQ Function

imgSessionSetUserLUT8bit

Usage

rval imgSessionSetUserLUT8bit(SESSION_ID sid, uInt32 lutType, uInt8* lut);

Purpose

Downloads a custom 8-bit lookup table (LUT) to the image acquisition device. Call this function at least once with the default constant (IMG_LUT_TYPE_DEFAULT) to initialize all LUTs, or make successive calls using different constants for each LUT. You also can override the default LUT on a per-tap basis. This function works with analog or digital image acquisition devices acquiring from an 8-bit camera.

Note  User LUTs are not supported on the NI 1405, NI 1426, NI 1427, NI 1429, or the NI 1430.

Parameters

Name Type Direction
sid SESSION_ID input
lutType uInt32 input
lut uInt8* input
rval Int32 output

Parameter Discussion

sid: valid SESSION_ID

lutType: type of LUT to be written. The following are valid values for this parameter:

IMG_LUT_TYPE_DEFAULTDefault LUT used to initialize all LUTs.
IMG_LUT_TYPE_REDRed channel LUT for RGB digital cameras or the PCI/PXI-1411.
IMG_LUT_TYPE_GREENGreen channel LUT for RGB digital cameras or the PCI/PXI-1411.
IMG_LUT_TYPE_BLUEBlue channel LUT for RGB digital cameras or the PCI/PXI-1411.
IMG_LUT_TYPE_TAP0Tap 0 LUT for digital devices.
IMG_LUT_TYPE_TAP1Tap 1 LUT for digital devices.
IMG_LUT_TYPE_TAP2Tap 2 LUT for digital devices.
IMG_LUT_TYPE_TAP3Tap 3 LUT for digital devices.
Note  IMG_LUT_TYPE_RED, IMG_LUT_TYPE_GREEN, and IMG_LUT_TYPE_BLUE are valid only for color cameras.

lut: array that contains the LUT to be downloaded to the image acquisition device. This array must contain 256 elements.

Return Value

This function returns 0 on success. On failure, this function returns an error code. For information about the error code, call imgShowError.