F_VN_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:
FUNCTION F_VN_CreateNDimensionalImageFromArray : HRESULT
VAR_INPUT
pData : PVOID;
ipImage : Reference To ITcVnImage;
END_VAR
VAR_IN_OUT
aShape : TcVnArray33_UDINT;
END_VAR
VAR_INPUT
ePixelType : ETcVnElementType;
hrPrev : HRESULT;
END_VARInputs
|
Name |
Type |
Description |
|---|---|---|
|
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 |
Reference To ITcVnImage |
Returns the created image (Non-zero interface pointers are reused.) |
|
ePixelType |
Pixel type | |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
In/Outputs
|
Name |
Type |
Description |
|---|---|---|
|
aShape |
Specifies the shape of ipDestImage. First entry is the number of dimensions of ipImage (max. 32), followed by the sizes of each dimension. |
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 |