public class MFVec4dObject extends X3DConcreteField implements MFVec4d
SFVec4dObject
Modifier and Type | Field and Description |
---|---|
static double[] |
DEFAULT_VALUE
Default value for this field type is an empty array.
|
static java.lang.String |
NAME
String constant NAME provides name of this element: MFVec4d.
|
validationResult
Constructor and Description |
---|
MFVec4dObject()
Constructor for MFVec4dObject performs value initialization.
|
MFVec4dObject(double[] newValue)
Constructor for MFVec4dObject using a corresponding Java primitive double[] array as new initial value.
|
MFVec4dObject(float[] newValue)
Constructor for MFVec3fObject using an alternatively typed float[] array as new initial value.
|
MFVec4dObject(MFVec4dObject newValue)
Constructor to copy an MFVec4dObject value as initial value for this new field object.
|
Modifier and Type | Method and Description |
---|---|
void |
append(double[] newValue)
Places new value(s) at the end of the existing value array, increasing the field length accordingly.
|
MFVec4dObject |
append(MFVec4dObject newValue)
Appends a new MFVec4dObject to the end of the existing value array, increasing the field length accordingly.
|
MFVec4dObject |
append(SFVec4dObject 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.
|
void |
get1Value(int index,
double[] destinationValue)
Get an individual value from the existing field array.
|
double[] |
getPrimitiveValue()
Provides current value of the field as a Java primitive type.
|
void |
getValue(double[] valueDestination)
Get the current value of this MFVec4dObject by copying it into the valueDestination array, leaving the current object unchanged.
|
void |
getValue(double[][] valueDestination)
Get the current value of this MFVec4dObject by copying it into the valueDestination array, leaving the current object unchanged.
|
void |
initialize()
Initialization for MFVec4dObject applies default initial value.
|
void |
insertValue(int index,
double[] newValue)
Insert a new value prior to the index location in the existing value array, increasing the field length accordingly.
|
MFVec4dObject |
multiply(double scaleFactor)
Multiply scaleFactor times all values in this field type.
|
MFVec4dObject |
normalize()
Utility method to normalize vector values to unit length, ignore vector values with zero length.
|
void |
remove(int index)
Remove one SFVec4d element of the field array at index position, if found.
|
void |
set1Value(int index,
double[] newValue)
Replace a single value at the appropriate location in the existing value array.
|
void |
setValue(double[] newValue)
Assign a new double[] value to this field.
|
MFVec4dObject |
setValue(float[] newValue)
Assign a single-precision floating-point array value to this double-precision field.
|
void |
setValue(int size,
double[] newValue)
Assign an array subset to this field.
|
void |
setValue(int size,
double[][] newValue)
Assign an array subset to this field.
|
MFVec4dObject |
setValue(MFVec4dObject newValue)
Apply an MFVec4dObject value to this field.
|
MFVec4dObject |
setValue(SFVec4dObject newValue)
Assign a single-field SFVec4dObject as new array value.
|
MFVec4dObject |
setValueByString(java.lang.String newValue)
Utility accessor for MFVec4dObject using String value (which must pass parsing validation checks).
|
int |
size()
Get the size of the underlying data array, meaning the number of
simple SFVec4d elements for the given data type.
|
double[] |
toDoubleArray()
Provide double array for this field type.
|
java.lang.String |
toString()
Provides current value as a String.
|
static java.lang.String |
toString(double[] value)
Static utility method to provide String representation of a correctly typed input value.
|
addX3DEventListener, getDefinition, getTupleSize, getValidationResult, isReadable, isWritable, removeX3DEventListener, setReadable, setWritable
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
addX3DEventListener, getDefinition, isReadable, isWritable, removeX3DEventListener
public static final java.lang.String NAME
public static final double[] DEFAULT_VALUE
public MFVec4dObject()
public MFVec4dObject(MFVec4dObject newValue)
newValue
- The newValue to applypublic MFVec4dObject(double[] newValue)
newValue
- is new value to assign
WARNING: newValue array length must correspond to tuple size for base type MFVec4d tuple size of 4.
setContainerFieldOverride(containerFieldName); // apply checksConcreteField#getTupleSize(String)public MFVec4dObject(float[] newValue)
newValue
- is new value to assignpublic void initialize()
initialize
in class X3DConcreteField
public MFVec4dObject setValueByString(java.lang.String newValue) throws InvalidFieldValueException
newValue
- is new value to assign, if empty then assign DEFAULT_VALUEMFMatrix4dObject
- namely this same object to allow sequential method pipelining (i.e. consecutive
method invocations on the same node object).InvalidFieldValueException
X3DLoaderObject.toX3dObjectTree(org.w3c.dom.Node)
public MFVec4dObject normalize()
MFVec4dObject
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same node object).public static java.lang.String toString(double[] value)
value
- The value to convert to a StringSFDoubleObject.stripTrailingZeroes(double)
public void getValue(double[] valueDestination)
public double[] getPrimitiveValue()
public java.lang.String toString()
toString
in class java.lang.Object
SFDoubleObject.stripTrailingZeroes(double)
public void get1Value(int index, double[] 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.
public void setValue(int size, double[] newValue)
setValue
in interface MFVec4d
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.X3DConcreteField.getTupleSize(String)
public void getValue(double[][] valueDestination)
public void setValue(int size, double[][] newValue)
setValue
in interface MFVec4d
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.X3DConcreteField.getTupleSize(String)
public void setValue(double[] newValue)
newValue
- is replacement value array to assignX3DConcreteField.getTupleSize(String)
public MFVec4dObject setValue(float[] newValue)
newValue
- is replacement value array to assignMFVec4dObject
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same node object).X3DConcreteField.getTupleSize(String)
public MFVec4dObject setValue(SFVec4dObject newValue)
newValue
- The replacement value to assign.MFVec4dObject
- namely this same object to allow sequential method pipelining (i.e. consecutive
method invocations on the same node object).public void set1Value(int index, double[] newValue) throws java.lang.ArrayIndexOutOfBoundsException
set1Value
in interface MFVec4d
index
- is position of selected value in current arraynewValue
- provides new value to applyjava.lang.ArrayIndexOutOfBoundsException
X3DConcreteField.getTupleSize(String)
public void append(double[] newValue)
append
in interface MFVec4d
newValue
- The newValue to appendX3DConcreteField.getTupleSize(String)
public MFVec4dObject append(SFVec4dObject newValue)
newValue
- The newValue to appendMFVec4dObject
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same node object).public MFVec4dObject append(MFVec4dObject newValue)
newValue
- The newValue to appendMFVec4dObject
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same node object).X3DConcreteField.getTupleSize(String)
public void insertValue(int index, double[] newValue)
insertValue
in interface MFVec4d
index
- The position for the inserted value in the current arraynewValue
- The newValue to insertX3DConcreteField.getTupleSize(String)
public int size()
public void clear()
public void remove(int index)
public double[] toDoubleArray()
public MFVec4dObject setValue(MFVec4dObject newValue)
newValue
- The newValue to applyMFVec4dObject
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same node object).public MFVec4dObject multiply(double scaleFactor)
scaleFactor
- scalar value for vector multiplicationMFVec4dObject
- namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same node object).Copyright ©2005-2017 Web3D Consortium under an open-source license, free for any use. Feedback is welcome.