You are here: Start » Function Reference » Computer Vision » Shape Fitting 3D » CreatePathFittingMap3D

CreatePathFittingMap3D

Header:	FIL.h
Namespace:	fil
Module:	Vision3DStandard

Precomputes a data object that is required for fast path fitting on surfaces.

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

Syntax

void fil::CreatePathFittingMap3D
(
	const fil::SurfaceFormat& inSurfaceFormat,
	const fil::PathFittingField& inFittingField,
	ftl::Optional<const fil::CoordinateSystem2D&> inFittingFieldAlignment,
	ftl::Optional<float> inScanStep,
	ftl::Optional<float> inSamplingStep,
	int inScanWidth,
	fil::InterpolationMethod::Type inSurfaceInterpolation,
	fil::PathFittingMap& outFittingMap,
	ftl::Array<fil::Segment2D>& diagScanSegments,
	ftl::Array<fil::Rectangle2D>& diagSamplingAreas
)

Parameters

Name	Type	Range	Default	Description
inSurfaceFormat	const SurfaceFormat&			Dimensions, depth image pixel type, coordinate offsets and scales of a surface on which path fitting will be performed
inFittingField	const PathFittingField&			Defines a stripe in which scan segments will be created
inFittingFieldAlignment	Optional<const CoordinateSystem2D&>		NIL	Adjusts the fitting field to the position of the inspected object
inScanStep	Optional<float>	0.0 -	NIL	Optional implicit conversion of the input path to an equidistant one
inSamplingStep	Optional<float>		NIL	Desired distance between consecutive sampling points on the scan segments; if Nil, the bigger of surface X and Y scales is chosen
inScanWidth	int	1 -	5	The width of each scan field in pixels of the surface depth image
inSurfaceInterpolation	InterpolationMethod::Type		InterpolationMethod::NearestNeighbour	Interpolation method used for extraction of depth image pixel values
outFittingMap	PathFittingMap&			Optimized data required for path fitting
diagScanSegments	Array<Segment2D>&			Segments along which the scans will be run
diagSamplingAreas	Array<Rectangle2D>&			Scan fields created for point detection