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

CreateSurfaceMeasurementMap

Header:	FIL.h
Namespace:	fil
Module:	Vision3DStandard

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

Syntax

void fil::CreateSurfaceMeasurementMap
(
	const fil::SurfaceFormat& inSurfaceFormat,
	const fil::SegmentScanField& inScanField,
	ftl::Optional<const fil::CoordinateSystem2D&> inScanFieldAlignment,
	int inScanCount,
	ftl::Optional<float> inSamplingStep,
	int inScanWidth,
	fil::InterpolationMethod::Type inSurfaceInterpolation,
	ftl::Array<fil::ScanMap>& outMeasurementMap,
	ftl::Optional<fil::SegmentScanField&> outAlignedScanField = ftl::NIL,
	ftl::Array<fil::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 ftl::NIL to these parameters: outAlignedScanField.