Package org.web3d.x3d.sai.Texturing3D

Interface TextureTransformMatrix3D

All Superinterfaces:

X3DAppearanceChildNode, X3DNode, X3DTextureTransformNode

All Known Implementing Classes:

TextureTransformMatrix3D

public interface TextureTransformMatrix3D
extends X3DTextureTransformNode

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 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:

• SAI Java Specification
• X3D Abstract Specification: TextureTransformMatrix3D
• X3D Tooltips: TextureTransformMatrix3D
• X3D Scene Authoring Hints: Images

Method Summary

Modifier and Type	Method	Description
String	getMapping()	Provide String value from inputOutput SFString field named mapping.
float[]	getMatrix()	Provide array of float results from inputOutput SFMatrix4f field named matrix.
X3DMetadataObject	getMetadata()	Provide org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) from inputOutput SFNode field metadata.
TextureTransformMatrix3D	setMapping(String newValue)	Accessor method to assign String value to inputOutput SFString field named mapping.
TextureTransformMatrix3D	setMatrix(float[] newValue)	Accessor method to assign float array to inputOutput SFMatrix4f field named matrix.
TextureTransformMatrix3D	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

TextureTransformMatrix3D setMapping(String newValue)

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

TextureTransformMatrix3D setMatrix(float[] newValue)

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 interface X3DAppearanceChildNode

Specified by:

getMetadata in interface X3DNode

Specified by:

getMetadata in interface X3DTextureTransformNode

Returns:

value of metadata field

See Also:

• X3D Scene Authoring Hints: Metadata Nodes

setMetadata

TextureTransformMatrix3D 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 X3DAppearanceChildNode

Specified by:

setMetadata in interface X3DNode

Specified by:

setMetadata in interface X3DTextureTransformNode

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:

• X3D Scene Authoring Hints: Metadata Nodes