F_VN_ConvertDataLayout

F_VN_ConvertDataLayout 1:

Convert a data layout (the arrangement of dimensions in the input data) to another data layout.

Syntax

Definition:

FUNCTION F_VN_ConvertDataLayout : HRESULT
VAR_INPUT
    ipSrcImage      : ITcVnImage;
    ipDestImage     : Reference To ITcVnImage;
    nSrcDataLayout  : ULINT;
    nDestDataLayout : ULINT;
    hrPrev          : HRESULT;
END_VAR

 Inputs

Name

Type

Description

ipSrcImage

ITcVnImage

Source image

ipDestImage

Reference To ITcVnImage

Destination image (An appropriate destination image will be created if required.)

nSrcDataLayout

ULINT

Data layout of the source image (Commonly used data layouts are available in the enumeration ETcVnDataLayout. If nSrcDataLayout is set to 0 or TCVN_DL_DEFAULT, the DataLayout will be automatically determined based on the dimension of the ipSrcImage: 0x12 for 2D, 0x123 for 3D, 0x1234 for 4D, and so forth.)

nDestDataLayout

ULINT

Required output data layout (Commonly used data layouts are available in the enumeration ETcVnDataLayout. nDestDataLayout must not equal 0 or TCVN_DL_DEFAULT.)

hrPrev

HRESULT

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

 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