Package org.web3d.x3d.sai.Shaders

Interface Matrix4VertexAttribute

All Superinterfaces:

X3DGeometricPropertyNode, X3DNode, X3DVertexAttributeNode

All Known Implementing Classes:

Matrix4VertexAttribute

public interface Matrix4VertexAttribute
extends X3DVertexAttributeNode

Matrix4VertexAttribute defines a set of per-vertex 4x4 matrix attributes.

Warning: this is an abstract interface that cannot be instantiated as a concrete object. Java programmers typically only need to use concrete objects provided by the org.web3d.x3d.jsail classes. Matrix4VertexAttribute node tooltip: (X3D version 3.1 or later) [X3DVertexAttributeNode] Matrix4VertexAttribute defines a set of per-vertex 4x4 matrix attributes. *


Package hint: This interface is defined by the X3D Java Language Binding Specification for the Scene Authoring Interface (SAI).

See Also:

• SAI Java Specification
• X3D Abstract Specification: Matrix4VertexAttribute
• X3D Tooltips: Matrix4VertexAttribute
• X3D Scene Authoring Hints

Method Summary

Modifier and Type	Method	Description
X3DMetadataObject	getMetadata()	Provide org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) from inputOutput SFNode field metadata.
String	getName()	Provide String value from initializeOnly xs:NMTOKEN field named name.
float[]	getValue()	Provide array of float results from inputOutput MFMatrix4f field named value.
Matrix4VertexAttribute	setMetadata(X3DMetadataObject newValue)	Accessor method to assign org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) to inputOutput SFNode field metadata.
Matrix4VertexAttribute	setName(String newValue)	Accessor method to assign String value to initializeOnly xs:NMTOKEN field named name.
Matrix4VertexAttribute	setValue(float[] newValue)	Accessor method to assign float array to inputOutput MFMatrix4f field named value.

Method Details

getMetadata

X3DMetadataObject getMetadata()

Provide org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) from inputOutput SFNode field metadata.

Tooltip: [X3DMetadataObject] Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.

• Hint: X3D Architecture 7.2.4 Metadata https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS /Part01/components/core.html#Metadata

Specified by:

getMetadata in interface X3DGeometricPropertyNode

Specified by:

getMetadata in interface X3DNode

Specified by:

getMetadata in interface X3DVertexAttributeNode

Returns:

value of metadata field

See Also:

• X3D Scene Authoring Hints: Metadata Nodes

setMetadata

Matrix4VertexAttribute setMetadata(X3DMetadataObject newValue)

Accessor method to assign org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) to inputOutput SFNode field metadata.

Tooltip: [X3DMetadataObject] Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.

• Hint: X3D Architecture 7.2.4 Metadata https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS /Part01/components/core.html#Metadata

Specified by:

setMetadata in interface X3DGeometricPropertyNode

Specified by:

setMetadata in interface X3DNode

Specified by:

setMetadata in interface X3DVertexAttributeNode

Parameters:

newValue - is new value for the metadata field.

Returns:

Matrix4VertexAttribute - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

See Also:

• X3D Scene Authoring Hints: Metadata Nodes

getName

String getName()

Provide String value from initializeOnly xs:NMTOKEN field named name.

Tooltip: Required name for this particular VertexAttribute instance.

• Warning: name is not specified if this instance is a USE node.
• Hint: well-defined names can simplify design and debugging through improved author understanding.
• Hint: X3D Scene Authoring Hints, Naming Conventions https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions

Specified by:

getName in interface X3DVertexAttributeNode

Returns:

value of name field

setName

Matrix4VertexAttribute setName(String newValue)

Accessor method to assign String value to initializeOnly xs:NMTOKEN field named name.

Tooltip: Required name for this particular VertexAttribute instance.

• Warning: name is not specified if this instance is a USE node.
• Hint: well-defined names can simplify design and debugging through improved author understanding.
• Hint: X3D Scene Authoring Hints, Naming Conventions https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions

Specified by:

setName in interface X3DVertexAttributeNode

Parameters:

newValue - is new value for the name field.

Returns:

Matrix4VertexAttribute - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

getValue

float[] getValue()

Provide array of float results from inputOutput MFMatrix4f field named value.

Tooltip: value specifies an arbitrary collection of matrix values that will be passed to the shader as per-vertex information.

• Hint: the length of the value field shall be a multiple of numComponents.

Returns:

value of value field

setValue

Matrix4VertexAttribute setValue(float[] newValue)

Accessor method to assign float array to inputOutput MFMatrix4f field named value.

Tooltip: value specifies an arbitrary collection of matrix values that will be passed to the shader as per-vertex information.

• Hint: the length of the value field shall be a multiple of numComponents.

Parameters:

newValue - is new value for the value field.

Returns:

Matrix4VertexAttribute - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).