CreateNDimensionalImage

Creates an N-dimensional image and allocates an appropriate data buffer. The initial reference count is set to one if a new image interface is created and kept, otherwise.

Syntax

Definition:

HRESULT CreateNDimensionalImage(
    HRESULT            hrPrev,
    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.)
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