You are here: Start » Function Reference » Computer Vision » 1D Edge Detection 3D » ScanSingleRidge3D

ScanSingleRidge3D

Header:	AVL.h
Namespace:	avl
Module:	Vision3DStandard

Locates the strongest high or low peak of surface height along a given path.

Syntax

void avl::ScanSingleRidge3D
(
	const avl::Surface& inSurface,
	const avl::ScanMap& inScanMap,
	const avl::RidgeScanParams3D& inRidgeScanParams,
	avl::Selection::Type inRidgeSelection,
	atl::Optional<const avl::LocalBlindness&> inLocalBlindness,
	atl::Optional<int> inMaxProfileGapWidth,
	atl::Conditional<avl::SurfaceRidge1D>& outRidge,
	atl::Optional<avl::Profile&> outHeightProfile = atl::NIL,
	atl::Optional<avl::Profile&> outResponseProfile = atl::NIL
)

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
inRidgeSelection	Selection::Type		Selection::Best	Selection mode of the resulting ridge
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
outRidge	Conditional<SurfaceRidge1D>&			Found surface ridge
outHeightProfile	Optional<Profile&>		NIL	Extracted surface height profile
outResponseProfile	Optional<Profile&>		NIL	Profile of the ridge operator response

Optional Outputs

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