com.openinventor.inventor.elements

Class SoGLCacheContextElement

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.elements.SoElement

com.openinventor.inventor.elements.SoGLCacheContextElement

Deprecated.

As of Open Inventor 9620 See documentation for more details

public class SoGLCacheContextElement
extends SoElement

Class: SoCacheContextElement. Element that stores the cache context. There is a method on the render action to set this; if you are not rendering onto multiple displays, you will not need to set this (assuming that caches are shareable between different windows on the same display, which is true of GLX).

This element should be set before traversal starts, and must not be changed during traversal (you'll get a debug error if a node tries to set the cache context during traversal).

This method also has API for quickly finding out whether or not OpenGL extensions are supported. Code that uses extension "foo" should look something like:

 #ifdef GL_EXT_foo
     static int fooExtInt = -1;
     if (fooExtInt == -1)
         fooExtInt = SoGLCacheContextElement.getExtID("GL_EXT_foo");
     if (SoGLCacheContextElement.extSupported(state, fooExtInt)) {
         glFoo(... make extension foo calls...);
     } else {
 #endif
         Extension not supported, make regular GL calls
 #ifdef GL_EXT_foo
     }
 #endif

Arranging the code that way ensures that it both compiles on systems that don't support the extension AND will run on any OpenGL-capable machine, even if the application displays on multiple displays (only some of which may support the extension).Deprecated since Open Inventor 9620
SoGLCacheContextElement is no longer supported. See section http://oivdoc96.vsg3d.com/content/compatibility-notes-4#Deprecation of the Reference Manual.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoGLCacheContextElement.AutoCacheModes Deprecated. Two bits are stored.

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

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
static int	DO_AUTO_CACHE Deprecated. Use SoGLCacheContextElement.AutoCacheModes.DO_AUTO_CACHE instead.
static int	DONT_AUTO_CACHE Deprecated. Use SoGLCacheContextElement.AutoCacheModes.DONT_AUTO_CACHE instead.

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Method Summary

Modifier and Type	Method and Description
static boolean	areMipMapsFast(SoState state) Deprecated. true if mip-mapped textures are known to be fast.
static boolean	extSupported(SoState state, int ext) Deprecated. This routine is pretty quick.
static int	get(SoState state) Deprecated. Gets the current context.
static int	getClassStackIndex() Deprecated. As of Open Inventor 9.3 replaced by SoElement.getClassStackIndex(Class)
static int	getExtID(java.lang.String str) Deprecated. Methods to quickly figure out if an OpenGL extension is available at run-time.
static boolean	getIsRemoteRendering(SoState state) Deprecated.
static boolean	isCompileModeFaster(SoState state) Deprecated. true if we think GL_COMPILE is faster than GL_COMPILE_AND_EXECUTE.
static int	resetAutoCacheBits(SoState state) Deprecated. Used by Separators to set/reset the auto-caching bits.
static void	set(SoState state, int context, boolean is2PassTransparency, boolean isRemoteRendering) Deprecated. Sets the current context.
static void	setAutoCacheBits(SoState state, int bits) Deprecated. Used by Separators to set/reset the auto-caching bits.
static void	shouldAutoCache(SoState state, int bits) Deprecated. Called by nodes to say that they should/shouldn't be auto-cached (pass true if should, false if shouldn't, don't call this method at all if the node doesn't care):
static void	shouldAutoCache(SoState state, SoGLCacheContextElement.AutoCacheModes mode) Deprecated. As of Open Inventor 9620 See documentation for more details

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

getClassStackIndex, pop, push

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

Field Detail

DO_AUTO_CACHE

@Deprecated
public static final int DO_AUTO_CACHE

Deprecated. Use SoGLCacheContextElement.AutoCacheModes.DO_AUTO_CACHE instead.

DONT_AUTO_CACHE

@Deprecated
public static final int DONT_AUTO_CACHE

Deprecated. Use SoGLCacheContextElement.AutoCacheModes.DONT_AUTO_CACHE instead.

Method Detail

setAutoCacheBits

public static void setAutoCacheBits(SoState state,
                                    int bits)

Deprecated.

Used by Separators to set/reset the auto-caching bits.

shouldAutoCache

public static void shouldAutoCache(SoState state,
                                   int bits)

Deprecated.

Called by nodes to say that they should/shouldn't be auto-cached (pass true if should, false if shouldn't, don't call this method at all if the node doesn't care):

extSupported

public static boolean extSupported(SoState state,
                                   int ext)

Deprecated.

This routine is pretty quick.

isCompileModeFaster

public static boolean isCompileModeFaster(SoState state)

Deprecated.

true if we think GL_COMPILE is faster than GL_COMPILE_AND_EXECUTE.

areMipMapsFast

public static boolean areMipMapsFast(SoState state)

Deprecated.

true if mip-mapped textures are known to be fast.

shouldAutoCache

@Deprecated
public static void shouldAutoCache(SoState state,
                                                SoGLCacheContextElement.AutoCacheModes mode)

Deprecated. As of Open Inventor 9620 See documentation for more details

Called by nodes to say that they should/shouldn't be auto-cached (pass true if should, false if shouldn't, don't call this method at all if the node doesn't care): Deprecated since Open Inventor 9620
Use SoGLRenderAction.shouldAutoCache(AutoCacheMode mode) instead.

get

public static int get(SoState state)

Deprecated.

Gets the current context.

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. *

set

public static void set(SoState state,
                       int context,
                       boolean is2PassTransparency,
                       boolean isRemoteRendering)

Deprecated.

Sets the current context. This is done by the renderAction; theoretically, a node that redirected the GL rendering context to another X server would also set this. This also frees up any display lists that are waiting for the context to become valid. The third argument indicates whether 2-pass transparency is in effect (as for DELAYED or SORTED blending), which means that caches containing transparent objects may not be valid. The fourth argument should be true if remote rendering is being done; the SoSeparator auto-caching algorithm uses this information to help decide whether or not to build caches.

resetAutoCacheBits

public static int resetAutoCacheBits(SoState state)

Deprecated.

Used by Separators to set/reset the auto-caching bits.

getExtID

public static int getExtID(java.lang.String str)

Deprecated.

Methods to quickly figure out if an OpenGL extension is available at run-time. This is the slow routine convert from a string to an integer. The integer should be saved to do quick lookups:

getIsRemoteRendering

public static boolean getIsRemoteRendering(SoState state)

Deprecated.