doxygen: add newline after \file
[blender.git] / source / blender / blenlib / intern / easing.c
index 7233a26..0776527 100644 (file)
@@ -1,20 +1,17 @@
 /*
- * Copyright © 2001 Robert Penner
- * All rights reserved.
- *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are met:
  *
- *   * Redistributions of source code must retain the above copyright
- *     notice, this list of conditions and the following disclaimer.
+ * * Redistributions of source code must retain the above copyright
+ *   notice, this list of conditions and the following disclaimer.
  *
- *   * Redistributions in binary form must reproduce the above copyright
- *     notice, this list of conditions and the following disclaimer in the
- *     documentation and/or other materials provided with the distribution.
+ * * Redistributions in binary form must reproduce the above copyright
+ *   notice, this list of conditions and the following disclaimer in the
+ *   documentation and/or other materials provided with the distribution.
  *
- *   * Neither the name of the author nor the names of contributors may be
- *     used to endorse or promote products derived from this software without
- *     specific prior written permission.
+ * * Neither the name of the author nor the names of contributors may be
+ *   used to endorse or promote products derived from this software without
+ *   specific prior written permission.
  *
  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * Copyright (c) 2001 Robert Penner
+ * All rights reserved.
  */
 
-/** \file blender/blenlib/intern/easing.c
- *  \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_math_base.h"
 
 #include "BLI_strict_flags.h"
 
+/* blend if (amplitude < fabsf(change) */
+#define USE_ELASTIC_BLEND
 
 float BLI_easing_back_ease_in(float time, float begin, float change, float duration, float overshoot)
 {
-       if (overshoot == 0.0f)
-               overshoot = 1.70158f;
        time /= duration;
        return change * time * time * ((overshoot + 1) * time - overshoot) + begin;
 }
 
 float BLI_easing_back_ease_out(float time, float begin, float change, float duration, float overshoot)
 {
-       if (overshoot == 0.0f)
-               overshoot = 1.70158f;
        time = time / duration - 1;
        return change * (time * time * ((overshoot + 1) * time + overshoot) + 1) + begin;
 }
 
 float BLI_easing_back_ease_in_out(float time, float begin, float change, float duration, float overshoot)
 {
-       if (overshoot == 0.0f)
-               overshoot = 1.70158f; 
        overshoot *= 1.525f;
        if ((time /= duration / 2) < 1.0f) {
                return change / 2 * (time * time * ((overshoot + 1) * time - overshoot)) + begin;
@@ -141,76 +137,115 @@ float BLI_easing_cubic_ease_in_out(float time, float begin, float change, float
        return change / 2 * (time * time * time + 2) + begin;
 }
 
+#ifdef USE_ELASTIC_BLEND
+/**
+ * When the amplitude is less than the change, we need to blend
+ * \a f when we're close to the crossing point (int time), else we get an ugly sharp falloff.
+ */
+static float elastic_blend(float time, float change, float duration, float amplitude, float s, float f)
+{
+       if (change) {
+               /* Looks like a magic number,
+                * but this is a part of the sine curve we need to blend from */
+               const float t = fabsf(s);
+               if (amplitude) {
+                       f *= amplitude / fabsf(change);
+               }
+               else {
+                       f = 0.0f;
+               }
+
+               if (fabsf(time * duration) < t) {
+                       float l = fabsf(time * duration) / t;
+                       f = (f * l) + (1.0f - l);
+               }
+       }
+
+       return f;
+}
+#endif
+
 float BLI_easing_elastic_ease_in(float time, float begin, float change, float duration, float amplitude, float period)
 {
        float s;
+       float f = 1.0f;
 
        if (time == 0.0f)
                return begin;
 
        if ((time /= duration) == 1.0f)
                return begin + change;
-
+       time -= 1.0f;
        if (!period)
                period = duration * 0.3f;
-
        if (!amplitude || amplitude < fabsf(change)) {
-               amplitude = change;
                s = period / 4;
+#ifdef USE_ELASTIC_BLEND
+               f = elastic_blend(time, change, duration, amplitude, s, f);
+#endif
+               amplitude = change;
        }
        else
                s = period / (2 * (float)M_PI) * asinf(change / amplitude);
 
-       time -= 1.0f;
-       return -(amplitude * powf(2, 10 * time) * sinf((time * duration - s) * (2 * (float)M_PI) / period)) + begin;
+       return (-f * (amplitude * powf(2, 10 * time) * sinf((time * duration - s) * (2 * (float)M_PI) / period))) + begin;
 }
 
 float BLI_easing_elastic_ease_out(float time, float begin, float change, float duration, float amplitude, float period)
 {
        float s;
+       float f = 1.0f;
 
        if (time == 0.0f)
                return begin;
        if ((time /= duration) == 1.0f)
                return begin + change;
+       time = -time;
        if (!period)
                period = duration * 0.3f;
        if (!amplitude || amplitude < fabsf(change)) {
-               amplitude = change;
                s = period / 4;
+#ifdef USE_ELASTIC_BLEND
+               f = elastic_blend(time, change, duration, amplitude, s, f);
+#endif
+               amplitude = change;
        }
        else
                s = period / (2 * (float)M_PI) * asinf(change / amplitude);
 
-       time = -time;
-       return (amplitude * powf(2, 10 * time) * sinf((time * duration - s) * (2 * (float)M_PI) / period) + change + begin);
+       return (f * (amplitude * powf(2, 10 * time) * sinf((time * duration - s) * (2 * (float)M_PI) / period))) + change + begin;
 }
 
 float BLI_easing_elastic_ease_in_out(float time, float begin, float change, float duration, float amplitude, float period)
 {
        float s;
+       float f = 1.0f;
 
        if (time == 0.0f)
                return begin;
        if ((time /= duration / 2) == 2.0f)
                return begin + change;
+       time -= 1.0f;
        if (!period)
                period = duration * (0.3f * 1.5f);
        if (!amplitude || amplitude < fabsf(change)) {
-               amplitude = change;
                s = period / 4;
+#ifdef USE_ELASTIC_BLEND
+               f = elastic_blend(time, change, duration, amplitude, s, f);
+#endif
+               amplitude = change;
        }
        else
                s = period / (2 * (float)M_PI) * asinf(change / amplitude);
 
-       time -= 1.0f;
-
        if (time < 0.0f) {
-               return -0.5f * (amplitude * powf(2, 10 * time) * sinf((time * duration - s) * (2 * (float)M_PI) / period)) + begin;
+               f *= -0.5f;
+               return  (f * (amplitude * powf(2, 10 * time) * sinf((time * duration - s) * (2 * (float)M_PI) / period))) + begin;
        }
        else {
                time = -time;
-               return (0.5f * amplitude * powf(2, 10 * time) * sinf((time * duration - s) * (2 * (float)M_PI) / period)) + change + begin;
+               f *= 0.5f;
+               return (f * (amplitude * powf(2, 10 * time) * sinf((time * duration - s) * (2 * (float)M_PI) / period))) + change + begin;
        }
 }
 
@@ -295,7 +330,7 @@ float BLI_easing_quint_ease_out(float time, float begin, float change, float dur
 float BLI_easing_quint_ease_in_out(float time, float begin, float change, float duration)
 {
        if ((time /= duration / 2) < 1.0f)
-                return change / 2 * time * time * time * time * time + begin;
+               return change / 2 * time * time * time * time * time + begin;
        time -= 2.0f;
        return change / 2 * (time * time * time * time * time + 2) + begin;
 }