com.openinventor.inventor.elements

Class SoShapeStyleElement

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.elements.SoElement

com.openinventor.inventor.elements.SoShapeStyleElement

public class SoShapeStyleElement
extends SoElement

Stores some information used by shapes. This elements stores some information shapes need to quickly determine whether or not they should render, and, if they should render, how they should render. Specifically, it stores:

NeedNormals: true if lighting is on
NeedTexCoords: true if texturing and texcoords not generated by GL
MightNotRender: true if:

• bounding box complexity
• invisible drawstyle
• render abort callback registered

See also:

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoShapeStyleElement.Flags flags

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

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
static int	BBOX_BIT Deprecated. Use SoShapeStyleElement.Flags.BBOX_BIT instead.
static int	DELAY_TRANSP_BIT Deprecated. Use SoShapeStyleElement.Flags.DELAY_TRANSP_BIT instead.
static int	INVISIBLE_BIT Deprecated. Use SoShapeStyleElement.Flags.INVISIBLE_BIT instead.

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Method Summary

Modifier and Type	Method and Description
static SoShapeStyleElement	get(SoState state) Get a readable instance.
static int	getClassStackIndex() Deprecated. As of Open Inventor 9.3 replaced by SoElement.getClassStackIndex(Class)
int	getRenderCaseMask() Returns a mask that can be used by the SoVertexPropertyCache class (see SoVertexProperty.h for the SoRenderInfo class) to quickly mask out the normal or texture coordinate cases if normals or texture coordinates aren't needed.
static boolean	isScreenDoor(SoState state) Returns true if screen door is set.
boolean	mightNotRender() Returns true if shapes may not render for some reason.
boolean	needNormals() Returns true if need normals.
boolean	needTexCoords() Calls needTexCoords((int)0).
boolean	needTexCoords(int unit) Returns true if need texture coordinates.
boolean	needTexCoords3() Calls needTexCoords3((int)0).
boolean	needTexCoords3(int unit) Returns true if need 3D texture coordinates.
void	push(SoState state) Pushes element.
static void	setComplexityType(SoState state, int value) API used by other elements.
static void	setDrawStyle(SoState state, int value) API used by other elements.
static void	setLightModel(SoState state, int value) API used by other elements.
static void	setOverrides(SoState state, boolean value) Set value is true if either diffuse, transparency, or materialbinding are overridden; otherwise false.
static void	setTexture3Enabled(SoState state, boolean value) Calls setTexture3Enabled(state, value, (int)0).
static void	setTexture3Enabled(SoState state, boolean value, int unit) API used by other elements.
static void	setTextureEnabled(SoState state, boolean value) Calls setTextureEnabled(state, value, (int)0).
static void	setTextureEnabled(SoState state, boolean value, int unit) API used by other elements.
static void	setTextureFunction(SoState state, boolean value) Calls setTextureFunction(state, value, (int)0).
static void	setTextureFunction(SoState state, boolean value, int unit) API used by other elements.
static void	setTransparencyType(SoState state, int value) API used by other elements.

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

INVISIBLE_BIT

@Deprecated
public static final int INVISIBLE_BIT

Deprecated. Use SoShapeStyleElement.Flags.INVISIBLE_BIT instead.

BBOX_BIT

@Deprecated
public static final int BBOX_BIT

Deprecated. Use SoShapeStyleElement.Flags.BBOX_BIT instead.

DELAY_TRANSP_BIT

@Deprecated
public static final int DELAY_TRANSP_BIT

Deprecated. Use SoShapeStyleElement.Flags.DELAY_TRANSP_BIT instead.

Method Detail

setTextureEnabled

public static void setTextureEnabled(SoState state,
                                     boolean value)

Calls setTextureEnabled(state, value, (int)0).

setTexture3Enabled

public static void setTexture3Enabled(SoState state,
                                      boolean value)

Calls setTexture3Enabled(state, value, (int)0).

needTexCoords

public boolean needTexCoords()

Calls needTexCoords((int)0).

setTextureFunction

public static void setTextureFunction(SoState state,
                                      boolean value)

Calls setTextureFunction(state, value, (int)0).

needTexCoords3

public boolean needTexCoords3()

Calls needTexCoords3((int)0).

setTextureEnabled

public static void setTextureEnabled(SoState state,
                                     boolean value,
                                     int unit)

API used by other elements.

setComplexityType

public static void setComplexityType(SoState state,
                                     int value)

API used by other elements.

setTexture3Enabled

public static void setTexture3Enabled(SoState state,
                                      boolean value,
                                      int unit)

API used by other elements.

setTransparencyType

public static void setTransparencyType(SoState state,
                                       int value)

API used by other elements.

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

mightNotRender

public boolean mightNotRender()

Returns true if shapes may not render for some reason.

setDrawStyle

public static void setDrawStyle(SoState state,
                                int value)

API used by other elements.

get

public static SoShapeStyleElement get(SoState state)

Get a readable instance.

needTexCoords

public boolean needTexCoords(int unit)

Returns true if need texture coordinates.

needTexCoords3

public boolean needTexCoords3(int unit)

Returns true if need 3D texture coordinates.

push

public void push(SoState state)

Pushes element. Allows for side effects to occur. Default methods do nothing.

Overrides:

push in class SoElement

needNormals

public boolean needNormals()

Returns true if need normals.

getRenderCaseMask

public int getRenderCaseMask()

Returns a mask that can be used by the SoVertexPropertyCache class (see SoVertexProperty.h for the SoRenderInfo class) to quickly mask out the normal or texture coordinate cases if normals or texture coordinates aren't needed.

setLightModel

public static void setLightModel(SoState state,
                                 int value)

API used by other elements.

setTextureFunction

public static void setTextureFunction(SoState state,
                                      boolean value,
                                      int unit)

API used by other elements.

isScreenDoor

public static boolean isScreenDoor(SoState state)

Returns true if screen door is set.

setOverrides

public static void setOverrides(SoState state,
                                boolean value)

Set value is true if either diffuse, transparency, or materialbinding are overridden; otherwise false.