NI-IMAQ C Function Reference

imgSessionSetUserLUT8bit

  • Mise à jour2023-02-21
  • Temps de lecture : 2 minute(s)

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, NI 1430, NI 1433, or the NI 1435.

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.