com.openinventor.inventor.elements

Class SoTextureEnabledElement

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.elements.SoElement

com.openinventor.inventor.elements.SoReplacedTextureElement

com.openinventor.inventor.elements.SoTextureEnabledElement

Direct Known Subclasses:

SoGLTextureEnabledElement

public class SoTextureEnabledElement
extends SoReplacedTextureElement

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

Nested Class Summary

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Method Summary

Modifier and Type	Method and Description
static boolean	get(SoState state) Calls get(state, (int)0).
static boolean	get(SoState state, int unit) Used by shapes to figure out if they need to send texture coordinates.
static int	getClassStackIndex() Deprecated. As of Open Inventor 9.3 replaced by SoElement.getClassStackIndex(Class)
static boolean	getDefault() By default there is no texture.
void	pop(SoState state, SoElement prevTopElement) Overrides pop() method so side effects can occur in GL.
void	push(SoState state) Overrides push() so we can remember previous element's value and avoid making GL calls if this element has the same value.
static void	set(SoState state, boolean value) Calls set(state, value, (com.openinventor.inventor.nodes.SoNode)null).
static void	set(SoState state, boolean value, SoNode node) Used by GLTextureImageElement, set to true when a non-null image is set, set to false when there is no texture image (the default).

Methods inherited from class com.openinventor.inventor.elements.SoElement

getClassStackIndex

Methods inherited from class com.openinventor.inventor.Inventor

dispose, getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

get

public static boolean get(SoState state)

Calls get(state, (int)0).

set

public static void set(SoState state,
                       boolean value)

Calls set(state, value, (com.openinventor.inventor.nodes.SoNode)null).

getDefault

public static boolean getDefault()

By default there is no texture.

set

public static void set(SoState state,
                       boolean value,
                       SoNode node)

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

get

public static boolean get(SoState state,
                          int unit)

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

push

public void push(SoState state)

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

Overrides:

push in class SoReplacedTextureElement

pop

public void pop(SoState state,
                SoElement prevTopElement)

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

Overrides:

pop in class SoElement

getClassStackIndex

@Deprecated
public static int getClassStackIndex()

Deprecated. As of Open Inventor 9.3 replaced by SoElement.getClassStackIndex(Class)

Returns the stack id for this element. *