ScanExactlyNStripes3D_Direct


Locates a specified number of multiple pairs of changes of surface height along a given path.

Syntax

C++
C#
Python
 
def ScanExactlyNStripes3D_Direct(
	inSurface: Surface,
	inScanPath: Path,
	/,
	*,
	inScanPathAlignment: CoordinateSystem2D | None = None,
	inSamplingStep: float | None = None,
	inScanWidth: int = 5,
	inSurfaceInterpolation: InterpolationMethod = InterpolationMethod.Bilinear,
	inStripeScanParams: StripeScanParams3D = StripeScanParams3D(ProfileInterpolationMethod.Quadratic4, 0.6, 5.0, None, SurfaceStripePolarity.Low, 0.0, None),
	inStripeCount: int = 1,
	inStripeSelection: Selection = Selection.Best,
	inMinGapWidth: float = 0.0,
	inMaxGapWidth: float | None = None,
	inLocalBlindness: LocalBlindness | None = None,
	inMaxProfileGapWidth: int | None = 1,
	outAlignedScanPath: Path | None = None,
	outHeightProfile: Profile | None = None,
	outResponseProfile: Profile | None = None
)
-> (
	outStripes: list[SurfaceStripe1D] | None,
	diagSamplingPoints: list[Path],
	diagSamplingStep: float
)

Parameters

Name Type Range Default Description
Input value inSurface Surface Input surface
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 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 - 5 Width of the scan field in pixels
Input value inSurfaceInterpolation InterpolationMethod InterpolationMethod.Bilinear Interpolation method used for extraction of surface points
Input value inStripeScanParams StripeScanParams3D StripeScanParams3D(ProfileInterpolationMethod.Quadratic4, 0.6, 5.0, None, SurfaceStripePolarity.Low, 0.0, None) Parameters controlling the surface stripe extraction process
Input value inStripeCount int 0 - 1 Number of surface stripes to be found
Input value inStripeSelection Selection Selection.Best Selection mode of the resulting stripes
Input value inMinGapWidth float 0.0 - 0.0 Minimal distance between consecutive surface stripes
Input value inMaxGapWidth float | None 0.0 - None Maximal distance between consecutive surface stripes
Input value inLocalBlindness LocalBlindness | None None Defines conditions in which weaker edges can be detected in the vicinity of stronger edges
Input value inMaxProfileGapWidth int | None 0 - 1 Maximal number of consecutive not existing profile points
Output value outStripes list[SurfaceStripe1D] | None Found surface stripes
Output value outAlignedScanPath Path | None None Path along which the scan is performed; in the image coordinate system
Output value outHeightProfile Profile | None None Extracted surface height profile
Output value outResponseProfile Profile | None None Profile of the edge (derivative) operator response
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