com.openinventor.inventor.elements

Class SoMaterialElement

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.elements.SoElement

com.openinventor.inventor.elements.SoReplacedElement

com.openinventor.inventor.elements.SoMaterialElement

public class SoMaterialElement
extends SoReplacedElement

Manages several properties that need to be lazily tracked for rendering. This element manages several properties such as colors, that need to be lazily tracked for rendering. Allows Open Inventor property nodes to set these properties without immediately making any rendering calls. Thus we avoid making redundant rendering 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 rendering state) be sent to the rendering engine.

Includes:
Transparencies
GLColorMaterial
PolygonStipple
Color index

See also:

SoBaseColor, SoMaterial, SoPackedColor, SoVertexProperty

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoMaterialElement.Masks Masks.

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 SbColor	getAmbient(SoState name_15218)
static int	getClassStackIndex() Deprecated. As of Open Inventor 9.3 replaced by SoElement.getClassStackIndex(Class)
static int	getColorIndex(SoState name_15216, int num)
static int[]	getColorIndices(SoState state)
static boolean	getColorMaterial(SoState name_15222)
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 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_15219)
int	getNumColorIndices() Method to inquire about current colors.
static long	getNumColorIndices(SoState state) Method to inquire about current colors.
int	getNumDiffuse() Method to inquire about current colors.
static long	getNumDiffuse(SoState state) Return number of diffuse colors.
static int	getNumTransparencies(SoState state) Method to inquire about current colors.
static SoCpuBufferObject	getPackedColors(SoState state) Return packed colors if any.
static float	getShininess(SoState name_15221)
static SbColor	getSpecular(SoState name_15220)
static float	getTransparency(SoState name_15212, int index) get() methods get value from Inventor state.
static boolean	isTransparent(SoState state) Method to inquire about current colors.
void	pop(SoState state, SoElement prevTopElement) Unref buffer object of the popped element.
void	push(SoState state) Copy current material into the pushed element.
static void	setAmbient(SoState state, SoNode node, SbColor color)
static void	setColorIndices(SoState state, SoNode node, int[] indices) Static set method.
static void	setColorMaterial(SoState state, SoNode node, boolean value)
static void	setDiffuse(SoState state, SoNode node, SbColor[] colors) Static set method.
static void	setEmissive(SoState state, SoNode node, SbColor color)
static void	setPacked(SoState state, SoNode node, int[] colors)
static void	setShininess(SoState state, SoNode node, float value)
static void	setSpecular(SoState state, SoNode node, SbColor color)
static void	setTransparency(SoState state, SoNode node, float[] transp) Static set method.

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

getClassStackIndex

Methods inherited from class com.openinventor.inventor.Inventor

dispose, getNativeResourceHandle

Methods inherited from class java.lang.Object

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

Method Detail

setColorMaterial

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

push

public void push(SoState state)

Copy current material into the pushed element.

Overrides:

push in class SoElement

getPackedColors

public static SoCpuBufferObject getPackedColors(SoState state)

Return packed colors if any.

getColorIndices

public static int[] getColorIndices(SoState state)

getTransparency

public static float getTransparency(SoState name_15212,
                                    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.

pop

public void pop(SoState state,
                SoElement prevTopElement)

Unref buffer object of the popped element.

Overrides:

pop in class SoElement

getDirectColorIndices

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

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.

setTransparency

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

Static set method.

setPacked

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

setDiffuse

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

Static set method.

getDefaultAmbient

public static SbColor getDefaultAmbient()

Specify Open Inventor defaults for colors, etc.

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.

• *

setSpecular

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

setShininess

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

setEmissive

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

setColorIndices

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

Static set method.

setAmbient

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

getDefaultAmbientIntensity

public static float getDefaultAmbientIntensity()

Specify Open Inventor defaults for colors, etc.

getDefaultDiffuse

public static SbColor getDefaultDiffuse()

Specify Open Inventor defaults for colors, etc.

getNumTransparencies

public static int getNumTransparencies(SoState state)

Method to inquire about current colors.

isTransparent

public static boolean isTransparent(SoState state)

Method to inquire about current colors.

getDefaultSpecular

public static SbColor getDefaultSpecular()

Specify Open Inventor defaults for colors, etc.

getDefaultTransparency

public static float getDefaultTransparency()

Specify Open Inventor defaults for colors, etc.

getDefaultColorIndex

public static int getDefaultColorIndex()

Specify Open Inventor defaults for colors, etc.

getDefaultEmissive

public static SbColor getDefaultEmissive()

Specify Open Inventor defaults for colors, etc.

getDefaultShininess

public static float getDefaultShininess()

Specify Open Inventor defaults for colors, etc.

getNumColorIndices

public static long getNumColorIndices(SoState state)

Method to inquire about current colors.

getNumDiffuse

public int getNumDiffuse()

Method to inquire about current colors.

getAmbient

public static SbColor getAmbient(SoState name_15218)

getNumColorIndices

public int getNumColorIndices()

Method to inquire about current colors.

getColorIndex

public static int getColorIndex(SoState name_15216,
                                int num)

getEmissive

public static SbColor getEmissive(SoState name_15219)

getColorMaterial

public static boolean getColorMaterial(SoState name_15222)

getNumDiffuse

public static long getNumDiffuse(SoState state)

Return number of diffuse colors.

getSpecular

public static SbColor getSpecular(SoState name_15220)

getShininess

public static float getShininess(SoState name_15221)