You are here: Start » Function Reference » Region » Region Relations » SelectRegions

SelectRegions

Header:	AVL.h
Namespace:	avl
Module:	FoundationBasic

Selects regions according to the selected feature and range.

Applications: Use this filter when you have an array of regions and you want to select some of them for further processing. It is slightly faster than ClassifyRegions.

Syntax

void avl::SelectRegions
(
	const atl::Array<avl::Region>& inRegions,
	avl::RegionFeature::Type inFeature,
	atl::Optional<float> inMinimum,
	atl::Optional<float> inMaximum,
	atl::Array<avl::Region>& outAccepted,
	atl::Optional<atl::Array<float>&> outValues = atl::NIL
)

Parameters

Name	Type	Default	Description
inRegions	const Array<Region>&		Input regions
inFeature	RegionFeature::Type		Region feature value to be computed
inMinimum	Optional<float>	NIL	Lowest value of the range
inMaximum	Optional<float>	NIL	Highest value of the range
outAccepted	Array<Region>&		Regions with feature values matching the range
outValues	Optional<Array<float>&>	NIL

Optional Outputs

The computation of following outputs can be switched off by passing value atl::NIL to these parameters: outValues.