Herror ::euler_number (
    Hobject Regions,
    long *EulerNumber
)
Herror ::euler_number (
    Hobject Regions,
    HTuple *EulerNumber
)
long HRegion::EulerNumber (
    void
) const
HTuple HRegionArray::EulerNumber (
    void
) const

Calculate the Euler number.

The procedure ::euler_number 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.


Parameters

Regions (input_object)
region(-array) -> Hobject: HRegion(Array)
Region(s) to be examined.

EulerNumber (output_control)
integer(-array) -> (HTuple.) long *
Calculated Euler number.


Result

The operator ::euler_number returns the value 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>). The behavior in case of empty region (the region is the empty set) is set via ::set_system('empty_region_result',<Result>). If necessary an exception handling is raised.


Possible Predecessors

::threshold, ::regiongrowing, ::connection


Alternatives

::connect_and_holes


Module

Region processing



Copyright © 1996-2002 MVTec Software GmbH