FindContours

Search for object contours in a binary image.
Can use available TwinCAT Job Tasks for executing parallel code regions.
Can return partial results when canceled by Watchdog.

Syntax

Definition:

HRESULT FindContours(
    HRESULT                         hrPrev,
    ITcVnImage*                     ipSrcImage,
    ITcVnContainer*&                ipContours,
    ETcVnContourRetrievalMode       eRetrievalMode = CRM_EXTERNAL,
    ETcVnContourApproximationMethod eApproximationMethod = CAM_SIMPLE,
    TcVnPoint&                      aOffset = {0, 0}
)

Parameters

Name

Type

Default

Description

hrPrev

HRESULT

 

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

ipSrcImage

ITcVnImage*

 

Source image (1 channel, binary)

ipContours

ITcVnContainer*&

 

Returns a container which is filled with the found contours (ContainerType_Vector_Vector_TcVnPoint2_DINT; The elements of this container are single contours. Non-zero interface pointers are reused.)

eRetrievalMode

ETcVnContourRetrievalMode

CRM_EXTERNAL

Specifies which contours are retrieved and how their relationship is encoded

eApproximationMethod

ETcVnContourApproximationMethod

CAM_SIMPLE

Contour encoding

aOffset

TcVnPoint&

{0, 0}

Offset by which every contour point is shifted

FindContours 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