G3D::Line Class Reference

#include <Line.h>

Public Member Functions
	Line ()
	Line (class BinaryInput &b)
void	serialize (class BinaryOutput &b) const
void	deserialize (class BinaryInput &b)
virtual	~Line ()
Vector3	closestPoint (const Vector3 &pt) const
double	distance (const Vector3 &point) const
Vector3	point () const
Vector3	direction () const
Vector3	intersection (const Plane &plane) const
Vector3	closestPoint (const Line &B, float &minDist) const
Vector3	closestPoint (const Line &B) const

Static Public Member Functions
static Line	fromTwoPoints (const Vector3 &point1, const Vector3 &point2)
static Line	fromPointAndDirection (const Vector3 &point, const Vector3 &direction)

Protected Member Functions
	Line (const Vector3 &point, const Vector3 &direction)

Protected Attributes
Vector3	_point
Vector3	_direction

Detailed Description

An infinite 3D line.

Constructor & Destructor Documentation

G3D::Line::Line ( const Vector3 &  point, const Vector3 &  direction  )

inlineprotected

 {
 _point = point;
 _direction = direction.direction();
 }

Here is the call graph for this function:

G3D::Line::Line ( )

inline

Undefined (provided for creating Array<Line> only)

{}

Here is the caller graph for this function:

G3D::Line::Line

(

class BinaryInput &

b

)

 {
 deserialize(b);
}

Here is the call graph for this function:

virtual G3D::Line::~Line ( )

inlinevirtual

{}

Member Function Documentation

Vector3 G3D::Line::closestPoint

(

const Vector3 &

pt

)

const

Returns the closest point on the line to point.

 {
 float t = _direction.dot(pt - _point);
 return _point + _direction * t;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Vector3 G3D::Line::closestPoint	(	const Line &	B,
		float &	minDist
	)		const

Finds the closest point to the two lines.

Parameters

minDist

Returns the minimum distance between the lines.

[http://objectmix.com/graphics/133793-coordinates-closest-points-pair-skew-lines.html]

 {
 const Vector3& P1 = _point;
 const Vector3& U1 = _direction;

 Vector3 P2 = B.point();
 Vector3 U2 = B.direction();
 
 const Vector3& P21 = P2 - P1;
 const Vector3& M = U2.cross(U1);
 float m2 = M.length();

 Vector3 R = P21.cross(M) / m2;
 
 float t1 = R.dot(U2);
 
 minDist = (float)abs(P21.dot(M)) / sqrt(m2);

 return P1 + t1 * U1;
}

Here is the call graph for this function:

Vector3 G3D::Line::closestPoint ( const Line &  B ) const

inline

 {
 float m;
 return closestPoint(B, m);
 }

Here is the call graph for this function:

void G3D::Line::deserialize

(

class BinaryInput &

b

)

 {
 _point.deserialize(b);
 _direction.deserialize(b);
}

Here is the call graph for this function:

Here is the caller graph for this function:

Vector3 G3D::Line::direction

(

)

const

Returns the direction (or negative direction) of the line

 {
 return _direction;
}

Here is the caller graph for this function:

double G3D::Line::distance ( const Vector3 &  point ) const

inline

Returns the distance between point and the line

 {
 return (closestPoint(point) - point).magnitude();
 }

Here is the call graph for this function:

static Line G3D::Line::fromPointAndDirection ( const Vector3 &  point, const Vector3 &  direction  )

inlinestatic

Creates a line from a point and a (nonzero) direction.

 {
 return Line(point, direction);
 }

Here is the call graph for this function:

Here is the caller graph for this function:

static Line G3D::Line::fromTwoPoints ( const Vector3 &  point1, const Vector3 &  point2  )

inlinestatic

Constructs a line from two (not equal) points.

 {
 return Line(point1, point2 - point1);
 }

Here is the call graph for this function:

Here is the caller graph for this function:

Vector3 G3D::Line::intersection

(

const Plane &

plane

)

const

Returns the point where the line and plane intersect. If there is no intersection, returns a point at infinity.

 {
 float d;
 Vector3 normal = plane.normal();
 plane.getEquation(normal, d);
 float rate = _direction.dot(normal);

 if (rate == 0) {

 return Vector3::inf();

 } else {
 float t = -(d + _point.dot(normal)) / rate;

 return _point + _direction * t;
 }
}

Here is the call graph for this function:

Here is the caller graph for this function:

Vector3 G3D::Line::point

(

)

const

Returns a point on the line

 {
 return _point;
}

Here is the caller graph for this function:

void G3D::Line::serialize

(

class BinaryOutput &

b

)

const

 {
 _point.serialize(b);
 _direction.serialize(b);
}

Here is the call graph for this function:

Member Data Documentation

Vector3 G3D::Line::_direction

protected

Vector3 G3D::Line::_point

protected

---

The documentation for this class was generated from the following files:

• dep/g3dlite/include/G3D/Line.h
• dep/g3dlite/source/Line.cpp