F_VN_DivideImages

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

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.)

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.44 or later	PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU	Tc3_Vision