Package org.web3d.x3d.sai.Texturing3D

Interface TextureCoordinate3D

All Superinterfaces:

X3DGeometricPropertyNode, X3DNode, X3DSingleTextureCoordinateNode, X3DTextureCoordinateNode

All Known Implementing Classes:

TextureCoordinate3D

public interface TextureCoordinate3D
extends X3DSingleTextureCoordinateNode

TextureCoordinate3D specifies a set of 3D texture coordinates used by vertex-based geometry nodes (such as IndexedFaceSet or ElevationGrid) to map 3D textures to vertices.

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. TextureCoordinate3D node tooltip: (X3D version 3.1 or later) [X3DTextureCoordinateNode] TextureCoordinate3D specifies a set of 3D texture coordinates used by vertex-based geometry nodes (such as IndexedFaceSet or ElevationGrid) to map 3D textures to vertices.

• Hint: add Shape and then polgyonal/planar geometry before adding texture coordinates.
• Hint: X3D Architecture 33.2.2 3D texturing concepts https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS /Part01/components/texture3D.html#3DTextureconcepts
• 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: TextureCoordinate3D
• X3D Tooltips: TextureCoordinate3D
• X3D Scene Authoring Hints: Images

Method Summary

Modifier and Type	Method	Description
String	getMapping()	Provide String value from inputOutput SFString field named mapping.
X3DMetadataObject	getMetadata()	Provide org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) from inputOutput SFNode field metadata.
float[]	getPoint()	Provide array of 3-tuple float results from inputOutput MFVec3f field named point.
TextureCoordinate3D	setMapping(String newValue)	Accessor method to assign String value to inputOutput SFString field named mapping.
TextureCoordinate3D	setMetadata(X3DMetadataObject newValue)	Accessor method to assign org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) to inputOutput SFNode field metadata.
TextureCoordinate3D	setPoint(float[] newValue)	Accessor method to assign 3-tuple float array to inputOutput MFVec3f field named point.

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

Specified by:

getMapping in interface X3DSingleTextureCoordinateNode

Returns:

value of mapping field

setMapping

TextureCoordinate3D 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

Specified by:

setMapping in interface X3DSingleTextureCoordinateNode

Parameters:

newValue - is new value for the mapping field.

Returns:

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

Specified by:

getMetadata in interface X3DNode

Specified by:

getMetadata in interface X3DSingleTextureCoordinateNode

Specified by:

getMetadata in interface X3DTextureCoordinateNode

Returns:

value of metadata field

See Also:

• X3D Scene Authoring Hints: Metadata Nodes

setMetadata

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

Specified by:

setMetadata in interface X3DTextureCoordinateNode

Parameters:

newValue - is new value for the metadata field.

Returns:

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

getPoint

float[] getPoint()

Provide array of 3-tuple float results from inputOutput MFVec3f field named point.

Tooltip: triplets of 3D (s,t,r) texture coordinates, either in range [0,1] or higher if repeating. *

Returns:

value of point field

setPoint

TextureCoordinate3D setPoint(float[] newValue)

Accessor method to assign 3-tuple float array to inputOutput MFVec3f field named point.

Tooltip: triplets of 3D (s,t,r) texture coordinates, either in range [0,1] or higher if repeating. *

Parameters:

newValue - is new value for the point field.

Returns:

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