OSG  3.4.0
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
Public Types | Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
osg::Stencil Class Reference

#include <Stencil.h>

Inheritance diagram for osg::Stencil:
Inheritance graph
[legend]
Collaboration diagram for osg::Stencil:
Collaboration graph
[legend]

Public Types

enum  Function {
  NEVER = GL_NEVER, LESS = GL_LESS, EQUAL = GL_EQUAL, LEQUAL = GL_LEQUAL,
  GREATER = GL_GREATER, NOTEQUAL = GL_NOTEQUAL, GEQUAL = GL_GEQUAL, ALWAYS = GL_ALWAYS
}
 
enum  Operation {
  KEEP = GL_KEEP, ZERO = GL_ZERO, REPLACE = GL_REPLACE, INCR = GL_INCR,
  DECR = GL_DECR, INVERT = GL_INVERT, INCR_WRAP = GL_INCR_WRAP, DECR_WRAP = GL_DECR_WRAP
}
 
- Public Types inherited from osg::StateAttribute
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, 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

 Stencil ()
 
 Stencil (const Stencil &stencil, const CopyOp &copyop=CopyOp::SHALLOW_COPY)
 
 META_StateAttribute (osg, Stencil, STENCIL)
 
virtual int compare (const StateAttribute &sa) const
 
virtual bool getModeUsage (StateAttribute::ModeUsage &usage) const
 
void setFunction (Function func, int ref, unsigned int mask)
 
void setFunction (Function func)
 
Function getFunction () const
 
void setFunctionRef (int ref)
 
int getFunctionRef () const
 
void setFunctionMask (unsigned int mask)
 
unsigned int getFunctionMask () const
 
void setOperation (Operation sfail, Operation zfail, Operation zpass)
 
void setStencilFailOperation (Operation sfail)
 
Operation getStencilFailOperation () const
 
void setStencilPassAndDepthFailOperation (Operation zfail)
 
Operation getStencilPassAndDepthFailOperation () const
 
void setStencilPassAndDepthPassOperation (Operation zpass)
 
Operation getStencilPassAndDepthPassOperation () const
 
void setWriteMask (unsigned int mask)
 
unsigned int getWriteMask () const
 
virtual void apply (State &state) const
 
- Public Member Functions inherited from osg::StateAttribute
 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
 
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 checkValidityOfAssociatedModes (osg::State &) const
 
void setUpdateCallback (StateAttributeCallback *uc)
 
StateAttributeCallbackgetUpdateCallback ()
 
const StateAttributeCallbackgetUpdateCallback () const
 
void setEventCallback (StateAttributeCallback *ec)
 
StateAttributeCallbackgetEventCallback ()
 
const StateAttributeCallbackgetEventCallback () 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 UniformasUniform ()
 
virtual const UniformasUniform () 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)
 
osg::UserDataContainergetUserDataContainer ()
 
const osg::UserDataContainergetUserDataContainer () const
 
osg::UserDataContainergetOrCreateUserDataContainer ()
 
virtual void setUserData (Referenced *obj)
 
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 ~Stencil ()
 
- Protected Member Functions inherited from osg::StateAttribute
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

Function _func
 
int _funcRef
 
unsigned int _funcMask
 
Operation _sfail
 
Operation _zfail
 
Operation _zpass
 
unsigned int _writeMask
 
- Protected Attributes inherited from osg::StateAttribute
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
 

Additional Inherited Members

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

Detailed Description

Encapsulate OpenGL glStencilFunc/Op/Mask functions.

All functionality except INCR_WRAP and DECR_WRAP is supported by OpenGL 1.1. INCR_WRAP an DECR_WRAP are available since OpenGL 1.4 or when GL_EXT_stencil_wrap extension is present.

If INCR_WRAP or DECR_WRAP values are used while they are detected to be not supported, the INCR or DECR values are sent to OpenGL instead.

OpenGL 2.0 introduced two side stenciling that is available through osg::StencilTwoSided class.

Definition at line 39 of file Stencil.h.

Member Enumeration Documentation

Enumerator
NEVER 
LESS 
EQUAL 
LEQUAL 
GREATER 
NOTEQUAL 
GEQUAL 
ALWAYS 

Definition at line 85 of file Stencil.h.

Enumerator
KEEP 
ZERO 
REPLACE 
INCR 
DECR 
INVERT 
INCR_WRAP 
DECR_WRAP 

Definition at line 114 of file Stencil.h.

Constructor & Destructor Documentation

osg::Stencil::Stencil ( )
osg::Stencil::Stencil ( const Stencil stencil,
const CopyOp copyop = CopyOp::SHALLOW_COPY 
)
inline

Copy constructor using CopyOp to manage deep vs shallow copy.

Definition at line 47 of file Stencil.h.

virtual osg::Stencil::~Stencil ( )
protectedvirtual

Member Function Documentation

virtual void osg::Stencil::apply ( State ) const
virtual

apply the OpenGL state attributes. The render info for the current OpenGL context is passed in to allow the StateAttribute to obtain details on the the current context and state.

Reimplemented from osg::StateAttribute.

virtual int osg::Stencil::compare ( const StateAttribute sa) const
inlinevirtual

return -1 if *this < *rhs, 0 if *this==*rhs, 1 if *this>*rhs.

Implements osg::StateAttribute.

Definition at line 61 of file Stencil.h.

Function osg::Stencil::getFunction ( ) const
inline

Definition at line 105 of file Stencil.h.

unsigned int osg::Stencil::getFunctionMask ( ) const
inline

Definition at line 111 of file Stencil.h.

int osg::Stencil::getFunctionRef ( ) const
inline

Definition at line 108 of file Stencil.h.

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

Return the modes associated with this StateAttribute.

Reimplemented from osg::StateAttribute.

Definition at line 79 of file Stencil.h.

Here is the call graph for this function:

Operation osg::Stencil::getStencilFailOperation ( ) const
inline

get the operation when the stencil test fails.

Definition at line 144 of file Stencil.h.

Operation osg::Stencil::getStencilPassAndDepthFailOperation ( ) const
inline

get the operation when the stencil test passes but the depth test fails.

Definition at line 150 of file Stencil.h.

Operation osg::Stencil::getStencilPassAndDepthPassOperation ( ) const
inline

get the operation when both the stencil test and the depth test pass.

Definition at line 156 of file Stencil.h.

unsigned int osg::Stencil::getWriteMask ( ) const
inline

Definition at line 161 of file Stencil.h.

osg::Stencil::META_StateAttribute ( osg  ,
Stencil  ,
STENCIL   
)
void osg::Stencil::setFunction ( Function  func,
int  ref,
unsigned int  mask 
)
inline

Definition at line 97 of file Stencil.h.

void osg::Stencil::setFunction ( Function  func)
inline

Definition at line 104 of file Stencil.h.

void osg::Stencil::setFunctionMask ( unsigned int  mask)
inline

Definition at line 110 of file Stencil.h.

void osg::Stencil::setFunctionRef ( int  ref)
inline

Definition at line 107 of file Stencil.h.

void osg::Stencil::setOperation ( Operation  sfail,
Operation  zfail,
Operation  zpass 
)
inline

set the operations to apply when the various stencil and depth tests fail or pass. First parameter is to control the operation when the stencil test fails. The second parameter is to control the operation when the stencil test passes, but depth test fails. The third parameter controls the operation when both the stencil test and depth pass. Ordering of parameter is the same as if using glStencilOp(,,).

Definition at line 133 of file Stencil.h.

void osg::Stencil::setStencilFailOperation ( Operation  sfail)
inline

set the operation when the stencil test fails.

Definition at line 141 of file Stencil.h.

void osg::Stencil::setStencilPassAndDepthFailOperation ( Operation  zfail)
inline

set the operation when the stencil test passes but the depth test fails.

Definition at line 147 of file Stencil.h.

void osg::Stencil::setStencilPassAndDepthPassOperation ( Operation  zpass)
inline

set the operation when both the stencil test and the depth test pass.

Definition at line 153 of file Stencil.h.

void osg::Stencil::setWriteMask ( unsigned int  mask)
inline

Definition at line 159 of file Stencil.h.

Member Data Documentation

Function osg::Stencil::_func
protected

Definition at line 171 of file Stencil.h.

unsigned int osg::Stencil::_funcMask
protected

Definition at line 173 of file Stencil.h.

int osg::Stencil::_funcRef
protected

Definition at line 172 of file Stencil.h.

Operation osg::Stencil::_sfail
protected

Definition at line 175 of file Stencil.h.

unsigned int osg::Stencil::_writeMask
protected

Definition at line 179 of file Stencil.h.

Operation osg::Stencil::_zfail
protected

Definition at line 176 of file Stencil.h.

Operation osg::Stencil::_zpass
protected

Definition at line 177 of file Stencil.h.


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