MergeRegions

Merge rectangles that overlap or whose edge-to-edge gap is within the specified distance.

Syntax

Definition:

HRESULT MergeRegions(
    HRESULT          hrPrev,
    ITcVnContainer*  ipSrcContainer,
    ITcVnContainer*& ipDestContainer,
    ULONG            nDistance,
    ULONGLONG        nOptions
)

Parameters

Name

Type

Description

hrPrev

HRESULT

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

ipSrcContainer

ITcVnContainer*

Source container containing rectangles to be merged (ContainerType_Vector_TcVnRectangle_DINT)

ipDestContainer

ITcVnContainer*&

Returns the resulting container, same type as ipSrcContainer

nDistance

ULONG

Maximum edge-to-edge gap (in pixels) for two non-overlapping rectangles to be merged (overlapping rectangles are always merged)

nOptions

ULONGLONG

Specifies the method for merging regions. Valid values are defined in ETcVnMergeRegionsOptions.

 Return value

HRESULT

Required License

TC3 Vision Base

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