F_VN_PutLabelExp

Write a label (text on unified background) into an image. (expert function)

Syntax

Definition:

FUNCTION F_VN_PutLabelExp : HRESULT
VAR_INPUT
    sText            : STRING;
    ipDestImage      : ITcVnImage;
    nX               : UDINT;
    nY               : UDINT;
    fFontScale       : LREAL;
    nThickness       : UDINT;
    eFontType        : ETcVnFontType;
END_VAR
VAR_IN_OUT
    aFontColor       : TcVnVector4_LREAL;
    aBackgroundColor : TcVnVector4_LREAL;
END_VAR
VAR_INPUT
    eLineType        : ETcVnLineType;
    hrPrev           : HRESULT;
END_VAR

Inputs

Name	Type	Description
sText	STRING	Text
ipDestImage	ITcVnImage	Destination image
nX	UDINT	x coordinate (bottom left)
nY	UDINT	y coordinate (bottom left)
fFontScale	LREAL	Scaling factor
nThickness	UDINT	Line thickness
eFontType	ETcVnFontType	Font type
eLineType	ETcVnLineType	Line type
hrPrev	HRESULT	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

In/Outputs

Name	Type	Description
aFontColor	TcVnVector4_LREAL	Font color
aBackgroundColor	TcVnVector4_LREAL	Background color

Return value

HRESULT

Required License

TC3 Vision Base

System Requirements

Development environment	Target platform	PLC libraries to include
TwinCAT V3.1. 4024.44 or later	PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU	Tc3_Vision