npm - qvector - Versions diffs - 1.0.0 - Mend

qvector 1.0.0

Files changed (3) hide show

package/compile.js ADDED Viewed

@@ -0,0 +1 @@

package/package.json ADDED Viewed

@@ -0,0 +1,11 @@
+{
+  "name": "qvector",
+  "version": "1.0.0",
+  "description": "QVector is a compact JavaScript library that streamlines trigonometry, making calculations simple and efficient. From angles and radians to complex transformations, Qasdr offers an intuitive API tailored for developers in fields like animation, gaming, and scientific computing. Reduce redundant formulas and focus on innovation with this versatile, performance-oriented tool.",
+  "main": "qvector.js",
+  "scripts": {
+    "postinstall": "node compile.js"
+  },
+  "author": "Alex",
+  "license": "MIT"
+}

package/qvector.js ADDED Viewed

@@ -0,0 +1,180 @@
+class QVector {
+    /**
+     * Convert degrees to radians
+     * @param {number} degrees
+     * @returns {number}
+     */
+    static toRadians(degrees) {
+      return (degrees * Math.PI) / 180;
+    }
+    /**
+     * Convert radians to degrees
+     * @param {number} radians
+     * @returns {number}
+     */
+    static toDegrees(radians) {
+      return (radians * 180) / Math.PI;
+    }
+    /**
+     * Calculate sine of an angle in degrees
+     * @param {number} degrees
+     * @returns {number}
+     */
+    static sin(degrees) {
+      return Math.sin(this.toRadians(degrees));
+    }
+    /**
+     * Calculate cosine of an angle in degrees
+     * @param {number} degrees
+     * @returns {number}
+     */
+    static cos(degrees) {
+      return Math.cos(this.toRadians(degrees));
+    }
+    /**
+     * Calculate tangent of an angle in degrees
+     * @param {number} degrees
+     * @returns {number}
+     */
+    static tan(degrees) {
+      return Math.tan(this.toRadians(degrees));
+    }
+    /**
+     * Calculate the arc sine (inverse sine) in degrees
+     * @param {number} value
+     * @returns {number}
+     */
+    static asin(value) {
+      return this.toDegrees(Math.asin(value));
+    }
+    /**
+     * Calculate the arc cosine (inverse cosine) in degrees
+     * @param {number} value
+     * @returns {number}
+     */
+    static acos(value) {
+      return this.toDegrees(Math.acos(value));
+    }
+    /**
+     * Calculate the arc tangent (inverse tangent) in degrees
+     * @param {number} value
+     * @returns {number}
+     */
+    static atan(value) {
+      return this.toDegrees(Math.atan(value));
+    }
+    /**
+     * Calculate the hypotenuse of a right triangle
+     * @param {number} a
+     * @param {number} b
+     * @returns {number}
+     */
+    static hypotenuse(a, b) {
+      return Math.sqrt(a ** 2 + b ** 2);
+    }
+    /**
+     * Calculate the distance between two points in 2D space
+     * @param {number} x1
+     * @param {number} y1
+     * @param {number} x2
+     * @param {number} y2
+     * @returns {number}
+     */
+    static distance2D(x1, y1, x2, y2) {
+      return this.hypotenuse(x2 - x1, y2 - y1);
+    }
+    /**
+     * Calculate the distance between two points in 3D space
+     * @param {number} x1
+     * @param {number} y1
+     * @param {number} z1
+     * @param {number} x2
+     * @param {number} y2
+     * @param {number} z2
+     * @returns {number}
+     */
+    static distance3D(x1, y1, z1, x2, y2, z2) {
+      return Math.sqrt((x2 - x1) ** 2 + (y2 - y1) ** 2 + (z2 - z1) ** 2);
+    }
+    /**
+     * Calculate the angle between two vectors in 2D space
+     * @param {number} x1
+     * @param {number} y1
+     * @param {number} x2
+     * @param {number} y2
+     * @returns {number} Angle in degrees
+     */
+    static angleBetweenVectors2D(x1, y1, x2, y2) {
+      const dotProduct = x1 * x2 + y1 * y2;
+      const magnitude1 = Math.sqrt(x1 ** 2 + y1 ** 2);
+      const magnitude2 = Math.sqrt(x2 ** 2 + y2 ** 2);
+      const cosTheta = dotProduct / (magnitude1 * magnitude2);
+      return this.acos(cosTheta);
+    }
+    /**
+     * Normalize a vector in 2D space
+     * @param {number} x
+     * @param {number} y
+     * @returns {object} Normalized vector
+     */
+    static normalizeVector2D(x, y) {
+      const magnitude = Math.sqrt(x ** 2 + y ** 2);
+      return { x: x / magnitude, y: y / magnitude };
+    }
+    /**
+     * Normalize a vector in 3D space
+     * @param {number} x
+     * @param {number} y
+     * @param {number} z
+     * @returns {object} Normalized vector
+     */
+    static normalizeVector3D(x, y, z) {
+      const magnitude = Math.sqrt(x ** 2 + y ** 2 + z ** 2);
+      return { x: x / magnitude, y: y / magnitude, z: z / magnitude };
+    }
+    /**
+     * Rotate a 2D vector by a given angle
+     * @param {number} x
+     * @param {number} y
+     * @param {number} angle Angle in degrees
+     * @returns {object} Rotated vector
+     */
+    static rotateVector2D(x, y, angle) {
+      const radians = this.toRadians(angle);
+      return {
+        x: x * Math.cos(radians) - y * Math.sin(radians),
+        y: x * Math.sin(radians) + y * Math.cos(radians),
+      };
+    }
+    /**
+     * Calculate the projection of a vector onto another in 2D space
+     * @param {number} x1
+     * @param {number} y1
+     * @param {number} x2
+     * @param {number} y2
+     * @returns {object} Projected vector
+     */
+    static projectVector2D(x1, y1, x2, y2) {
+      const dotProduct = x1 * x2 + y1 * y2;
+      const magnitudeSquared = x2 ** 2 + y2 ** 2;
+      const scale = dotProduct / magnitudeSquared;
+      return { x: scale * x2, y: scale * y2 };
+    }
+}
+module.exports = QVector;