F_VN_GenerateColorMap

F_VN_GenerateColorMap 1:

Generates a pre-defined color map.

Syntax

Definition:

FUNCTION F_VN_GenerateColorMap : HRESULT
VAR_INPUT
    ipColorMap    : Reference To  ITcVnContainer;
    eColorMap     : ETcVnColorMap;
    eColorMapSize : ETcVnColorMapSize;
    hrPrev        : HRESULT;
END_VAR

F_VN_GenerateColorMap 2: Inputs

Name

Type

Description

ipColorMap

Reference To ITcVnContainer

Returns the color map (ContainerType_Vector_TcVnVector3_REAL with 256 or 65536 elements)

eColorMap

ETcVnColorMap

Selects a color map (similar to GNU Octave/MATLAB types)

eColorMapSize

ETcVnColorMapSize

Defines how many elements the generated color map should have

hrPrev

HRESULT

HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

F_VN_GenerateColorMap 3: Return value

HRESULT

Weiterführende Informationen

Die Funktion F_VN_GenerateColorMap erstellt eine Farbtabelle, die mit der Funktion F_VN_ApplyColorMap auf ein Bild angewandt werden kann.

Parameter

Color Map

Der Parameter ipColorMap gibt die erstellte Farbtabelle zurück.

Farbverlauf

Der Farbverlauf eColorMap der Farbtabelle wird über das Enum ETcVnColorMap festgelegt. Wenn Sie manuell einen Farbverlauf festlegen möchten, nutzen Sie die Funktion F_VN_GenerateCustomColorMap.

Größe der Farbtabelle

Die Größe eColorMapSize wird über das Enum ETcVnColorMapSize festgelegt und definiert, ob die Farbtabelle für 8-Bit-Bilder (TCVN_CMS_256) oder für 16-Bit-Bilder (TCVN_CMS_65536) erstellt wird.

Anwendung

VAR
    ipColorMap      :   ITcVnColorMap;
END_VAR

hr := F_VN_GenerateColorMap(
    ipColorMap      :=  ipColorMap,
    eColorMap       :=  TCVN_CM_HOT,
    eColorMapSize   :=  TCVN_CMS_256,
    hrPrev          :=  hr
);

Required License

TC3 Vision Base

System Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT V3.1.4024.54 or later

PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU

Tc3_Vision