CreateNDimensionalImageFromArray

Creates an N-dimensional image and initialize it with the provided data. The initial reference count is set to one if a new image interface is created and kept, otherwise.

Syntax

Definition:

HRESULT CreateNDimensionalImageFromArray(
    HRESULT            hrPrev,
    PVOID              pData,
    ITcVnImage*&       ipImage,
    TcVnArray33_UDINT& aShape,
    ETcVnElementType   ePixelType
)

Parameters

Name

Type

Description

hrPrev

HRESULT

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

pData

PVOID

Pointer to the 1D data array. Ensure that the array contains at least the number of elements equal to the product of all dimensions in aShape and that the array element type matches ePixelType.

ipImage

ITcVnImage*&

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

aShape

TcVnArray33_UDINT&

Specifies the shape of ipDestImage. First entry is the number of dimensions of ipImage (max. 32), followed by the sizes of each dimension.

ePixelType

ETcVnElementType

Pixel type

 Return value

HRESULT

Required License

TC3 Vision Base

System Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT V3.1.4024.59 or later

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

Tc3_Vision