@lijuhong1981/jsmath 1.1.9 → 1.1.11

package/index.js

@@ -55,6 +55,9 @@ import randomNumber from "./src/randomNumber.js";
 import randomInteger from "./src/randomInteger.js";
 import toFixed from "./src/toFixed.js";
 import Interval from "./src/Interval.js";
+import windowPositionToNDC from "./src/windowPositionToNDC.js";
+import getNDCInElement from "./src/getNDCInElement.js";
+import ndcToWindowPosition from "./src/ndcToWindowPosition.js";
 
 export {
     PI,
@@ -113,4 +116,7 @@ export {
     randomInteger,
     toFixed,
     Interval,
+    windowPositionToNDC,
+    getNDCInElement,
+    ndcToWindowPosition,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lijuhong1981/jsmath",
-  "version": "1.1.9",
+  "version": "1.1.11",
   "description": "> TODO: description",
   "author": "lijuhong1981",
   "homepage": "https://github.com/lijuhong1981/jslibs#readme",
@@ -18,5 +18,5 @@
   "bugs": {
     "url": "https://github.com/lijuhong1981/jslibs/issues"
   },
-  "gitHead": "728afda1d6b6237b89025658bcba18c18d58d94e"
+  "gitHead": "fde69a7f1188bc71f49cd03831c4265de45f8394"
 }

package/src/getNDCInElement.js

@@ -0,0 +1,14 @@
+import windowPositionToNDC from "./windowPositionToNDC.js";
+
+/**
+ * 根据一个HTMLElement中的像素位置计算NDC坐标(NormalizedDeviceCoordinates)
+ * @param {HTMLElement} element HTMLElement对象
+ * @param {Object} posInElement 在HTMLElement中的像素坐标，{x: 500, y: 300}
+ * @param {Object} result 输出结果对象
+ * @returns {Object} 输出结果对象, 如：{x: 0.5, y: -0.5}
+ */
+function getNDCInElement(element, posInElement, result = {}) {
+    return windowPositionToNDC(posInElement, element.clientWidth, element.clientHeight, result);
+};
+
+export default getNDCInElement;

package/src/ndcToWindowPosition.js

@@ -0,0 +1,30 @@
+import Check from '@lijuhong1981/jscheck/src/Check.js';
+import isValid from '@lijuhong1981/jscheck/src/isValid.js';
+
+/**
+ * ndc坐标(NormalizedDeviceCoordinates)转换为窗口像素坐标
+ * @param {Object} ndc 需转换的ndc坐标, {x: 0.5, y: -0.5, z: 0.0}
+ * @param {Number} width 窗口像素宽
+ * @param {Number} height 窗口像素高
+ * @param {Object} result 输出结果对象
+ * @returns {Object} 输出结果对象, 如：{x: 123, y: 321}
+ */
+function ndcToWindowPosition(ndc, width, height, result = {}) {
+    Check.typeOf.object('ndc', ndc);
+    Check.typeOf.number('width', width);
+    Check.typeOf.number('height', height);
+
+    // invisible
+    if (isValid(ndc.z) && (ndc.z < 0 || ndc.z > 1))
+        return;
+
+    const x = (ndc.x + 1) / 2 * width;
+    const y = (1 - ndc.y) / 2 * height;
+
+    result.x = x;
+    result.y = y;
+
+    return result;
+}
+
+export default ndcToWindowPosition;

package/src/windowPositionToNDC.js

@@ -0,0 +1,22 @@
+import Check from '@lijuhong1981/jscheck/src/Check.js';
+
+/**
+ * 窗口像素坐标转换为NDC坐标(NormalizedDeviceCoordinates)
+ * @param {Object} posInWindow 需转换的窗口像素坐标，{x: 500, y: 300}
+ * @param {Number} width 窗口像素宽
+ * @param {Number} height 窗口像素高
+ * @param {Object} result 输出结果对象
+ * @returns {Object} 输出结果对象, 如：{x: 0.5, y: -0.5}
+ */
+function windowPositionToNDC(posInWindow, width, height, result = {}) {
+    Check.typeOf.object('posInWindow', posInWindow);
+    Check.typeOf.number('width', width);
+    Check.typeOf.number('height', height);
+
+    result.x = (posInWindow.x / width) * 2 - 1;
+    result.y = -(posInWindow.y / height) * 2 + 1;
+
+    return result;
+};
+
+export default windowPositionToNDC;