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

AVL.ScanExactlyNStripes Method

Locates a specified number of multiple pairs of opposite edges across a given path.

Namespace:	AvlNet
Assembly:	AVL.NET.dll

Syntax

public static void ScanExactlyNStripes(
	AvlNet.Image inImage,
	AvlNet.ScanMap inScanMap,
	AvlNet.StripeScanParams inStripeScanParams,
	int inStripeCount,
	AvlNet.Selection inStripeSelection,
	float inMinGapWidth,
	float? inMaxGapWidth,
	AvlNet.LocalBlindness? inLocalBlindness,
	out AvlNet.Stripe1D[] outStripes,
	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.
inStripeScanParams	AvlNet.StripeScanParams			Parameters controlling the stripe extraction process.
inStripeCount	int	<0, INF>	1	Number of stripes to be found. Default value: 1.
inStripeSelection	AvlNet.Selection		avl::Selection::Best	Selection mode of the resulting stripes. Default value: avl::Selection::Best.
inMinGapWidth	float	<0.0f, INF>		Minimal distance between consecutive stripes.
inMaxGapWidth	float ?	<0.0f, INF>		Maximal distance between consecutive stripes. 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.
outStripes	AvlNet.Stripe1D			Found stripes.
outGaps	AvlNet.Gap1D			Distances between consecutive stripes.
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 finds a set of inStripeCount consecutive stripes (i.e. pairs of opposite-polarity edges running across the path). If no subset (of inStripeCount elements) of detected edge pairs meets the requirements of inStripeScanParams.stripePolarity, inStripeScanParams.minMagnitude, inStripeScanParams.minStripeWidth and inMinGapWidth then the outputs are set to NIL.

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

ScanExactlyNStripes locates the edge pairs using a scan map representing the scan path above (inStripeCount = 2, inStripeScanParams.stripePolarity = Dark).

Remarks

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