DetectEdges_AsPaths_Mask


Extracts subpixel-precise paths that represent continuous edges. Faster, yet less accurate version.

Applications:Consistent detection of contours of variable or unpredictable shape, e.g. screw thread outline or a custom piece of textile.

Syntax

C++
C#
Python
 
def DetectEdges_AsPaths_Mask(
	inImage: Image,
	/,
	*,
	inRoi: Region | None = None,
	inEdgeMaskFilter: EdgeMaskFilter = EdgeMaskFilter.Sobel,
	inEdgeThreshold: float = 35.0,
	inEdgeHysteresis: float = 15.0,
	inMaxJoiningDistance: float | None = None,
	inMaxJoiningAngle: float = 30.0,
	inJoiningDistanceBalance: float = 0.0,
	inJoiningEndingLength: float | None = None,
	inMinEdgeLength: float = 0.0,
	diagGradientMagnitudeImage: Image | None = None,
	diagEdgeRegion: Region | None = None
)
-> outEdges: list[Path]

Parameters

Name Type Range Default Description
Input value inImage Image Image from which edges will be extracted
Input value inRoi Region | None None Region of the image from which edges will be extracted
Input value inEdgeMaskFilter EdgeMaskFilter EdgeMaskFilter.Sobel Type of edge filter used for computing gradients
Input value inEdgeThreshold float 0.0 - 35.0 Sufficient edge strength; edges of that strength will always be detected
Input value inEdgeHysteresis float 0.0 - 15.0 Value by which the edge threshold is decreased for edge points neighboring with sufficiently strong edges
Input value inMaxJoiningDistance float | None 0.0 - None Maximal distance between edges that can be joined
Input value inMaxJoiningAngle float 0.0 - 180.0 30.0 Maximal allowed angle between edges being joined
Input value inJoiningDistanceBalance float 0.0 - 1.0 0.0 Determines how important distance between edges is according to their angle difference
Input value inJoiningEndingLength float | None 1.0 - None Determines the length of the edge end used for edge angle computing
Input value inMinEdgeLength float 0.0 - 0.0 Minimal length of an edge
Output value outEdges list[Path] Paths representing found edges
Diagnostic input diagGradientMagnitudeImage Image | None None Visualization of the gradient magnitude
Diagnostic input diagEdgeRegion Region | None None Region representing found edges

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.