Package org.web3d.x3d.sai.Texturing

Interface TextureCoordinate

All Superinterfaces:

X3DGeometricPropertyNode, X3DNode, X3DSingleTextureCoordinateNode, X3DTextureCoordinateNode

All Known Implementing Classes:

TextureCoordinate

public interface TextureCoordinate
extends X3DSingleTextureCoordinateNode

TextureCoordinate specifies 2D (s,t) texture-coordinate points, used by vertex-based geometry nodes (such as IndexedFaceSet or ElevationGrid) to map textures to vertices (and patches to NURBS surfaces).

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. TextureCoordinate node tooltip: [X3DSingleTextureCoordinateNode] TextureCoordinate specifies 2D (s,t) texture-coordinate points, used by vertex-based geometry nodes (such as IndexedFaceSet or ElevationGrid) to map textures to vertices (and patches to NURBS surfaces).

• Hint: add Shape and then polgyonal/planar geometry before adding TextureCoordinate.
• Hint: Texture mapping https://en.wikipedia.org/wiki/Texture_mapping
• Hint: X3D Texturing component Figure 18.1, Texture map coordinate system https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS /Part01/components/texturing.html#f-TextureMapCoordSystem

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: TextureCoordinate
• X3D Tooltips: TextureCoordinate
• 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 2-tuple float results from inputOutput MFVec2f field named point.
TextureCoordinate	setMapping(String newValue)	Accessor method to assign String value to inputOutput SFString field named mapping.
TextureCoordinate	setMetadata(X3DMetadataObject newValue)	Accessor method to assign org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) to inputOutput SFNode field metadata.
TextureCoordinate	setPoint(float[] newValue)	Accessor method to assign 2-tuple float array to inputOutput MFVec2f 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

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

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

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

TextureCoordinate - 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 2-tuple float results from inputOutput MFVec2f field named point.

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

Returns:

value of point field

setPoint

TextureCoordinate setPoint(float[] newValue)

Accessor method to assign 2-tuple float array to inputOutput MFVec2f field named point.

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

Parameters:

newValue - is new value for the point field.

Returns:

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