com.openinventor.inventor.elements

Class SoLazyElement

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.elements.SoElement

com.openinventor.inventor.elements.SoLazyElement

Direct Known Subclasses:

SoGLLazyElement

public class SoLazyElement
extends SoElement

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

See also:

SoBaseColor, SoMaterial, SoPackedColor, SoTransparencyType, SoVertexProperty

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoLazyElement.Cases Following masks and cases define the components of the lazy element.
static class	SoLazyElement.LightModels Enum values to be used in setting/getting light model.
static class	SoLazyElement.Masks Masks.

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

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
static int	ALL_MASK Deprecated. Use SoLazyElement.Masks.ALL_MASK instead.
static int	AMBIENT_CASE Deprecated. Use SoLazyElement.Cases.AMBIENT_CASE instead.
static int	AMBIENT_MASK Deprecated. Use SoLazyElement.Masks.AMBIENT_MASK instead.
static int	BASE_COLOR Deprecated. Use SoLazyElement.LightModels.BASE_COLOR instead.
static int	BLENDING_CASE Deprecated. Use SoLazyElement.Cases.BLENDING_CASE instead.
static int	BLENDING_MASK Deprecated. Use SoLazyElement.Masks.BLENDING_MASK instead.
static int	COLOR_MATERIAL_CASE Deprecated. Use SoLazyElement.Cases.COLOR_MATERIAL_CASE instead.
static int	COLOR_MATERIAL_MASK Deprecated. Use SoLazyElement.Masks.COLOR_MATERIAL_MASK instead.
static int	DIFFUSE_CASE Deprecated. Use SoLazyElement.Cases.DIFFUSE_CASE instead.
static int	DIFFUSE_MASK Deprecated. Use SoLazyElement.Masks.DIFFUSE_MASK instead.
static int	EMISSIVE_CASE Deprecated. Use SoLazyElement.Cases.EMISSIVE_CASE instead.
static int	EMISSIVE_MASK Deprecated. Use SoLazyElement.Masks.EMISSIVE_MASK instead.
static int	LIGHT_MODEL_CASE Deprecated. Use SoLazyElement.Cases.LIGHT_MODEL_CASE instead.
static int	LIGHT_MODEL_MASK Deprecated. Use SoLazyElement.Masks.LIGHT_MODEL_MASK instead.
static int	LINE_WIDTH_CASE Deprecated. Use SoLazyElement.Cases.LINE_WIDTH_CASE instead.
static int	LINE_WIDTH_MASK Deprecated. Use SoLazyElement.Masks.LINE_WIDTH_MASK instead.
static int	PATTERN_CASE Deprecated. Use SoLazyElement.Cases.PATTERN_CASE instead.
static int	PATTERN_MASK Deprecated. Use SoLazyElement.Masks.PATTERN_MASK instead.
static int	PHONG Deprecated. Use SoLazyElement.LightModels.PHONG instead.
static int	SHININESS_CASE Deprecated. Use SoLazyElement.Cases.SHININESS_CASE instead.
static int	SHININESS_MASK Deprecated. Use SoLazyElement.Masks.SHININESS_MASK instead.
static int	SMOOTHING_CASE Deprecated. Use SoLazyElement.Cases.SMOOTHING_CASE instead.
static int	SMOOTHING_MASK Deprecated. Use SoLazyElement.Masks.SMOOTHING_MASK instead.
static int	SPECULAR_CASE Deprecated. Use SoLazyElement.Cases.SPECULAR_CASE instead.
static int	SPECULAR_MASK Deprecated. Use SoLazyElement.Masks.SPECULAR_MASK instead.
static int	TRANSPARENCY_CASE Deprecated. Use SoLazyElement.Cases.TRANSPARENCY_CASE instead.
static int	TRANSPARENCY_MASK Deprecated. Use SoLazyElement.Masks.TRANSPARENCY_MASK instead.

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Method Summary

Modifier and Type	Method and Description
static SbColor	getAmbient(SoState name_16927)
static boolean	getBlending(SoState name_16932)
static int	getClassStackIndex() Deprecated. As of Open Inventor 9.3 replaced by SoElement.getClassStackIndex(Class)
static int	getColorIndex(SoState name_16925, int num)
static int[]	getColorIndices(SoState state)
static boolean	getColorMaterial(SoState name_16931)
static SbColor	getDefaultAmbient() Specify Open Inventor defaults for colors, etc.
static float	getDefaultAmbientIntensity() Specify Open Inventor defaults for colors, etc.
static int	getDefaultColorIndex() Specify Open Inventor defaults for colors, etc.
static SbColor	getDefaultDiffuse() Specify Open Inventor defaults for colors, etc.
static SbColor	getDefaultEmissive() Specify Open Inventor defaults for colors, etc.
static int	getDefaultLightModel() Specify Open Inventor defaults for colors, etc.
static float	getDefaultLineWidth() Specify Open Inventor defaults for colors, etc.
static int	getDefaultPacked() Specify Open Inventor defaults for colors, etc.
static int	getDefaultPackedInternal() Specify Open Inventor defaults for colors, etc.
static float	getDefaultShininess() Specify Open Inventor defaults for colors, etc.
static SbColor	getDefaultSpecular() Specify Open Inventor defaults for colors, etc.
static float	getDefaultTransparency() Specify Open Inventor defaults for colors, etc.
static SbColor	getDiffuse(SoState state, int index) get() methods get value from Inventor state.
static java.nio.IntBuffer	getDirectColorIndices(SoState state)
static SbColor	getEmissive(SoState name_16928)
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 int	getLightModel(SoState name_16934)
int	getNumColorIndices() Method to inquire about current colors.
int	getNumDiffuse() Method to inquire about current colors.
int	getNumTransparencies() Method to inquire about current colors.
static int[]	getPackedColors(SoState state)
static float	getShininess(SoState name_16930)
static boolean	getSmoothing(SoState name_16933)
static SbColor	getSpecular(SoState name_16929)
static float	getTransparency(SoState name_16921, int index) get() methods get value from Inventor state.
boolean	isPacked() Method to inquire about current colors.
boolean	isTransparent() Method to inquire about current colors.
void	push(SoState state) push (for non-GL elements)
static void	setAmbient(SoState state, SbColor color)
static void	setAmbient(SoState state, SbColor[] color) Deprecated. As of Open Inventor 8.0, no longer used.
static void	setBlending(SoState state, boolean value)
static void	setColorIndices(SoState state, SoNode node, int[] indices) Static set method.
static void	setColorMaterial(SoState state, boolean value)
static void	setDiffuse(SoState state, SoNode node, SbColor[] colors, SoColorPacker cPacker) Static set method.
static void	setEmissive(SoState state, SbColor color)
static void	setEmissive(SoState state, SbColor[] color) Deprecated. As of Open Inventor 8.0, no longer used.
static void	setLightModel(SoState state, int model)
static void	setPacked(SoState state, SoNode node, SoColorPacker cPacker, int[] colors) Static set method.
static void	setShininess(SoState state, float value)
static void	setSmoothing(SoState state, boolean value)
static void	setSpecular(SoState state, SbColor color)
static void	setSpecular(SoState state, SbColor[] color) Deprecated. As of Open Inventor 8.0, no longer used.
static void	setTransparency(SoState state, SoNode node, float[] transp, SoColorPacker cPacker) Static set method.

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

getClassStackIndex, pop

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

LIGHT_MODEL_CASE

@Deprecated
public static final int LIGHT_MODEL_CASE

Deprecated. Use SoLazyElement.Cases.LIGHT_MODEL_CASE instead.

COLOR_MATERIAL_CASE

@Deprecated
public static final int COLOR_MATERIAL_CASE

Deprecated. Use SoLazyElement.Cases.COLOR_MATERIAL_CASE instead.

DIFFUSE_CASE

@Deprecated
public static final int DIFFUSE_CASE

Deprecated. Use SoLazyElement.Cases.DIFFUSE_CASE instead.

AMBIENT_CASE

@Deprecated
public static final int AMBIENT_CASE

Deprecated. Use SoLazyElement.Cases.AMBIENT_CASE instead.

EMISSIVE_CASE

@Deprecated
public static final int EMISSIVE_CASE

Deprecated. Use SoLazyElement.Cases.EMISSIVE_CASE instead.

SPECULAR_CASE

@Deprecated
public static final int SPECULAR_CASE

Deprecated. Use SoLazyElement.Cases.SPECULAR_CASE instead.

SHININESS_CASE

@Deprecated
public static final int SHININESS_CASE

Deprecated. Use SoLazyElement.Cases.SHININESS_CASE instead.

BLENDING_CASE

@Deprecated
public static final int BLENDING_CASE

Deprecated. Use SoLazyElement.Cases.BLENDING_CASE instead.

TRANSPARENCY_CASE

@Deprecated
public static final int TRANSPARENCY_CASE

Deprecated. Use SoLazyElement.Cases.TRANSPARENCY_CASE instead.

PATTERN_CASE

@Deprecated
public static final int PATTERN_CASE

Deprecated. Use SoLazyElement.Cases.PATTERN_CASE instead.

SMOOTHING_CASE

@Deprecated
public static final int SMOOTHING_CASE

Deprecated. Use SoLazyElement.Cases.SMOOTHING_CASE instead.

LINE_WIDTH_CASE

@Deprecated
public static final int LINE_WIDTH_CASE

Deprecated. Use SoLazyElement.Cases.LINE_WIDTH_CASE instead.

LIGHT_MODEL_MASK

@Deprecated
public static final int LIGHT_MODEL_MASK

Deprecated. Use SoLazyElement.Masks.LIGHT_MODEL_MASK instead.

COLOR_MATERIAL_MASK

@Deprecated
public static final int COLOR_MATERIAL_MASK

Deprecated. Use SoLazyElement.Masks.COLOR_MATERIAL_MASK instead.

DIFFUSE_MASK

@Deprecated
public static final int DIFFUSE_MASK

Deprecated. Use SoLazyElement.Masks.DIFFUSE_MASK instead.

AMBIENT_MASK

@Deprecated
public static final int AMBIENT_MASK

Deprecated. Use SoLazyElement.Masks.AMBIENT_MASK instead.

EMISSIVE_MASK

@Deprecated
public static final int EMISSIVE_MASK

Deprecated. Use SoLazyElement.Masks.EMISSIVE_MASK instead.

SPECULAR_MASK

@Deprecated
public static final int SPECULAR_MASK

Deprecated. Use SoLazyElement.Masks.SPECULAR_MASK instead.

SHININESS_MASK

@Deprecated
public static final int SHININESS_MASK

Deprecated. Use SoLazyElement.Masks.SHININESS_MASK instead.

TRANSPARENCY_MASK

@Deprecated
public static final int TRANSPARENCY_MASK

Deprecated. Use SoLazyElement.Masks.TRANSPARENCY_MASK instead.

BLENDING_MASK

@Deprecated
public static final int BLENDING_MASK

Deprecated. Use SoLazyElement.Masks.BLENDING_MASK instead.

SMOOTHING_MASK

@Deprecated
public static final int SMOOTHING_MASK

Deprecated. Use SoLazyElement.Masks.SMOOTHING_MASK instead.

ALL_MASK

@Deprecated
public static final int ALL_MASK

Deprecated. Use SoLazyElement.Masks.ALL_MASK instead.

PATTERN_MASK

@Deprecated
public static final int PATTERN_MASK

Deprecated. Use SoLazyElement.Masks.PATTERN_MASK instead.

LINE_WIDTH_MASK

@Deprecated
public static final int LINE_WIDTH_MASK

Deprecated. Use SoLazyElement.Masks.LINE_WIDTH_MASK instead.

BASE_COLOR

@Deprecated
public static final int BASE_COLOR

Deprecated. Use SoLazyElement.LightModels.BASE_COLOR instead.

PHONG

@Deprecated
public static final int PHONG

Deprecated. Use SoLazyElement.LightModels.PHONG instead.

Method Detail

setAmbient

@Deprecated
public static void setAmbient(SoState state,
                                           SbColor[] color)

Deprecated. As of Open Inventor 8.0, no longer used.

setEmissive

@Deprecated
public static void setEmissive(SoState state,
                                            SbColor[] color)

Deprecated. As of Open Inventor 8.0, no longer used.

setSpecular

@Deprecated
public static void setSpecular(SoState state,
                                            SbColor[] color)

Deprecated. As of Open Inventor 8.0, no longer used.

getDefaultAmbient

public static SbColor getDefaultAmbient()

Specify Open Inventor defaults for colors, etc.

setAmbient

public static void setAmbient(SoState state,
                              SbColor color)

setColorIndices

public static void setColorIndices(SoState state,
                                   SoNode node,
                                   int[] indices)

Static set method.

setPacked

public static void setPacked(SoState state,
                             SoNode node,
                             SoColorPacker cPacker,
                             int[] colors)

Static set method.

getDefaultDiffuse

public static SbColor getDefaultDiffuse()

Specify Open Inventor defaults for colors, etc.

setSpecular

public static void setSpecular(SoState state,
                               SbColor color)

getDefaultEmissive

public static SbColor getDefaultEmissive()

Specify Open Inventor defaults for colors, etc.

setShininess

public static void setShininess(SoState state,
                                float value)

getAmbient

public static SbColor getAmbient(SoState name_16927)

setEmissive

public static void setEmissive(SoState state,
                               SbColor color)

getDefaultSpecular

public static SbColor getDefaultSpecular()

Specify Open Inventor defaults for colors, etc.

getEmissive

public static SbColor getEmissive(SoState name_16928)

getSmoothing

public static boolean getSmoothing(SoState name_16933)

getLightModel

public static int getLightModel(SoState name_16934)

getShininess

public static float getShininess(SoState name_16930)

getColorMaterial

public static boolean getColorMaterial(SoState name_16931)

getBlending

public static boolean getBlending(SoState name_16932)

getSpecular

public static SbColor getSpecular(SoState name_16929)

getDefaultAmbientIntensity

public static float getDefaultAmbientIntensity()

Specify Open Inventor defaults for colors, etc.

setTransparency

public static void setTransparency(SoState state,
                                   SoNode node,
                                   float[] transp,
                                   SoColorPacker cPacker)

Static set method.

setDiffuse

public static void setDiffuse(SoState state,
                              SoNode node,
                              SbColor[] colors,
                              SoColorPacker cPacker)

Static set method.

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

getInstance

public 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. Note that this element is not const; however modifications to it can cause problems. SoEXTENDER apps should use only SoEXTENDER methods on this element.

setBlending

public static void setBlending(SoState state,
                               boolean value)

getNumColorIndices

public int getNumColorIndices()

Method to inquire about current colors.

isPacked

public boolean isPacked()

Method to inquire about current colors.

setColorMaterial

public static void setColorMaterial(SoState state,
                                    boolean value)

isTransparent

public boolean isTransparent()

Method to inquire about current colors.

getTransparency

public static float getTransparency(SoState name_16921,
                                    int index)

get() methods get value from Inventor state. The public methods are static, they get an instance of the element. If there is a cache, the appropriate virtual registerGetDependence is called.

setLightModel

public static void setLightModel(SoState state,
                                 int model)

getDiffuse

public static SbColor getDiffuse(SoState state,
                                 int index)

get() methods get value from Inventor state. The public methods are static, they get an instance of the element. If there is a cache, the appropriate virtual registerGetDependence is called.

getNumDiffuse

public int getNumDiffuse()

Method to inquire about current colors.

getNumTransparencies

public int getNumTransparencies()

Method to inquire about current colors.

setSmoothing

public static void setSmoothing(SoState state,
                                boolean value)

push

public void push(SoState state)

push (for non-GL elements)

Overrides:

push in class SoElement

getColorIndices

public static int[] getColorIndices(SoState state)

getDefaultPacked

public static int getDefaultPacked()

Specify Open Inventor defaults for colors, etc.

getDefaultPackedInternal

public static int getDefaultPackedInternal()

Specify Open Inventor defaults for colors, etc.

getColorIndex

public static int getColorIndex(SoState name_16925,
                                int num)

getDefaultShininess

public static float getDefaultShininess()

Specify Open Inventor defaults for colors, etc.

getDefaultTransparency

public static float getDefaultTransparency()

Specify Open Inventor defaults for colors, etc.

getPackedColors

public static int[] getPackedColors(SoState state)

getDefaultLineWidth

public static float getDefaultLineWidth()

Specify Open Inventor defaults for colors, etc.

getDefaultColorIndex

public static int getDefaultColorIndex()

Specify Open Inventor defaults for colors, etc.

getDirectColorIndices

public static java.nio.IntBuffer getDirectColorIndices(SoState state)

getDefaultLightModel

public static int getDefaultLightModel()

Specify Open Inventor defaults for colors, etc.