Back to Adaptive Vision Library website

# CreateSegmentFittingMap

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

Applications: Used together with segment fitting, but can be moved before the loop.

### 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,
const avl::SamplingParams& inSamplingParams,
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)
inSamplingParams const SamplingParams& .interpolation Bilinear Parameters controlling the sampling process
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