Reorganise item code so that VM-specific code is in its correct directories and not...

[xonotic/xonotic-data.pk3dir.git] / qcsrc / lib / math.qh

diff --git a/qcsrc/lib/math.qh b/qcsrc/lib/math.qh
index 3e77b369fdf37110c332d948c71935c2539a28eb..ac23325000995f50ef2e1fdde945686ff741401f 100644 (file)
--- a/qcsrc/lib/math.qh
+++ b/qcsrc/lib/math.qh
@@ -71,6 +71,39 @@ vector vsnap(vector point, float fsize)
        return vret;
 }
 
+ERASEABLE
+float lerpratio(float f0, float f1, float ratio)
+{
+       return f0 * (1 - ratio) + f1 * ratio;
+}
+
+ERASEABLE
+float lerp(float t0, float f0, float t1, float f1, float t)
+{
+       return lerpratio(f0, f1, (t - t0) / (t1 - t0));
+}
+
+ERASEABLE
+float lerp3ratio(float f0, float f1, float f2, float ratio)
+{
+       float mid = 0.5;
+       return ratio < mid ? lerpratio(f0, f1, ratio / mid) : ratio > mid ? lerpratio(f1, f2, (ratio - mid) / mid) : f1;
+}
+
+
+ERASEABLE
+vector lerpvratio(vector f0, vector f1, float ratio)
+{
+       return f0 * (1 - ratio) + f1 * ratio;
+}
+
+ERASEABLE
+vector lerpv3ratio(vector f0, vector f1, vector f2, float ratio)
+{
+       float mid = 0.5;
+       return ratio < mid ? lerpvratio(f0, f1, ratio / mid) : ratio > mid ? lerpvratio(f1, f2, (ratio - mid) / mid) : f1;
+}
+
 ERASEABLE
 vector lerpv(float t0, vector v0, float t1, vector v1, float t)
 {
@@ -324,9 +357,11 @@ vector solve_quadratic(float a, float b, float c)
 }
 
 /// Maps values between the src and dest range: src_min to dest_min, src_max to dest_max, values between them
-/// to the curresponding values between and extrapolates for values outside the range.
+/// to the corresponding values between and extrapolates for values outside the range.
+///
+/// src_min and src_max must not be the same or division by zero occurs.
 ///
-/// Max can be lower than min if you want to invert the range, values can be negative.
+/// dest_max can be smaller than dest_min if you want the resulting range to be inverted, all values can be negative.
 ERASEABLE
 float map_ranges(float value, float src_min, float src_max, float dest_min, float dest_max) {
        float src_diff = src_max - src_min;
@@ -338,6 +373,7 @@ float map_ranges(float value, float src_min, float src_max, float dest_min, floa
 /// Same as `map_ranges` except that values outside the source range are clamped to min or max.
 ERASEABLE
 float map_bound_ranges(float value, float src_min, float src_max, float dest_min, float dest_max) {
-       value = bound(src_min, value, src_max);
+       if (value <= src_min) return dest_min;
+       if (value >= src_max) return dest_max;
        return map_ranges(value, src_min, src_max, dest_min, dest_max);
 }