Back to Adaptive Vision Library website
You are here: Start » Function Reference » 1D Edge Detection 3D » ScanExactlyNRidges3D
![](../../img/icon\ScanMultipleRidges.png)
ScanExactlyNRidges3D
Locates a specified number of the strongest high or low peaks of surface height along a given path.
Header: | AVL.h |
---|
Syntax
C++
C#
void avl::ScanExactlyNRidges3D ( const avl::Surface& inSurface, const ScanMap& inScanMap, const avl::RidgeScanParams3D& inRidgeScanParams, int inRidgeCount, avl::Selection::Type inRidgeSelection, float inMinDistance, atl::Optional<float> inMaxDistance, atl::Optional<const avl::LocalBlindness&> inLocalBlindness, atl::Optional<int> inMaxProfileGapWidth, atl::Conditional<atl::Array<avl::SurfaceRidge1D> >& outRidges, avl::Profile& diagHeightProfile, avl::Profile& diagResponseProfile )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
![]() |
inSurface | const Surface& | Input surface | ||
![]() |
inScanMap | const ScanMap& | Data precomputed with CreateSurfaceScanMap | ||
![]() |
inRidgeScanParams | const RidgeScanParams3D& | Parameters controlling the surface ridge extraction process | ||
![]() |
inRidgeCount | int | 0 - ![]() |
1 | Number of ridges to be found |
![]() |
inRidgeSelection | Selection::Type | Selection::Best | Selection mode of the resulting ridges | |
![]() |
inMinDistance | float | 0.0 - ![]() |
0.0f | Minimal distance between consecutive ridges |
![]() |
inMaxDistance | Optional<float> | 0.0 - ![]() |
NIL | Maximal distance between consecutive ridges |
![]() |
inLocalBlindness | Optional<const LocalBlindness&> | NIL | Defines conditions in which weaker ridges can be detected in the vicinity of stronger ridges | |
![]() |
inMaxProfileGapWidth | Optional<int> | 0 - ![]() |
1 | Maximal number of consecutive not existing profile points |
![]() |
outRidges | Conditional<Array<SurfaceRidge1D> >& | Found surface ridges | ||
![]() |
diagHeightProfile | Profile& | Extracted surface height profile | ||
![]() |
diagResponseProfile | Profile& | Profile of the ridge operator response |