F_VN_ApplyColorMap

Syntax

Definition:

FUNCTION F_VN_ApplyColorMap : HRESULT
VAR_INPUT
    ipSrcImage  : ITcVnImage;
    ipDestImage : Reference To  ITcVnImage;
    ipColorMap  : ITcVnContainer;
    hrPrev      : HRESULT;
END_VAR

 Inputs

 Return value

HRESULT

Further information

The function F_VN_ApplyColorMap applies a color table to the input image.

Parameter

Input image

The input image ipSrcImage must be a 1-channel grayscale image and have an element type of USINT (8-bit) or UINT (16-bit).

Result image

The result image ipDestImage returns the 3-channel RGB color image with the element type USINT (8-bit) that was transformed with the color table.

Color table

The color table ipColorMap defines how the input image is transformed. The color table is a container that can be created either manually or with one of the following two functions:

• F_VN_GenerateColorMap
• F_VN_GenerateCustomColorMap

The container must contain 256 elements (for 8-bit) or 65,536 elements (for 16-bit), depending on the element type of the input image, and must be of the type ContainerType_Vector_TcVnVector3_REAL.

Application

The application of a typical heat map to an 8-bit image looks like this, for example:

hr := F_VN_GenerateColorMap(ipColorMap, TCVN_CMM_HOT, TCVN_CMS_256, hr);
hr := F_VN_ApplyColorMap(
    ipSrcImage      :=  ipImageIn,
    ipDestImage     :=  ipImageRes,
    ipColorMap      :=  ipColorMap,
    hrPrev          :=  hr
);

Required License

TC3 Vision Base

System Requirements