Add conversion routines

plugins/aframe-with-encantar.js

@@ -38,12 +38,54 @@ const ARBaseSystem = () => ({
     viewer: null,
 
     /**
-     * Pointer-based input in the current frame (touch, mouse, pen...)
-     * You need a PointerTracker in your session in order to use these
-     * @type {TrackablePointer[]}
+     * Pointer-based input (current frame)
+     * Make sure to add a PointerTracker to your session in order to use these
+     * @returns {TrackablePointer[]}
      */
     pointers: [],
 
+    /**
+     * Convert an AR Vector2 to a THREE Vector2
+     * @param {Vector2} v
+     * @returns {THREE.Vector2}
+     */
+    convertVector2(v)
+    {
+        return new THREE.Vector2(v.x, v.y);
+    },
+
+    /**
+     * Convert an AR Vector3 to a THREE Vector3
+     * @param {Vector3} v
+     * @returns {THREE.Vector3}
+     */
+    convertVector3(v)
+    {
+        return new THREE.Vector3(v.x, v.y, v.z);
+    },
+
+    /**
+     * Convert an AR Quaternion to a THREE Quaternion
+     * @param {Quaternion} q
+     * @returns {THREE.Quaternion}
+     */
+    convertQuaternion(q)
+    {
+        return new THREE.Quaternion(q.x, q.y, q.z, q.w);
+    },
+
+    /**
+     * Convert an AR Ray to a THREE Ray
+     * @param {Ray} r
+     * @returns {THREE.Ray}
+     */
+    convertRay(r)
+    {
+        const origin = this.convertVector3(r.origin);
+        const direction = this.convertVector3(r.direction);
+        return new THREE.Ray(origin, direction);
+    },
+
 });
 
 /**

plugins/babylon-with-encantar.js

@@ -92,8 +92,8 @@ class ARSystem
     }
 
     /**
-     * Pointer-based input in the current frame (touch, mouse, pen...)
-     * You need a PointerTracker in your session in order to use these
+     * Pointer-based input (current frame)
+     * Make sure to add a PointerTracker to your session in order to use these
      * @returns {TrackablePointer[]}
      */
     get pointers()
@@ -139,6 +139,48 @@ class ARSystem
     }
 
     /**
+     * Convert an AR Vector2 to a BABYLON Vector2
+     * @param {Vector2} v
+     * @returns {BABYLON.Vector2}
+     */
+    convertVector2(v)
+    {
+        return new BABYLON.Vector2(v.x, v.y);
+    }
+
+    /**
+     * Convert an AR Vector3 to a BABYLON Vector3
+     * @param {Vector3} v
+     * @returns {BABYLON.Vector3}
+     */
+    convertVector3(v)
+    {
+        return new BABYLON.Vector3(v.x, v.y, v.z);
+    }
+
+    /**
+     * Convert an AR Quaternion to a BABYLON Quaternion
+     * @param {Quaternion} q
+     * @returns {BABYLON.Quaternion}
+     */
+    convertQuaternion(q)
+    {
+        return new BABYLON.Quaternion(q.x, q.y, q.z, q.w);
+    }
+
+    /**
+     * Convert an AR Ray to a BABYLON Ray
+     * @param {Ray} r
+     * @returns {BABYLON.Ray}
+     */
+    convertRay(r)
+    {
+        const origin = this.convertVector3(r.origin);
+        const direction = this.convertVector3(r.direction);
+        return new BABYLON.Ray(origin, direction);
+    }
+
+    /**
      * Constructor
      */
     constructor()

plugins/three-with-encantar.js

@@ -92,8 +92,8 @@ class ARSystem
     }
 
     /**
-     * Pointer-based input in the current frame (touch, mouse, pen...)
-     * You need a PointerTracker in your session in order to use these
+     * Pointer-based input (current frame)
+     * Make sure to add a PointerTracker to your session in order to use these
      * @returns {TrackablePointer[]}
      */
     get pointers()
@@ -139,6 +139,48 @@ class ARSystem
     }
 
     /**
+     * Convert an AR Vector2 to a THREE Vector2
+     * @param {Vector2} v
+     * @returns {THREE.Vector2}
+     */
+    convertVector2(v)
+    {
+        return new THREE.Vector2(v.x, v.y);
+    }
+
+    /**
+     * Convert an AR Vector3 to a THREE Vector3
+     * @param {Vector3} v
+     * @returns {THREE.Vector3}
+     */
+    convertVector3(v)
+    {
+        return new THREE.Vector3(v.x, v.y, v.z);
+    }
+
+    /**
+     * Convert an AR Quaternion to a THREE Quaternion
+     * @param {Quaternion} q
+     * @returns {THREE.Quaternion}
+     */
+    convertQuaternion(q)
+    {
+        return new THREE.Quaternion(q.x, q.y, q.z, q.w);
+    }
+
+    /**
+     * Convert an AR Ray to a THREE Ray
+     * @param {Ray} r
+     * @returns {THREE.Ray}
+     */
+    convertRay(r)
+    {
+        const origin = this.convertVector3(r.origin);
+        const direction = this.convertVector3(r.direction);
+        return new THREE.Ray(origin, direction);
+    }
+
+    /**
      * Constructor
      */
     constructor()