You are here: Start » AVL.NET » AVL.ScanMultipleEdges Method

AVL.ScanMultipleEdges Method

Locates multiple transitions between dark and bright pixels along a given path.

Namespace:	AvlNet
Assembly:	AVL.NET.dll

Syntax

public static void ScanMultipleEdges(
	AvlNet.Image inImage,
	AvlNet.ScanMap inScanMap,
	AvlNet.EdgeScanParams inEdgeScanParams,
	float inMinDistance,
	float? inMaxDistance,
	AvlNet.LocalBlindness? inLocalBlindness,
	out AvlNet.Edge1D[] outEdges,
	out AvlNet.Gap1D[] outGaps,
	out AvlNet.Profile diagBrightnessProfile,
	out AvlNet.Profile diagResponseProfile
)

Parameters

Name	Type	Range	Default	Description
inImage	AvlNet.Image			Input image.
inScanMap	AvlNet.ScanMap			Data precomputed with CreateScanMap.
inEdgeScanParams	AvlNet.EdgeScanParams			Parameters controlling the edge extraction process.
inMinDistance	float	<0.0f, INF>	0.0f	Minimal distance between consecutive edges. Default value: 0.0f.
inMaxDistance	float ?	<0.0f, INF>		Maximal distance between consecutive edges. Default value: atl::NIL, or null.
inLocalBlindness	AvlNet.LocalBlindness ?			Defines conditions in which weaker edges can be detected in the vicinity of stronger edges. Default value: atl::NIL, or null.
outEdges	AvlNet.Edge1D			Found edges.
outGaps	AvlNet.Gap1D			Gaps between consecutive edges.
diagBrightnessProfile	AvlNet.Profile			Extracted image profile.
diagResponseProfile	AvlNet.Profile			Profile of the edge (derivative) operator response.

Description

The operation scans the image using inScanMap previously generated from a scan path and detects image edges perpendicular to the path. Depending on the inEdgeScanParams.edgeTransition parameter, edges representing increase or decrease (or both) of image brightness along the path will be taken into account.

When the number of edges to be found is known, one can use the ScanExactlyNEdges.

Note that in case of a scan path which is closed, the parameters controlling the distances between consecutive found objects do not control the distance between the first and the last of the found objects (counting from the beginning of the scan path).

Examples

ScanExactlyNEdges locates the edges using a scan map representing the scan path above.

Remarks

For more information about local coordinate systems please refer to the following article.