org.distorted.library.type

Class DynamicQuat

java.lang.Object

org.distorted.library.type.Dynamic

org.distorted.library.type.DynamicQuat

All Implemented Interfaces:

Data4D

public class DynamicQuat
extends Dynamic
implements Data4D

A 4-dimensional implementation of the Dynamic class to interpolate between a list of Static4Ds. Here, the Points are assumed to be Quaternions - thus we do the Spherical Linear Interpolation, aka SLERP. Noise not supported (yet?). Only unit quaternions represent valid rotations in 3D - and interpolating through rotations is the most common use case for this class. No effort is done to normalize the Points though. Rotation Quaternion is assumed to be in the form ( axisX*sinT, axisY*sinT, axisZ*sinT, cosT ).

Field Summary

Fields inherited from class org.distorted.library.type.Dynamic

ACCESS_TYPE_RANDOM, ACCESS_TYPE_SEQUENTIAL, MODE_JUMP, MODE_LOOP, MODE_PATH

Constructor Summary

Constructors

Constructor and Description
DynamicQuat() Default constructor.
DynamicQuat(int duration, float count) Constructor setting the speed of interpolation and the number of revolutions.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(int location, Static4D v) Adds a new Static4D to the location'th place in our List of Points to interpolate through.
void	add(Static4D v) Adds a new Static4D to the end of our list of Points to interpolate through.
Static4D	getPoint(int location) Returns the location'th Static4D.
boolean	remove(int location) Removes a location'th Point from the List of Points we interpolate through.
boolean	remove(Static4D v) Removes all occurrences of Point v from the List of Points to interpolate through.
void	removeAll() Removes all Points.
void	setPoint(int location, float x, float y, float z, float w) Resets the location'th Point.

Methods inherited from class org.distorted.library.type.Dynamic

get, getConvexity, getCount, getDimension, getDuration, getNumPoints, onPause, resetToBeginning, setAccessType, setConvexity, setCount, setDuration, setMode

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.distorted.library.type.Data4D

get

Constructor Detail

DynamicQuat

public DynamicQuat()

Default constructor.

DynamicQuat

public DynamicQuat(int duration,
           float count)

Constructor setting the speed of interpolation and the number of revolutions. What constitutes 'one revolution' depends on the MODE: Dynamic.MODE_LOOP, Dynamic.MODE_PATH or Dynamic.MODE_JUMP.

Parameters:

duration - number of milliseconds it takes to do one revolution.

count - number of revolutions we will do. Count<=0 means 'infinite'.

Method Detail

getPoint

public Static4D getPoint(int location)

Returns the location'th Static4D.

Parameters:

location - the index of the Point we are interested in.

Returns:

The Static4D, if 0<=location<getNumPoints(), or null otherwise.

setPoint

public void setPoint(int location,
            float x,
            float y,
            float z,
            float w)

Resets the location'th Point.

Rotation Quaternion is assumed to be in the form ( axisX*sinT, axisY*sinT, axisZ*sinT, cosT ).

Parameters:

location - the index of the Point we are setting.

x - New value of its first float.

add

public void add(Static4D v)

Adds a new Static4D to the end of our list of Points to interpolate through.

Only a reference to the Point gets added to the List; this means that one can add a Point here, and later on Static4D.set(float,float,float,float) it to some new value and the change will be seamlessly reflected in the interpolated path.

A Point can be added multiple times.

Parameters:

v - The Point to add.

add

public void add(int location,
       Static4D v)

Adds a new Static4D to the location'th place in our List of Points to interpolate through.

Parameters:

location - Index in our List to add the new Point at.

v - The Static4D to add.

remove

public boolean remove(Static4D v)

Removes all occurrences of Point v from the List of Points to interpolate through.

Parameters:

v - The Point to remove.

Returns:

true if we have removed at least one Point.

remove

public boolean remove(int location)

Removes a location'th Point from the List of Points we interpolate through.

Parameters:

location - index of the Point we want to remove.

Returns:

true if location is valid, i.e. if 0<=location<getNumPoints().

removeAll

public void removeAll()

Removes all Points.