F_VN_CreateNDimensionalImageAndSetPixels
Creates an N-dimensional 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_CreateNDimensionalImageAndSetPixels : HRESULT
VAR_INPUT
ipImage : Reference To ITcVnImage;
END_VAR
VAR_IN_OUT
aShape : TcVnArray33_UDINT;
END_VAR
VAR_INPUT
ePixelType : ETcVnElementType;
fValue : LREAL;
hrPrev : HRESULT;
END_VARInputs
|
Name |
Type |
Description |
|---|---|---|
|
ipImage |
Reference To ITcVnImage |
Returns the created image (Non-zero interface pointers are reused.) |
|
ePixelType |
Pixel type | |
|
fValue |
LREAL |
Pixel value |
|
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 |