Implements cluster culling to cull back facing subgraphs and drawables. Derived from Drawable::CullCallback and osg::NodeCallback. More...

#include <ClusterCullingCallback>

Inheritance diagram for osg::ClusterCullingCallback:

Public Member Functions
	ClusterCullingCallback ()

	ClusterCullingCallback (const ClusterCullingCallback &ccc, const CopyOp &copyop)

	ClusterCullingCallback (const osg::Vec3 &controlPoint, const osg::Vec3 &normal, float deviation, float radius=-1.0f)

	ClusterCullingCallback (const osg::Drawable *drawable)

	META_Object (osg, ClusterCullingCallback)

virtual NodeCallback *	asNodeCallback ()

virtual const NodeCallback *	asNodeCallback () const

virtual DrawableCullCallback *	asDrawableCullCallback ()

virtual const DrawableCullCallback *	asDrawableCullCallback () const

virtual bool	run (osg::Object object, osg::Object data)

void	computeFrom (const osg::Drawable *drawable)

void	transform (const osg::Matrixd &matrix)

void	set (const osg::Vec3 &controlPoint, const osg::Vec3 &normal, float deviation, float radius)

void	setControlPoint (const osg::Vec3 &controlPoint)

const osg::Vec3 &	getControlPoint () const

void	setNormal (const osg::Vec3 &normal)

const osg::Vec3 &	getNormal () const

void	setRadius (float radius)

float	getRadius () const

void	setDeviation (float deviation)

float	getDeviation () const

virtual bool	cull (osg::NodeVisitor , osg::Drawable , osg::State *) const

virtual void	operator() (Node node, NodeVisitor nv)

Public Member Functions inherited from osg::DrawableCullCallback
	DrawableCullCallback ()

	DrawableCullCallback (const DrawableCullCallback &org, const CopyOp &copyop)

	META_Object (osg, DrawableCullCallback)

virtual bool	cull (osg::NodeVisitor nv, osg::Drawable drawable, osg::RenderInfo *renderInfo) const

virtual bool	run (osg::Object object, osg::Object data)

Public Member Functions inherited from osg::Callback
	Callback ()

	Callback (const Callback &cb, const CopyOp &copyop)

	META_Object (osg, Callback)

virtual Callback *	asCallback ()

virtual const Callback *	asCallback () const

virtual CallbackObject *	asCallbackObject ()

virtual const CallbackObject *	asCallbackObject () const

virtual StateAttributeCallback *	asStateAttributeCallback ()

virtual const StateAttributeCallback *	asStateAttributeCallback () const

virtual UniformCallback *	asUniformCallback ()

virtual const UniformCallback *	asUniformCallback () const

virtual DrawableUpdateCallback *	asDrawableUpdateCallback ()

virtual const DrawableUpdateCallback *	asDrawableUpdateCallback () const

virtual DrawableEventCallback *	asDrawableEventCallback ()

virtual const DrawableEventCallback *	asDrawableEventCallback () const

virtual osgGA::EventHandler *	asEventHandler ()

virtual const osgGA::EventHandler *	asEventHandler () const

bool	traverse (osg::Object object, osg::Object data)

void	setNestedCallback (osg::Callback *cb)

osg::Callback *	getNestedCallback ()

const osg::Callback *	getNestedCallback () const

void	addNestedCallback (osg::Callback *nc)

void	removeNestedCallback (osg::Callback *nc)

Public Member Functions inherited from osg::Object
	Object ()

	Object (bool threadSafeRefUnref)

	Object (const Object &, const CopyOp &copyop=CopyOp::SHALLOW_COPY)

virtual Object *	cloneType () const =0

virtual Object *	clone (const CopyOp &) const =0

virtual bool	isSameKindAs (const Object *) const

virtual const char *	libraryName () const =0

virtual const char *	className () const =0

std::string	getCompoundClassName () const

virtual Node *	asNode ()

virtual const Node *	asNode () const

virtual NodeVisitor *	asNodeVisitor ()

virtual const NodeVisitor *	asNodeVisitor () const

virtual StateSet *	asStateSet ()

virtual const StateSet *	asStateSet () const

virtual StateAttribute *	asStateAttribute ()

virtual const StateAttribute *	asStateAttribute () const

virtual Uniform *	asUniform ()

virtual const Uniform *	asUniform () const

virtual Camera *	asCamera ()

virtual const Camera *	asCamera () const

virtual Drawable *	asDrawable ()

virtual const Drawable *	asDrawable () const

virtual UserDataContainer *	asUserDataContainer ()

virtual const UserDataContainer *	asUserDataContainer () const

virtual ValueObject *	asValueObject ()

virtual const ValueObject *	asValueObject () const

virtual Image *	asImage ()

virtual const Image *	asImage () const

virtual void	setThreadSafeRefUnref (bool threadSafe)

virtual void	setName (const std::string &name)

void	setName (const char *name)

const std::string &	getName () const

void	setDataVariance (DataVariance dv)

DataVariance	getDataVariance () const

virtual void	computeDataVariance ()

void	setUserDataContainer (osg::UserDataContainer *udc)

template<class T >
void	setUserDataContainer (const ref_ptr< T > &udc)

osg::UserDataContainer *	getUserDataContainer ()

const osg::UserDataContainer *	getUserDataContainer () const

osg::UserDataContainer *	getOrCreateUserDataContainer ()

virtual void	setUserData (Referenced *obj)

template<class T >
void	setUserData (const ref_ptr< T > &ud)

virtual Referenced *	getUserData ()

virtual const Referenced *	getUserData () const

template<typename T >
bool	getUserValue (const std::string &name, T &value) const

template<typename T >
void	setUserValue (const std::string &name, const T &value)

virtual void	resizeGLObjectBuffers (unsigned int)

virtual void	releaseGLObjects (osg::State *=0) const

template<typename T >
BoolValueObject UCharValueObject UShortValueObject UIntValueObject DoubleValueObject Vec3fValueObject Vec2dValueObject Vec4dValueObject PlaneValueObject MatrixdValueObject BoundingBoxdValueObject BoundingSpheredValueObject bool	getUserValue (const std::string &name, T &value) const

Public Member Functions inherited from osg::Referenced
	Referenced ()

	Referenced (bool threadSafeRefUnref)

	Referenced (const Referenced &)

Referenced &	operator= (const Referenced &)

bool	getThreadSafeRefUnref () const

OpenThreads::Mutex *	getRefMutex () const

int	ref () const

int	unref () const

int	unref_nodelete () const

int	referenceCount () const

ObserverSet *	getObserverSet () const

ObserverSet *	getOrCreateObserverSet () const

void	addObserver (Observer *observer) const

void	removeObserver (Observer *observer) const

Public Member Functions inherited from osg::NodeCallback
	NodeCallback ()

	NodeCallback (const NodeCallback &nc, const CopyOp &copyop)

	META_Object (osg, NodeCallback)

Protected Member Functions
virtual	~ClusterCullingCallback ()

Protected Member Functions inherited from osg::Callback
virtual	~Callback ()

Protected Member Functions inherited from osg::Object
virtual	~Object ()

Protected Member Functions inherited from osg::Referenced
virtual	~Referenced ()

void	signalObserversAndDelete (bool signalDelete, bool doDelete) const

void	deleteUsingDeleteHandler () const

Protected Member Functions inherited from osg::NodeCallback
virtual	~NodeCallback ()

Protected Attributes
osg::Vec3	_controlPoint

osg::Vec3	_normal

float	_radius

float	_deviation

Protected Attributes inherited from osg::Callback
ref_ptr< Callback >	_nestedCallback

Protected Attributes inherited from osg::Object
std::string	_name

DataVariance	_dataVariance

osg::UserDataContainer *	_userDataContainer

Protected Attributes inherited from osg::Referenced
OpenThreads::AtomicPtr	_observerSet

OpenThreads::Atomic	_refCount

Additional Inherited Members
Public Types inherited from osg::Object
enum	DataVariance { DYNAMIC , STATIC , UNSPECIFIED }

Static Public Member Functions inherited from osg::Referenced
static OpenThreads::Mutex *	getGlobalReferencedMutex ()

static void	setDeleteHandler (DeleteHandler *handler)

static DeleteHandler *	getDeleteHandler ()

Detailed Description

Implements cluster culling to cull back facing subgraphs and drawables. Derived from Drawable::CullCallback and osg::NodeCallback.

This culling callback is intended to be attached to a node using the setCullCallback method. If the node is a drawable cull(osg::NodeVisitor*, osg::Drawable*, osg::State*) otherwise operator()(Node*, NodeVisitor*) will be called during the cull traversal.

To decide whether the node (in case of a drawable) or its children (in case of any other node type) are to be culled depends on four parameters:

a control point,
a normal specified at the control point,
a deviation value representing the cosinus of an enclosed angle and
a radius describing a sphere around the control point.

The node is culled if the following two conditions are fulfilled:

the distance between the current eye/view point to the control point is larger or equal to radius,
the cosinus of the enclosed angle between the normal and the vector from the control point to the eye/view point is smaller(!) than the specified deviation value (normally this value is negative meaning that the enclosed angle between the control point and the eye/view point is larger than the angle indirectly specified by the deviation value).

Remarks: As the deviation is representing the cosine of an enclosed angle its value should be within the the interval [-1; 1]. A value of one will cull all nodes while a value of -1 will never cull a node. The deviation will normally have negative values because then the enclosed angle between the normal and the eye/view point is larger than 90 degrees (and therefore the eye sees the "back" from the control point).

Constructor & Destructor Documentation

◆ ClusterCullingCallback() [1/4]

osg::ClusterCullingCallback::ClusterCullingCallback ( )

◆ ClusterCullingCallback() [2/4]

osg::ClusterCullingCallback::ClusterCullingCallback	(	const ClusterCullingCallback &	ccc,
		const CopyOp &	copyop
	)

◆ ClusterCullingCallback() [3/4]

osg::ClusterCullingCallback::ClusterCullingCallback	(	const osg::Vec3 &	controlPoint,
		const osg::Vec3 &	normal,
		float	deviation,
		float	radius = `-1.0f`
	)

◆ ClusterCullingCallback() [4/4]

osg::ClusterCullingCallback::ClusterCullingCallback ( const osg::Drawable * drawable )

◆ ~ClusterCullingCallback()

virtual osg::ClusterCullingCallback::~ClusterCullingCallback ( )

inlineprotectedvirtual

Member Function Documentation

◆ asDrawableCullCallback() [1/2]

virtual DrawableCullCallback * osg::ClusterCullingCallback::asDrawableCullCallback ( )

inlinevirtual

Reimplemented from osg::DrawableCullCallback.

◆ asDrawableCullCallback() [2/2]

virtual const DrawableCullCallback * osg::ClusterCullingCallback::asDrawableCullCallback ( ) const

inlinevirtual

Reimplemented from osg::DrawableCullCallback.

◆ asNodeCallback() [1/2]

virtual NodeCallback * osg::ClusterCullingCallback::asNodeCallback ( )

inlinevirtual

Reimplemented from osg::Callback.

◆ asNodeCallback() [2/2]

virtual const NodeCallback * osg::ClusterCullingCallback::asNodeCallback ( ) const

inlinevirtual

Reimplemented from osg::Callback.

◆ computeFrom()

void osg::ClusterCullingCallback::computeFrom ( const osg::Drawable * drawable )

Computes the control point, normal, and deviation from the given drawable contents.

◆ cull()

virtual bool osg::ClusterCullingCallback::cull	(	osg::NodeVisitor *	,
		osg::Drawable *	,
		osg::State *
	)		const

virtual

deprecated.

Reimplemented from osg::DrawableCullCallback.

◆ getControlPoint()

const osg::Vec3 & osg::ClusterCullingCallback::getControlPoint ( ) const

inline

◆ getDeviation()

float osg::ClusterCullingCallback::getDeviation ( ) const

inline

◆ getNormal()

const osg::Vec3 & osg::ClusterCullingCallback::getNormal ( ) const

inline

◆ getRadius()

float osg::ClusterCullingCallback::getRadius ( ) const

inline

◆ META_Object()

osg::ClusterCullingCallback::META_Object	(	osg	,
		ClusterCullingCallback
	)

◆ operator()()

virtual void osg::ClusterCullingCallback::operator()	(	Node *	node,
		NodeVisitor *	nv
	)

virtual

Callback method called by the NodeVisitor when visiting a node.

Reimplemented from osg::NodeCallback.

◆ run()

virtual bool osg::ClusterCullingCallback::run	(	osg::Object *	object,
		osg::Object *	data
	)

inlinevirtual

Invoke the callback, first parameter is the Object that the callback is attached to, the second parameter, the data, is typically the NodeVisitor that is invoking the callback. The run(..) method may be overridden by users directly, or if the user is using one of the old style callbacks such as NodeCallback or Drawable::UpdateCallback then you can just override the appropriate callback method on those callback subclasses. If you are implementing your own callback then one should call traverse() to make sure nested callbacks and visitor traversal() is completed.

Reimplemented from osg::Callback.

◆ set()

void osg::ClusterCullingCallback::set	(	const osg::Vec3 &	controlPoint,
		const osg::Vec3 &	normal,
		float	deviation,
		float	radius
	)

◆ setControlPoint()

void osg::ClusterCullingCallback::setControlPoint ( const osg::Vec3 & controlPoint )

inline

◆ setDeviation()

void osg::ClusterCullingCallback::setDeviation ( float deviation )

inline

◆ setNormal()

void osg::ClusterCullingCallback::setNormal ( const osg::Vec3 & normal )

inline

◆ setRadius()

void osg::ClusterCullingCallback::setRadius ( float radius )

inline

◆ transform()

void osg::ClusterCullingCallback::transform ( const osg::Matrixd & matrix )

Transform the ClusterCullingCallback's positional members to a new coordinate frame.

Member Data Documentation

◆ _controlPoint

osg::Vec3 osg::ClusterCullingCallback::_controlPoint

protected

◆ _deviation

float osg::ClusterCullingCallback::_deviation

protected

◆ _normal

osg::Vec3 osg::ClusterCullingCallback::_normal

protected

◆ _radius

float osg::ClusterCullingCallback::_radius

protected

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

ClusterCullingCallback

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ClusterCullingCallback() [1/4]

◆ ClusterCullingCallback() [2/4]

◆ ClusterCullingCallback() [3/4]

◆ ClusterCullingCallback() [4/4]

◆ ~ClusterCullingCallback()

Member Function Documentation

◆ asDrawableCullCallback() [1/2]

◆ asDrawableCullCallback() [2/2]

◆ asNodeCallback() [1/2]

◆ asNodeCallback() [2/2]

◆ computeFrom()

◆ cull()

◆ getControlPoint()

◆ getDeviation()

◆ getNormal()

◆ getRadius()

◆ META_Object()

◆ operator()()

◆ run()

◆ set()

◆ setControlPoint()

◆ setDeviation()

◆ setNormal()

◆ setRadius()

◆ transform()

Member Data Documentation

◆ _controlPoint

◆ _deviation

◆ _normal

◆ _radius