public class ShaderAttributeBinding extends ShaderAttribute
attrName is implicitly set to the
value of the corresponding Java 3D system attribute
j3dAttrName during rendering. attrName
must be the name of a valid uniform attribute in the shader in
which it is used. Otherwise, the attribute name will be ignored and
a runtime error may be generated. j3dAttrName must be
the name of a predefined Java 3D system attribute. An
IllegalArgumentException will be thrown if the specified
j3dAttrName is not one of the predefined system
attributes. Further, the type of the j3dAttrName
attribute must match the type of the corresponding
attrName variable in the shader in which it is
used. Otherwise, the shader will not be able to use the attribute
and a runtime error may be generated.
Following is the list of predefined Java 3D system attributes:
| Name | Type | Description |
something |
Float | This is something (of course) |
somethingElse |
Tuple3f | This is something else |
Depending on the shading language (and profile) being used, several Java 3D state attributes are automatically made available to the shader program as pre-defined uniform attributes. The application doesn't need to do anything to pass these attributes in to the shader program. The implementation of each shader language (e.g., Cg, GLSL) defines its own mapping from Java 3D attribute to uniform variable name.
A list of these attributes for each shader language can be found in the concrete subclass of ShaderProgram for that shader language.
NOTE: This class is not yet
implemented.
ShaderAttributeSet,
ShaderProgram| Constructor and Description |
|---|
ShaderAttributeBinding(String attrName,
String j3dAttrName)
Constructs a new ShaderAttributeBinding from the specified
(attrName, j3dAttrName) pair. |
| Modifier and Type | Method and Description |
|---|---|
String |
getJ3DAttributeName()
Retrieves the name of the Java 3D system attribute that is bound to this
shader attribute.
|
getAttributeNamecloneNodeComponent, cloneNodeComponent, duplicateNodeComponent, duplicateNodeComponent, getDuplicateOnCloneTree, setDuplicateOnCloneTreeclearCapability, clearCapabilityIsFrequent, duplicateSceneGraphObject, getCapability, getCapabilityIsFrequent, getName, getUserData, isCompiled, isLive, setCapability, setCapabilityIsFrequent, setName, setUserData, toString, updateNodeReferencespublic ShaderAttributeBinding(String attrName, String j3dAttrName)
(attrName, j3dAttrName) pair.attrName - the name of the shader attribute to be addedj3dAttrName - the name of the Java 3D attribute
to bind to the shader attributeUnsupportedOperationException - this class is not
yet implementedNullPointerException - if attrName or j3dAttrName is nullIllegalArgumentException - if j3dAttrName is not the name
of a valid predefined Java 3D system attributepublic String getJ3DAttributeName()
Copyright © 2016–2022 SciJava. All rights reserved.