Back to Adaptive Vision Library website

You are here: Start » Function Reference » Region Global Transforms » SplitRegionIntoExactlyNComponents

SplitRegionIntoExactlyNComponents


Splits a region into a fixed-size array of regions. Minimizes distances between blobs belonging to a single component.

Syntax

C++
C#
 
void avl::SplitRegionIntoExactlyNComponents
(
	const avl::Region& inRegion,
	int inComponentCount,
	bool inRemoveBoundaryBlobs,
	atl::Optional<avl::SplitAlgorithm::Type> inSplitAlgorithm,
	atl::Conditional<atl::Array<avl::Region> >& outComponents
)

Parameters

Name Type Range Default Description
inRegion const Region& Input region
inComponentCount int 1 -
inRemoveBoundaryBlobs bool False Flag indicating whether the blobs on border of the input region should be removed or not
inSplitAlgorithm Optional<SplitAlgorithm::Type> NIL Algorithm that is used to split the region, if set to Auto, the algorithm with shorter predicted time of execution will be chosen
outComponents Conditional<Array<Region> >&

Examples

SplitRegionIntoExactlyNComponents used with inComponentCount = 4.

Remarks

This filter is mostly used in Blob Analysis Technique please refer to our Machine Vision Guide - Blob Analysis article.

See Also

SplitRegionIntoBlobs, SplitRegionIntoComponents