@lijuhong1981/jsmath 1.0.9 → 1.0.10

package/index.js

@@ -22,9 +22,10 @@ import convertToLatitudeRange from "./src/convertToLatitudeRange.js";
 import convertToLongitudeRange from "./src/convertToLongitudeRange.js";
 import isBetween from "./src/isBetween.js";
 import lerp from "./src/lerp.js";
-import percentInRange from "./src/percentInRange.js";
-import randomInteger from "./src/randomInteger.js";
+import scalarInRange from "./src/scalarInRange.js";
+import normalize from "./src/normalize.js";
 import randomNumber from "./src/randomNumber.js";
+import randomInteger from "./src/randomInteger.js";
 import Range from "./src/Range.js";
 
 export {
@@ -50,8 +51,9 @@ export {
     convertToLongitudeRange,
     isBetween,
     lerp,
-    percentInRange,
-    randomInteger,
+    scalarInRange,
+    normalize,
     randomNumber,
+    randomInteger,
     Range,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lijuhong1981/jsmath",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "",
   "main": "index.js",
   "module": "index.js",

package/src/lerp.js

@@ -2,20 +2,20 @@ import Check from "@lijuhong1981/jscheck";
 import clamp from "./clamp.js";
 
 /**
- * 在两个数值间线性插值
- * @param {Number} strat 开始数值
+ * 在两个数值之间线性插值
+ * @param {Number} start 开始数值
  * @param {Number} end 结束数值
- * @param {Number} percent 插值百分比，needClamp为true时约束在[0,1]区间内，为false时可超出[0,1]区间
+ * @param {Number} scalar 插值标量，needClamp为true时约束在[0,1]区间内，为false时可超出[0,1]区间
  * @param {Boolean} needClamp 是否需要约束插值，默认true
  * @returns {Number} 插值结果
  */
-function lerp(strat, end, percent, needClamp = true) {
-    Check.typeOf.number('strat', strat);
+function lerp(start, end, scalar, needClamp = true) {
+    Check.typeOf.number('start', start);
     Check.typeOf.number('end', end);
-    Check.typeOf.number('percent', percent);
+    Check.typeOf.number('scalar', scalar);
     if (needClamp)
-        percent = clamp(percent, 0, 1);
-    return strat + (end - strat) * percent;
+        scalar = clamp(scalar, 0, 1);
+    return start + (end - start) * scalar;
 };
 
 export default lerp;

package/src/normalize.js

@@ -0,0 +1,15 @@
+import scalarInRange from "./scalarInRange.js";
+
+/**
+ * 计算一个数值在两个数值范围内的线性插值标准量
+ * 结果范围为[0, 1]区间
+ * @param {Number} value 需要计算的数值
+ * @param {Number} rangeMinimum 较小数
+ * @param {Number} rangeMaximum 较大数
+ * @returns {Number} 插值标量
+ */
+function normalize(value, rangeMinimum, rangeMaximum) {
+    return scalarInRange(value, rangeMinimum, rangeMaximum, true);
+};
+
+export default normalize;

package/src/{percentInRange.js → scalarInRange.js}

@@ -2,21 +2,21 @@ import Check from "@lijuhong1981/jscheck";
 import clamp from "./clamp.js";
 
 /**
- * 计算一个数值在两个数值范围内的线性插值百分比
+ * 计算一个数值在两个数值范围内的线性插值标量
  * @param {Number} value 需要计算的数值
  * @param {Number} rangeMinimum 较小数
  * @param {Number} rangeMaximum 较大数
  * @param {Boolean} needClamp 是否需要约束至0到1之间，默认false
- * @returns {Number} 百分比
+ * @returns {Number} 插值标量
  */
-function percentInRange(value, rangeMinimum, rangeMaximum, needClamp = false) {
+function scalarInRange(value, rangeMinimum, rangeMaximum, needClamp = false) {
     Check.typeOf.number('value', value);
     Check.typeOf.number('rangeMinimum', rangeMinimum);
     Check.typeOf.number('rangeMaximum', rangeMaximum);
-    let percent = (value - rangeMinimum) / (rangeMaximum - rangeMinimum);
+    let scalar = (value - rangeMinimum) / (rangeMaximum - rangeMinimum);
     if (needClamp)
-        percent = clamp(percent, 0, 1);
-    return percent;
+        scalar = clamp(scalar, 0, 1);
+    return scalar;
 };
 
-export default percentInRange;
+export default scalarInRange;