CreateImageFromArray

Creates an 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 CreateImageFromArray(
    HRESULT          hrPrev,
    PVOID            pData,
    ITcVnImage*&     ipImage,
    ULONG            nWidth,
    ULONG            nHeight,
    ETcVnElementType ePixelType,
    ULONG            nChannelNum
)

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. Make sure that the array contains at least nWidth * nHeight * nChannelNum elements and that the array element type matches ePixelType.
ipImage	ITcVnImage*&	Returns the created image (Non-zero interface pointers are reused.)
nWidth	ULONG	Image width
nHeight	ULONG	Image height
ePixelType	ETcVnElementType	Pixel type
nChannelNum	ULONG	Number of channels (1 to 255)

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