You are here: Start » Function Reference » 1D Edge Detection » ScanSingleStripe
ScanSingleStripe
Header: | AVL.h |
---|---|
Namespace: | avl |
Locates the strongest pair of edges across a given path.
Syntax
void avl::ScanSingleStripe ( const avl::Image& inImage, const ScanMap& inScanMap, const StripeScanParams& inStripeScanParams, avl::Selection::Type inStripeSelection, atl::Optional<const avl::LocalBlindness&> inLocalBlindness, atl::Conditional<avl::Stripe1D>& outStripe, avl::Profile& diagBrightnessProfile, avl::Profile& diagResponseProfile )
Parameters
Name | Type | Default | Description | |
---|---|---|---|---|
inImage | const Image& | Input image | ||
inScanMap | const ScanMap& | Data precomputed with CreateScanMap | ||
inStripeScanParams | const StripeScanParams& | Parameters controlling the stripe extraction process | ||
inStripeSelection | Selection::Type | Selection::Best | Selection mode of the resulting stripe | |
inLocalBlindness | Optional<const LocalBlindness&> | NIL | Defines conditions in which weaker edges can be detected in the vicinity of stronger edges | |
outStripe | Conditional<Stripe1D>& | Found stripe | ||
diagBrightnessProfile | Profile& | Extracted image profile | ||
diagResponseProfile | Profile& | Profile of the edge (derivative) operator response |
Description
The operation scans the image using inScanMap previously generated from a scan path and locates the strongest stripe (i.e. a pair of opposite-polarity edges running across the path) of the given characteristics. If there is no such stripe then the outputs are set to NIL.
Hints
- Define inStripeScanParams.StripePolarity to detect a particular edge type, and only that type.
- If no stripe is found, try decreasing inStripeScanParams.MinMagnitude. Verify this with the values on the diagResponseProfile output.
- If consecutive edges are closer than 6 pixels apart, change inStripeScanParams.ProfileInterpolation to Quadratic3.
Examples
Remarks
For more information about local coordinate systems please refer to the following article.
This filter is a part of the 1D Edge Detection toolset. For a comprehensive introduction to this technique please refer to 1D Edge Detection and 1D Edge Detection - Subpixel Precision chapters of our Machine Vision Guide.
See Also
- CreateScanMap – Precomputes a data object that is required for fast 1D edge detection.
- ScanExactlyNStripes – Locates a specified number of multiple pairs of opposite edges across a given path.
- ScanMultipleStripes – Locates multiple pairs of edges across a given path.