Interface Tangent

All Superinterfaces:
X3DGeometricPropertyNode, X3DNode, X3DTangentNode
All Known Implementing Classes:
Tangent
public interface Tangent extends X3DTangentNode
Tangent defines a set of 3D surface-normal vectors that apply either to a sibling Coordinate|CoordinateDouble node, or else to a parent ElevationGrid node.

Tangent node tooltip: (X3D version 4.1 draft) [X3DTangentNode] Tangent defines a set of 3D surface-normal vectors that apply either to a sibling Coordinate|CoordinateDouble node, or else to a parent ElevationGrid node. Tangent values are perpendicular directions that are used per-polygon or per-vertex when computing lighting and shading.
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
    X3DMetadataObject
    getMetadata()
    Provide org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) from inputOutput SFNode field metadata.
    float[]
    getVector()
    Provide array of 4-tuple float results within allowed range of [-1,1] from inputOutput MFVec4f field named vector.
    Tangent
    setMetadata(X3DMetadataObject newValue)
    Accessor method to assign org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) to inputOutput SFNode field metadata.
    Tangent
    setVector(float[] newValue)
    Accessor method to assign 4-tuple float array to inputOutput MFVec4f field named vector.

  • 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.
      Specified by:
      getMetadata in interface X3DGeometricPropertyNode
      Specified by:
      getMetadata in interface X3DNode
      Specified by:
      getMetadata in interface X3DTangentNode
      Returns:
      value of metadata field
      See Also:

    • setMetadata

      Tangent 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.
      Specified by:
      setMetadata in interface X3DGeometricPropertyNode
      Specified by:
      setMetadata in interface X3DNode
      Specified by:
      setMetadata in interface X3DTangentNode
      Parameters:
      newValue - is new value for the metadata field.
      Returns:
      Tangent - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
      See Also:

    • getVector

      float[] getVector()
      Provide array of 4-tuple float results within allowed range of [-1,1] from inputOutput MFVec4f field named vector.

      Tooltip: set of x-y-z-w orthogonal vector values for a surface, applied either per-vertex or per-face to a mesh. This is an advanced technique for surface shading.
      • Hint: values for w are handedness of the tangent base, either +1 or -1. All vertexes of the same triangle must have the same w value for their tangent vectors.
      • Warning: unit length means a magnitude of 1.0, so x-y-z normal values of (0,0,0) are invalid.
      Returns:
      value of vector field

    • setVector

      Tangent setVector(float[] newValue)
      Accessor method to assign 4-tuple float array to inputOutput MFVec4f field named vector.

      Tooltip: set of x-y-z-w orthogonal vector values for a surface, applied either per-vertex or per-face to a mesh. This is an advanced technique for surface shading.
      • Hint: values for w are handedness of the tangent base, either +1 or -1. All vertexes of the same triangle must have the same w value for their tangent vectors.
      • Warning: unit length means a magnitude of 1.0, so x-y-z normal values of (0,0,0) are invalid.
      Parameters:
      newValue - is new value for the vector field.
      Returns:
      Tangent - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).