osg::Polytope Class Reference

A Polytope class for representing convex clipping volumes made up of a set of planes. More...

List of all members.

Public Types
typedef unsigned int	ClippingMask
typedef std::vector< Plane >	PlaneList
typedef std::vector< Vec3 >	VertexList
typedef fast_back_stack< ClippingMask >	MaskStack
Public Member Functions
	Polytope ()
	Polytope (const Polytope &cv)
	Polytope (const PlaneList &pl)
	~Polytope ()
void	clear ()
Polytope &	operator= (const Polytope &cv)
void	setToUnitFrustum (bool withNear=true, bool withFar=true)
	Create a Polytope which is a cube, centered at 0,0,0, with sides of 2 units.
void	setAndTransformProvidingInverse (const Polytope &pt, const osg::Matrix &matrix)
void	set (const PlaneList &pl)
void	add (const osg::Plane &pl)
void	flip ()
	flip/reverse the orientation of all the planes.
PlaneList &	getPlaneList ()
const PlaneList &	getPlaneList () const
void	setReferenceVertexList (VertexList &vertices)
VertexList &	getReferenceVertexList ()
const VertexList &	getReferenceVertexList () const
void	setupMask ()
ClippingMask &	getCurrentMask ()
ClippingMask	getCurrentMask () const
void	setResultMask (ClippingMask mask)
ClippingMask	getResultMask () const
MaskStack &	getMaskStack ()
const MaskStack &	getMaskStack () const
void	pushCurrentMask ()
void	popCurrentMask ()
bool	contains (const osg::Vec3 &v) const
	Check whether a vertex is contained within clipping set.
bool	contains (const std::vector< Vec3 > &vertices)
	Check whether any part of vertex list is contained within clipping set.
bool	contains (const osg::BoundingSphere &bs)
	Check whether any part of a bounding sphere is contained within clipping set.
bool	contains (const osg::BoundingBox &bb)
	Check whether any part of a bounding box is contained within clipping set.
bool	containsAllOf (const std::vector< Vec3 > &vertices)
	Check whether all of vertex list is contained with clipping set.
bool	containsAllOf (const osg::BoundingSphere &bs)
	Check whether the entire bounding sphere is contained within clipping set.
bool	containsAllOf (const osg::BoundingBox &bb)
	Check whether the entire bounding box is contained within clipping set.
void	transform (const osg::Matrix &matrix)
	Transform the clipping set by matrix.
void	transformProvidingInverse (const osg::Matrix &matrix)
	Transform the clipping set by provide a pre inverted matrix.
Protected Attributes
MaskStack	_maskStack
ClippingMask	_resultMask
PlaneList	_planeList
VertexList	_referenceVertexList

---

Detailed Description

A Polytope class for representing convex clipping volumes made up of a set of planes.

When adding planes, their normals should point inwards (into the volume)

---

Member Typedef Documentation

typedef unsigned int osg::Polytope::ClippingMask

typedef fast_back_stack<ClippingMask> osg::Polytope::MaskStack

typedef std::vector<Plane> osg::Polytope::PlaneList

typedef std::vector<Vec3> osg::Polytope::VertexList

---

Constructor & Destructor Documentation

osg::Polytope::Polytope (   )  [inline]

osg::Polytope::Polytope (  const Polytope &  cv  )  [inline]

osg::Polytope::Polytope (  const PlaneList &  pl  )  [inline]

osg::Polytope::~Polytope (   )  [inline]

---

Member Function Documentation

void osg::Polytope::add (  const osg::Plane &  pl  )  [inline]

void osg::Polytope::clear (   )  [inline]

bool osg::Polytope::contains (  const osg::BoundingBox &  bb  )  [inline]

Check whether any part of a bounding box is contained within clipping set. Using a mask to determine which planes should be used for the check, and modifying the mask to turn off planes which wouldn't contribute to clipping of any internal objects. This feature is used in osgUtil::CullVisitor to prevent redundant plane checking.

bool osg::Polytope::contains (  const osg::BoundingSphere &  bs  )  [inline]

Check whether any part of a bounding sphere is contained within clipping set. Using a mask to determine which planes should be used for the check, and modifying the mask to turn off planes which wouldn't contribute to clipping of any internal objects. This feature is used in osgUtil::CullVisitor to prevent redundant plane checking.

bool osg::Polytope::contains (  const std::vector< Vec3 > &  vertices  )  [inline]

Check whether any part of vertex list is contained within clipping set.

bool osg::Polytope::contains (  const osg::Vec3 &  v  )  const [inline]

Check whether a vertex is contained within clipping set.

bool osg::Polytope::containsAllOf (  const osg::BoundingBox &  bb  )  [inline]

Check whether the entire bounding box is contained within clipping set.

bool osg::Polytope::containsAllOf (  const osg::BoundingSphere &  bs  )  [inline]

Check whether the entire bounding sphere is contained within clipping set.

bool osg::Polytope::containsAllOf (  const std::vector< Vec3 > &  vertices  )  [inline]

Check whether all of vertex list is contained with clipping set.

void osg::Polytope::flip (   )  [inline]

flip/reverse the orientation of all the planes.

ClippingMask osg::Polytope::getCurrentMask (   )  const [inline]

ClippingMask& osg::Polytope::getCurrentMask (   )  [inline]

const MaskStack& osg::Polytope::getMaskStack (   )  const [inline]

MaskStack& osg::Polytope::getMaskStack (   )  [inline]

const PlaneList& osg::Polytope::getPlaneList (   )  const [inline]

PlaneList& osg::Polytope::getPlaneList (   )  [inline]

const VertexList& osg::Polytope::getReferenceVertexList (   )  const [inline]

VertexList& osg::Polytope::getReferenceVertexList (   )  [inline]

ClippingMask osg::Polytope::getResultMask (   )  const [inline]

Polytope& osg::Polytope::operator= (  const Polytope &  cv  )  [inline]

void osg::Polytope::popCurrentMask (   )  [inline]

void osg::Polytope::pushCurrentMask (   )  [inline]

void osg::Polytope::set (  const PlaneList &  pl  )  [inline]

void osg::Polytope::setAndTransformProvidingInverse (  const Polytope &  pt, const osg::Matrix &  matrix )  [inline]

void osg::Polytope::setReferenceVertexList (  VertexList &  vertices  )  [inline]

void osg::Polytope::setResultMask (  ClippingMask  mask  )  [inline]

void osg::Polytope::setToUnitFrustum (  bool  withNear = true, bool  withFar = true )  [inline]

Create a Polytope which is a cube, centered at 0,0,0, with sides of 2 units.

void osg::Polytope::setupMask (   )  [inline]

void osg::Polytope::transform (  const osg::Matrix &  matrix  )  [inline]

Transform the clipping set by matrix. Note, this operations carries out the calculation of the inverse of the matrix since a plane must be multiplied by the inverse transposed to transform it. This makes this operation expensive. If the inverse has been already calculated elsewhere then use transformProvidingInverse() instead. See http://www.worldserver.com/turk/computergraphics/NormalTransformations.pdf

void osg::Polytope::transformProvidingInverse (  const osg::Matrix &  matrix  )  [inline]

Transform the clipping set by provide a pre inverted matrix. see transform for details.

---

Member Data Documentation

MaskStack osg::Polytope::_maskStack [protected]

PlaneList osg::Polytope::_planeList [protected]

VertexList osg::Polytope::_referenceVertexList [protected]

ClippingMask osg::Polytope::_resultMask [protected]

---

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

• Polytope

---