Class SFVec4f

java.lang.Object
org.web3d.x3d.jsail.fields.X3DConcreteField
org.web3d.x3d.jsail.fields.SFVec4f
All Implemented Interfaces:
SFVec4f, X3DField

public class SFVec4f extends X3DConcreteField implements SFVec4f
This utility class provides a concrete implementation corresponding to SFVec4f X3D field type.

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.
Package hint: This specification class is defined by the X3D Java Language Binding Specification for the Scene Authoring Interface (SAI). SFVec4f is a 4-tuple set of single-precision floating-point values, specifying a 3D homogeneous vector. Warning: comma characters within singleton values do not pass strict XML validation.

Related field object: MFVec4f
See Also:
  • Field Details

  • Constructor Details

    • SFVec4f

      public SFVec4f()
      Constructor for SFVec4f performs value initialization.
    • SFVec4f

      public SFVec4f(SFVec4f newValue)
      Constructor to copy an SFVec4f value as initial value for this new field object.
      Parameters:
      newValue - The newValue to apply
    • SFVec4f

      public SFVec4f(float[] newValue)
      Constructor for SFVec4f using a corresponding Java primitive float[] array as new initial value.
      Parameters:
      newValue - is new value to assign Warning: newValue array length must correspond to tuple size for base type SFVec4f tuple size of 4. setContainerFieldOverride(containerFieldName); // apply checksConcreteField#getTupleSize(String)
    • SFVec4f

      public SFVec4f(float x, float y, float z, float w)
      Utility constructor for SFVec4f using individual primitive values.
      Parameters:
      x - first component
      y - second component
      z - third component
      w - fourth component
      See Also:
    • SFVec4f

      public SFVec4f(double x, double y, double z, double t)
      Utility constructor for SFVec4f using double values.
      Parameters:
      x - first component
      y - second component
      z - third component
      t - fourth component
      See Also:
    • SFVec4f

      public SFVec4f(double[] newValue)
      Utility constructor for SFVec4f using an alternatively typed Java double[] array as new initial value.
      Parameters:
      newValue - is new value to assign
  • Method Details

    • isArray

      public static final boolean isArray()
      Whether or not this field type is an array (false)
      Returns:
      true if array type
    • initialize

      public final void initialize()
      Initialization for SFVec4f applies default initial value. Static initializer also provided to verify that the regex pattern compiles and matches that default value.
      Specified by:
      initialize in class X3DConcreteField
      See Also:
    • equals

      public boolean equals(SFVec4f comparisonSFVec4f)
      Determine whether two objects contain equal values.
      Parameters:
      comparisonSFVec4f - field type to compare
      Returns:
      true if equivalent, false otherwise
    • validate

      public final String validate()
      Validate current value via get/set comparison tests
      Returns:
      empty string if get/set testing passes, warning otherwise
      See Also:
    • validateRegex

      public final String validateRegex()
      Validate current value via regular expression (regex) check of current object's toString() value, reporting errors only if found.
      Returns:
      empty string if PATTERN matches, warning otherwise
      See Also:
    • matches

      public final boolean matches()
      Test PATTERN match via regular expression (regex) check of current object's toString() value.
      Returns:
      true if PATTERN matches, false otherwise
      See Also:
    • matches

      public static final boolean matches(String value)
      Test PATTERN match with regular expression (regex) of provided value.
      Parameters:
      value - String to check against regex pattern for successful match
      Returns:
      true if PATTERN matches, false otherwise
      See Also:
    • setValueByString

      public SFVec4f setValueByString(String newValue) throws InvalidFieldValueException
      Utility accessor for SFVec4f using String value (which must pass parsing validation checks).

      Warning: this method is not type safe at compile time! Best practice for X3DJSAIL programmers is to use strongly typed methods instead, in order to avoid potential for run-time errors.
      Parameters:
      newValue - is new value to assign, if empty then assign DEFAULT_VALUE
      Returns:
      MFMatrix4d - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same node object).
      Throws:
      InvalidFieldValueException
      See Also:
    • normalize

      public SFVec4f normalize()
      Utility method to normalize this vector value to unit length, ignore if zero length.
      Returns:
      SFVec4f - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
    • toString

      public static String toString(float[] value)
      Static utility method to provide String representation of a correctly typed input value.
      Parameters:
      value - The value to convert to a String
      Returns:
      String version of the provided value, with trailing zeroes and decimal points omitted.
      See Also:
    • getValue

      public void getValue(float[] valueDestination)
      Get the current value of this SFVec4f by copying it into the valueDestination array, leaving the current object unchanged.
      Specified by:
      getValue in interface SFVec4f
      Parameters:
      valueDestination - The array to be filled in with current field values.
    • getPrimitiveValue

      public float[] getPrimitiveValue()
      Provides current value of the field as a Java primitive type.
      Returns:
      current value
    • toString

      public String toString()
      Provides current value as a String.
      Overrides:
      toString in class Object
      Returns:
      String version of the provided value, with trailing zeroes and decimal points omitted.
      See Also:
    • setValue

      public void setValue(float[] newValue)
      Assign a new value to this field. Warning: newValue array length must correspond to tuple size for base type SFVec4f tuple size of 4.
      Specified by:
      setValue in interface SFVec4f
      Parameters:
      newValue - The replacement value to assign.
      See Also:
    • setValueArray

      public SFVec4f setValueArray(float[] newValue)
      Assign a new array value to this field, pipelined. This is an alternate utility method since primary method returns void and cannot be overridden. Warning: newValue array length must correspond to tuple size for base type SFVec4f tuple size of 4.
      Parameters:
      newValue - The replacement value to assign.
      Returns:
      SFVec4f - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
      See Also:
    • setValue

      public SFVec4f setValue(double[] newValue)
      Constructor for SFVec4f using a corresponding Java primitive double[] array as new initial value.
      Parameters:
      newValue - is new value to assign Warning: newValue array length must correspond to tuple size for base type SFVec4f tuple size of 4.
      Returns:
      SFVec4f - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
    • setValue

      public SFVec4f setValue(float x, float y, float z, float t)
      Assign a new value to this field.
      Parameters:
      x - first component
      y - second component
      z - third component
      t - fourth component
      Returns:
      SFVec4f - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
    • setValue

      public SFVec4f setValue(double x, double y, double z, double t)
      Assign a new value to this field.
      Parameters:
      x - first component
      y - second component
      z - third component
      t - fourth component
      Returns:
      SFVec4f - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
    • toFloatArray

      public float[] toFloatArray()
      Provide float array for this field type.
      Returns:
      Array of floats in this field array.
    • setValue

      public SFVec4f setValue(SFVec4f newValue)
      Apply an SFVec4f value to this field.
      Parameters:
      newValue - The newValue to apply
      Returns:
      SFVec4f - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
    • multiply

      public SFVec4f multiply(float scaleFactor)
      Multiply scaleFactor times all values in this field type.
      Parameters:
      scaleFactor - scalar value for vector multiplication
      Returns:
      SFVec4f - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
    • isDefaultValue

      public boolean isDefaultValue()
      Determine whether current value matches DEFAULT_VALUE
      Returns:
      whether current value matches DEFAULT_VALUE
      See Also: