Interface TextureTransformMatrix3D
- All Superinterfaces:
X3DAppearanceChildNode
,X3DNode
,X3DTextureTransformNode
- All Known Implementing Classes:
TextureTransformMatrix3D
TextureTransformMatrix3D applies a 3D transformation to texture coordinates.
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
Package hint: This interface is defined by the X3D Java Language Binding Specification for the Scene Authoring Interface (SAI).
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.
TextureTransformMatrix3D node tooltip: (X3D version 3.1 or later) [X3DTextureTransformNode] TextureTransformMatrix3D applies a 3D transformation to texture coordinates.
- Warning: resulting visible effects appear reversed because image changes occur before mapping to geometry.
- Hint: order of operations is translation, rotation about center, non-uniform scale about center.
- Hint: insert Shape and Appearance nodes before adding TextureTransformMatrix3D.
- Hint: Texture mapping https://en.wikipedia.org/wiki/Texture_mapping
- Warning: requires X3D profile='Full' or else include <component name='Texturing3D' level='1'/>
Package hint: This interface is defined by the X3D Java Language Binding Specification for the Scene Authoring Interface (SAI).
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionProvide String value from inputOutput SFString field named mapping.float[]
Provide array of float results from inputOutput SFMatrix4f field named matrix.Provide org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) from inputOutput SFNode field metadata.setMapping
(String newValue) Accessor method to assign String value to inputOutput SFString field named mapping.setMatrix
(float[] newValue) Accessor method to assign float array to inputOutput SFMatrix4f field named matrix.setMetadata
(X3DMetadataObject newValue) Accessor method to assign org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) to inputOutput SFNode field metadata.
-
Method Details
-
getMapping
String getMapping()Provide String value from inputOutput SFString field named mapping.
Tooltip: The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.- Hint: TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator https://savage.nps.edu/X3dValidator
- Returns:
- value of mapping field
-
setMapping
Accessor method to assign String value to inputOutput SFString field named mapping.
Tooltip: The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.- Hint: TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator https://savage.nps.edu/X3dValidator
- Parameters:
newValue
- is new value for the mapping field.- Returns:
TextureTransformMatrix3D
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
-
getMatrix
float[] getMatrix()Provide array of float results from inputOutput SFMatrix4f field named matrix.
Tooltip: matrix is a generalized, unfiltered 4x4 transformation matrix to modify texture (opposite effect appears on geometry). *- Returns:
- value of matrix field
-
setMatrix
Accessor method to assign float array to inputOutput SFMatrix4f field named matrix.
Tooltip: matrix is a generalized, unfiltered 4x4 transformation matrix to modify texture (opposite effect appears on geometry). *- Parameters:
newValue
- is new value for the matrix field.- Returns:
TextureTransformMatrix3D
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
-
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 interfaceX3DAppearanceChildNode
- Specified by:
getMetadata
in interfaceX3DNode
- Specified by:
getMetadata
in interfaceX3DTextureTransformNode
- Returns:
- value of metadata field
- See Also:
-
setMetadata
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 interfaceX3DAppearanceChildNode
- Specified by:
setMetadata
in interfaceX3DNode
- Specified by:
setMetadata
in interfaceX3DTextureTransformNode
- Parameters:
newValue
- is new value for the metadata field.- Returns:
TextureTransformMatrix3D
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).- See Also:
-