ossimEcefRay Class Reference

#include <ossimEcefRay.h>

Public Member Functions
	ossimEcefRay ()
	ossimEcefRay (const ossimEcefRay &copy_this)
	ossimEcefRay (const ossimEcefPoint &origin, const ossimEcefVector &direction)
	ossimEcefRay (const ossimEcefPoint &from, const ossimEcefPoint &to)
	ossimEcefRay (const ossimGpt &from, const ossimGpt &to)
bool	isNan () const
bool	hasNans () const
void	makeNan ()
const ossimEcefRay &	operator= (const ossimEcefRay &r)
bool	operator== (const ossimEcefRay &r) const
bool	operator!= (const ossimEcefRay &r) const
const ossimEcefPoint &	origin () const
const ossimEcefVector &	direction () const
void	setOrigin (const ossimEcefPoint &orig)
void	setDirection (const ossimEcefVector &d)
ossimEcefPoint	extend (const double &t) const
ossimEcefRay	reflectRay (const ossimEcefVector &normal) const
ossimEcefPoint	intersectAboveEarthEllipsoid (const double &heightAboveEllipsoid, const ossimDatum *aDatum=ossimDatumFactory::instance() ->wgs84()) const
std::ostream &	print (std::ostream &os=ossimNotify(ossimNotifyLevel_INFO)) const

Private Attributes
ossimEcefPoint	theOrigin
ossimEcefVector	theDirection

Friends
std::ostream &	operator<< (std::ostream &os, const ossimEcefRay &instance)

Detailed Description

Definition at line 35 of file ossimEcefRay.h.

Constructor & Destructor Documentation

ossimEcefRay() [1/5]

ossimEcefRay::ossimEcefRay ( )

inline

CONSTRUCTORS:

Definition at line 41 of file ossimEcefRay.h.

Referenced by reflectRay().

{};

ossimEcefRay() [2/5]

ossimEcefRay::ossimEcefRay ( const ossimEcefRay &  copy_this )

inline

Definition at line 43 of file ossimEcefRay.h.

      : theOrigin(copy_this.theOrigin), theDirection(copy_this.theDirection) {}

ossimEcefRay() [3/5]

ossimEcefRay::ossimEcefRay ( const ossimEcefPoint &  origin, const ossimEcefVector &  direction  )

inline

Definition at line 46 of file ossimEcefRay.h.

      : theOrigin(origin), theDirection(direction.unitVector()) {}

ossimEcefRay() [4/5]

ossimEcefRay::ossimEcefRay	(	const ossimEcefPoint &	from,
		const ossimEcefPoint &	to
	)

Definition at line 50 of file ossimEcefRay.cpp.

References ossimEcefVector::normalize(), and theDirection.

   : theOrigin(from)
{
   ossimEcefVector ecef (to - from);
   ecef.normalize();
   theDirection = ecef;
}

ossimEcefRay() [5/5]

ossimEcefRay::ossimEcefRay	(	const ossimGpt &	from,
		const ossimGpt &	to
	)

Definition at line 66 of file ossimEcefRay.cpp.

References ossimEcefVector::normalize(), and theDirection.

   : theOrigin(from)
{
   ossimEcefVector ecef (ossimEcefPoint(to) - ossimEcefPoint(from));
   ecef.normalize();
   theDirection = ecef;
}

Member Function Documentation

direction()

const ossimEcefVector& ossimEcefRay::direction ( ) const

inline

Definition at line 80 of file ossimEcefRay.h.

{ return theDirection; }

extend()

ossimEcefPoint ossimEcefRay::extend ( const double &  t ) const

inline

Extends the ray by distance t (meters) from the origin to the ECEF point returned.

Definition at line 152 of file ossimEcefRay.h.

References theDirection, and theOrigin.

{
   return (theOrigin + theDirection*t);
}

hasNans()

bool ossimEcefRay::hasNans ( ) const

inline

Definition at line 60 of file ossimEcefRay.h.

      {
         return theOrigin.isNan()||theDirection.isNan();
      }

intersectAboveEarthEllipsoid()

ossimEcefPoint ossimEcefRay::intersectAboveEarthEllipsoid	(	const double &	heightAboveEllipsoid,
		const ossimDatum *	aDatum = ossimDatumFactory::instance()->wgs84()
	)		const

Intersects the ray with the given elevation above the earth ellipsoid.

Definition at line 82 of file ossimEcefRay.cpp.

References ossimDatum::ellipsoid(), ossimDatumFactory::instance(), ossimEcefPoint::makeNan(), ossimEllipsoid::nearestIntersection(), and ossimDatumFactory::wgs84().

Referenced by ossimAlphaSensor::lineSampleHeightToWorld(), ossimApplanixUtmModel::lineSampleHeightToWorld(), ossimPpjFrameSensor::lineSampleHeightToWorld(), ossimSpectraboticsRedEdgeModel::lineSampleHeightToWorld(), ossimApplanixEcefModel::lineSampleHeightToWorld(), ossimIpodSensor::lineSampleHeightToWorld(), ossimSkyBoxLearSensor::lineSampleHeightToWorld(), and ossimplugins::ossimFormosatModel::lineSampleHeightToWorld().

{
   const ossimDatum* datum = argDatum;
   if (!datum)
      datum = ossimDatumFactory::instance()->wgs84();

   //***
   // Pass the call on to ellipsoid where intersection math is implemented:
   //***
   ossimEcefPoint solution;
   bool intersected = datum->ellipsoid()->nearestIntersection
                      (*this, argHeight, solution);

   if (!intersected)
      solution.makeNan();

   return solution;
}

isNan()

bool ossimEcefRay::isNan ( ) const

inline

Definition at line 56 of file ossimEcefRay.h.

      {
         return theOrigin.isNan()&&theDirection.isNan();
      }

makeNan()

void ossimEcefRay::makeNan ( )

inline

Definition at line 64 of file ossimEcefRay.h.

      {
         theOrigin.makeNan();
         theDirection.makeNan();
      }

operator!=()

bool ossimEcefRay::operator!= ( const ossimEcefRay &  r ) const

inline

Definition at line 141 of file ossimEcefRay.h.

{
   return !(*this == r);
}

operator=()

const ossimEcefRay & ossimEcefRay::operator= ( const ossimEcefRay &  r )

inline

OPERATORS:

Definition at line 123 of file ossimEcefRay.h.

References theDirection, and theOrigin.

{
   theOrigin = r.theOrigin;
   theDirection = r.theDirection;
   return *this;
}

operator==()

bool ossimEcefRay::operator== ( const ossimEcefRay &  r ) const

inline

Definition at line 133 of file ossimEcefRay.h.

References theDirection, and theOrigin.

{
   return ((theOrigin == r.theOrigin) && (theDirection == r.theDirection));
}

origin()

const ossimEcefPoint& ossimEcefRay::origin ( ) const

inline

DATA ACCESS METHODS:

Definition at line 79 of file ossimEcefRay.h.

{ return theOrigin; }

print()

std::ostream & ossimEcefRay::print

(

std::ostream &

os = ossimNotify(ossimNotifyLevel_INFO)

)

const

Debug Dump

Definition at line 102 of file ossimEcefRay.cpp.

References theDirection, and theOrigin.

Referenced by operator<<().

{
   os << "(ossimEcefRay)\n"
      << "   theOrigin    = " << theOrigin
      << "\n   theDirection = " << theDirection << std::endl;
   return os;
}

reflectRay()

ossimEcefRay ossimEcefRay::reflectRay ( const ossimEcefVector &  normal ) const

inline

This method computes a ray with the same origin but a new direction corresponding to a reflection from some surface defined by its normal vector (assumed to be a unit vector):

Definition at line 165 of file ossimEcefRay.h.

References ossimEcefVector::dot(), ossimEcefRay(), theDirection, and theOrigin.

{
   ossimEcefVector new_dir(theDirection - normal*2.0*normal.dot(theDirection));
   return ossimEcefRay(theOrigin, new_dir);
}

setDirection()

void ossimEcefRay::setDirection ( const ossimEcefVector &  d )

inline

Definition at line 82 of file ossimEcefRay.h.

References ossimEcefVector::unitVector().

Referenced by ossimApplanixUtmModel::imagingRay(), ossimPpjFrameSensor::imagingRay(), ossimAlphaSensorHRI::imagingRay(), ossimAlphaSensorHSI::imagingRay(), ossimApplanixEcefModel::imagingRay(), ossimSkyBoxLearSensor::imagingRay(), and ossimIpodSensor::imagingRay().

{ theDirection=d.unitVector();}

setOrigin()

void ossimEcefRay::setOrigin ( const ossimEcefPoint &  orig )

inline

Definition at line 81 of file ossimEcefRay.h.

Referenced by ossimApplanixUtmModel::imagingRay(), ossimPpjFrameSensor::imagingRay(), ossimAlphaSensorHRI::imagingRay(), ossimAlphaSensorHSI::imagingRay(), ossimApplanixEcefModel::imagingRay(), ossimSkyBoxLearSensor::imagingRay(), and ossimIpodSensor::imagingRay().

{ theOrigin = orig; }

Friends And Related Function Documentation

operator<<

std::ostream& operator<< ( std::ostream &  os, const ossimEcefRay &  instance  )

friend

Definition at line 110 of file ossimEcefRay.cpp.

{
   return instance.print(os);
}

Member Data Documentation

theDirection

ossimEcefVector ossimEcefRay::theDirection

private

Definition at line 115 of file ossimEcefRay.h.

Referenced by extend(), operator=(), operator==(), ossimEcefRay(), print(), and reflectRay().

theOrigin

ossimEcefPoint ossimEcefRay::theOrigin

private

Definition at line 114 of file ossimEcefRay.h.

Referenced by extend(), operator=(), operator==(), print(), and reflectRay().

---

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

• ossimEcefRay.h
• ossimEcefRay.cpp