/src/main/java/org/distorted/library/type/Dynamic.java - Diff - Distorted Android

« Previous | Next »

Revision c45c2ab1

Added by Leszek Koltunski about 5 years ago

ID c45c2ab1210c7e8d142fa336269364be711e4f85
Parent b920c848
Child 017e8aab

Minor improvements in the Dynamics.

     ///////////////////////////////////////////////////////////////////////////////////////////////////
     /** A class to interpolate between a list of Statics.
     * <p><ul>
     * <li>if there is only one Point, just jump to it.
     * <li>if there is only one Point, just return it.
     * <li>if there are two Points, linearly bounce between them
     * <li>if there are more, interpolate a loop (or a path!) between them.
     * <li>if there are more, interpolate a path between them. Exact way we interpolate depends on the MODE.
     * </ul>
     */
-...
     public abstract class Dynamic
+      {
       /**
        * One revolution takes us from the first vector to the last and back to first through the shortest path.
        * One revolution takes us from the first point to the last and back to first through the shortest path.
        */
       public static final int MODE_LOOP = 0;
       /**
        * We come back from the last to the first vector through the same way we got there.
        * One revolution takes us from the first point to the last and back to first through the same path.
        */
       public static final int MODE_PATH = 1;
       /**
        * We just jump back from the last point to the first.
        * One revolution takes us from the first point to the last and jumps straight back to the first point.
        */
       public static final int MODE_JUMP = 2;
-...
        * On the other hand, when in this mode, it is not possible to smoothly interpolate when mDuration suddenly
        * changes.
        */
       public static final int ACCESS_RANDOM     = 0;
       public static final int ACCESS_TYPE_RANDOM     = 0;
       /**
        * Set the mode to ACCESS_SEQUENTIAL if you need to change mDuration and you would rather have the Dynamic
        * keep on smoothly interpolating.
        * On the other hand, in this mode, a Dynamic can only be accessed in sequential manner, which means one
        * Dynamic can only be used in one effect at a time.
        */
       public static final int ACCESS_SEQUENTIAL = 1;
       public static final int ACCESS_TYPE_SEQUENTIAL = 1;
       protected int mDimension;
       protected int numPoints;
-...
       protected long mDuration;     // number of milliseconds it takes to do a full loop/path from first vector to the last and back to the first
       protected float mCount;       // 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.
       protected double mLastPos;
       protected int mAccessMode;
       protected int mAccessType;
       protected class VectorNoise
+        {
-...
         mDimension = dimension;
         mSegment   = -1;
         mLastPos   = -1;
         mAccessMode= ACCESS_RANDOM;
         mAccessType = ACCESS_TYPE_RANDOM;
         mTimeOffset = 0;
         mSetOffset  = true;
-...
      * <li>Loop is when we go from the first point all the way to the last, and the back to the first through
      * the shortest way.
      * <li>Path is when we come back from the last point back to the first the same way we got there.
      * <li>Jump is when we go from first to last and then jump back to the first.
      * <li>Jump is when we go from first to last and then jump straight back to the first.
      * </ul>
+     *
      * @param mode {@link Dynamic#MODE_LOOP}, {@link Dynamic#MODE_PATH} or {@link Dynamic#MODE_JUMP}.
-...
     ///////////////////////////////////////////////////////////////////////////////////////////////////
     /**
      * Returns the number of Statics this Dynamic has been fed with.
      * Returns the number of Points this Dynamic has been fed with.
+     *
      * @return the number of Statics we are currently interpolating through.
      * @return the number of Points we are currently interpolating through.
      */
       public synchronized int getNumPoints()
+        {
-...
     ///////////////////////////////////////////////////////////////////////////////////////////////////
     /**
      * Controls how many times we want to interpolate.
      * Sets how many revolutions we want to do.
      * <p>
      * Count equal to 1 means 'go from the first Static to the last and back'. Does not have to be an
      * integer - i.e. count=1.5 would mean 'start at the first Point, go to the last, come back to the first,
      * go to the last again and stop'.
      * Does not have to be an integer. What constitutes 'one revolution' depends on the MODE:
      * {@link Dynamic#MODE_LOOP}, {@link Dynamic#MODE_PATH} or {@link Dynamic#MODE_JUMP}.
      * Count<=0 means 'go on interpolating indefinitely'.
+     *
      * @param count the number of times we want to interpolate between our collection of Statics.
      * @param count the number of times we want to interpolate between our collection of Points.
      */
       public void setCount(float count)
+        {
-...
     ///////////////////////////////////////////////////////////////////////////////////////////////////
     /**
      * Return the number of times this Dynamic will interpolate.
      * Return the number of revolutions this Dynamic will make.
      * What constitutes 'one revolution' depends on the MODE:
      * {@link Dynamic#MODE_LOOP}, {@link Dynamic#MODE_PATH} or {@link Dynamic#MODE_JUMP}.
+     *
      * @return the number of times this Dynamic will interpolate.
      * @return the number revolutions this Dynamic will make.
      */
       public float getCount()
+        {
-...
     ///////////////////////////////////////////////////////////////////////////////////////////////////
     /**
      * Start running from the beginning again.
+     *
      * If a Dynamic has been used already, and we want to use it again and start interpolating from the
      * first Point, first we need to reset it using this method.
      */
       public void resetToBeginning()
+        {
-...
     ///////////////////////////////////////////////////////////////////////////////////////////////////
     /**
      * @param duration Number of milliseconds this Dynamic will interpolate for.
      * @param duration Number of milliseconds one revolution will take.
      *                 What constitutes 'one revolution' depends on the MODE:
      *                 {@link Dynamic#MODE_LOOP}, {@link Dynamic#MODE_PATH} or {@link Dynamic#MODE_JUMP}.
      */
       public void setDuration(long duration)
+        {
-...
     ///////////////////////////////////////////////////////////////////////////////////////////////////
     /**
      * @return Number of milliseconds this Dynamic will interpolate for.
      * @return Number of milliseconds one revolution will take.
      */
       public long getDuration()
+        {
-...
     ///////////////////////////////////////////////////////////////////////////////////////////////////
     /**
      * Sets the access mode this Dynamic will be working in.
      * Sets the access type this Dynamic will be working in.
+     *
      * @param mode {@link Dynamic#ACCESS_RANDOM} or {@link Dynamic#ACCESS_SEQUENTIAL}.
      * @param type {@link Dynamic#ACCESS_TYPE_RANDOM} or {@link Dynamic#ACCESS_TYPE_SEQUENTIAL}.
      */
       public void setAccessMode(int mode)
       public void setAccessType(int type)
+        {
         mAccessMode = mode;
         mAccessType = type;
         mLastPos = -1;
+        }
     ///////////////////////////////////////////////////////////////////////////////////////////////////
     /**
      * Return the Dimension, ie number of floats in a single Point this Dynamic interpolates through.
+     *
      * @return number of floats in a single Point (ie its dimension) contained in the Dynamic.
      */
       public int getDimension()
+        {
-...
+     *
      * @param buffer Float buffer we will write the results 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.
      * @param time   Time of interpolation. Time=0.0 is the beginning of the first revolution, time=1.0 - the end
      *               of the first revolution, time=2.5 - the middle of the third revolution.
      *               What constitutes 'one revolution' depends on the MODE:
      *               {@link Dynamic#MODE_LOOP}, {@link Dynamic#MODE_PATH} or {@link Dynamic#MODE_JUMP}.
      */
       public void get(float[] buffer, int offset, long time)
+        {
-...
+     *
      * @param buffer Float buffer we will write the results 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*mDuration - the
      *               last, time=1.0*mDuration - the first again, and time 0.1*mDuration would be 1/5 of the
      *               way between the first and the last Points.
      * @param time   Time of interpolation. Time=0.0 is the beginning of the first revolution, time=1.0 - the end
      *               of the first revolution, time=2.5 - the middle of the third revolution.
      *               What constitutes 'one revolution' depends on the MODE:
      *               {@link Dynamic#MODE_LOOP}, {@link Dynamic#MODE_PATH} or {@link Dynamic#MODE_JUMP}.
      * @param step   Time difference between now and the last time we called this function. Needed to figure
      *               out if the previous time we were called the effect wasn't finished yet, but now it is.
      * @return true if the interpolation reached its end.
-...
         double pos;
         if( mAccessMode==ACCESS_SEQUENTIAL )
         if( mAccessType ==ACCESS_TYPE_SEQUENTIAL )
+          {
           pos = mLastPos<0 ? (double)time/mDuration : (double)step/mDuration + mLastPos;
           mLastPos = pos;

Also available in: Unified diff

Project

General

Profile

Distorted Android

Revision c45c2ab1

Added by Leszek Koltunski about 5 years ago