You are here: Start » AVL.NET » AVL.PathToPathDistanceProfile Method

AVL.PathToPathDistanceProfile Method

Computes the profile of distances between two paths.

Namespace:	AvlNet
Assembly:	AVL.NET.dll

Syntax

public static void PathToPathDistanceProfile(
	AvlNet.Path inPath1,
	AvlNet.Path inPath2,
	AvlNet.PathDistanceMode inPathDistanceMode,
	float inResolution,
	out AvlNet.Profile outDistanceProfile,
	out float[] outDistances,
	out AvlNet.Segment2D[] outConnectingSegments
)

Parameters

Name	Type	Range	Default	Description
inPath1	AvlNet.Path			First input path.
inPath2	AvlNet.Path			Second input path.
inPathDistanceMode	AvlNet.PathDistanceMode			Distance measuring method.
inResolution	float	<0.0f, INF>	1.0f	Default value: 1.0f.
outDistanceProfile	AvlNet.Profile			Profile of distances between second path and consecutive points of first path.
outDistances	float			Distances between second path and consecutive points of first path
outConnectingSegments	AvlNet.Segment2D			Segments connecting second path and consecutive points of first path having minimal length

Description

The operation iterates over characteristic points of inPath1 and at each point computes the distance from this point to inPath2. The distance is computed as follows, depending on the value of inPathDistanceMode:

The distance to nearest characteristic point of inPath2, if inPathDistanceMode is set to PointToPoint.
The minimal distance to inPath2 segments adjacent to the nearest characteristic point of inPath2 (which is much more precise), if inPathDistanceMode is set to PointToSegment.

The operation computes outDistanceProfile profile of consecutive distances and, additionally, outConnectingSegments array of corresponding line segments.

Examples

Sample paths

The resulting outConnectingSegments drawn onto the input paths.

The resulting outDistanceProfile.

Errors