ConvertDataLayout

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

Syntax

Definition:

HRESULT ConvertDataLayout(
    HRESULT      hrPrev,
    ITcVnImage*  ipSrcImage,
    ITcVnImage*& ipDestImage,
    ULONGLONG    nSrcDataLayout,
    ULONGLONG    nDestDataLayout
)

Parameters

Name

Type

Description

hrPrev

HRESULT

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

ipSrcImage

ITcVnImage*

Source image

ipDestImage

ITcVnImage*&

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

nSrcDataLayout

ULONGLONG

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

ULONGLONG

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

ConvertDataLayout 1: 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 min. PL50, e.g. Intel 4-core Atom CPU

Tc3_Vision