Distorted Android

///////////////////////////////////////////////////////////////////////////////////////////////////

// Copyright 2016 Leszek Koltunski                                                               //

//                                                                                               //

// This file is part of Distorted.                                                               //

//                                                                                               //

// Distorted is free software: you can redistribute it and/or modify                             //

// it under the terms of the GNU General Public License as published by                          //

// the Free Software Foundation, either version 2 of the License, or                             //

// (at your option) any later version.                                                           //

//                                                                                               //

// Distorted is distributed in the hope that it will be useful,                                  //

// but WITHOUT ANY WARRANTY; without even the implied warranty of                                //

// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                                 //

// GNU General Public License for more details.                                                  //

//                                                                                               //

// You should have received a copy of the GNU General Public License                             //

// along with Distorted.  If not, see <http://www.gnu.org/licenses/>.                            //

///////////////////////////////////////////////////////////////////////////////////////////////////

package org.distorted.library.type;

import java.util.Vector;

///////////////////////////////////////////////////////////////////////////////////////////////////

/** 

* A 3-dimensional implementation of the Dynamic class to interpolate between a list

* of Static3Ds.

*/

public class Dynamic3D extends Dynamic implements Data3D

  {

///////////////////////////////////////////////////////////////////////////////////////////////////

// the coefficients of the X(t), Y(t) and Z(t) polynomials: X(t) = ax*T^3 + bx*T^2 + cx*t + dx  etc.

// (x,y,z) is the vector tangent to the path.

// (vx,vy,vz) is the original vector from vv (copied here so when interpolating we can see if it is 

// still valid and if not - rebuild the Cache

  private class VectorCache

    {

    float ax, bx, cx, dx;

    float ay, by, cy, dy;

    float az, bz, cz, dz;

    float x,y,z;

    float vx,vy,vz;

    }

  private Vector<VectorCache> vc;

  private VectorCache tmp1, tmp2;

  private Vector<Static3D> vv;

  private Static3D prev, curr, next;

  private float vec1X,vec1Y,vec1Z;   // vector perpendicular to v(t) and in the same plane as v(t) and a(t) (for >2 points only, in case of 2 points this is calculated differently)

  private float vec2X,vec2Y,vec2Z;   // vector perpendicular to v(t0 and to vec1.

///////////////////////////////////////////////////////////////////////////////////////////////////

// no array bounds checking!

  private void vec(int c)

    {

    int p = c>0 ? c-1: numPoints-1;

    int n = c<numPoints-1 ? c+1: 0;

    prev = vv.elementAt(p);

    curr = vv.elementAt(c);

    next = vv.elementAt(n);

    tmp1 = vc.elementAt(c);

    float px = curr.x - prev.x;

    float py = curr.y - prev.y;

    float pz = curr.z - prev.z;

    float nx = next.x - curr.x;

    float ny = next.y - curr.y;

    float nz = next.z - curr.z;

    float d = nx*nx+ny*ny+nz*nz;

    if( d>0 )

      {

      float q = (float)Math.sqrt((px*px+py*py+pz*pz)/d);

      if( q>1 )

        {

        tmp1.x = nx+px/q;

        tmp1.y = ny+py/q;

        tmp1.z = nz+pz/q;

        }

      else

        {

        tmp1.x = px+nx*q;

        tmp1.y = py+ny*q;

        tmp1.z = pz+nz*q;

        }

      }

    else

      {

      tmp1.x = 0.0f;

      tmp1.y = 0.0f;

      tmp1.z = 0.0f;  

      }

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  private void recomputeCache()

    {  

    if( numPoints==1 )

      {

      tmp1= vc.elementAt(0);

      curr= vv.elementAt(0);

      tmp1.ax = tmp1.ay = tmp1.az = 0.0f;

      tmp1.bx = tmp1.by = tmp1.bz = 0.0f;

      tmp1.cx = curr.x;

      tmp1.cy = curr.y;

      tmp1.cz = curr.z;

      tmp1.dx = tmp1.dy = tmp1.dz = 0.0f;

      }

    else if( numPoints==2 )

      {

      tmp1= vc.elementAt(0);

      tmp2= vc.elementAt(1);

      curr= vv.elementAt(0);

      next= vv.elementAt(1);

      tmp1.ax = tmp1.ay = tmp1.az = 0.0f;

      tmp1.bx = tmp1.by = tmp1.bz = 0.0f;

      tmp1.cx = next.x - curr.x;

      tmp1.cy = next.y - curr.y;

      tmp1.cz = next.z - curr.z;

      tmp1.dx = curr.x;

      tmp1.dy = curr.y;

      tmp1.dz = curr.z;

      tmp2.ax = tmp2.ay = tmp2.az = 0.0f;

      tmp2.bx = tmp2.by = tmp2.bz = 0.0f;

      tmp2.cx = curr.x - next.x;

      tmp2.cy = curr.y - next.y;

      tmp2.cz = curr.z - next.z;

      tmp2.dx = next.x;

      tmp2.dy = next.y;

      tmp2.dz = next.z;

      }

    else

      {

      int i, n;  

      for(i=0; i<numPoints; i++) vec(i);

      for(i=0; i<numPoints; i++)

        {

        n = i<numPoints-1 ? i+1:0;  

        tmp1= vc.elementAt(i);

        tmp2= vc.elementAt(n);

        curr= vv.elementAt(i);

        next= vv.elementAt(n);

        tmp1.vx = curr.x;

        tmp1.vy = curr.y;

        tmp1.vz = curr.z;

        tmp1.ax =  2*curr.x +   tmp1.x - 2*next.x + tmp2.x;

        tmp1.bx = -3*curr.x - 2*tmp1.x + 3*next.x - tmp2.x;

        tmp1.cx = tmp1.x;

        tmp1.dx = curr.x;

        tmp1.ay =  2*curr.y +   tmp1.y - 2*next.y + tmp2.y;

        tmp1.by = -3*curr.y - 2*tmp1.y + 3*next.y - tmp2.y;

        tmp1.cy = tmp1.y;

        tmp1.dy = curr.y;

        tmp1.az =  2*curr.z +   tmp1.z - 2*next.z + tmp2.z;

        tmp1.bz = -3*curr.z - 2*tmp1.z + 3*next.z - tmp2.z;

        tmp1.cz = tmp1.z;

        tmp1.dz = curr.z;

        }

      }

    cacheDirty = false;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

// v is the speed vector (i.e. position p(t) differentiated by time)

// a is the acceleration vector (differentiate once more)

// now what we are doing is compute vec1{X,Y,Z} to be a vector perpendicular to v and in the same plane as both v and a.

// vec2{X,Y,Z} would be (v)x(vec1).

//  

// vec1 = a-delta*v where delta = (v*a)/|v|^2   (see Gram-Schmidt)

  private void setUpVectors(float time,VectorCache vc)

    {

    if( vc!=null )

      {

      float vx = (3*vc.ax*time+2*vc.bx)*time+vc.cx;

      float vy = (3*vc.ay*time+2*vc.by)*time+vc.cy;

      float vz = (3*vc.az*time+2*vc.bz)*time+vc.cz;

      float ax = 6*vc.ax*time+2*vc.bx;

      float ay = 6*vc.ay*time+2*vc.by;

      float az = 6*vc.az*time+2*vc.bz;

      float v_sq = vx*vx+vy*vy+vz*vz;

      float delta = (vx*ax+vy*ay+vz*az)/v_sq;

      vec1X = ax-delta*vx;

      vec1Y = ay-delta*vy;

      vec1Z = az-delta*vz;

      vec2X = vy*vec1Z-vz*vec1Y;

      vec2Y = vz*vec1X-vx*vec1Z;

      vec2Z = vx*vec1Y-vy*vec1X;

      float len1 = (float)Math.sqrt(v_sq/(vec1X*vec1X+vec1Y*vec1Y+vec1Z*vec1Z));

      float len2 = (float)Math.sqrt(v_sq/(vec2X*vec2X+vec2Y*vec2Y+vec2Z*vec2Z));   

      vec1X*=len1;

      vec1Y*=len1;

      vec1Z*=len1;

      vec2X*=len2;

      vec2Y*=len2;

      vec2Z*=len2;

      }

    else

      {

      curr = vv.elementAt(0);

      next = vv.elementAt(1); 

      float vx = (next.x-curr.x);

      float vy = (next.y-curr.y);

      float vz = (next.z-curr.z);

      float b = (float)Math.sqrt(vx*vx+vy*vy);

      if( b>0.0f )

        {

        vec1X = vx*vz/b;

        vec1Y = vy*vz/b;

        vec1Z = -b;

        vec2X = vy*vec1Z-vz*vec1Y;

        vec2Y = vz*vec1X-vx*vec1Z;

        vec2Z = vx*vec1Y-vy*vec1X;

        float len2 = (float)Math.sqrt((vx*vx+vy*vy+vz*vz)/(vec2X*vec2X+vec2Y*vec2Y+vec2Z*vec2Z));

        vec2X*=len2;

        vec2Y*=len2;

        vec2Z*=len2;

        }

      else

        {

        vec1X = vz;

        vec1Y = 0.0f;

        vec1Z = 0.0f;

        vec2X = 0.0f;

        vec2Y = vz;

        vec2Z = 0.0f;

        }

      }

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

// PUBLIC API

///////////////////////////////////////////////////////////////////////////////////////////////////

/**

 * Default constructor.

 */

  public Dynamic3D()

    {

    this(0,0.5f);

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

/**

 * Default constructor.

 *

 * @param duration number of milliseconds it takes to do a full loop/path from first vector to the

 *                 last and back to the first

 * @param count    number of loops/paths we will do; mCount = 1.5 means we go from the first vector

 *                 to the last, back to first, and to the last again.

 */

  public Dynamic3D(int duration, float count)

    {

    vv = new Vector<>();

    vc = new Vector<>();

    vn = null;

    numPoints = 0;

    cacheDirty = false;

    mMode = MODE_LOOP;

    mDuration = duration;

    mCount = count;

    mDimension = 3;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

/**

 * Returns the location'th Static3D.

 *   

 * @param location the index of the Point we are interested in.

 * @return The Static3D, if 0<=location&lt;getNumPoints(), or null otherwise.

 */  

  public synchronized Static3D getPoint(int location)

    {

    return (location>=0 && location<numPoints) ? vv.elementAt(location) : null;  

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

/**

 * Resets the location'th Point.

 * 

 * @param location the index of the Point we are setting.

 * @param x New value of its first float.

 */

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

    {

    if( location>=0 && location<numPoints )

      {

      curr = vv.elementAt(location);

      if( curr!=null )

        {

        curr.set(x,y,z);

        cacheDirty=true;

        }

      }

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

/**

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

 * <p>   

 * Only a reference to the Point gets added to the List; this means that one can add a Point 

 * here, and later on {@link Static3D#set(float,float,float)} it to some new value and the

 * change will be seamlessly reflected in the interpolated path.  

 * <p>

 * A Point can be added multiple times.

 *   

 * @param v The Point to add.

 */    

  public synchronized void add(Static3D v)

    {

    if( v!=null )

      {

      vv.add(v);

      if( vn!=null ) vn.add(new VectorNoise(3));

      switch(numPoints)

        {

        case 0: break;

        case 1: setUpVectors(0.0f,null);

                break;

        case 2: vc.add(new VectorCache());

                vc.add(new VectorCache());

                vc.add(new VectorCache());

                break;

        default:vc.add(new VectorCache());

        }

      numPoints++;

      cacheDirty = true;

      }

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

/**

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

 *   

 * @param location Index in our List to add the new Point at.

 * @param v The Point to add.

 */  

  public synchronized void add(int location, Static3D v)

    {

    if( v!=null )

      {

      vv.add(location, v);

      if( vn!=null ) vn.add(new VectorNoise(3));

      switch(numPoints)

        {

        case 0: break;

        case 1: setUpVectors(0.0f,null);

                break;

        case 2: vc.add(new VectorCache());

                vc.add(new VectorCache());

                vc.add(new VectorCache());

                break;

        default:vc.add(location,new VectorCache());

        }

      numPoints++;

      cacheDirty = true;

      }

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

/**

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

 * 

 * @param v The Point to remove.

 * @return <code>true</code> if we have removed at least one Point.

 */

  public synchronized boolean remove(Static3D v)

    {

    int n = vv.indexOf(v);

    boolean found = false;

    while( n>=0 ) 

      {

      vv.remove(n);

      if( vn!=null ) vn.remove(0);

      switch(numPoints)

        {

        case 0:

        case 1: 

        case 2: break;

        case 3: vc.removeAllElements();

                setUpVectors(0.0f,null);

                break;

        default:vc.remove(n);

        }

      numPoints--;

      found = true;

      n = vv.indexOf(v);

      }

    if( found ) 

      {

      cacheDirty=true;

      }

    return found;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

/**

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

 * 

 * @param location index of the Point we want to remove. 

 * @return <code>true</code> if location is valid, i.e. if 0<=location&lt;getNumPoints().

 */

  public synchronized boolean remove(int location)

    {

    if( location>=0 && location<numPoints ) 

      {

      vv.removeElementAt(location);

      if( vn!=null ) vn.remove(0);

      switch(numPoints)

        {

        case 0:

        case 1: 

        case 2: break;

        case 3: vc.removeAllElements();

                setUpVectors(0.0f,null);

                break;

        default:vc.removeElementAt(location);

        }

      numPoints--;

      cacheDirty = true; 

      return true;

      }

   return false;

   }

///////////////////////////////////////////////////////////////////////////////////////////////////

/**

 * Removes all Points.

 */

  public synchronized void removeAll()

    {

    numPoints = 0;

    vv.removeAllElements();

    vc.removeAllElements();

    cacheDirty = false;

    if( vn!=null ) vn.removeAllElements();

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

/**

 * Writes the results of interpolation between the Points at time 'time' to the passed float buffer.

 * <p>

 * Since this is a 3-dimensional Dynamic, the resulting interpolated Static3D gets written

 * to three locations in the buffer: buffer[offset], buffer[offset+1] and buffer[offset+2]. 

 * 

 * @param buffer Float buffer we will write the resulting Static3D to.

 * @param offset Offset in the buffer where to write the result.

 * @param time Time of interpolation. Time=0.0 would return the first Point, Time=0.5 - the last,

 *             time=1.0 - the first again, and time 0.1 would be 1/5 of the way between the first and the last Points.

 */    

  public synchronized void interpolate(float[] buffer, int offset, float time)

    {  

    switch(numPoints)

      {

      case 0: buffer[offset  ] = 0.0f;

              buffer[offset+1] = 0.0f;

              buffer[offset+2] = 0.0f;

              break;

      case 1: curr = vv.elementAt(0);

              buffer[offset  ] = curr.x;

              buffer[offset+1] = curr.y;

              buffer[offset+2] = curr.z;

              break;

      case 2: curr = vv.elementAt(0);

              next = vv.elementAt(1);

              if( mMode==MODE_LOOP || mMode==MODE_PATH ) time = (time>0.5f ? 2-2*time : 2*time);

              if( vn!=null )

                {

                time = noise(time,0);

                buffer[offset  ] = (next.x-curr.x)*time + curr.x + (vec1X*mFactor[0] + vec2X*mFactor[1]);

                buffer[offset+1] = (next.y-curr.y)*time + curr.y + (vec1Y*mFactor[0] + vec2Y*mFactor[1]);

                buffer[offset+2] = (next.z-curr.z)*time + curr.z + (vec1Z*mFactor[0] + vec2Z*mFactor[1]);

                }

              else

                {

                buffer[offset  ] = (next.x-curr.x)*time + curr.x;

                buffer[offset+1] = (next.y-curr.y)*time + curr.y;

                buffer[offset+2] = (next.z-curr.z)*time + curr.z;

                }

              break;

      default:float t = time;

              switch(mMode)

                {

                case MODE_LOOP: time = time*numPoints;

                                break;

                case MODE_PATH: time = (time<=0.5f) ? 2*time*(numPoints-1) : 2*(1-time)*(numPoints-1);

                                break;

                case MODE_JUMP: time = time*(numPoints-1);

                                break;

                }

              int vecCurr = (int)time;

              time = time-vecCurr;

              if( vecCurr>=0 && vecCurr<numPoints )

                {

                if( cacheDirty ) recomputeCache();    // recompute cache if we have added or remove vectors since last computation

                else if( mVecCurr!= vecCurr )         // ...or if we have just passed a vector and the vector we are currently flying to has changed

                  {

                  int vecNext;   

                  mVecCurr = vecCurr;

                  switch(mMode)

                    {

                    case MODE_LOOP: vecNext = vecCurr==numPoints-1 ? 0:vecCurr+1; 

                                    break;

                    case MODE_PATH: if( t<0.5f ) vecNext = vecCurr==numPoints-1 ? numPoints-2: vecCurr+1;  

                                    else         vecNext = vecCurr==0 ? 1 : vecCurr-1;  

                                    break;

                    case MODE_JUMP: vecNext = vecCurr==numPoints-1 ? 1:vecCurr+1;

                                    break;

                    default       : vecNext = 0;                

                    }

                  next = vv.elementAt(vecNext);

                  tmp2 = vc.elementAt(vecNext);

                  if( tmp2.vx!=next.x || tmp2.vy!=next.y || tmp2.vz!=next.z ) recomputeCache();

                  }

                tmp1 = vc.elementAt(vecCurr);

                if( vn!=null )

                  {

                  time = noise(time,vecCurr);

                  setUpVectors(time,tmp1);

                  buffer[offset  ]= ((tmp1.ax*time+tmp1.bx)*time+tmp1.cx)*time+tmp1.dx + (vec1X*mFactor[0] + vec2X*mFactor[1]);

                  buffer[offset+1]= ((tmp1.ay*time+tmp1.by)*time+tmp1.cy)*time+tmp1.dy + (vec1Y*mFactor[0] + vec2Y*mFactor[1]);

                  buffer[offset+2]= ((tmp1.az*time+tmp1.bz)*time+tmp1.cz)*time+tmp1.dz + (vec1Z*mFactor[0] + vec2Z*mFactor[1]);

                  }

                else

                  {

                  buffer[offset  ]= ((tmp1.ax*time+tmp1.bx)*time+tmp1.cx)*time+tmp1.dx;

                  buffer[offset+1]= ((tmp1.ay*time+tmp1.by)*time+tmp1.cy)*time+tmp1.dy;

                  buffer[offset+2]= ((tmp1.az*time+tmp1.bz)*time+tmp1.cz)*time+tmp1.dz;

                  }

                break;

                }

       }

     }  

  }

///////////////////////////////////////////////////////////////////////////////////////////////////

//