Manages several properties that need to be lazily tracked for OpenGL. More...

#include <Inventor/elements/SoLazyElement.h>

Inheritance diagram for SoLazyElement:

Public Types
enum	cases { LIGHT_MODEL_CASE = 0 , COLOR_MATERIAL_CASE = 1 , DIFFUSE_CASE = 2 , AMBIENT_CASE = 3 , EMISSIVE_CASE = 4 , SPECULAR_CASE = 5 , SHININESS_CASE = 6 , BLENDING_CASE = 7 , TRANSPARENCY_CASE = 8 , PATTERN_CASE = 9 , SMOOTHING_CASE = 10 , LINE_WIDTH_CASE = 11 }
	Following masks and cases define the components of the lazy element. More...

enum	masks { LIGHT_MODEL_MASK = 1 << LIGHT_MODEL_CASE , COLOR_MATERIAL_MASK = 1 << COLOR_MATERIAL_CASE , DIFFUSE_MASK = 1 << DIFFUSE_CASE , AMBIENT_MASK = 1 << AMBIENT_CASE , EMISSIVE_MASK = 1 << EMISSIVE_CASE , SPECULAR_MASK = 1 << SPECULAR_CASE , SHININESS_MASK = 1 << SHININESS_CASE , TRANSPARENCY_MASK = 1 << TRANSPARENCY_CASE , BLENDING_MASK = 1 << BLENDING_CASE , SMOOTHING_MASK = 1 << SMOOTHING_CASE , ALL_MASK = (1 << SO_LAZY_NUM_COMPONENTS)-1 , PATTERN_MASK = 1 << PATTERN_CASE , LINE_WIDTH_MASK = 1 << LINE_WIDTH_CASE }
	Masks. More...

Public Member Functions
int32_t	getNumDiffuse () const
	Method to inquire about current colors.

int32_t	getNumTransparencies () const
	Method to inquire about current colors.

int32_t	getNumColorIndices () const
	Method to inquire about current colors.

SbBool	isPacked () const
	Method to inquire about current colors.

SbBool	isTransparent () const
	Method to inquire about current colors.

virtual void	push (SoState *state)
	push (for non-GL elements)

virtual void	print (FILE *fp) const
	Prints element (for debugging).

Public Member Functions inherited from SoElement
virtual void	pop (SoState state, const SoElement prevTopElement)
	Pops element.

virtual SoType	getTypeId () const
	Returns type identifier for element instance.

Public Member Functions inherited from SoTypedObject
SbBool	isOfType (const SoType &type) const
	Returns TRUE if this object is of the type specified in type or is derived from that type.

template<typename TypedObjectClass >
SbBool	isOfType () const
	Returns TRUE if this object is of the type of class TypedObjectClass or is derived from that class.

Static Public Member Functions
static SoType	getClassTypeId ()
	Returns the type identifier for this class.

static int	getClassStackIndex ()
	Returns the stack id for this element.

static void	setDiffuse (SoState state, SoNode node, int32_t numColors, const SbColor colors, SoColorPacker cPacker)
	Static set method.

static void	setTransparency (SoState state, SoNode node, int32_t numTransp, const float transp, SoColorPacker cPacker)
	Static set method.

static void	setPacked (SoState state, SoNode node, SoColorPacker cPacker, int32_t numColors, const uint32_t colors)
	Static set method.

static void	setColorIndices (SoState state, SoNode node, int32_t numIndices, const int32_t *indices)
	Static set method.

static void	setAmbient (SoState state, SoNode node, const SbColor &color)

static void	setEmissive (SoState state, SoNode node, const SbColor &color)

static void	setSpecular (SoState state, SoNode node, const SbColor &color)

static void	setShininess (SoState state, SoNode node, float value)

static void	setColorMaterial (SoState state, SoNode node, SbBool value)

static void	setBlending (SoState *state, SbBool value)

static void	setSmoothing (SoState *state, SbBool value)

static void	setLightModel (SoState *state, const int32_t model)

static SbColor	getDiffuse (SoState *state, int index)
	get() methods get value from Inventor state.

static float	getTransparency (SoState *, int index)
	get() methods get value from Inventor state.

static const uint32_t *	getPackedColors (SoState *state)

static const int32_t *	getColorIndices (SoState *state)

static int32_t	getColorIndex (SoState *, int num)

static SbColor	getAmbient (SoState *)

static SbColor	getEmissive (SoState *)

static SbColor	getSpecular (SoState *)

static float	getShininess (SoState *)

static SbBool	getColorMaterial (SoState *)

static SbBool	getBlending (SoState *)

static SbBool	getSmoothing (SoState *)

static int32_t	getLightModel (SoState *)

static SoLazyElement *	getInstance (SoState *state)
	Returns the top (current) instance of the element in the state Note that the cache dependencies associated with this element are managed differently from other elements: this replaces the SoElement::getConstElement that is used by standard elements, but which causes cache dependency.

static float	getDefaultAmbientIntensity ()
	Specify Open Inventor defaults for colors, etc.

static SbColor	getDefaultDiffuse ()
	Specify Open Inventor defaults for colors, etc.

static SbColor	getDefaultAmbient ()
	Specify Open Inventor defaults for colors, etc.

static SbColor	getDefaultSpecular ()
	Specify Open Inventor defaults for colors, etc.

static SbColor	getDefaultEmissive ()
	Specify Open Inventor defaults for colors, etc.

static float	getDefaultShininess ()
	Specify Open Inventor defaults for colors, etc.

static uint32_t	getDefaultPackedInternal ()
	Specify Open Inventor defaults for colors, etc.

static uint32_t	getDefaultPacked ()
	Specify Open Inventor defaults for colors, etc.

static float	getDefaultTransparency ()
	Specify Open Inventor defaults for colors, etc.

static int32_t	getDefaultLightModel ()
	Specify Open Inventor defaults for colors, etc.

static int32_t	getDefaultColorIndex ()
	Specify Open Inventor defaults for colors, etc.

static float	getDefaultLineWidth ()
	Specify Open Inventor defaults for colors, etc.

Deprecated

static SoDEPRECATED void	setAmbient (SoState state, SoNode node, const SbColor *color)

static SoDEPRECATED void	setEmissive (SoState state, SoNode node, const SbColor *color)

static SoDEPRECATED void	setSpecular (SoState state, SoNode node, const SbColor *color)

Static Public Member Functions inherited from SoElement
static SoType	getClassTypeId ()
	Returns type identifier for SoElement class.

Static Public Member Functions inherited from SoTypedObject
static SoType	getClassTypeId ()
	Returns the type identifier for this class.

Related Symbols
(Note that these are not member symbols.)
#define	SO_LAZY_NUM_COMPONENTS 12
	Number of components (subelements) in this element:

Detailed Description

Manages several properties that need to be lazily tracked for OpenGL.

This element manages several properties such as colors, that need to be lazily tracked for OpenGL. Allows Open Inventor property nodes to set these properties without immediately making any OpenGL calls. Thus we avoid making redundant OpenGL calls to set, for example, the material color. Open Inventor rendering nodes then request that the values of any properties that are relevant to that shape and "out of date" (not current with OpenGL state) be sent to OpenGL.

Includes:
Transparencies
GLColorMaterial
GLBlendEnablement
PolygonStipple
Light model
Color index
Line width

Member Enumeration Documentation

◆ cases

enum SoLazyElement::cases

Following masks and cases define the components of the lazy element.

Masks are needed by SoEXTENDER apps that need to use SoGLLazyElement::reset(bitmask) to invalidate GL values of particular components. NOTE: the order of these cases should not be changed without careful consideration of dependencies in the reallySend method. Cases

Enumerator
LIGHT_MODEL_CASE	Light model case.
COLOR_MATERIAL_CASE	Color material case.
DIFFUSE_CASE	Diffuse case.
AMBIENT_CASE	Ambient case.
EMISSIVE_CASE	Emissive case.
SPECULAR_CASE	Specular case.
SHININESS_CASE	Shininess case.
BLENDING_CASE	Blending case.
TRANSPARENCY_CASE	Transparency case.
PATTERN_CASE	Pattern case.
SMOOTHING_CASE	Smoothing case.
LINE_WIDTH_CASE	Line width case.

Definition at line 121 of file SoLazyElement.h.

◆ masks

enum SoLazyElement::masks

Masks.

Enumerator
LIGHT_MODEL_MASK	Light model mask.
COLOR_MATERIAL_MASK	Color mask.
DIFFUSE_MASK	Diffuse mask.
AMBIENT_MASK	Ambient mask.
EMISSIVE_MASK	Emissive mask.
SPECULAR_MASK	Specular mask.
SHININESS_MASK	Shininess mask.
TRANSPARENCY_MASK	Transparency mask.
BLENDING_MASK	Blending mask.
SMOOTHING_MASK	Smoothing mask.
ALL_MASK	All masks.
PATTERN_MASK	Pattern mask.
LINE_WIDTH_MASK	Line width mask.

Definition at line 149 of file SoLazyElement.h.

Member Function Documentation

◆ getAmbient()

static SbColor SoLazyElement::getAmbient ( SoState * )

static

◆ getBlending()

static SbBool SoLazyElement::getBlending ( SoState * )

static

◆ getClassStackIndex()

static int SoLazyElement::getClassStackIndex ( )

static

Returns the stack id for this element.

◆ getClassTypeId()

static SoType SoLazyElement::getClassTypeId ( )

static

Returns the type identifier for this class.

◆ getColorIndex()

static int32_t SoLazyElement::getColorIndex	(	SoState *	,
		int	num
	)

static

◆ getColorIndices()

static const int32_t * SoLazyElement::getColorIndices ( SoState * state )

static

◆ getColorMaterial()

static SbBool SoLazyElement::getColorMaterial ( SoState * )

static