Package org.web3d.x3d.sai.Texturing

Interface MultiTextureTransform

All Superinterfaces:

X3DAppearanceChildNode, X3DNode, X3DTextureTransformNode

All Known Implementing Classes:

MultiTextureTransform

public interface MultiTextureTransform
extends X3DTextureTransformNode

MultiTextureTransform contains multiple TextureTransform nodes, each provided for use by corresponding ImageTexture MovieTexture or PixelTexture nodes within a sibling MultiTexture node.

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. MultiTextureTransform node tooltip: [X3DTextureTransformNode] MultiTextureTransform contains multiple TextureTransform nodes, each provided for use by corresponding ImageTexture MovieTexture or PixelTexture nodes within a sibling MultiTexture node.

• Hint: insert Shape and Appearance nodes before adding MultiTextureTransform.
• Hint: Texture mapping https://en.wikipedia.org/wiki/Texture_mapping
• Warning: the number of textures to be blended may have a significant impact on performance, depending on available graphics hardware capabilities.
• Hint: multitexturing is accomplished using MultiTexture, MultiTextureCoordinate and MultiTextureTransform nodes.
• Hint: X3D Texturing component Figure 18.2 Lightmap example, https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS /Part01/components/texturing.html#f-Lightmapexample
• Hint: X3D Texturing component Table 18.2: Comparison of single texture and multitexture attributes, https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS /Part01/components/texturing.html#t-SingleAndMultitextureAttrs
• Warning: MultiTextureTransform may not contain another MultiTextureTransform node.

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: MultiTextureTransform
• X3D Tooltips: MultiTextureTransform
• X3D Scene Authoring Hints: Images

Method Summary

Modifier and Type	Method	Description
void	addTextureTransform(X3DNode[] newValue)	Add array of child textureTransform nodes to array of existing nodes (if any).
X3DMetadataObject	getMetadata()	Provide org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) from inputOutput SFNode field metadata.
X3DNode[]	getTextureTransform()	Provide array of org.web3d.x3d.sai.Core.X3DNode results (using an array consisting of properly typed nodes or ProtoInstances) from inputOutput MFNode field textureTransform.
MultiTextureTransform	setMetadata(X3DMetadataObject newValue)	Accessor method to assign org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) to inputOutput SFNode field metadata.
void	setTextureTransform(X3DNode newValue)	Set single child textureTransform node, replacing prior array of existing nodes (if any).
MultiTextureTransform	setTextureTransform(X3DNode[] newValue)	Accessor method to assign org.web3d.x3d.sai.Core.X3DNode array (using an array consisting of properly typed nodes or ProtoInstances) to inputOutput MFNode field textureTransform.

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

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

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

getTextureTransform

X3DNode[] getTextureTransform()

Provide array of org.web3d.x3d.sai.Core.X3DNode results (using an array consisting of properly typed nodes or ProtoInstances) from inputOutput MFNode field textureTransform.

Tooltip: [X3DSingleTextureTransformNode] Zero or more contained TextureTransform nodes, for each of the different texture channels, that define 2D transformation applied to texture coordinates.

• Hint: Texture coordinates are reapplied (or else recomputed if textureTransform field initially NULL) whenever the corresponding vertex-based geometry changes.
• Hint: if textureTransform array is empty, then this field has no effect.
• Warning: MultiTextureTransform may not contain another MultiTextureTransform node.

Warning: according to X3D Unified Object Model (X3DUOM), acceptable node types are limited to X3DSingleTextureTransformNode.

Returns:

value of textureTransform field

See Also:

• X3DSingleTextureTransformNode

setTextureTransform

MultiTextureTransform setTextureTransform(X3DNode[] newValue)

Accessor method to assign org.web3d.x3d.sai.Core.X3DNode array (using an array consisting of properly typed nodes or ProtoInstances) to inputOutput MFNode field textureTransform.

Tooltip: [X3DSingleTextureTransformNode] Zero or more contained TextureTransform nodes, for each of the different texture channels, that define 2D transformation applied to texture coordinates.

• Hint: Texture coordinates are reapplied (or else recomputed if textureTransform field initially NULL) whenever the corresponding vertex-based geometry changes.
• Hint: if textureTransform array is empty, then this field has no effect.
• Warning: MultiTextureTransform may not contain another MultiTextureTransform node.

Note: according to X3D Unified Object Model (X3DUOM), acceptable node types are limited to X3DSingleTextureTransformNode.

Parameters:

newValue - is new value for the textureTransform field.

Returns:

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

addTextureTransform

void addTextureTransform(X3DNode[] newValue)

Add array of child textureTransform nodes to array of existing nodes (if any).

Note: according to X3D Unified Object Model (X3DUOM), acceptable node types are limited to X3DSingleTextureTransformNode.

Parameters:

newValue - is new value array to be appended the textureTransform field.

setTextureTransform

void setTextureTransform(X3DNode newValue)

Set single child textureTransform node, replacing prior array of existing nodes (if any).

Parameters:

newValue - is new node for the textureTransform field