F_VN_SetRoi_TcVnRectangle_UDINT

F_VN_SetRoi_TcVnRectangle_UDINT 1:

Sets a region of interest (ROI) within an image.

Syntax

Definition:

FUNCTION F_VN_SetRoi_TcVnRectangle_UDINT : HRESULT
VAR_IN_OUT
    stRoi       : TcVnRectangle_UDINT;
END_VAR
VAR_INPUT
    ipDestImage : ITcVnImage;
    hrPrev      : HRESULT;
END_VAR

F_VN_SetRoi_TcVnRectangle_UDINT 2: Inputs

Name

Type

Description

ipDestImage

ITcVnImage

Destination image

hrPrev

HRESULT

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

F_VN_SetRoi_TcVnRectangle_UDINT 3: In/Outputs

Name

Type

Description

stRoi

TcVnRectangle_UDINT

Region of interest

F_VN_SetRoi_TcVnRectangle_UDINT 4: Return value

HRESULT

Further information

Like the function F_VN_SetRoi, the function F_VN_SetRoi_TcVnRectangle_UDINT sets a Region of Interest. However, it doesn't accept the rectangle parameters individually, but as a structure of the type TcVnRectangle_UDINT.

This makes it possible, for example, to set the ROI directly with the result of the function F_VN_UprightBoundingRectangle.

Application

The setting of an ROI around a found contour looks like this:

hr := F_VN_UprightBoundingRectangle(ipContour, stRoi, hr);
hr := F_VN_SetRoi_TcVnRectangle_UDINT(stRoi, ipImageWork, hr);

Related functions

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