openscenegraph
Classes | Public Types | Public Member Functions | Protected Member Functions | Protected Attributes | Friends | List of all members
osg::StateAttribute Class Referenceabstract

#include <StateAttribute>

Inheritance diagram for osg::StateAttribute:
osg::Object osg::Referenced osg::AlphaFunc osg::BindImageTexture osg::BlendColor osg::BlendEquation osg::BlendFunc osg::BufferIndexBinding osg::Capability osg::ClampColor osg::ClipControl osg::ClipPlane osg::ColorMask osg::ColorMatrix osg::CullFace osg::Depth osg::DepthRangeIndexed osg::Fog osg::FragmentProgram osg::FrameBufferObject osg::FrontFace osg::Hint osg::Light osg::LightModel osg::LineStipple osg::LineWidth osg::LogicOp osg::Material osg::Multisample osg::PatchParameter osg::Point osg::PointSprite osg::PolygonMode osg::PolygonOffset osg::PolygonStipple osg::PrimitiveRestartIndex osg::Program osg::SampleMaski osg::Sampler osg::Scissor osg::ScissorIndexed osg::ShadeModel osg::ShaderAttribute osg::Stencil osg::StencilTwoSided osg::TexEnv osg::TexEnvCombine osg::TexEnvFilter osg::TexGen osg::TexMat osg::Texture osg::VertexAttribDivisor osg::VertexProgram osg::Viewport osgFX::Validator

Classes

struct  ModeUsage
 
struct  ReassignToParents
 

Public Types

enum  Values {
  OFF = 0x0 , ON = 0x1 , OVERRIDE = 0x2 , PROTECTED = 0x4 ,
  INHERIT = 0x8
}
 
enum  Type {
  TEXTURE , POLYGONMODE , POLYGONOFFSET , MATERIAL ,
  ALPHAFUNC , ANTIALIAS , COLORTABLE , CULLFACE ,
  FOG , FRONTFACE , LIGHT , POINT ,
  LINEWIDTH , LINESTIPPLE , POLYGONSTIPPLE , SHADEMODEL ,
  TEXENV , TEXENVFILTER , TEXGEN , TEXMAT ,
  LIGHTMODEL , BLENDFUNC , BLENDEQUATION , LOGICOP ,
  STENCIL , COLORMASK , DEPTH , VIEWPORT ,
  SCISSOR , BLENDCOLOR , MULTISAMPLE , CLIPPLANE ,
  COLORMATRIX , VERTEXPROGRAM , FRAGMENTPROGRAM , POINTSPRITE ,
  PROGRAM , CLAMPCOLOR , HINT , SAMPLEMASKI ,
  PRIMITIVERESTARTINDEX , CLIPCONTROL , VALIDATOR , VIEWMATRIXEXTRACTOR ,
  OSGNV_PARAMETER_BLOCK , OSGNVEXT_TEXTURE_SHADER , OSGNVEXT_VERTEX_PROGRAM , OSGNVEXT_REGISTER_COMBINERS ,
  OSGNVCG_PROGRAM , OSGNVSLANG_PROGRAM , OSGNVPARSE_PROGRAM_PARSER , UNIFORMBUFFERBINDING ,
  TRANSFORMFEEDBACKBUFFERBINDING , ATOMICCOUNTERBUFFERBINDING , PATCH_PARAMETER , FRAME_BUFFER_OBJECT ,
  VERTEX_ATTRIB_DIVISOR , SHADERSTORAGEBUFFERBINDING , INDIRECTDRAWBUFFERBINDING , VIEWPORTINDEXED ,
  DEPTHRANGEINDEXED , SCISSORINDEXED , BINDIMAGETEXTURE , SAMPLER ,
  CAPABILITY = 100
}
 
typedef GLenum GLMode
 
typedef unsigned int GLModeValue
 
typedef unsigned int OverrideValue
 
typedef std::pair< Type, unsigned int > TypeMemberPair
 
typedef std::vector< StateSet * > ParentList
 
typedef osg::StateAttributeCallback Callback
 
- Public Types inherited from osg::Object
enum  DataVariance { DYNAMIC , STATIC , UNSPECIFIED }
 

Public Member Functions

 StateAttribute ()
 
 StateAttribute (const StateAttribute &sa, const CopyOp &copyop=CopyOp::SHALLOW_COPY)
 
virtual ObjectcloneType () const =0
 
virtual Objectclone (const CopyOp &) const =0
 
virtual bool isSameKindAs (const Object *obj) const
 
virtual const char * libraryName () const
 
virtual const char * className () const
 
virtual StateAttributeasStateAttribute ()
 
virtual const StateAttributeasStateAttribute () const
 
virtual TextureasTexture ()
 
virtual const TextureasTexture () const
 
virtual Type getType () const =0
 
virtual unsigned int getMember () const
 
TypeMemberPair getTypeMemberPair () const
 
virtual bool isTextureAttribute () const
 
virtual int compare (const StateAttribute &sa) const =0
 
bool operator< (const StateAttribute &rhs) const
 
bool operator== (const StateAttribute &rhs) const
 
bool operator!= (const StateAttribute &rhs) const
 
const ParentListgetParents () const
 
StateSetgetParent (unsigned int i)
 
const StateSetgetParent (unsigned int i) const
 
unsigned int getNumParents () const
 
void setShaderComponent (ShaderComponent *sc)
 
ShaderComponentgetShaderComponent ()
 
const ShaderComponentgetShaderComponent () const
 
virtual bool getModeUsage (ModeUsage &) const
 
virtual bool checkValidityOfAssociatedModes (osg::State &) const
 
void setUpdateCallback (StateAttributeCallback *uc)
 
StateAttributeCallbackgetUpdateCallback ()
 
const StateAttributeCallbackgetUpdateCallback () const
 
void setEventCallback (StateAttributeCallback *ec)
 
StateAttributeCallbackgetEventCallback ()
 
const StateAttributeCallbackgetEventCallback () const
 
virtual void apply (State &) const
 
virtual void compileGLObjects (State &) const
 
virtual void resizeGLObjectBuffers (unsigned int)
 
virtual void releaseGLObjects (State *=0) const
 
- Public Member Functions inherited from osg::Object
 Object ()
 
 Object (bool threadSafeRefUnref)
 
 Object (const Object &, const CopyOp &copyop=CopyOp::SHALLOW_COPY)
 
std::string getCompoundClassName () const
 
virtual NodeasNode ()
 
virtual const NodeasNode () const
 
virtual NodeVisitorasNodeVisitor ()
 
virtual const NodeVisitorasNodeVisitor () const
 
virtual StateSetasStateSet ()
 
virtual const StateSetasStateSet () const
 
virtual UniformasUniform ()
 
virtual const UniformasUniform () const
 
virtual CameraasCamera ()
 
virtual const CameraasCamera () const
 
virtual DrawableasDrawable ()
 
virtual const DrawableasDrawable () const
 
virtual CallbackasCallback ()
 
virtual const CallbackasCallback () const
 
virtual CallbackObjectasCallbackObject ()
 
virtual const CallbackObjectasCallbackObject () const
 
virtual UserDataContainerasUserDataContainer ()
 
virtual const UserDataContainerasUserDataContainer () const
 
virtual ValueObjectasValueObject ()
 
virtual const ValueObjectasValueObject () const
 
virtual ImageasImage ()
 
virtual const ImageasImage () 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::UserDataContainergetUserDataContainer ()
 
const osg::UserDataContainergetUserDataContainer () const
 
osg::UserDataContainergetOrCreateUserDataContainer ()
 
virtual void setUserData (Referenced *obj)
 
template<class T >
void setUserData (const ref_ptr< T > &ud)
 
virtual ReferencedgetUserData ()
 
virtual const ReferencedgetUserData () 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)
 
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 &)
 
Referencedoperator= (const Referenced &)
 
bool getThreadSafeRefUnref () const
 
OpenThreads::MutexgetRefMutex () const
 
int ref () const
 
int unref () const
 
int unref_nodelete () const
 
int referenceCount () const
 
ObserverSetgetObserverSet () const
 
ObserverSetgetOrCreateObserverSet () const
 
void addObserver (Observer *observer) const
 
void removeObserver (Observer *observer) const
 

Protected Member Functions

virtual ~StateAttribute ()
 
void addParent (osg::StateSet *object)
 
void removeParent (osg::StateSet *object)
 
- 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 Attributes

ParentList _parents
 
ref_ptr< ShaderComponent_shaderComponent
 
ref_ptr< StateAttributeCallback_updateCallback
 
ref_ptr< StateAttributeCallback_eventCallback
 
- 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
 

Friends

class osg::StateSet
 

Additional Inherited Members

- Static Public Member Functions inherited from osg::Referenced
static OpenThreads::MutexgetGlobalReferencedMutex ()
 
static void setDeleteHandler (DeleteHandler *handler)
 
static DeleteHandlergetDeleteHandler ()
 

Detailed Description

Base class for state attributes.

Member Typedef Documentation

◆ Callback

◆ GLMode

GLMode is the value used in glEnable/glDisable(mode)

◆ GLModeValue

typedef unsigned int osg::StateAttribute::GLModeValue

GLModeValue is used to specify whether a mode is enabled (ON) or disabled (OFF). GLMoveValue is also used to specify the override behavior of modes from parent to children. See enum Value description for more details.

◆ OverrideValue

typedef unsigned int osg::StateAttribute::OverrideValue

Override is used to specify the override behavior of StateAttributes from parent to children. See enum Value description for more details.

◆ ParentList

A vector of osg::StateSet pointers which is used to store the parent(s) of this StateAttribute.

◆ TypeMemberPair

typedef std::pair<Type,unsigned int> osg::StateAttribute::TypeMemberPair

Simple pairing between an attribute type and the member within that attribute type group.

Member Enumeration Documentation

◆ Type

Type identifier to differentiate between different state types. Values of StateAttribute::Type used to aid identification of different StateAttribute subclasses. Each subclass defines its own value in the virtual Type getType() method. When extending the osg's StateAttribute's simply define your own Type value which is unique, using the StateAttribute::Type enum as a guide of what values to use. If your new subclass needs to override a standard StateAttribute then simply use that type's value.

Enumerator
TEXTURE 
POLYGONMODE 
POLYGONOFFSET 
MATERIAL 
ALPHAFUNC 
ANTIALIAS 
COLORTABLE 
CULLFACE 
FOG 
FRONTFACE 
LIGHT 
POINT 
LINEWIDTH 
LINESTIPPLE 
POLYGONSTIPPLE 
SHADEMODEL 
TEXENV 
TEXENVFILTER 
TEXGEN 
TEXMAT 
LIGHTMODEL 
BLENDFUNC 
BLENDEQUATION 
LOGICOP 
STENCIL 
COLORMASK 
DEPTH 
VIEWPORT 
SCISSOR 
BLENDCOLOR 
MULTISAMPLE 
CLIPPLANE 
COLORMATRIX 
VERTEXPROGRAM 
FRAGMENTPROGRAM 
POINTSPRITE 
PROGRAM 
CLAMPCOLOR 
HINT 
SAMPLEMASKI 
PRIMITIVERESTARTINDEX 
CLIPCONTROL 
VALIDATOR 

osgFX namespace

VIEWMATRIXEXTRACTOR 
OSGNV_PARAMETER_BLOCK 

osgNV namespace

OSGNVEXT_TEXTURE_SHADER 
OSGNVEXT_VERTEX_PROGRAM 
OSGNVEXT_REGISTER_COMBINERS 
OSGNVCG_PROGRAM 

osgNVCg namespace

OSGNVSLANG_PROGRAM 
OSGNVPARSE_PROGRAM_PARSER 
UNIFORMBUFFERBINDING 
TRANSFORMFEEDBACKBUFFERBINDING 
ATOMICCOUNTERBUFFERBINDING 
PATCH_PARAMETER 
FRAME_BUFFER_OBJECT 
VERTEX_ATTRIB_DIVISOR 
SHADERSTORAGEBUFFERBINDING 
INDIRECTDRAWBUFFERBINDING 
VIEWPORTINDEXED 
DEPTHRANGEINDEXED 
SCISSORINDEXED 
BINDIMAGETEXTURE 
SAMPLER 
CAPABILITY 

◆ Values

list values which can be used to set either GLModeValues or OverrideValues. When using in conjunction with GLModeValues, all Values have meaning. When using in conjunction with StateAttribute OverrideValue only OFF,OVERRIDE and INHERIT are meaningful. However, they are useful when using GLModeValue and OverrideValue in conjunction with each other as when using StateSet::setAttributeAndModes(..).

Enumerator
OFF 

means that associated GLMode and Override is disabled.

ON 

means that associated GLMode is enabled and Override is disabled.

OVERRIDE 

Overriding of GLMode's or StateAttributes is enabled, so that state below it is overridden.

PROTECTED 

Protecting of GLMode's or StateAttributes is enabled, so that state from above cannot override this and below state.

INHERIT 

means that GLMode or StateAttribute should be inherited from above.

Constructor & Destructor Documentation

◆ StateAttribute() [1/2]

osg::StateAttribute::StateAttribute ( )

◆ StateAttribute() [2/2]

osg::StateAttribute::StateAttribute ( const StateAttribute sa,
const CopyOp copyop = CopyOp::SHALLOW_COPY 
)
inline

◆ ~StateAttribute()

virtual osg::StateAttribute::~StateAttribute ( )
inlineprotectedvirtual

Member Function Documentation

◆ addParent()

void osg::StateAttribute::addParent ( osg::StateSet object)
protected

◆ apply()

virtual void osg::StateAttribute::apply ( State ) const
inlinevirtual

◆ asStateAttribute() [1/2]

virtual StateAttribute * osg::StateAttribute::asStateAttribute ( )
inlinevirtual

Convert 'this' into a StateAttribute pointer if Object is a StateAttribute, otherwise return 0. Equivalent to dynamic_cast<StateAttribute*>(this).

Reimplemented from osg::Object.

◆ asStateAttribute() [2/2]

virtual const StateAttribute * osg::StateAttribute::asStateAttribute ( ) const
inlinevirtual

convert 'const this' into a const StateAttribute pointer if Object is a StateAttribute, otherwise return 0. Equivalent to dynamic_cast<const StateAttribute*>(this).

Reimplemented from osg::Object.

◆ asTexture() [1/2]

virtual Texture * osg::StateAttribute::asTexture ( )
inlinevirtual

Fast alternative to dynamic_cast<> for determining if state attribute is a Texture.

Reimplemented in osg::Texture.

◆ asTexture() [2/2]

virtual const Texture * osg::StateAttribute::asTexture ( ) const
inlinevirtual

Fast alternative to dynamic_cast<> for determining if state attribute is a Texture.

Reimplemented in osg::Texture.

◆ checkValidityOfAssociatedModes()

virtual bool osg::StateAttribute::checkValidityOfAssociatedModes ( osg::State ) const
inlinevirtual

Check the modes associated with this StateAttribute are supported by current OpenGL drivers, and if not set the associated mode in osg::State to be black listed/invalid. Return true if all associated modes are valid.

Reimplemented in osg::PointSprite.

◆ className()

virtual const char * osg::StateAttribute::className ( ) const
inlinevirtual

Return the name of the attribute's class type.

Implements osg::Object.

Reimplemented in osg::ClipPlane, osg::Hint, osg::Light, osg::ShaderAttribute, osg::Texture, osg::VertexAttribDivisor, and osgText::GlyphTexture.

◆ clone()

virtual Object * osg::StateAttribute::clone ( const CopyOp ) const
pure virtual

Clone an attribute, with Object* return type. Must be defined by derived classes.

Implements osg::Object.

Implemented in osg::Texture, osg::ClipPlane, osg::Hint, osg::Light, osg::ShaderAttribute, and osg::VertexAttribDivisor.

◆ cloneType()

virtual Object * osg::StateAttribute::cloneType ( ) const
pure virtual

Clone the type of an attribute, with Object* return type. Must be defined by derived classes.

Implements osg::Object.

Implemented in osg::ClipPlane, osg::Hint, osg::Light, osg::ShaderAttribute, osg::VertexAttribDivisor, and osg::Texture.

◆ compare()

virtual int osg::StateAttribute::compare ( const StateAttribute sa) const
pure virtual

◆ compileGLObjects()

virtual void osg::StateAttribute::compileGLObjects ( State ) const
inlinevirtual

Default to nothing to compile - all state is applied immediately.

Reimplemented in osg::Program, osgFX::Validator, osg::Sampler, osg::FragmentProgram, osg::ShaderAttribute, osg::Texture, and osg::VertexProgram.

◆ getEventCallback() [1/2]

StateAttributeCallback * osg::StateAttribute::getEventCallback ( )
inline

Get the non const EventCallback.

◆ getEventCallback() [2/2]

const StateAttributeCallback * osg::StateAttribute::getEventCallback ( ) const
inline

Get the const EventCallback.

◆ getMember()

virtual unsigned int osg::StateAttribute::getMember ( ) const
inlinevirtual

Return the member identifier within the attribute's class type. Used for light number/clip plane number etc.

Reimplemented in osg::BindImageTexture, osg::BlendEquationi, osg::BlendFunci, osg::BufferIndexBinding, osg::Capabilityi, osg::ClipPlane, osg::ColorMaski, osg::DepthRangeIndexed, osg::Hint, osg::Light, osg::ScissorIndexed, osg::VertexAttribDivisor, and osg::ViewportIndexed.

◆ getModeUsage()

virtual bool osg::StateAttribute::getModeUsage ( ModeUsage ) const
inlinevirtual

◆ getNumParents()

unsigned int osg::StateAttribute::getNumParents ( ) const
inline

Get the number of parents of this StateAttribute.

Returns
the number of parents of this StateAttribute.

◆ getParent() [1/2]

StateSet * osg::StateAttribute::getParent ( unsigned int  i)
inline

◆ getParent() [2/2]

const StateSet * osg::StateAttribute::getParent ( unsigned int  i) const
inline

Get a single const parent of this StateAttribute.

Parameters
iindex of the parent to get.
Returns
the parent i.

◆ getParents()

const ParentList & osg::StateAttribute::getParents ( ) const
inline

Get the parent list of this StateAttribute.

◆ getShaderComponent() [1/2]

ShaderComponent * osg::StateAttribute::getShaderComponent ( )
inline

◆ getShaderComponent() [2/2]

const ShaderComponent * osg::StateAttribute::getShaderComponent ( ) const
inline

◆ getType()

virtual Type osg::StateAttribute::getType ( ) const
pure virtual

Return the Type identifier of the attribute's class type.

Implemented in osg::Capability, osg::ClipPlane, osg::Hint, osg::Light, osg::ShaderAttribute, osg::Texture, and osg::VertexAttribDivisor.

◆ getTypeMemberPair()

TypeMemberPair osg::StateAttribute::getTypeMemberPair ( ) const
inline

Return the TypeMemberPair that uniquely identifies this type member.

◆ getUpdateCallback() [1/2]

StateAttributeCallback * osg::StateAttribute::getUpdateCallback ( )
inline

Get the non const UpdateCallback.

◆ getUpdateCallback() [2/2]

const StateAttributeCallback * osg::StateAttribute::getUpdateCallback ( ) const
inline

Get the const UpdateCallback.

◆ isSameKindAs()

virtual bool osg::StateAttribute::isSameKindAs ( const Object obj) const
inlinevirtual

Return true if this and obj are of the same kind of object.

Reimplemented from osg::Object.

Reimplemented in osg::ClipPlane, osg::Hint, osg::Light, osg::ShaderAttribute, osg::Texture, and osg::VertexAttribDivisor.

◆ isTextureAttribute()

virtual bool osg::StateAttribute::isTextureAttribute ( ) const
inlinevirtual

Return true if StateAttribute is a type which controls texturing and needs to be issued w.r.t to specific texture unit.

Reimplemented in osg::PointSprite, osg::TexEnv, osg::TexEnvCombine, osg::TexEnvFilter, osg::TexGen, osg::TexMat, and osg::Texture.

◆ libraryName()

virtual const char * osg::StateAttribute::libraryName ( ) const
inlinevirtual

Return the name of the attribute's library.

Implements osg::Object.

Reimplemented in osg::ClipPlane, osg::Hint, osg::Light, osg::ShaderAttribute, osg::Texture, and osg::VertexAttribDivisor.

◆ operator!=()

bool osg::StateAttribute::operator!= ( const StateAttribute rhs) const
inline

◆ operator<()

bool osg::StateAttribute::operator< ( const StateAttribute rhs) const
inline

◆ operator==()

bool osg::StateAttribute::operator== ( const StateAttribute rhs) const
inline

◆ releaseGLObjects()

virtual void osg::StateAttribute::releaseGLObjects ( State = 0) const
inlinevirtual

Release OpenGL objects in specified graphics context if State object is passed, otherwise release OpenGL objects for all graphics context if State object pointer NULL.

Reimplemented from osg::Object.

Reimplemented in osg::FrameBufferObject, osg::Program, osg::FragmentProgram, osg::Sampler, osg::ShaderAttribute, osg::Texture, and osg::VertexProgram.

◆ removeParent()

void osg::StateAttribute::removeParent ( osg::StateSet object)
protected

◆ resizeGLObjectBuffers()

virtual void osg::StateAttribute::resizeGLObjectBuffers ( unsigned int  )
inlinevirtual

Resize any per context GLObject buffers to specified size.

Reimplemented from osg::Object.

Reimplemented in osg::FragmentProgram, osg::FrameBufferObject, osg::Program, osg::ShaderAttribute, osg::Texture, osg::VertexProgram, and osgText::GlyphTexture.

◆ setEventCallback()

void osg::StateAttribute::setEventCallback ( StateAttributeCallback ec)

Set the EventCallback which allows users to attach customize the updating of an object during the Event traversal.

◆ setShaderComponent()

void osg::StateAttribute::setShaderComponent ( ShaderComponent sc)
inline

◆ setUpdateCallback()

void osg::StateAttribute::setUpdateCallback ( StateAttributeCallback uc)

Set the UpdateCallback which allows users to attach customize the updating of an object during the update traversal.

Friends And Related Symbol Documentation

◆ osg::StateSet

friend class osg::StateSet
friend

Member Data Documentation

◆ _eventCallback

ref_ptr<StateAttributeCallback> osg::StateAttribute::_eventCallback
protected

◆ _parents

ParentList osg::StateAttribute::_parents
protected

◆ _shaderComponent

ref_ptr<ShaderComponent> osg::StateAttribute::_shaderComponent
protected

◆ _updateCallback

ref_ptr<StateAttributeCallback> osg::StateAttribute::_updateCallback
protected

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