RayStep Class Reference

Core class for stepping along a ray. More...

#include <raystep.h>

Inheritance diagram for RayStep:

Public Member Functions
	RayStep (const Vector &, const Vector &)
	Create a ray stepping structure.
	RayStep (const Ray &, const double &, const double &)
	Create a ray stepping structure.
Vector	Vertex (int) const
	Return one of the end vertex of the axis.
Vector	VertexAt (const double &) const
	Compute a point on the segment.
Segment	GetSegment () const
	Get the segment.
Sphere	GetSphere () const
	Return the embedding sphere.
Vector	Center () const
	Get the center.
double	Radius () const
	Return the segment radius.
double	GetLength () const
	Return the length of the segment.
Vector	GetAxis () const
	Return the unit vector.
Box	GetBox () const
	Return the bounding box.
	~RayStep ()
	Empty.
void	Step (const double &, const double &)
	Compute the next step forward.
RayStep	Translated (const Vector &) const
	Translates a segment.
RayStep	Scaled (const Vector &) const
	Scales a segment.
RayStep	Rotated (const Matrix &) const
	Rotates a segment.
bool	Intersect (const Box &) const
	Compute the intersection between the segment and a box.
RayStep	InverseTransformed (const Frame &) const
	Inverse transformation.

Static Public Attributes
static const double	epsilon = 1.0e-8
	ε for intersection tests.

Protected Attributes
Vector	u
	Unit direction vector.
double	length
	Length.
Vector	c
	Center.
double	r
	Radius.
Box	box
	Bounding box.
Protected Attributes inherited from Segment
Vector	b = Vector::Z
	End vertices of the segment.

Additional Inherited Members
Protected Member Functions inherited from Segment
	Segment ()
	Empty.
	Segment (const Vector &, const Vector &)
	Creates a segment given its end vertices.
	~Segment ()
	Empty.
void	Rotate (const Matrix &)
	Rotates a segment.
void	Translate (const Vector &)
	Translates a segment.
void	Scale (const double &)
	Uniformly scales a segment.
Segment	Translated (const Vector &) const
	Translates a segment.
Segment	Scaled (const Vector &) const
	Scales a segment.
Segment	Scaled (const double &) const
	Uniformly scales a segment.
Segment	Rotated (const Matrix &) const
	Rotates a segment.
Segment	InverseTransformed (const Frame &) const
	Inverse transformation.
Quadric	Equation (const Ray &) const
	Computes the polynomial equation of the Euclidean distance between a ray and the line corresponding to the segment.
Vector	Vertex (int) const
	Return one of the end vertex of the axis.
Vector &	Vertex (int)
	Return one of the end vertex of the axis.
Vector	VertexAt (const double &) const
	Compute a point on the segment.
Vector	Center () const
	Compute the center of the segment.
bool	Intersect (const Box &) const
	Check if a segment intersects a box.
Vector	GetAxis () const
	Returns the normalized axis vector.
Box	GetBox () const
	Compute the bounding box of the segment.
double	Length () const
	Return axis length.
double	R (const Vector &) const
	Compute the squared distance to the segment.
double	R (const Vector &, double &) const
	Compute the squared distance to the segment.
double	R (const Segment &) const
	Compute the squared distance between two segments.
Vector	Normal (const Vector &) const
	Compute the normal vector between a point and its projection onto the segment.
bool	Equal (const Segment &, const double &) const
	Test if two segments are almost equal.
Static Protected Member Functions inherited from Segment
static Quadric	EdgeEquation (const Ray &, const Vector &, const Vector &, const Vector &)
	Compute the polynomial equation of the distance function along the ray.
static Vector	Intersect (const Vector &, const Vector &, const double, const double, double=0.0)
	Compute the intersection between the line f(x)=y and a line such that f(a)=va and f(b)=vb, on the segment ab.

Detailed Description

Core class for stepping along a ray.

The class stores the end points of the line segment, its length and unit direction.

Constructor & Destructor Documentation

RayStep() [1/2]

RayStep::RayStep ( const Vector & a, const Vector & b )

explicit

Create a ray stepping structure.

Parameters

a,b	Segment points.

RayStep() [2/2]

RayStep::RayStep ( const Ray & ray, const double & t, const double & s )

explicit

Create a ray stepping structure.

Parameters

ray	The ray.
t	Position on the ray.
s	Stepping length.

Member Function Documentation

Intersect()

bool RayStep::Intersect

(

const Box &

box

)

const

Compute the intersection between the segment and a box.

Parameters

box

The box.

See also

Segment::Intersect(const Box&) const

InverseTransformed()

RayStep RayStep::InverseTransformed

(

const Frame &

frame

)

const

Inverse transformation.

Parameters

frame

The frame.

Rotated()

RayStep RayStep::Rotated

(

const Matrix &

r

)

const

Rotates a segment.

Parameters

r	Rotation matrix.

Scaled()

RayStep RayStep::Scaled

(

const Vector &

s

)

const

Scales a segment.

Parameters

s	Scaling vector.

Step()

void RayStep::Step	(	const double &	s,
		const double &	l )

Compute the next step forward.

Start form the first vertex of the segment, step in the same direction by a given distance, with a new stepping distance.

Avoids the re-computation of the unit direction vector, and testing segment vertexes for computing the bounding box.

Parameters

s	Stepping distance.
l	Next segment length.

Translated()

RayStep RayStep::Translated

(

const Vector &

t

)

const

Translates a segment.

Parameters

t	Translation vector.

VertexAt()

Vector RayStep::VertexAt ( const double & t ) const

inline

Compute a point on the segment.

Parameters

t	Interpolation parameter.