DetectPatternPoints (2)

Detects calibration pattern points (circles) within the provided image and sorts them.
Can use available TwinCAT Job Tasks for executing parallel code regions.

Syntax

Definition:

HRESULT DetectPatternPoints(
    HRESULT          hrPrev,
    ITcVnImage*      ipSrcImage,
    ITcVnContainer*& ipPatternPoints,
    TcVnParamsSB&    stBlobDetectionParams,
    ULONG            nPatternRows,
    ULONG            nPatternCols,
    ULONG            nOptions
)

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 (USINT, 1 or 3 channels)

ipPatternPoints

ITcVnContainer*&

Returns the pattern point positions, sorted row by row from left to right (ContainerType_Vector_TcVnPoint2_REAL; Non-zero interface pointers are reused.)

stBlobDetectionParams

TcVnParamsSB&

Parameters to detect and filter contours. At least, suitable values for fMinArea and fMaxArea should be specified.

nPatternRows

ULONG

Expected number of pattern rows

nPatternCols

ULONG

Expected number of pattern columns

nOptions

ULONG

Provide options from ETcVnDetectPatternPointsOptions. Always requires selection of either DPPO_SYMMETRIC or DPPO_ASYMMETRIC. Can optionally be combined with DPPO_CLUSTERING via bitwise OR.

 Return value

HRESULT

Required License

TC3 Vision Metrology 2D

System Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT V3.1.4026 or later

PC or CX (x64) with min. PL50, e.g. Intel 4-core Atom CPU

Tc3_Vision