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

Invoke.AdjustPathArrayToEdges

Translates, rotates and scales the given contour set to the edges of the input image with subpixel precision.

Namespace:Fil
Assembly:FilNet.dll

Syntax

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

Parameters

Name Type Range Default Description
inImageFil.ImageInput image.
inPathsSystem.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.
inAlignmentFtl.Optional<Fil.CoordinateSystem2D>Alignment to be corrected, usually connects to outObject.Alignment of LocateObjects 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<Fil.Path>Adjusted output paths.
outAlignmentFil.CoordinateSystem2DCorrected alignment - the inAlignment input modified with estimated adjustment parameters.
diagAttractionVectorsFil.Diagnostic<System.Collections.Generic.List<Fil.Segment2D>>Attraction vectors from first iteration.

See also