Package vrml.field

Class MFVec3f

java.lang.Object

vrml.Field

vrml.MField

vrml.field.MFVec3f

All Implemented Interfaces:

Cloneable

public class MFVec3f
extends MField

VRML JSAI type class containing multiple vector3f fields.

Internally, the class stores the values as a single, flat array so that is the most efficient method to use to avoid reallocation. All methods make internal copies of the values.

Version:

$Revision: 1.7 $

Author:

Alan Hudson, Justin Couch

Field Summary

Fields

Modifier and Type	Field	Description
protected static final int	ARRAY_INC	How much should we increment the array by when there is an add or insert request.
protected float[]	data	The vec values

Fields inherited from class vrml.MField

numElements

Fields inherited from class vrml.Field

valueChanged

Constructor Summary

Constructors

Constructor	Description
MFVec3f()	Construct a new empty vector.
MFVec3f(float[] vec3s)	Construct a new vector array based on all the given values.
MFVec3f(float[][] vec3s)	Construct a new vector array based on all the given values.
MFVec3f(int size, float[] vec3s)	Construct a new vector array based on a fraction of the items supplied.

Method Summary

Modifier and Type	Method	Description
void	addValue(float x, float y, float z)	Append the components as a new vector value to the end of this field.
void	addValue(ConstSFVec3f vec)	Append the field as a new vec value to the end of this field.
void	addValue(SFVec3f vec)	Append the field as a new vec value to the end of this field.
void	clear()	Clear the field of all elements
Object	clone()	Make a clone of this object.
void	delete(int index)	Remove the element at the given position and shift any other items down.
void	get1Value(int index, float[] vec3s)	Copy the value of the vector at the given index into the user array.
void	get1Value(int index, SFVec3f vec)	Copy the vector value at the given index into the supplied field.
void	getValue(float[] vec3s)	Copy the value of this field into the given flat array.
void	getValue(float[][] vec3s)	Copy the values from this field into the given array.
void	insertValue(int index, float x, float y, float z)	Insert the vector represented by the components at the given position in the array.
void	insertValue(int index, ConstSFVec3f vec)	Insert the vector represented by the given field at the given position in the array.
void	insertValue(int index, SFVec3f vec)	Insert the vector represented by the given field at the given position in the array.
void	set1Value(int index, float x, float y, float z)	Set the element at the given index with the given vec components.
void	set1Value(int index, ConstSFVec3f vec)	Set the element at the given index with the value from the given field.
void	set1Value(int index, SFVec3f vec)	Set the element at the given index with the value from the given field.
void	setValue(float[] vec3s)	Set the field to the new values.
void	setValue(float[][] vec3s)	Set the field to the new values.
void	setValue(int size, float[] vec3s)	Set the value of this field given limited array of vecs.
void	setValue(ConstMFVec3f vecs)	Set the value of this field to the values in the given field.
void	setValue(MFVec3f vecs)	Set the value of this field based on the values in the given field.
String	toString()	Create a string representation of the field values.

Methods inherited from class vrml.MField

getSize

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

ARRAY_INC

protected static final int ARRAY_INC

How much should we increment the array by when there is an add or insert request. This value is array items, not elements.

See Also:

• Constant Field Values

data

protected float[] data

The vec values

Constructor Details

MFVec3f

public MFVec3f()

Construct a new empty vector.

MFVec3f

public MFVec3f(float[][] vec3s)

Construct a new vector array based on all the given values.

Parameters:

vec3s - The source vector values

MFVec3f

public MFVec3f(float[] vec3s)

Construct a new vector array based on all the given values.

Parameters:

vec3s - The source vector values

MFVec3f

public MFVec3f(int size,
 float[] vec3s)

Construct a new vector array based on a fraction of the items supplied.

Parameters:

size - The number of vectors is size / 3.

vec3s - The source vector values

Method Details

getValue

public void getValue(float[][] vec3s)

Copy the values from this field into the given array.

Parameters:

vec3s - The target array to copy values into

getValue

public void getValue(float[] vec3s)

Copy the value of this field into the given flat array.

Parameters:

vec3s - The target array to copy values into

get1Value

public void get1Value(int index,
 float[] vec3s)

Copy the value of the vector at the given index into the user array.

Parameters:

index - The index in the array of values to read

vec3s - The array to copy the vector value to

get1Value

public void get1Value(int index,
 SFVec3f vec)

Copy the vector value at the given index into the supplied field.

Parameters:

index - The index in the array of values to read

vec - The field to copy the vector value to

setValue

public void setValue(float[][] vec3s)

Set the field to the new values.

Parameters:

vec3s - The new vec values to use

setValue

public void setValue(float[] vec3s)

Set the field to the new values.

Parameters:

vec3s - The new vec values to use

setValue

public void setValue(int size,
 float[] vec3s)

Set the value of this field given limited array of vecs. x1, y1, z1, x2, y2, z2, ....

Parameters:

size - The number of vecs is size / 3.

vec3s - Color triplicates flattened.

setValue

public void setValue(MFVec3f vecs)

Set the value of this field based on the values in the given field.

Parameters:

vecs - The field to copy from

setValue

public void setValue(ConstMFVec3f vecs)

Set the value of this field to the values in the given field.

Parameters:

vecs - The field to copy from

set1Value

public void set1Value(int index,
 ConstSFVec3f vec)

Set the element at the given index with the value from the given field.

Parameters:

index - The index of the element to set

vec - The field to copy the data from

set1Value

public void set1Value(int index,
 SFVec3f vec)

Set the element at the given index with the value from the given field.

Parameters:

index - The index of the element to set

vec - The field to copy the data from

set1Value

public void set1Value(int index,
 float x,
 float y,
 float z)

Set the element at the given index with the given vec components.

Parameters:

index - The index of the element to set

x - The x component to use

y - The y component to use

z - The z component to use

addValue

public void addValue(ConstSFVec3f vec)

Append the field as a new vec value to the end of this field.

Parameters:

vec - The field to append

addValue

public void addValue(SFVec3f vec)

Append the field as a new vec value to the end of this field.

Parameters:

vec - The field to append

addValue

public void addValue(float x,
 float y,
 float z)

Append the components as a new vector value to the end of this field.

Parameters:

x - The x component to use

y - The y component to use

z - The z component to use

insertValue

public void insertValue(int index,
 ConstSFVec3f vec)

Insert the vector represented by the given field at the given position in the array.

Parameters:

index - The position to insert the value

vec - The vec field to insert

insertValue

public void insertValue(int index,
 SFVec3f vec)

Insert the vector represented by the given field at the given position in the array.

Parameters:

index - The position to insert the value

vec - The vec field to insert

insertValue

public void insertValue(int index,
 float x,
 float y,
 float z)

Insert the vector represented by the components at the given position in the array.

Parameters:

index - The position to insert the value

x - The x component to use

y - The y component to use

z - The z component to use

clear

public void clear()

Clear the field of all elements

Specified by:

clear in class MField

delete

public void delete(int index)

Remove the element at the given position and shift any other items down.

Specified by:

delete in class MField

Parameters:

index - The position to delete the item at

toString

public String toString()

Create a string representation of the field values.

Overrides:

toString in class Object

Returns:

A string representing the values.

clone

public Object clone()

Make a clone of this object.

Specified by:

clone in class Field

Returns:

A copy of the field and its data