F_VN_DivideImages

F_VN_DivideImages 1:

Element-wise division of two images using saturation arithmetics. (A division by zero equals zero.)

Syntax

Definition:

FUNCTION F_VN_DivideImages : HRESULT
VAR_INPUT
    ipSrcImage1 : ITcVnImage;
    ipSrcImage2 : ITcVnImage;
    ipDestImage : Reference To ITcVnImage;
    hrPrev      : HRESULT;
END_VAR

F_VN_DivideImages 2: Inputs

Name

Type

Description

ipSrcImage1

ITcVnImage

First source image (dividend)

ipSrcImage2

ITcVnImage

Second source image (divisor)

ipDestImage

Reference To ITcVnImage

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

hrPrev

HRESULT

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

F_VN_DivideImages 3: Return value

HRESULT

Further information

The function F_VN_DivideImages returns zero for the respective elements in the case of division by zero. However, this only works if the option Floating point exceptions of the executing PLC task is deactivated. Otherwise a division-by-zero error occurs.

Notice

Floating point exceptions

This function can unnecessarily cause errors if the option Floating point exceptions of the executing PLC task is active. Therefore, deactivate this option.

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