@lijuhong1981/jsmath 1.0.2 → 1.0.4

package/index.js

@@ -13,9 +13,13 @@ import {
     RADIANS_PER_ARCSECOND
 } from "./src/Constant.js";
 import clamp from "./src/clamp.js";
+import clampLatitude from "./src/clampLatitude.js";
+import clampLongitude from "./src/clampLongitude.js";
 import convertToRange from "./src/convertToRange.js";
-import convertToDegreesRound from "./src/convertToDegreesRound.js";
-import convertToRadiansRound from "./src/convertToRadiansRound.js";
+import convertToDegreesCircular from "./src/convertToDegreesCircular .js";
+import convertToRadiansCircular from "./src/convertToRadiansCircular.js";
+import convertToLatitudeRange from "./src/convertToLatitudeRange.js";
+import convertToLongitudeRange from "./src/convertToLongitudeRange.js";
 import isBetween from "./src/isBetween.js";
 import percentInRange from "./src/percentInRange.js";
 import percentToRange from "./src/percentToRange.js";
@@ -36,9 +40,13 @@ export {
     DEGREES_PER_RADIAN,
     RADIANS_PER_ARCSECOND,
     clamp,
+    clampLatitude,
+    clampLongitude,
     convertToRange,
-    convertToDegreesRound,
-    convertToRadiansRound,
+    convertToDegreesCircular,
+    convertToRadiansCircular,
+    convertToLatitudeRange,
+    convertToLongitudeRange,
     isBetween,
     percentInRange,
     percentToRange,

package/package.json

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

package/src/clampLatitude.js

@@ -0,0 +1,16 @@
+import { PI_OVER_TWO, clamp } from "@lijuhong1981/jsmath";
+
+/**
+ * 将一个纬度值约束在纬度范围内
+ * @param {Number} latitude 需要约束的纬度值
+ * @param {Boolean} degrees 单位，true表示角度单位，false表示弧度单位，默认true
+ * @returns {Number} 约束后的纬度
+ */
+function clampLatitude(latitude, degrees = true) {
+    if (degrees)
+        return clamp(latitude, -90, 90);
+    else
+        return clamp(latitude, -PI_OVER_TWO, PI_OVER_TWO);
+};
+
+export default clampLatitude;

package/src/clampLongitude.js

@@ -0,0 +1,16 @@
+import { clamp } from "@lijuhong1981/jsmath";
+
+/**
+ * 将一个经度值约束在经度范围内
+ * @param {Number} longitude 需要约束的经度值
+ * @param {Boolean} degrees 单位，true表示角度单位，false表示弧度单位，默认true
+ * @returns {Number} 约束后的经度
+ */
+function clampLongitude(longitude, degrees = true) {
+    if (degrees)
+        return clamp(longitude, -180, 180);
+    else
+        return clamp(longitude, -Math.PI, Math.PI);
+};
+
+export default clampLongitude;

package/src/{convertToDegreesRound.js → convertToDegreesCircular .js }

@@ -6,8 +6,8 @@ import convertToRange from "./convertToRange.js";
  * @param {Number} minValue 起始角度，默认0
  * @returns {Number} 转换后的角度
  */
-function convertToDegreesRound(degrees, minValue = 0) {
+function convertToDegreesCircular(degrees, minValue = 0) {
     return convertToRange(degrees, minValue, minValue + 360);
 };
 
-export default convertToDegreesRound;
+export default convertToDegreesCircular;

package/src/convertToLatitudeRange.js

@@ -0,0 +1,24 @@
+import { PI_OVER_TWO } from "@lijuhong1981/jsmath";
+
+function convertToLatitudeRange(latitude, degrees = true) {
+    if (degrees) {
+        while (latitude > 90 || latitude < -90) {
+            if (latitude > 90) {
+                latitude = 180 - latitude;
+            } else if (latitude < -90) {
+                latitude = -180 - latitude;
+            }
+        }
+    } else {
+        while (latitude > PI_OVER_TWO || latitude < -PI_OVER_TWO) {
+            if (latitude > PI_OVER_TWO) {
+                latitude = Math.PI - latitude;
+            } else if (latitude < -PI_OVER_TWO) {
+                latitude = -Math.PI - latitude;
+            }
+        }
+    }
+    return latitude;
+};
+
+export default convertToLatitudeRange;

package/src/convertToLongitudeRange.js

@@ -0,0 +1,10 @@
+import { convertToRange } from "@lijuhong1981/jsmath";
+
+function convertToLongitudeRange(longitude, degrees = true) {
+    if (degrees)
+        return convertToRange(longitude, -180, 180);
+    else
+        return convertToRange(longitude, -Math.PI, Math.PI);
+};
+
+export default convertToLongitudeRange;

package/src/{convertToRadiansRound.js → convertToRadiansCircular.js}

@@ -7,8 +7,8 @@ import { TWO_PI } from "./Constant.js";
  * @param {Number} minValue 圆周起始弧度，默认0
  * @returns {Number} 转换后的弧度
  */
-function convertToRadiansRound(radians, minValue = 0) {
+function convertToRadiansCircular(radians, minValue = 0) {
     return convertToRange(radians, minValue, minValue + TWO_PI);
 };
 
-export default convertToRadiansRound;
+export default convertToRadiansCircular;