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

euler_numbereuler_numbereuler_numberEulerNumberEulerNumber (Operator)

Name

euler_numbereuler_numbereuler_numberEulerNumberEulerNumber — Calculate the Euler number.

Signature

euler_number(Regions : : : EulerNumber)

Herror euler_number(const Hobject Regions, Hlong* EulerNumber)

Herror T_euler_number(const Hobject Regions, Htuple* EulerNumber)

Herror euler_number(Hobject Regions, Hlong* EulerNumber)

Herror euler_number(Hobject Regions, HTuple* EulerNumber)

Hlong HRegion::EulerNumber() const

HTuple HRegionArray::EulerNumber() const

void HOperatorSetX.EulerNumber(
[in] IHUntypedObjectX* Regions, [out] VARIANT* EulerNumber)

VARIANT HRegionX.EulerNumber()

static void HOperatorSet.EulerNumber(HObject regions, out HTuple eulerNumber)

HTuple HRegion.EulerNumber()

Description

The operator euler_numbereuler_numbereuler_numberEulerNumberEulerNumber calculates the Euler number, i.e., the difference between the number of connection components and the number of holes.

If more than one region is passed the results are stored in tuples, the index of a value in the tuple corresponding to the index of a region in the input.

Parallelization

Parameters

RegionsRegionsRegionsRegionsregions (input_object)  region(-array) objectHRegionHRegionHRegionXHobject

Region(s) to be examined.

EulerNumberEulerNumberEulerNumberEulerNumbereulerNumber (output_control)  integer(-array) HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Calculated Euler number.

Result

The operator euler_numbereuler_numbereuler_numberEulerNumberEulerNumber 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>). If necessary an exception is raised.

Possible Predecessors

thresholdthresholdthresholdThresholdThreshold, regiongrowingregiongrowingregiongrowingRegiongrowingRegiongrowing, connectionconnectionconnectionConnectionConnection

Alternatives

connect_and_holesconnect_and_holesconnect_and_holesConnectAndHolesConnectAndHoles

Module

Foundation


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