ClassesClassesClassesClasses | | | | Operators

area_holesarea_holesAreaHolesarea_holesAreaHolesAreaHoles (Operator)

Name

area_holesarea_holesAreaHolesarea_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)

Herror area_holes(Hobject Regions, Hlong* Area)

Herror area_holes(Hobject Regions, HTuple* Area)

Hlong HRegion::AreaHoles() const

HTuple HRegionArray::AreaHoles() const

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

HTuple HRegion::AreaHoles() const

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

VARIANT HRegionX.AreaHoles()

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

HTuple HRegion.AreaHoles()

Description

The operator area_holesarea_holesAreaHolesarea_holesAreaHolesAreaHoles 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>)set_system("neighborhood",<4/8>)SetSystem("neighborhood",<4/8>)SetSystem("neighborhood",<4/8>) (default: 8-neighborhood).

In the documentation of the operator region_featuresregion_featuresRegionFeaturesregion_featuresRegionFeaturesRegionFeatures, 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.

Parallelization

Parameters

RegionsRegionsRegionsRegionsRegionsregions (input_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject

Region(s) to be examined.

AreaAreaAreaAreaAreaarea (output_control)  integer(-array) HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (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_holesAreaHolesarea_holesAreaHolesAreaHoles returns 2 (H_MSG_TRUE) if all parameters are correct.

Possible Predecessors

thresholdthresholdThresholdthresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionconnectionConnectionConnection

See also

area_centerarea_centerAreaCenterarea_centerAreaCenterAreaCenter, fill_upfill_upFillUpfill_upFillUpFillUp

Module

Foundation


ClassesClassesClassesClasses | | | | Operators