Package org.web3d.x3d.sai.Texturing

Interface MultiTextureCoordinate

All Superinterfaces:

X3DGeometricPropertyNode, X3DNode, X3DTextureCoordinateNode

All Known Implementing Classes:

MultiTextureCoordinate

public interface MultiTextureCoordinate
extends X3DTextureCoordinateNode

MultiTextureCoordinate contains multiple TextureCoordinate or TextureCoordinateGenerator nodes, for use by a parent polygonal geometry node such as IndexedFaceSet or a Triangle* 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. MultiTextureCoordinate node tooltip: [X3DTextureCoordinateNode] MultiTextureCoordinate contains multiple TextureCoordinate or TextureCoordinateGenerator nodes, for use by a parent polygonal geometry node such as IndexedFaceSet or a Triangle* node. Each of the contained texture coordinate nodes correspond to the multiple texture nodes contained in a sibling Appearance/MultiTexture node.

• Hint: add Shape and then polgyonal/planar geometry before adding MultiTextureCoordinate.
• 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: MultiTextureCoordinate may not contain another MultiTextureCoordinate 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: MultiTextureCoordinate
• X3D Tooltips: MultiTextureCoordinate
• X3D Scene Authoring Hints: Images

Method Summary

Modifier and Type	Method	Description
void	addTexCoord(X3DNode[] newValue)	Add array of child texCoord 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[]	getTexCoord()	Provide array of org.web3d.x3d.sai.Core.X3DNode results (using an array consisting of properly typed nodes or ProtoInstances) from inputOutput MFNode field texCoord.
MultiTextureCoordinate	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	setTexCoord(X3DNode newValue)	Set single child texCoord node, replacing prior array of existing nodes (if any).
MultiTextureCoordinate	setTexCoord(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 texCoord.

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 X3DTextureCoordinateNode

Returns:

value of metadata field

See Also:

• X3D Scene Authoring Hints: Metadata Nodes

setMetadata

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

Parameters:

newValue - is new value for the metadata field.

Returns:

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

getTexCoord

X3DNode[] getTexCoord()

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

Tooltip: [X3DSingleTextureCoordinateNode] Zero or more contained TextureCoordinate or TextureCoordinateGenerator nodes that specify texture coordinates for the different texture channels, used for texture mapping onto corresponding geometry.

• Warning: MultiTextureCoordinate may not contain another MultiTextureCoordinate node.

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

Returns:

value of texCoord field

See Also:

• X3DSingleTextureCoordinateNode

setTexCoord

MultiTextureCoordinate setTexCoord(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 texCoord.

Tooltip: [X3DSingleTextureCoordinateNode] Zero or more contained TextureCoordinate or TextureCoordinateGenerator nodes that specify texture coordinates for the different texture channels, used for texture mapping onto corresponding geometry.

• Warning: MultiTextureCoordinate may not contain another MultiTextureCoordinate node.

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

Parameters:

newValue - is new value for the texCoord field.

Returns:

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

addTexCoord

void addTexCoord(X3DNode[] newValue)

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

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

Parameters:

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

setTexCoord

void setTexCoord(X3DNode newValue)

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

Parameters:

newValue - is new node for the texCoord field