imgBayerColorDecode

NI IMAQ Function

imgBayerColorDecode

Usage

rval imgBayerColorDecode(void* dst, const void* src, uInt32 rows, uInt32 cols, uInt32 dstRowPixels, uInt32 srcRowPixels, uInt32* redLUT, uInt32* greenLUT, uInt32* blueLUT, uInt8 bayerPattern, uInt8 bitDepth, uInt32 reserved)

Purpose

Decodes a Bayer-encoded image to produce an RGB representation of the image.

Parameters

Name Type Direction
dst void* output
src const void* input
rows uInt32 input
cols uInt32 input
dstRowPixels uInt32 input
srcRowPixels uInt32 input
redLUT uInt32* input
greenLUT uInt32* input
blueLUT uInt32* input
bayerPattern uInt8 input
bitDepth uInt8 input
reserved uInt32 input

Parameter Discussion

dst: pointer to an area of memory that will contain the decoded image on return.

src: pointer to the source image.

rows: number of rows in the source image.

cols: number of columns in the source image.

dstRowPixels: number of pixels in each row of the destination image, including the borders.

srcRowPixels: number of pixels in each row of the source image, including the borders.

redLUT: pointer to an area of memory that contains the lookup table to be applied to the red pixels. This array must be allocated by the user and contain 256 elements for 8-bit images and 65,536 elements for 16-bit images. Generate the redLUT using imgCalculateBayerColorLUT.

greenLUT: pointer to an area of memory that contains the lookup table to be applied to the green pixels. This array must be allocated by the user and contain 256 elements for 8-bit images and 65,536 elements for 16-bit images. Generate the greenLUT using imgCalculateBayerColorLUT.

blueLUT: pointer to an area of memory that contains the lookup table to be applied to the blue pixels. This array be must allocated by the user and contain 256 elements for 8-bit images and 65,536 elements for 16-bit images. Generate the blueLUT using imgCalculateBayerColorLUT.

bayerPattern: Bayer encoding pattern. Valid patterns include the following values:

IMG_BAYER_PATTERN_GBGB_RGRGSpecifies the following Bayer pattern:
GBGB
RGRG
IMG_BAYER_PATTERN_GRGR_BGBGSpecifies the following Bayer pattern:
GRGR
BGBG
IMG_BAYER_PATTERN_BGBG_GRGRSpecifies the following Bayer pattern:
BGBG
GRGR
IMG_BAYER_PATTERN_RGRG_GBGBSpecifies the following Bayer pattern:
RGRG
GBGB

bitDepth: number of bits per pixel of the source image.

algorithm: reserved for future use. This value must be 0.

Tip  For information about Bayer decoding, refer to the White Balancing Utility located at Start»All Programs»National Instruments»Vision»White Balancing Utility.

Return Value

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