CreateSurfaceScanMap


Precomputes a data object that is required for fast 1D edge detection in 3D.

Applications:Used together with 1D Edge Detection 3D filters, but can be moved before the loop if only the scan parameters do not change.

Syntax

C++
C#
Python
 
def CreateSurfaceScanMap(
	inSurfaceFormat: SurfaceFormat,
	inScanPath: Path,
	inScanWidth: int,
	inSurfaceInterpolation: InterpolationMethod,
	outScanMap: ScanMap,
	/,
	*,
	inScanPathAlignment: CoordinateSystem2D | None = None,
	inSamplingStep: float | None = None,
	outAlignedScanPath: Path | None = None
)
-> (
	diagSamplingPoints: list[Path],
	diagSamplingStep: float
)

Parameters

Name Type Range Default Description
Input value inSurfaceFormat SurfaceFormat Dimensions, depth image pixel type, coordinate offsets and scales of a surface on which edge detection will be performed
Input value inScanPath Path Path along which the scan is performed
Input value inScanPathAlignment CoordinateSystem2D | None None Adjusts the scan path to the position of the inspected object
Input value inSamplingStep float | None 0.0 - None Desired distance between consecutive sampling points on the scan path; if Nil, the bigger of surface X and Y scales is chosen
Input value inScanWidth int 1 - Width of the scan field in pixels of the surface depth image
Input value inSurfaceInterpolation InterpolationMethod Interpolation method used for extraction of depth image pixel values
Output value outScanMap ScanMap Optimized data object required for 1D edge detection in 3D
Output value outAlignedScanPath Path | None None Transformed input path
Diagnostic input diagSamplingPoints list[Path] Array of paths each one containing the sampling points that contributed to a single value of the extracted profile; in the image coordinate system
Diagnostic input diagSamplingStep float Used distance between consecutive sampling points on the scan path