HALCON Reference Manual 10.0.2
Table of Contents / Regions / Features ClassesClassesClasses | | | Operators

connect_and_holesconnect_and_holesconnect_and_holesConnectAndHolesConnectAndHoles (Operator)

Name

connect_and_holesconnect_and_holesconnect_and_holesConnectAndHolesConnectAndHoles — Number of connection components and holes

Signature

connect_and_holes(Regions : : : NumConnected, NumHoles)

Herror connect_and_holes(const Hobject Regions, Hlong* NumConnected, Hlong* NumHoles)

Herror T_connect_and_holes(const Hobject Regions, Htuple* NumConnected, Htuple* NumHoles)

Herror connect_and_holes(Hobject Regions, Hlong* NumConnected, Hlong* NumHoles)

Herror connect_and_holes(Hobject Regions, HTuple* NumConnected, HTuple* NumHoles)

Hlong HRegion::ConnectAndHoles(Hlong* NumHoles) const

HTuple HRegionArray::ConnectAndHoles(HTuple* NumHoles) const

void HOperatorSetX.ConnectAndHoles(
[in] IHUntypedObjectX* Regions, [out] VARIANT* NumConnected, [out] VARIANT* NumHoles)

VARIANT HRegionX.ConnectAndHoles([out] VARIANT* NumHoles)

static void HOperatorSet.ConnectAndHoles(HObject regions, out HTuple numConnected, out HTuple numHoles)

HTuple HRegion.ConnectAndHoles(out HTuple numHoles)

int HRegion.ConnectAndHoles(out int numHoles)

Description

The operator connect_and_holesconnect_and_holesconnect_and_holesConnectAndHolesConnectAndHoles calculates the number of connection components and the number of holes of each region of RegionsRegionsRegionsRegionsregions.

If more than one region is passed the numerical values of the output control parameters NumConnectedNumConnectedNumConnectedNumConnectednumConnected and NumHolesNumHolesNumHolesNumHolesnumHoles are each stored in a tuple, the position of a value in the tuple corresponding to the position of the region in the input tuple.

Parallelization

Parameters

RegionsRegionsRegionsRegionsregions (input_object)  region(-array) → objectHRegionHRegionHRegionXHobject

Region(s) to be examined.

NumConnectedNumConnectedNumConnectedNumConnectednumConnected (output_control)  integer(-array) → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Number of connection components of a region.

NumHolesNumHolesNumHolesNumHolesnumHoles (output_control)  integer(-array) → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Number of holes of a region.

Result

The operator connect_and_holesconnect_and_holesconnect_and_holesConnectAndHolesConnectAndHoles returns the value 2 (H_MSG_TRUE) if the input is not empty. The behavior in case of empty input (no input regions available) is set via the operator set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). The behavior in case of empty region (the region is the empty set) is set via set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>).

Possible Predecessors

thresholdthresholdthresholdThresholdThreshold, regiongrowingregiongrowingregiongrowingRegiongrowingRegiongrowing, connectionconnectionconnectionConnectionConnection

Alternatives

euler_numbereuler_numbereuler_numberEulerNumberEulerNumber

See also

connectionconnectionconnectionConnectionConnection, fill_upfill_upfill_upFillUpFillUp, fill_up_shapefill_up_shapefill_up_shapeFillUpShapeFillUpShape, union1union1union1Union1Union1

Module

Foundation

Table of Contents / Regions / Features ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH