Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Path Metrics » PathToPathDistance

Computes the minimum distance between two paths.

Name | Type | Range | Description | |
---|---|---|---|---|

inPath1 | Path | First input path | ||

inPath2 | Path | Second input path | ||

inPathDistanceMode | PathDistanceMode | Distance measuring method | ||

inResolution | Real | 0.0 - | ||

outDistance | Real | Minimal distance between input paths | ||

outConnectingSegment | Segment2D | Segment connecting input paths having minimal length |

### Description

The operation finds the minimal distance between a characteristic point of inPath1 and path inPath2. The distance between a point and a path 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 the outDistance distance and, additionally, the outConnectingSegment line segment corresponding to the result.

### Examples

### Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type | Description |
---|---|

DomainError |
One or both input paths are empty in PathToPathDistance. |

### Complexity Level

This filter is available on **Basic** Complexity Level.

### See Also

- PathToPathDistanceProfile – Computes the profile of distances between two paths.