area_holesarea_holesAreaHolesAreaHoles (Operator)

Name

area_holesarea_holesAreaHolesAreaHoles — Compute the area of holes of regions.

Signature

area_holes(Regions : : : Area)

Herror area_holes(const Hobject Regions, Hlong* Area)

Herror T_area_holes(const Hobject Regions, Htuple* Area)

void AreaHoles(const HObject& Regions, HTuple* Area)

HTuple HRegion::AreaHoles() const

static void HOperatorSet.AreaHoles(HObject regions, out HTuple area)

HTuple HRegion.AreaHoles()

Description

The operator area_holesarea_holesAreaHolesAreaHolesAreaHoles calculates the area of the holes in the input regions. The area is defined as the number of pixels contained in the holes. If a region has more than one hole the sum of the areas of all holes in this region are returned. The neighborhood type is set via set_system('neighborhood',<4/8>)set_system("neighborhood",<4/8>)SetSystem("neighborhood",<4/8>)SetSystem("neighborhood",<4/8>)SetSystem("neighborhood",<4/8>) (default: 8-neighborhood).

In the documentation of this chapter (Regions / Features), you can find an image illustrating regions which vary in the area of their holes.

If more than one region is passed the results are stored in tuples with the index of a value in the tuple corresponding to the index of the input region. In case of an empty region the area has the value 0.

Execution Information

Parameters

RegionsRegionsRegionsRegionsregions (input_object)  region(-array) objectHRegionHRegionHobject

Region(s) to be examined.

AreaAreaAreaAreaarea (output_control)  integer(-array) HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Area(s) of holes of the region(s).

Example (HDevelop)

read_image(Image,'modules/modules_01')
threshold(Image,Region,50,250)
area_holes(Region,Area)

Result

The operator area_holesarea_holesAreaHolesAreaHolesAreaHoles returns 2 (H_MSG_TRUE) if all parameters are correct.

Possible Predecessors

thresholdthresholdThresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionConnectionConnection

See also

area_centerarea_centerAreaCenterAreaCenterAreaCenter, fill_upfill_upFillUpFillUpFillUp

Module

Foundation