Track's Foot Point

Foot of a point in space on a track. Finds a point on a track so that the line from it to the target point stands perpendicular on the track's tangent at that point. More...

Functions
dclspc std::pair< bool, Length >	trax::Foot (const spat::Position< Length > &ofPoint, const Track &toTrack)
	Foot for point in space.
dclspc std::pair< bool, Length >	trax::Foot (const spat::Position< Length > &ofPoint, const Track &toTrack, Length bestGuess)
dclspc std::pair< bool, Length >	trax::Foot (const spat::Position< Length > &ofPoint, const Track &toTrack, Length bestGuess, common::Interval< Length > inRange)
dclspc std::pair< bool, Length >	trax::Foot (const spat::VectorBundle< Length, One > &ofRay, const Track &toTrack)
	Foot for a ray in space.
dclspc std::pair< bool, Length >	trax::Foot (const spat::VectorBundle< Length, One > &ofRay, const Track &toTrack, Length bestGuess)
dclspc std::pair< bool, Length >	trax::Foot (const spat::VectorBundle< Length, One > &ofRay, const Track &toTrack, Length bestGuess, common::Interval< Length > inRange)

Detailed Description

Foot of a point in space on a track. Finds a point on a track so that the line from it to the target point stands perpendicular on the track's tangent at that point.

Feets are also locally shortest distanced to the reference point, i.e. the neighbouring points of the curve would be of greater distance to the point. For complex curves the function might not find the foot with the globally shortest distance.

Parameters

ofPoint	The point to find the foot of the perpendicular for.
ofRay	A ray to find the foot of the perpendicular for. The perpendicular will also be prependicular to the ray.
toTrack	The track to find the foot on.
bestGuess	A value of s that might be close to the desired solution.
inRange	A range on the track to limit the search to.

Exceptions

std::invalid_argument	if bestGuess is not inside the tracks range or not inside inRange.
std::runtime_error	if the track is not properly built.

Returns

A pair whiches first element is true if a solution was found. The second element then is the track parameter s for the foot point in question.

Exceptions

std::runtime_error	if the track is not valid.
std::invalid_argument	if bestGuess is out of the valid range.