GfLineSeg Class Reference

Basic type: 3D line segment. More...

#include <lineSeg.h>

Public Member Functions
	GfLineSeg ()
	The default constructor leaves line parameters undefined.
	GfLineSeg (const GfVec3d &p0, const GfVec3d &p1)
	Construct a line segment that spans two points.
GfVec3d	GetPoint (double t) const
	Return the point on the segment specified by the parameter t.
const GfVec3d &	GetDirection () const
	Return the normalized direction of the line.
double	GetLength () const
	Return the length of the line.
GF_API GfVec3d	FindClosestPoint (const GfVec3d &point, double *t=NULL) const
	Returns the point on the line that is closest to point.
bool	operator== (const GfLineSeg &l) const
	Component-wise equality test.
bool	operator!= (const GfLineSeg &r) const
	Component-wise inequality test.

Friends
GF_API friend bool	GfFindClosestPoints (const GfLine &, const GfLineSeg &, GfVec3d *, GfVec3d *, double *, double *)
	Computes the closets points on line and seg.
GF_API friend bool	GfFindClosestPoints (const GfLineSeg &, const GfLineSeg &, GfVec3d *, GfVec3d *, double *, double *)
	Computes the closets points on two line segments, seg1 and seg2.

Detailed Description

Basic type: 3D line segment.

This class represents a three-dimensional line segment in space.

Definition at line 47 of file lineSeg.h.

Constructor & Destructor Documentation

GfLineSeg() [1/2]

GfLineSeg ( )

inline

The default constructor leaves line parameters undefined.

Definition at line 52 of file lineSeg.h.

GfLineSeg() [2/2]

GfLineSeg ( const GfVec3d &  p0, const GfVec3d &  p1  )

inline

Construct a line segment that spans two points.

Definition at line 56 of file lineSeg.h.

Member Function Documentation

FindClosestPoint()

GF_API GfVec3d FindClosestPoint	(	const GfVec3d &	point,
		double *	t = NULL
	)		const

Returns the point on the line that is closest to point.

If t is not NULL, it will be set to the parametric distance along the line of the closest point.

GetDirection()

const GfVec3d & GetDirection ( ) const

inline

Return the normalized direction of the line.

Definition at line 65 of file lineSeg.h.

GetLength()

double GetLength ( ) const

inline

Return the length of the line.

Definition at line 68 of file lineSeg.h.

GetPoint()

GfVec3d GetPoint ( double  t ) const

inline

Return the point on the segment specified by the parameter t.

p = p0 + t * (p1 - p0)

Definition at line 62 of file lineSeg.h.

operator!=()

bool operator!= ( const GfLineSeg &  r ) const

inline

Component-wise inequality test.

The starting points, and directions must match exactly for lines to be considered equal.

Definition at line 85 of file lineSeg.h.

operator==()

bool operator== ( const GfLineSeg &  l ) const

inline

Component-wise equality test.

The starting points and directions, must match exactly for lines to be considered equal.

Definition at line 78 of file lineSeg.h.

Friends And Related Function Documentation

GfFindClosestPoints [1/2]

GF_API friend bool GfFindClosestPoints ( const GfLine &  , const GfLineSeg &  , GfVec3d *  , GfVec3d *  , double *  , double *    )

friend

Computes the closets points on line and seg.

The two points are returned in p1 and p2. The parametric distances of p1 and p2 along the line and segment are returned in t1 and t2.

This returns false if the lines were close enough to parallel that no points could be computed; in this case, the other return values are undefined.

GfFindClosestPoints [2/2]

GF_API friend bool GfFindClosestPoints ( const GfLineSeg &  , const GfLineSeg &  , GfVec3d *  , GfVec3d *  , double *  , double *    )

friend

Computes the closets points on two line segments, seg1 and seg2.

The two points are returned in p1 and p2. The parametric distances of p1 and p2 along the segments are returned in t1 and t2.

This returns false if the lines were close enough to parallel that no points could be computed; in this case, the other return values are undefined.

---

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

• pxr/base/gf/lineSeg.h