You are here: Start » Geometry 2D Distance Metrics » PointToLineDistance

PointToLineDistance

Measures the distance between a point and a line.

Syntax

void fil::PointToLineDistance
(
	const fil::Point2D& inPoint,
	const fil::Line2D& inLine,
	float inResolution,
	float& outDistance,
	ftl::Optional<fil::Segment2D&> outConnectingSegment = ftl::NIL
)

Parameters

Name	Type	Range	Default	Description
inPoint	const Point2D&
inLine	const Line2D&
inResolution	float	0.0 -	1.0f	Number of real-world units per one pixel
outDistance	float&
outConnectingSegment	Optional<Segment2D&>		NIL

Examples

PointToLineDistance performed on a sample point and a sample line. The green segment is the value of outConnectingSegment output.

Errors

Error type	Description
DomainError	Indefinite line on input in PointToLineDistance.