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

CreateSurfaceMeasurementMap

Header:	AVL.h
Namespace:	avl
Module:	Vision3DStandard

(Pre)computes surface sampling locations used by MeasureObjectWidth3D function.

Syntax

void avl::CreateSurfaceMeasurementMap
(
	const avl::SurfaceFormat& inSurfaceFormat,
	const avl::SegmentScanField& inScanField,
	atl::Optional<const avl::CoordinateSystem2D&> inScanFieldAlignment,
	int inScanCount,
	atl::Optional<float> inSamplingStep,
	int inScanWidth,
	avl::InterpolationMethod::Type inSurfaceInterpolation,
	atl::Array<avl::ScanMap>& outMeasurementMap,
	atl::Optional<avl::SegmentScanField&> outAlignedScanField = atl::NIL,
	atl::Array<avl::Segment2D>& diagScanSegments
)

Parameters

Name	Type	Range	Default	Description
inSurfaceFormat	const SurfaceFormat&			Information about dimensions, depth and pixel type of the surface
inScanField	const SegmentScanField&			Field in which scans will be performed
inScanFieldAlignment	Optional<const CoordinateSystem2D&>		NIL	Adjusts the scan field to the position of the inspected object
inScanCount	int	2 -	5	Number of scans to be performed
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	Width of the scan area
inSurfaceInterpolation	InterpolationMethod::Type		Bilinear	Interpolation method used in extraction of image pixel values
outMeasurementMap	Array<ScanMap>&
outAlignedScanField	Optional<SegmentScanField&>		NIL	Field in which the scans will be performed
diagScanSegments	Array<Segment2D>&			Array of scan segments

Optional Outputs

The computation of following outputs can be switched off by passing value atl::NIL to these parameters: outAlignedScanField.