Class MFRotation
java.lang.Object
org.web3d.x3d.jsail.fields.X3DConcreteField
org.web3d.x3d.jsail.fields.MFRotation
- All Implemented Interfaces:
MField
,MFRotation
,X3DField
This utility class provides a concrete implementation corresponding to MFRotation 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
Package hint: This specification class is defined by the X3D Java Language Binding Specification for the Scene Authoring Interface (SAI). MFRotation is an array of SFRotation values. Individual singleton SFRotation array values are optionally separated by commas in XML syntax.
Related field object:
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). MFRotation is an array of SFRotation values. Individual singleton SFRotation array values are optionally separated by commas in XML syntax.
Related field object:
SFRotation
- See Also:
-
Field Summary
Modifier and TypeFieldDescriptionstatic final float[]
Default value for this field type is an empty array.static final String
Default string value for this field type is "".static final String
String constant NAME provides name of this element: MFRotationstatic final Pattern
Precompiled regular expression (regex) pattern for this field type using default REGEX value.static final String
Default regular expression (regex) pattern for this field type is \s*((([+-]?static final int
Default tuple size for this field type is 4 (i.e. number of component values making up a single-field SF object).Fields inherited from class org.web3d.x3d.jsail.fields.X3DConcreteField
validationResult
-
Constructor Summary
ConstructorDescriptionConstructor for MFRotation performs value initialization.MFRotation
(double[] newValue) Utility constructor for MFRotation using an alternatively typed Java double[] array as new initial value.MFRotation
(float[] newValue) Constructor for MFRotation using a corresponding Java primitive float[] array as new initial value.MFRotation
(MFRotation newValue) Constructor to copy an MFRotation value as initial value for this new field object.MFRotation
(SFRotation newValue) Utility constructor for MFRotation to assign a single SFRotation as new initial value. -
Method Summary
Modifier and TypeMethodDescriptionvoid
append
(float[] newValue) Places new value(s) at the end of the existing value array, increasing the field length accordingly.append
(MFRotation newValue) Appends a new MFRotation to the end of the existing value array, increasing the field length accordingly.append
(SFRotation newValue) Appends a new singleton typed value at the end of the existing value array, increasing the field length accordingly.void
clear()
Removes all values in the field array, changing the array size to zero.boolean
equals
(MFRotation comparisonMFRotation) Determine whether two objects contain equal values.void
get1Value
(int index, float[] destinationValue) Get an individual value from the existing field array.float[]
Provides current value of the field as a Java primitive type.void
getValue
(float[] valueDestination) Get the current value of this MFRotation by copying it into the valueDestination array, leaving the current object unchanged.void
getValue
(float[][] valueDestination) Get the current value of this MFRotation by copying it into the valueDestination array, leaving the current object unchanged.final void
Initialization for MFRotation applies default initial value.void
insertValue
(int index, float[] newValue) Insert a new value prior to the index location in the existing value array, increasing the field length accordingly.static final boolean
isArray()
Whether or not this field type is an array (true)boolean
Determine whether current value matches DEFAULT_VALUEfinal boolean
matches()
Test PATTERN match via regular expression (regex) check of current object's toString() value.static final boolean
Test PATTERN match with regular expression (regex) of provided value.void
remove
(int index) Remove one SFRotation element of the field array at index position, if found.void
set1Value
(int index, float[] newValue) Replace a single value at the appropriate location in the existing value array.setValue
(double[] newValue) Assign a double-precision array value to this single-precision field.void
setValue
(float[] newValue) Assign a new float[] value to this field.void
setValue
(int size, float[] newValue) Assign an array subset to this field.void
setValue
(int size, float[][] newValue) Assign an array subset to this field.setValue
(MFRotation newValue) Apply an MFRotation value to this field.setValue
(SFRotation newValue) Assign a single-field SFRotation as new array value.setValueByString
(String newValue) Utility accessor for MFRotation using String value (which must pass parsing validation checks).int
size()
Get the size of the underlying data array, meaning the number of simple SFRotation elements for the given data type.float[]
Provide float array for this field type.toString()
Provides current value as a String.static String
toString
(float[] value) Static utility method to provide String representation of a correctly typed input value.final String
validate()
Validate current value via get/set comparison testsfinal String
Validate current value via regular expression (regex) check of current object's toString() value, reporting errors only if found.Methods inherited from class org.web3d.x3d.jsail.fields.X3DConcreteField
addX3DEventListener, getDefinition, getTupleSize, getValidationResult, isReadable, isWritable, removeX3DEventListener, setReadable, setWritable
-
Field Details
-
NAME
String constant NAME provides name of this element: MFRotation- See Also:
-
DEFAULT_VALUE
public static final float[] DEFAULT_VALUEDefault value for this field type is an empty array.- See Also:
-
DEFAULT_VALUE_STRING
Default string value for this field type is "".- See Also:
-
TUPLE_SIZE
public static final int TUPLE_SIZEDefault tuple size for this field type is 4 (i.e. number of component values making up a single-field SF object).- See Also:
-
REGEX
Default regular expression (regex) pattern for this field type is \s*((([+-]?((0|[1-9][0-9]*)(\.[0-9]*)?|\.[0-9]+)([Ee][+-]?[0-9]+)?)\s+){3}([+-]?((0|[1-9][0-9]*)(\.[0-9]*)?|\.[0-9]+)([Ee][+-]?[0-9]+)?)\s*,?\s*)*- See Also:
-
PATTERN
Precompiled regular expression (regex) pattern for this field type using default REGEX value.- See Also:
-
-
Constructor Details
-
MFRotation
public MFRotation()Constructor for MFRotation performs value initialization. -
MFRotation
Constructor to copy an MFRotation value as initial value for this new field object.- Parameters:
newValue
- The newValue to apply
-
MFRotation
public MFRotation(float[] newValue) Constructor for MFRotation 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 MFRotation tuple size of 4. setContainerFieldOverride(containerFieldName); // apply checksConcreteField#getTupleSize(String)
-
MFRotation
Utility constructor for MFRotation to assign a single SFRotation as new initial value.- Parameters:
newValue
- is new value to assign
-
MFRotation
public MFRotation(double[] newValue) Utility constructor for MFRotation 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 (true)- Returns:
- true if array type
-
initialize
public final void initialize()Initialization for MFRotation applies default initial value. Static initializer also provided to verify that the regex pattern compiles and matches that default value.- Specified by:
initialize
in classX3DConcreteField
- See Also:
-
equals
Determine whether two objects contain equal values.- Parameters:
comparisonMFRotation
- field type to compare- Returns:
- true if equivalent, false otherwise
-
validate
Validate current value via get/set comparison tests- Returns:
- empty string if get/set testing passes, warning otherwise
- See Also:
-
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
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
Utility accessor for MFRotation 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:
-
toString
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 MFRotation by copying it into the valueDestination array, leaving the current object unchanged.- Specified by:
getValue
in interfaceMFRotation
- 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
-
get1Value
public void get1Value(int index, float[] destinationValue) Get an individual value from the existing field array.
If the index is outside the bounds of the current array of data values, an ArrayIndexOutOfBoundsException is thrown.
- Specified by:
get1Value
in interfaceMFRotation
- Parameters:
index
- is position of selected value in current arraydestinationValue
- where to place result for selected value- Throws:
ArrayIndexOutOfBoundsException
- The index was outside of the bounds of the current array.
-
setValue
public void setValue(int size, float[] newValue) Assign an array subset to this field. Warning: newValue array length must correspond to tuple size for base type MFRotation tuple size of 4.- Specified by:
setValue
in interfaceMFRotation
- Parameters:
size
- indicates size of result to copy (i.e. the number of typed singleton values) from beginning of newValue array.newValue
- The replacement value array to (potentially) slice and then assign.- See Also:
-
getValue
public void getValue(float[][] valueDestination) Get the current value of this MFRotation by copying it into the valueDestination array, leaving the current object unchanged.- Specified by:
getValue
in interfaceMFRotation
- Parameters:
valueDestination
- The array to be filled in with current field values.
-
setValue
public void setValue(int size, float[][] newValue) Assign an array subset to this field. Warning: newValue array length must correspond to tuple size for base type MFRotation tuple size of 4.- Specified by:
setValue
in interfaceMFRotation
- Parameters:
size
- indicates size of result to copy (i.e. the number of typed singleton values) from beginning of newValue array.newValue
- The replacement value array to (potentially) slice and then assign.- See Also:
-
setValue
public void setValue(float[] newValue) Assign a new float[] value to this field. Warning: newValue array length must correspond to tuple size for base type MFRotation tuple size of 4.- Parameters:
newValue
- is replacement value array to assign- See Also:
-
setValue
Assign a double-precision array value to this single-precision field.
Warning: this method casts type of input values from higher precision to lower precision.
Warning: newValue array length must correspond to tuple size for base type MFRotation tuple size of 4.- Parameters:
newValue
- is replacement value array to assign- Returns:
MFRotation
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).- See Also:
-
setValue
Assign a single-field SFRotation as new array value.- Parameters:
newValue
- The replacement value to assign.- Returns:
MFRotation
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same node object).
-
set1Value
Replace a single value at the appropriate location in the existing value array. Size of the current underlying value array does not change. Warning: newValue array length must correspond to tuple size for base type MFRotation tuple size of 4.- Specified by:
set1Value
in interfaceMFRotation
- Parameters:
index
- is position of selected value in current arraynewValue
- provides new value to apply- Throws:
ArrayIndexOutOfBoundsException
- See Also:
-
append
public void append(float[] newValue) Places new value(s) at the end of the existing value array, increasing the field length accordingly. Warning: newValue array length must correspond to tuple size for base type MFRotation tuple size of 4.- Specified by:
append
in interfaceMFRotation
- Parameters:
newValue
- The newValue to append- See Also:
-
append
Appends a new singleton typed value at the end of the existing value array, increasing the field length accordingly. Note: this method can be useful for incrementally constructing arrays.- Parameters:
newValue
- The newValue to append- Returns:
MFRotation
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
-
append
Appends a new MFRotation to the end of the existing value array, increasing the field length accordingly. Note: this method can be useful for constructing long arrays.- Parameters:
newValue
- The newValue to append- Returns:
MFRotation
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).- See Also:
-
insertValue
public void insertValue(int index, float[] newValue) Insert a new value prior to the index location in the existing value array, increasing the field length accordingly. Warning: newValue array length must correspond to tuple size for base type MFRotation tuple size of 4.- Specified by:
insertValue
in interfaceMFRotation
- Parameters:
index
- The position for the inserted value in the current arraynewValue
- The newValue to insert- See Also:
-
size
-
clear
-
remove
-
toFloatArray
public float[] toFloatArray()Provide float array for this field type.- Returns:
- Array of floats in this field array.
-
setValue
Apply an MFRotation value to this field.- Parameters:
newValue
- The newValue to apply- Returns:
MFRotation
- 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:
-