Back to FabImage Library website

You are here: Start » Function Reference » Region » Region Features » RegionNumberOfHoles

RegionNumberOfHoles


Header: FIL.h
Namespace: fil
Module: FoundationBasic

Computes the number of holes in a region.

Syntax

C++
C#
 
void fil::RegionNumberOfHoles
(
	const fil::Region& inRegion,
	fil::RegionConnectivity::Type inConnectivity,
	int inMinHoleArea,
	ftl::Optional<int> inMaxHoleArea,
	int& outNumberOfHoles
)

Parameters

Name Type Range Default Description
Input value inRegion const Region& Input region
Input value inConnectivity RegionConnectivity::Type Region connectivity semantics
Input value inMinHoleArea int 0 - 1 Minimal area of a hole
Input value inMaxHoleArea Optional<int> 0 - NIL Maximal area of a hole
Output value outNumberOfHoles int&

Description

The operation computes the number of region holes. Holes of a region are those connected areas of pixels not belonging to the region, that do not touch the boundary of the region frame.

Examples

The number of holes in the sample (left) region equals to 3. The holes are presented on the right image.

See Also

  • FillRegionHoles – Adds pixels to the input region so that it contains no holes.