WarpPerspective (Exp)

Apply a perspective transformation to an image.
Can use available TwinCAT Job Tasks for executing parallel code regions.
Can return partial results when canceled by Watchdog.

Syntax

Definition:

HRESULT WarpPerspective(
    HRESULT                        hrPrev,
    ITcVnImage*                    ipSrcImage,
    ITcVnImage*&                   ipDestImage,
    TcVnMatrix3x3_LREAL&           aTransformationMatrix,
    ULONG                          nDestWidth,
    ULONG                          nDestHeight,
    ETcVnInterpolationType         eInterpolationType,
    bool                           bWarpInverse,
    ETcVnBorderInterpolationMethod eBorderInterpolation,
    double                         fBorderValue
)

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 image will be created if required.)

aTransformationMatrix

TcVnMatrix3x3_LREAL&

Perspective transformation matrix

nDestWidth

ULONG

Width of the destination image

nDestHeight

ULONG

Height of the destination image

eInterpolationType

ETcVnInterpolationType

Interpolation method

bWarpInverse

bool

Handle aTransformationMatrix as the inverse transformation

eBorderInterpolation

ETcVnBorderInterpolationMethod

Border interpolation method (ISOLATED not supported)

fBorderValue

double

Border value, if CONSTANT is used

WarpPerspective (Exp) 1: 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