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. X3D 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 <a href="https://en.wikipedia.org/wiki/Texture_mapping" target="_blank">https://en.wikipedia.org/wiki/Texture_mapping</a> Warning: requires X3D profile='Full' or else include &lt;component name='Texturing3D' level='1'/&gt; *


Package hint: This interface is defined by the X3D Java Language Binding Specification for the Scene Authoring Interface (SAI).
See Also:

  • 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 <a href="https://savage.nps.edu/X3dValidator" target="_blank">https://savage.nps.edu/X3dValidator</a> *
      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 <a href="https://savage.nps.edu/X3dValidator" target="_blank">https://savage.nps.edu/X3dValidator</a> *
      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 <a href="https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-IS.proof//Part01/components/core.html#Metadata" target="_blank">https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-IS.proof//Part01/components/core.html#Metadata</a> *
      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:

    • 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 <a href="https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-IS.proof//Part01/components/core.html#Metadata" target="_blank">https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-IS.proof//Part01/components/core.html#Metadata</a> *
      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: