SoTextureEnabledElement Class Reference
[Elements]

Enables/disables textures. More...

#include <Inventor/elements/SoTextureEnabledElement.h>

Inheritance diagram for SoTextureEnabledElement:
SoReplacedTextureElement SoElement SoTypedObject SoGLTextureEnabledElement

List of all members.

Public Member Functions

virtual void push (SoState *state)
virtual void pop (SoState *state, const SoElement *prevTopElement)

Static Public Member Functions

static SoType getClassTypeId ()
static int getClassStackIndex ()
static void set (SoState *state, SbBool value, SoNode *node=NULL)
static SbBool get (SoState *state, int unit=0)
static SbBool getDefault ()

Detailed Description

Enables/disables textures.

This element enables/disables textures. This is implemented as a separate element from the TextureImageElement so the texture image can be changed without invalidating caches containing shapes -- shapes need to know if texturing is going on or not so they can decide to send down texture coordinates or not.

This element is set by the GLTextureImageElement and the GLTextureImageElement, but the interaction between the three elements is a little complicated. Each of the other two elements always sets up the GL texture state appropriately, however, texturing is only enabled if both elements agree that it should be enabled (they check each other's value before calling set).

This element cannot be overridden, but, since the elements that set it check each other's value, overriding those elements has the same effect.

SEE ALSO

SoTexture2, SoExtTexture2, SoImageBackground, SoTextureCubeMapEnabledElement, SoTexture3EnabledElement


Member Function Documentation

static SbBool SoTextureEnabledElement::get ( SoState state,
int  unit = 0 
) [static]

Used by shapes to figure out if they need to send texture coordinates.

static int SoTextureEnabledElement::getClassStackIndex (  )  [static]

Returns the stack id for this element.

Reimplemented from SoReplacedTextureElement.

Reimplemented in SoGLTextureEnabledElement.

static SoType SoTextureEnabledElement::getClassTypeId (  )  [static]

Returns the type identifier for this class.

Reimplemented from SoReplacedTextureElement.

Reimplemented in SoGLTextureEnabledElement.

static SbBool SoTextureEnabledElement::getDefault (  )  [inline, static]

By default there is no texture.

virtual void SoTextureEnabledElement::pop ( SoState state,
const SoElement prevTopElement 
) [virtual]

Overrides pop() method so side effects can occur in GL.

Reimplemented in SoGLTextureEnabledElement.

virtual void SoTextureEnabledElement::push ( SoState state  )  [virtual]

Overrides push() so we can remember previous element's value and avoid making GL calls if this element has the same value.

Reimplemented from SoReplacedTextureElement.

static void SoTextureEnabledElement::set ( SoState state,
SbBool  value,
SoNode node = NULL 
) [static]

Used by GLTextureImageElement, set to TRUE when a non-null image is set, set to FALSE when there is no texture image (the default).


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

Open Inventor Toolkit reference manual, generated on 12 Feb 2024
Copyright © Thermo Fisher Scientific All rights reserved.
http://www.openinventor.com/