You are here: Start » FIL.NET » Invoke.AdjustPathArraysToEdges

Invoke.AdjustPathArraysToEdges

Translates, rotates and scales multiple contour sets (PathArray), each separately, to the edges of the input image with subpixel precision.

Namespace:Fil
Assembly:FilNet.dll

Syntax

C++
C#
 
public static void AdjustPathArraysToEdges
(
	Fil.Image inImage,
	List<List<Fil.Path>> inPaths,
	Optional<float> inPointSpacing,
	Optional<List<Fil.CoordinateSystem2D>> inAlignments,
	float inAttractionRadius,
	Fil.AdjustmentMetric inAdjustmentMetric,
	bool inAdjustTranslation,
	bool inAdjustRotation,
	bool inAdjustScale,
	int inIterationCount,
	float inBaseGradient,
	List<List<Fil.Path>> outAdjustedPaths,
	List<Fil.CoordinateSystem2D> outAlignments,
	Diagnostic<List<List<Fil.Segment2D>>> diagAttractionVectors
)

Parameters

Name Type Range Default Description
inImageFil.ImageInput image.
inPathsSystem.Collections.Generic.List<System.Collections.Generic.List<Fil.Path>>Paths to be adjusted. For sparse, synthetic paths the inPointSpacing needs to be specified.
inPointSpacingFtl.Optional<float><1.0f, INF>If set, sampling points of the input path will be equidistant with specified spacing. Useful for increasing density of synthetic, sparse paths. Default value: ftl::NIL.
inAlignmentsFtl.Optional<System.Collections.Generic.List<Fil.CoordinateSystem2D>>Alignments to be corrected, usually connect to outObjects.Alignment[] of LocateObjects:Multiple filter. Default value: ftl::NIL.
inAttractionRadiusfloat<0.1f, INF>2.0fExpected initial distance between inPaths and edges of the input image. Default value: 2.0f.
inAdjustmentMetricFil.AdjustmentMetricSegmentDistanceMetric used for path attraction. The SegmentDistance minimizes distances along path normal vectors, and thus adjustment is more accurate. PointDistance_* minimize euclidean distance, adjustment tends to be more stable. Default value: SegmentDistance.
inAdjustTranslationboolTrueCompute the translation part of adjustment transform. Must be true when using AttractPathTangents estimation method. Default value: True.
inAdjustRotationboolTrueCompute the rotation part of adjustment transform. Default value: True.
inAdjustScaleboolFalseCompute the scale part of adjustment transform. Default value: False.
inIterationCountint<0, 100>6Number of iterations of internal adjustment algorithm. Default value: 6.
inBaseGradientfloat<0.1f, INF>1.0fThreshold for suppression of weak input image gradients. Increase for very noisy images. Default value: 1.0f.
outAdjustedPathsSystem.Collections.Generic.List<System.Collections.Generic.List<Fil.Path>>Adjusted output paths.
outAlignmentsSystem.Collections.Generic.List<Fil.CoordinateSystem2D>Corrected alignments - inAlignments input modified with estimated adjustment parameters.
diagAttractionVectorsFil.Diagnostic<System.Collections.Generic.List<System.Collections.Generic.List<Fil.Segment2D>>>Attraction vectors from first iteration.

See also