F_VN_CreateImageAndSetPixels

F_VN_CreateImageAndSetPixels 1:

Creates an image, allocates an appropriate data buffer and sets all pixels to the specified value. The initial reference count is set to one if a new image interface is created and kept, otherwise.

Syntax

Definition:

FUNCTION F_VN_CreateImageAndSetPixels : HRESULT
VAR_INPUT
    ipImage     : Reference To ITcVnImage;
    nWidth      : UDINT;
    nHeight     : UDINT;
    ePixelType  : ETcVnElementType;
    nChannelNum : UDINT;
END_VAR
VAR_IN_OUT
    aValue      : TcVnVector4_LREAL;
END_VAR
VAR_INPUT
    hrPrev      : HRESULT;
END_VAR

F_VN_CreateImageAndSetPixels 2: Inputs

Name

Type

Description

ipImage

Reference To ITcVnImage

Returns the created image (Non-zero interface pointers are reused.)

nWidth

UDINT

Image width

nHeight

UDINT

Image height

ePixelType

ETcVnElementType

Pixel type

nChannelNum

UDINT

Number of channels (1 to 4)

hrPrev

HRESULT

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

F_VN_CreateImageAndSetPixels 3: In/Outputs

Name

Type

Description

aValue

TcVnVector4_LREAL

Pixel value

F_VN_CreateImageAndSetPixels 4: Return value

HRESULT

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