Back to Adaptive Vision Library website

You are here: Start » Function Reference » Shape Fitting » CreateSegmentFittingMap

CreateSegmentFittingMap


Header:AVL.h
Namespace:avl

Precomputes a data object that is required for fast segment fitting on images.

Syntax

C++
C#
 
void avl::CreateSegmentFittingMap
(
	const avl::ImageFormat& inImageFormat,
	const avl::SegmentFittingField& inFittingField,
	atl::Optional<const avl::CoordinateSystem2D&> inFittingFieldAlignment,
	const int inScanCount,
	const int inScanWidth,
	avl::InterpolationMethod::Type inImageInterpolation,
	SegmentFittingMap& outFittingMap,
	atl::Array<avl::Segment2D>& diagScanSegments,
	atl::Array<avl::Rectangle2D>& diagSamplingAreas
)

Parameters

Name Type Range Default Description
inImageFormat const ImageFormat& Dimensions, depth and pixel type of the images on which fitting will be performed
inFittingField const SegmentFittingField& Defines a rectangle in which scan segments will be created
inFittingFieldAlignment Optional<const CoordinateSystem2D&> NIL Adjusts the fitting field to the position of the inspected object
inScanCount const int 3 - 10 The number of points that will be searched to estimate the position of the segment
inScanWidth const int 1 - 5 The width of each scan field (in pixels)
inImageInterpolation InterpolationMethod::Type InterpolationMethod::​NearestNeighbour Interpolation method used for extraction of image pixel values
outFittingMap SegmentFittingMap& Optimized data required for segment fitting
diagScanSegments Array<Segment2D>& Segments along which the scans will be run
diagSamplingAreas Array<Rectangle2D>& Scan fields created for point detection

Description

The operation creates a series of scan maps that can be later used by other Shape Fitting filters. Each scan map corresponds to a single scan segment of inScanWidth length.

The optional parameter inFittingFieldAlignment defines the transform to be performed on the inFittingField so that the result is defined in a new context, e.g. returned by one of Template Matching filters.

Remarks

Read more about Local Coordinate Systems in Machine Vision Guide: Local Coordinate Systems.

This filter is a part of the Shape Fitting toolset. To read more about this technique, one can refer to the Shape Fitting chapter of our Machine Vision Guide

See Also

  • FitSegmentToEdges – Performs a series of 1D edge detections and finds a segment that best matches the detected points.
  • FitSegmentToRidges – Performs a series of 1D ridge detections and finds a segment that best matches the detected points.
  • FitSegmentToStripe – Performs a series of 1D stripe detections and finds a segment that best matches the detected points.