Back to Adaptive Vision Library website
You are here: Start » Function Reference » Region Features » RegionDiameter
RegionDiameter
Computes the longest segment connecting two pixels contained in region and its length.
Syntax
C++
C#
void avl::RegionDiameter ( const avl::Region& inRegion, atl::Optional<avl::Segment2D&> outDiameter = atl::NIL, atl::Optional<float&> outDiameterLength = atl::NIL )
Parameters
Name | Type | Default | Description | |
---|---|---|---|---|
inRegion | const Region& | Input region | ||
outDiameter | Optional<Segment2D&> | NIL | ||
outDiameterLength | Optional<float&> | NIL |
Description
The operation finds the most distant pair of region pixels and returns the distance between them (outDiameterLength) and the segment representing the diameter (outDiameter). If there is more than one pair of maximal distance, the returned segment will correspond to one of them. The orientation of the resulting outDiameter is always between 0 and 180 degrees.
Hints
- If the input region is not guaranteed to be non-empty, precede this filter with SkipEmptyRegion.
Examples
Errors
Error type | Description |
---|---|
DomainError | Empty region in RegionDiameter |