com.openinventor.inventor.nodes

Class SoShaderStateMatrixParameter

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.nodes.SoNode

com.openinventor.inventor.nodes.SoShaderParameter

com.openinventor.inventor.nodes.SoUniformShaderParameter

com.openinventor.inventor.nodes.SoShaderStateMatrixParameter

All Implemented Interfaces:

SafeDisposable

public class SoShaderStateMatrixParameter
extends SoUniformShaderParameter

Uniform shader parameter node storing an OpenGL state matrix. This node allows the application to provide a uniform parameter of type OpenGL state matrix to a shader object, e.g. SoFragmentShader.

Uniform shader parameter nodes are usually added to the shader object's parameter field to affect only that specific shader program, but can also be inserted in the scene graph and affect all subsequent shader programs.

See the base classes SoShaderParameter and SoUniformShaderParameter for details.

This parameter should be only used with NVIDIA Cg (has no effect otherwise) and only if the profile is neither arbvp1 nor arbfp1. With either of the profiles arbvp1 and arbfp1, the OpenGL state matrix is directly accessible from the variable glstate.matrix.

NOTE: Using this parameter may slow down the rendering process because each SoTransform node in the scene graph below the SoShaderProgram will break the render cache.

File format/default:

ShaderStateMatrixParameter {

name	""
identifier	0
matrixType	MODELVIEW
matrixTransform	1 0 0 0
	0 1 0 0
	0 0 1 0
	0 0 0 1
shaderType	VERTEX

}

See also:

SoShaderParameter, SoUniformShaderParameter, SoShaderParameter1f, SoShaderParameter1i, SoShaderParameter2f, SoShaderParameter2i, SoShaderParameter3f, SoShaderParameter3i, SoShaderParameter4f, SoShaderParameter4i, SoShaderParameterArray1f, SoShaderParameterArray1i, SoShaderParameterArray2f, SoShaderParameterArray2i, SoShaderParameterArray3f, SoShaderParameterArray3i, SoShaderParameterArray4f, SoShaderParameter4i, SoShaderParameterMatrix, SoShaderParameterMatrixArray, SoShaderObject, SoShaderProgram.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoShaderStateMatrixParameter.MatrixTransforms Matrix transformation possible values.
static class	SoShaderStateMatrixParameter.MatrixTypes Matrix type possible values.

Nested classes/interfaces inherited from class com.openinventor.inventor.nodes.SoUniformShaderParameter

SoUniformShaderParameter.ShaderTypes

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

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
static int	IDENTITY Deprecated. Use SoShaderStateMatrixParameter.MatrixTransforms.IDENTITY instead.
static int	INVERSE Deprecated. Use SoShaderStateMatrixParameter.MatrixTransforms.INVERSE instead.
static int	INVERSE_TRANSPOSE Deprecated. Use SoShaderStateMatrixParameter.MatrixTransforms.INVERSE_TRANSPOSE instead.
SoSFEnum<SoShaderStateMatrixParameter.MatrixTransforms>	matrixTransform Specifies the transformation to be applied to the state matrix.
SoSFEnum<SoShaderStateMatrixParameter.MatrixTypes>	matrixType Specifies the type of the state matrix.
static int	MODELVIEW Deprecated. Use SoShaderStateMatrixParameter.MatrixTypes.MODELVIEW instead.
static int	MODELVIEW_PROJECTION Deprecated. Use SoShaderStateMatrixParameter.MatrixTypes.MODELVIEW_PROJECTION instead.
static int	PROJECTION Deprecated. Use SoShaderStateMatrixParameter.MatrixTypes.PROJECTION instead.
static int	TEXTURE Deprecated. Use SoShaderStateMatrixParameter.MatrixTypes.TEXTURE instead.
static int	TRANSPOSE Deprecated. Use SoShaderStateMatrixParameter.MatrixTransforms.TRANSPOSE instead.

Fields inherited from class com.openinventor.inventor.nodes.SoUniformShaderParameter

FRAGMENT, shaderType, VERTEX

Fields inherited from class com.openinventor.inventor.nodes.SoShaderParameter

identifier, name

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoShaderStateMatrixParameter() Constructor.

Method Summary

Methods inherited from class com.openinventor.inventor.nodes.SoUniformShaderParameter

isEqual

Methods inherited from class com.openinventor.inventor.nodes.SoNode

affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

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

Field Detail

MODELVIEW

@Deprecated
public static final int MODELVIEW

Deprecated. Use SoShaderStateMatrixParameter.MatrixTypes.MODELVIEW instead.

PROJECTION

@Deprecated
public static final int PROJECTION

Deprecated. Use SoShaderStateMatrixParameter.MatrixTypes.PROJECTION instead.

TEXTURE

@Deprecated
public static final int TEXTURE

Deprecated. Use SoShaderStateMatrixParameter.MatrixTypes.TEXTURE instead.

MODELVIEW_PROJECTION

@Deprecated
public static final int MODELVIEW_PROJECTION

Deprecated. Use SoShaderStateMatrixParameter.MatrixTypes.MODELVIEW_PROJECTION instead.

IDENTITY

@Deprecated
public static final int IDENTITY

Deprecated. Use SoShaderStateMatrixParameter.MatrixTransforms.IDENTITY instead.

TRANSPOSE

@Deprecated
public static final int TRANSPOSE

Deprecated. Use SoShaderStateMatrixParameter.MatrixTransforms.TRANSPOSE instead.

INVERSE

@Deprecated
public static final int INVERSE

Deprecated. Use SoShaderStateMatrixParameter.MatrixTransforms.INVERSE instead.

INVERSE_TRANSPOSE

@Deprecated
public static final int INVERSE_TRANSPOSE

Deprecated. Use SoShaderStateMatrixParameter.MatrixTransforms.INVERSE_TRANSPOSE instead.

matrixType

public final SoSFEnum<SoShaderStateMatrixParameter.MatrixTypes> matrixType

Specifies the type of the state matrix.

matrixTransform

public final SoSFEnum<SoShaderStateMatrixParameter.MatrixTransforms> matrixTransform

Specifies the transformation to be applied to the state matrix.

Constructor Detail

SoShaderStateMatrixParameter

public SoShaderStateMatrixParameter()

Constructor.