Update to encantar.js

CONTRIBUTING.md

@@ -1,8 +1,6 @@
 # How to contribute
 
-Thank you for your interest in contributing to MARTINS.js! 👍
-
-In order to contribute to MARTINS.js, you must certify that you have the right to submit your contribution according to the [Developer Certificate of Origin (DCO)](https://developercertificate.org). Each commit must include a `Signed-off-by` line at the end of the commit message, as in the template below:
+Please certify that you have the right to submit your contribution according to the [Developer Certificate of Origin (DCO)](https://developercertificate.org). Each commit must include a `Signed-off-by` line at the end of the commit message, as in the template below:
 
 ```
 Signed-off-by: Your Name <your.email@addr.es>

README.md

@@ -1,10 +1,10 @@
-# MARTINS.js WebAR engine
+# encantAR.js WebAR engine
 
-[![GitHub release (latest by date)](https://img.shields.io/github/v/release/alemart/martins-js)](https://github.com/alemart/martins-js/releases/) ![GitHub file size in bytes on a specified ref (branch/commit/tag)](https://img.shields.io/github/size/alemart/martins-js/dist/martins.min.js?branch=master&label=minified%20js) [![GitHub Repo stars](https://img.shields.io/github/stars/alemart/martins-js?logo=github)](https://github.com/alemart/martins-js/stargazers) [![GitHub Sponsors](https://img.shields.io/github/sponsors/alemart?logo=github)](https://github.com/sponsors/alemart/)
+[![GitHub release (latest by date)](https://img.shields.io/github/v/release/alemart/encantar-js)](https://github.com/alemart/encantar-js/releases/) ![GitHub file size in bytes on a specified ref (branch/commit/tag)](https://img.shields.io/github/size/alemart/encantar-js/dist/encantar.min.js?branch=master&label=minified%20js) [![GitHub Repo stars](https://img.shields.io/github/stars/alemart/encantar-js?logo=github)](https://github.com/alemart/encantar-js/stargazers) [![GitHub Sponsors](https://img.shields.io/github/sponsors/alemart?logo=github)](https://github.com/sponsors/alemart/)
 
-Create amazing Augmented Reality experiences with **MARTINS.js**, a GPU-accelerated Augmented Reality engine for the web.
+Create amazing Augmented Reality experiences with **encantAR.js**, a GPU-accelerated Augmented Reality engine for the web.
 
-:books: Documentation: <https://alemart.github.io/martins-js/>
+:books: Documentation: <https://alemart.github.io/encantar-js/>
 
 ## Features
 
@@ -13,7 +13,7 @@ Create amazing Augmented Reality experiences with **MARTINS.js**, a GPU-accelera
 
 ## Try a demo
 
-:arrow_right: [Launch now!](https://alemart.github.io/martins-js/demo)
+:arrow_right: [Launch now!](https://alemart.github.io/encantar-js/demo)
 
 >
 > **Guidelines:**
@@ -23,17 +23,17 @@ Create amazing Augmented Reality experiences with **MARTINS.js**, a GPU-accelera
 > * The physical environment should be properly illuminated.
 >
 
-## Why use MARTINS.js?
+## Why use encantAR.js?
 
-* **No need to download apps!** MARTINS.js is a WebAR engine: it runs in web browsers. Users can access the AR experiences immediately.
-* **Easy to get started!** MARTINS.js can be used with a `<script>` tag in your page. A static HTML page is enough to get started.
-* **Fast and powerful!** MARTINS.js is GPU-accelerated. It uses WebGL2 and WebAssembly for turbocharged performance.
-* **Fully standalone!** MARTINS.js is built from scratch using standard web technologies. No need for additional hardware or software!
+* **No need to download apps!** encantAR.js is a WebAR engine: it runs in web browsers. Users can access the AR experiences immediately.
+* **Easy to get started!** encantAR.js can be used with a `<script>` tag in your page. A static HTML page is enough to get started.
+* **Fast and powerful!** encantAR.js is GPU-accelerated. It uses WebGL2 and WebAssembly for turbocharged performance.
+* **Fully standalone!** encantAR.js is built from scratch using standard web technologies. No need for additional hardware or software!
 * **Free and open-source!** Get started right away!
 
 ## Browser compatibility
 
-MARTINS.js is compatible with all major web browsers:
+encantAR.js is compatible with all major web browsers:
 
 | Chrome | Edge | Firefox | Opera | Safari* |
 | ------ | ---- | ------- | ----- | ------- |
@@ -41,8 +41,8 @@ MARTINS.js is compatible with all major web browsers:
 
 \* use Safari 15.2 or later.
 
-MARTINS.js requires WebGL2 and WebAssembly.
+encantAR.js requires WebGL2 and WebAssembly.
 
 ## About
 
-MARTINS.js is developed by [Alexandre Martins](https://github.com/alemart) and released under the [LGPL](LICENSE.md). It is based on [Speedy Vision](https://github.com/alemart/speedy-vision).
+encantAR.js is developed by [Alexandre Martins](https://github.com/alemart) and released under the [LGPL](LICENSE.md). It is based on [Speedy Vision](https://github.com/alemart/speedy-vision).

demos/assets/aframe-with-martins.js → demos/assets/aframe-with-encantar.js

@@ -1,20 +1,20 @@
 /**
- * @file MARTINS.js & AFRAME glue code
+ * @file aframe plugin for encantar.js
  * @author Alexandre Martins (https://github.com/alemart)
  * @license LGPL-3.0-or-later
  */
 
 /* Usage of the indicated versions is encouraged */
-__THIS_GLUE_CODE_HAS_BEEN_TESTED_WITH__({
-    'MARTINS.js': { version: '0.2.0' },
-        'AFRAME': { version: '1.4.2' }
+__THIS_PLUGIN_HAS_BEEN_TESTED_WITH__({
+    'encantar.js': { version: '0.2.0' },
+         'aframe': { version: '1.4.2' }
 });
 
 /**
- * Connect MARTINS.js to AFRAME
+ * Connect encantar.js to aframe
  * @param {(canvas: HTMLCanvasElement) => Promise<Session> | SpeedyPromise<Session>} startARSession
  */
-function linkMartinsToAFRAME(startARSession)
+function encantar(startARSession)
 {
     AFRAME.registerSystem('ar-system', {
         init()
@@ -218,7 +218,7 @@ function linkMartinsToAFRAME(startARSession)
 
 // Start automatically
 if(typeof startARSession === 'function')
-    linkMartinsToAFRAME(startARSession);
+    encantar(startARSession);
 else
     alert('Missing startARSession');
 
@@ -226,11 +226,11 @@ else
  * Version check
  * @param {object} json
  */
-function __THIS_GLUE_CODE_HAS_BEEN_TESTED_WITH__(json)
+function __THIS_PLUGIN_HAS_BEEN_TESTED_WITH__(json)
 {
     try { Martins, AFRAME;
-    const versionOf = { 'MARTINS.js': Martins.version.replace(/-.*$/, ''), 'AFRAME': AFRAME.version };
-    const check = (x,v,w) => v !== w ? console.warn(`\n\n\nWARNING\n\nThis glue code has been tested with ${x} version ${v}. The version in use is ${w}. Usage of ${x} version ${v} is recommended instead.\n\n\n`) : void 0;
+    const versionOf = { 'encantar.js': Martins.version.replace(/-.*$/, ''), 'aframe': AFRAME.version };
+    const check = (x,v,w) => v !== w ? console.warn(`\n\n\nWARNING\n\nThis plugin has been tested with ${x} version ${v}. The version in use is ${w}. Usage of ${x} version ${v} is recommended instead.\n\n\n`) : void 0;
     for(const [x, expected] of Object.entries(json)) check(x, expected.version, versionOf[x]);
     } catch(e) { alert(e.message); }
 }

demos/assets/three-with-martins.js → demos/assets/three-with-encantar.js

@@ -1,35 +1,35 @@
 /**
- * @file MARTINS.js & THREE.js glue code
+ * @file three.js plugin for encantar.js
  * @author Alexandre Martins (https://github.com/alemart)
  * @license LGPL-3.0-or-later
  */
 
 /* Usage of the indicated versions is encouraged */
-__THIS_GLUE_CODE_HAS_BEEN_TESTED_WITH__({
-    'MARTINS.js': { version: '0.2.0' },
-      'THREE.js': { version: '147' }
+__THIS_PLUGIN_HAS_BEEN_TESTED_WITH__({
+    'encantar.js': { version: '0.2.1' },
+       'three.js': { version: '147' }
 });
 
 /**
  * Use this object to create your augmented scene
  * @typedef {object} ARSystem
- * @property {Session} session MARTINS.js Session
+ * @property {Session} session AR Session
  * @property {Frame} frame current Frame
  * @property {ReferenceImage | null} referenceImage corresponds to the target being tracked (if any)
- * @property {THREE.Scene} scene THREE.js Scene
+ * @property {THREE.Scene} scene three.js Scene
  * @property {THREE.Group} root a 3D object that is automatically aligned with the physical target
  * @property {THREE.Camera} camera a camera adjusted for AR
- * @property {THREE.WebGLRenderer} renderer THREE.js renderer
+ * @property {THREE.WebGLRenderer} renderer three.js renderer
  */
 
 /**
- * Connect MARTINS.js to THREE.js
+ * Connect encantar.js to three.js
  * @param {() => Promise<Session> | SpeedyPromise<Session>} startARSession
  * @param {(ar: ARSystem) => void} [animateVirtualScene] animation callback
  * @param {(ar: ARSystem) => void | Promise<void> | SpeedyPromise<Session>} [initializeVirtualScene] initialization callback
  * @returns {Promise<ARSystem> | SpeedyPromise<ARSystem>}
  */
-function linkMartinsToTHREE(startARSession, animateVirtualScene, initializeVirtualScene)
+function encantar(startARSession, animateVirtualScene, initializeVirtualScene)
 {
     const ar = /** @type {ARSystem} */ ({
         session: null,
@@ -144,12 +144,12 @@ function linkMartinsToTHREE(startARSession, animateVirtualScene, initializeVirtu
  * Version check
  * @param {object} json
  */
-function __THIS_GLUE_CODE_HAS_BEEN_TESTED_WITH__(json)
+function __THIS_PLUGIN_HAS_BEEN_TESTED_WITH__(json)
 {
     window.addEventListener('load', () => {
     try { Martins, __THREE__;
-    const versionOf = { 'MARTINS.js': Martins.version.replace(/-.*$/, ''), 'THREE.js': __THREE__ };
-    const check = (x,v,w) => v !== w ? console.warn(`\n\n\nWARNING\n\nThis glue code has been tested with ${x} version ${v}. The version in use is ${w}. Usage of ${x} version ${v} is recommended instead.\n\n\n`) : void 0;
+    const versionOf = { 'encantar.js': Martins.version.replace(/-.*$/, ''), 'three.js': __THREE__ };
+    const check = (x,v,w) => v !== w ? console.warn(`\n\n\nWARNING\n\nThis plugin has been tested with ${x} version ${v}. The version in use is ${w}. Usage of ${x} version ${v} is recommended instead.\n\n\n`) : void 0;
     for(const [x, expected] of Object.entries(json)) check(x, expected.version, versionOf[x]);
     } catch(e) { alert(e.message); }
     });

demos/hello-aframe/NOTICE.html

@@ -17,10 +17,10 @@
         <p>This application contains free and open-source software and this page sets forth the corresponding attribution notices.</p>
         <ol>
             <li>
-                MARTINS.js: GPU-accelerated Augmented Reality for the web<br>
+                encantAR.js: GPU-accelerated Augmented Reality for the web<br>
                 Copyright &copy; 2022-present Alexandre Martins<br>
                 License: <a href="#lgpl">GNU Lesser General Public License, version 3</a><br>
-                <a href="https://github.com/alemart/martins-js" target="_blank" rel="external">https://github.com/alemart/martins-js</a>
+                <a href="https://github.com/alemart/encantar-js" target="_blank" rel="external">https://github.com/alemart/encantar-js</a>
             </li>
             <li>
                 Speedy Vision: GPU-accelerated Computer Vision for JavaScript<br>

demos/hello-aframe/README.html

@@ -2,7 +2,7 @@
 <html>
     <head>
         <meta charset="utf-8">
-        <title>MARTINS.js WebAR demo with A-Frame</title>
+        <title>encantAR.js WebAR demo with A-Frame</title>
         <style>
         li + li {
             margin-top: 1em;
@@ -42,12 +42,12 @@
         <img src="qr-code.gif" alt="QR code" class="qr-code">
 
         <h2>Share</h2>
-        <p>This application is powered by <a href="https://alemart.github.io/martins-js" target="_blank">MARTINS.js: GPU-accelerated Augmented Reality for the web</a>.</p>
+        <p>This application is powered by <a href="https://alemart.github.io/encantar-js" target="_blank">encantAR.js: GPU-accelerated Augmented Reality for the web</a>.</p>
         <div>
-            <a href="https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Falemart.github.io/martins-js&quote=%23martins-js" target="_blank" rel="external" class="button"><img src="../assets/facebook.png" alt="Share on Facebook"></a>
-            <a href="https://twitter.com/intent/tweet?url=https%3A%2F%2Falemart.github.io/martins-js&hashtags=martins-js" target="_blank" rel="external" class="button"><img src="../assets/twitter.png" alt="Share on X"></a>
-            <a href="https://wa.me/?text=https%3A%2F%2Falemart.github.io/martins-js" target="_blank" rel="external" class="button"><img src="../assets/whatsapp.png" alt="Share via WhatsApp"></a>
-            <a href="https://t.me/share/url?url=https%3A%2F%2Falemart.github.io/martins-js" target="_blank" rel="external" class="button"><img src="../assets/telegram.png" alt="Share via Telegram"></a>
+            <a href="https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Falemart.github.io/encantar-js&quote=%23encantar-js" target="_blank" rel="external" class="button"><img src="../assets/facebook.png" alt="Share on Facebook"></a>
+            <a href="https://twitter.com/intent/tweet?url=https%3A%2F%2Falemart.github.io/encantar-js&hashtags=encantar-js" target="_blank" rel="external" class="button"><img src="../assets/twitter.png" alt="Share on X"></a>
+            <a href="https://wa.me/?text=https%3A%2F%2Falemart.github.io/encantar-js" target="_blank" rel="external" class="button"><img src="../assets/whatsapp.png" alt="Share via WhatsApp"></a>
+            <a href="https://t.me/share/url?url=https%3A%2F%2Falemart.github.io/encantar-js" target="_blank" rel="external" class="button"><img src="../assets/telegram.png" alt="Share via Telegram"></a>
         </div>
     </body>
 </html>

demos/hello-aframe/demo.js

@@ -1,9 +1,3 @@
-/**
- * @file MARTINS.js WebAR demo with A-Frame
- * @author Alexandre Martins (https://github.com/alemart)
- * @license LGPL-3.0-or-later
- */
-
 async function startARSession(canvas)
 {
     if(!Martins.isSupported()) {

demos/hello-aframe/index.html

@@ -3,13 +3,13 @@
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR demo with A-Frame</title>
+        <title>encantAR.js WebAR demo with A-Frame</title>
         <link href="demo.css" rel="stylesheet">
-        <script src="../../dist/martins.min.js"></script>
+        <script src="../../dist/encantar.min.js"></script>
         <script src="https://cdn.jsdelivr.net/npm/aframe@1.4.2/dist/aframe-v1.4.2.min.js"></script>
         <script src="../assets/aframe-particle-system-component.min.js"></script>
         <script src="demo.js"></script>
-        <script src="../assets/aframe-with-martins.js"></script>
+        <script src="../assets/aframe-with-encantar.js"></script>
     </head>
     <body>
         <div id="ar-viewport">

demos/hello-aframe/video.html

@@ -3,13 +3,13 @@
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR demo with A-Frame</title>
+        <title>encantAR.js WebAR demo with A-Frame</title>
         <link href="demo.css" rel="stylesheet">
-        <script src="../../dist/martins.min.js"></script>
+        <script src="../../dist/encantar.min.js"></script>
         <script src="https://cdn.jsdelivr.net/npm/aframe@1.4.2/dist/aframe-v1.4.2.min.js"></script>
         <script src="../assets/aframe-particle-system-component.min.js"></script>
         <script src="demo.js"></script>
-        <script src="../assets/aframe-with-martins.js"></script>
+        <script src="../assets/aframe-with-encantar.js"></script>
     </head>
     <body>
         <div id="ar-viewport">

demos/hello-three/NOTICE.html

@@ -17,10 +17,10 @@
         <p>This application contains free and open-source software and this page sets forth the corresponding attribution notices.</p>
         <ol>
             <li>
-                MARTINS.js: GPU-accelerated Augmented Reality for the web<br>
+                encantAR.js: GPU-accelerated Augmented Reality for the web<br>
                 Copyright &copy; 2022-present Alexandre Martins<br>
                 License: <a href="#lgpl">GNU Lesser General Public License, version 3</a><br>
-                <a href="https://github.com/alemart/martins-js" target="_blank" rel="external">https://github.com/alemart/martins-js</a>
+                <a href="https://github.com/alemart/encantar-js" target="_blank" rel="external">https://github.com/alemart/encantar-js</a>
             </li>
             <li>
                 Speedy Vision: GPU-accelerated Computer Vision for JavaScript<br>

demos/hello-three/README.html

@@ -2,7 +2,7 @@
 <html>
     <head>
         <meta charset="utf-8">
-        <title>MARTINS.js WebAR demo with three.js</title>
+        <title>encantAR.js WebAR demo with three.js</title>
         <style>
         li + li {
             margin-top: 1em;
@@ -42,12 +42,12 @@
         <img src="qr-code.gif" alt="QR code" class="qr-code">
 
         <h2>Share</h2>
-        <p>This application is powered by <a href="https://alemart.github.io/martins-js" target="_blank">MARTINS.js: GPU-accelerated Augmented Reality for the web</a>.</p>
+        <p>This application is powered by <a href="https://alemart.github.io/encantar-js" target="_blank">encantAR.js: GPU-accelerated Augmented Reality for the web</a>.</p>
         <div>
-            <a href="https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Falemart.github.io/martins-js&quote=%23martins-js" target="_blank" rel="external" class="button"><img src="../assets/facebook.png" alt="Share on Facebook"></a>
-            <a href="https://twitter.com/intent/tweet?url=https%3A%2F%2Falemart.github.io/martins-js&hashtags=martins-js" target="_blank" rel="external" class="button"><img src="../assets/twitter.png" alt="Share on X"></a>
-            <a href="https://wa.me/?text=https%3A%2F%2Falemart.github.io/martins-js" target="_blank" rel="external" class="button"><img src="../assets/whatsapp.png" alt="Share via WhatsApp"></a>
-            <a href="https://t.me/share/url?url=https%3A%2F%2Falemart.github.io/martins-js" target="_blank" rel="external" class="button"><img src="../assets/telegram.png" alt="Share via Telegram"></a>
+            <a href="https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Falemart.github.io/encantar-js&quote=%23encantar-js" target="_blank" rel="external" class="button"><img src="../assets/facebook.png" alt="Share on Facebook"></a>
+            <a href="https://twitter.com/intent/tweet?url=https%3A%2F%2Falemart.github.io/encantar-js&hashtags=encantar-js" target="_blank" rel="external" class="button"><img src="../assets/twitter.png" alt="Share on X"></a>
+            <a href="https://wa.me/?text=https%3A%2F%2Falemart.github.io/encantar-js" target="_blank" rel="external" class="button"><img src="../assets/whatsapp.png" alt="Share via WhatsApp"></a>
+            <a href="https://t.me/share/url?url=https%3A%2F%2Falemart.github.io/encantar-js" target="_blank" rel="external" class="button"><img src="../assets/telegram.png" alt="Share via Telegram"></a>
         </div>
     </body>
 </html>

demos/hello-three/demo.js

@@ -1,9 +1,3 @@
-/**
- * @file MARTINS.js WebAR demo with three.js
- * @author Alexandre Martins (https://github.com/alemart)
- * @license LGPL-3.0-or-later
- */
-
 window.addEventListener('load', () => {
 
     const my = { };
@@ -157,7 +151,7 @@ window.addEventListener('load', () => {
         return session;
     }
 
-    // link MARTINS.js to THREE.js
-    linkMartinsToTHREE(startARSession, animate, initialize);
+    // enchant!
+    encantar(startARSession, animate, initialize);
 
 });

demos/hello-three/index.html

@@ -3,12 +3,12 @@
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR demo with three.js</title>
+        <title>encantAR.js WebAR demo with three.js</title>
         <link href="demo.css" rel="stylesheet">
-        <script src="../../dist/martins.min.js"></script>
+        <script src="../../dist/encantar.min.js"></script>
         <script src="https://cdn.jsdelivr.net/npm/three@0.147.0/build/three.min.js"></script>
         <script src="https://cdn.jsdelivr.net/npm/three@0.147.0/examples/js/loaders/GLTFLoader.js"></script>
-        <script src="../assets/three-with-martins.js"></script>
+        <script src="../assets/three-with-encantar.js"></script>
         <script src="demo.js"></script>
     </head>
     <body>

demos/hello-three/video.html

@@ -3,12 +3,12 @@
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR demo with three.js</title>
+        <title>encantAR.js WebAR demo with three.js</title>
         <link href="demo.css" rel="stylesheet">
-        <script src="../../dist/martins.min.js"></script>
+        <script src="../../dist/encantar.min.js"></script>
         <script src="https://cdn.jsdelivr.net/npm/three@0.147.0/build/three.min.js"></script>
         <script src="https://cdn.jsdelivr.net/npm/three@0.147.0/examples/js/loaders/GLTFLoader.js"></script>
-        <script src="../assets/three-with-martins.js"></script>
+        <script src="../assets/three-with-encantar.js"></script>
         <script src="demo.js"></script>
     </head>
     <body>

demos/hello-webgl/NOTICE.html

@@ -17,10 +17,10 @@
         <p>This application contains free and open-source software and this page sets forth the corresponding attribution notices.</p>
         <ol>
             <li>
-                MARTINS.js: GPU-accelerated Augmented Reality for the web<br>
+                encantAR.js: GPU-accelerated Augmented Reality for the web<br>
                 Copyright &copy; 2022-present Alexandre Martins<br>
                 License: <a href="#lgpl">GNU Lesser General Public License, version 3</a><br>
-                <a href="https://github.com/alemart/martins-js" target="_blank" rel="external">https://github.com/alemart/martins-js</a>
+                <a href="https://github.com/alemart/encantar-js" target="_blank" rel="external">https://github.com/alemart/encantar-js</a>
             </li>
             <li>
                 Speedy Vision: GPU-accelerated Computer Vision for JavaScript<br>

demos/hello-webgl/README.html

@@ -2,7 +2,7 @@
 <html>
     <head>
         <meta charset="utf-8">
-        <title>MARTINS.js WebAR demo with WebGL</title>
+        <title>encantAR.js WebAR demo with WebGL</title>
         <style>
         li + li {
             margin-top: 1em;
@@ -42,12 +42,12 @@
         <img src="qr-code.gif" alt="QR code" class="qr-code">
 
         <h2>Share</h2>
-        <p>This application is powered by <a href="https://alemart.github.io/martins-js" target="_blank">MARTINS.js: GPU-accelerated Augmented Reality for the web</a>.</p>
+        <p>This application is powered by <a href="https://alemart.github.io/encantar-js" target="_blank">encantAR.js: GPU-accelerated Augmented Reality for the web</a>.</p>
         <div>
-            <a href="https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Falemart.github.io/martins-js&quote=%23martins-js" target="_blank" rel="external" class="button"><img src="../assets/facebook.png" alt="Share on Facebook"></a>
-            <a href="https://twitter.com/intent/tweet?url=https%3A%2F%2Falemart.github.io/martins-js&hashtags=martins-js" target="_blank" rel="external" class="button"><img src="../assets/twitter.png" alt="Share on X"></a>
-            <a href="https://wa.me/?text=https%3A%2F%2Falemart.github.io/martins-js" target="_blank" rel="external" class="button"><img src="../assets/whatsapp.png" alt="Share via WhatsApp"></a>
-            <a href="https://t.me/share/url?url=https%3A%2F%2Falemart.github.io/martins-js" target="_blank" rel="external" class="button"><img src="../assets/telegram.png" alt="Share via Telegram"></a>
+            <a href="https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Falemart.github.io/encantar-js&quote=%23encantar-js" target="_blank" rel="external" class="button"><img src="../assets/facebook.png" alt="Share on Facebook"></a>
+            <a href="https://twitter.com/intent/tweet?url=https%3A%2F%2Falemart.github.io/encantar-js&hashtags=encantar-js" target="_blank" rel="external" class="button"><img src="../assets/twitter.png" alt="Share on X"></a>
+            <a href="https://wa.me/?text=https%3A%2F%2Falemart.github.io/encantar-js" target="_blank" rel="external" class="button"><img src="../assets/whatsapp.png" alt="Share via WhatsApp"></a>
+            <a href="https://t.me/share/url?url=https%3A%2F%2Falemart.github.io/encantar-js" target="_blank" rel="external" class="button"><img src="../assets/telegram.png" alt="Share via Telegram"></a>
         </div>
     </body>
 </html>

demos/hello-webgl/demo.js

@@ -1,9 +1,3 @@
-/**
- * @file MARTINS.js WebAR demo with WebGL
- * @author Alexandre Martins (https://github.com/alemart)
- * @license LGPL-3.0-or-later
- */
-
 /*
 
 Note:
@@ -842,7 +836,7 @@ class WingMan extends Sprite
 
 /*
 
-MARTINS.js + WebGL code:
+encantar.js + WebGL code:
 
 */
 

demos/hello-webgl/index.html

@@ -3,9 +3,9 @@
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR demo with WebGL</title>
+        <title>encantAR.js WebAR demo with WebGL</title>
         <link href="demo.css" rel="stylesheet">
-        <script src="../../dist/martins.min.js"></script>
+        <script src="../../dist/encantar.min.js"></script>
         <script src="demo.js"></script>
     </head>
     <body>

demos/hello-webgl/video.html

@@ -3,9 +3,9 @@
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR demo with WebGL</title>
+        <title>encantAR.js WebAR demo with WebGL</title>
         <link href="demo.css" rel="stylesheet">
-        <script src="../../dist/martins.min.js"></script>
+        <script src="../../dist/encantar.min.js"></script>
         <script src="demo.js"></script>
     </head>
     <body>

demos/hello-world/NOTICE.html

@@ -17,10 +17,10 @@
         <p>This application contains free and open-source software and this page sets forth the corresponding attribution notices.</p>
         <ol>
             <li>
-                MARTINS.js: GPU-accelerated Augmented Reality for the web<br>
+                encantAR.js: GPU-accelerated Augmented Reality for the web<br>
                 Copyright &copy; 2022-present Alexandre Martins<br>
                 License: <a href="#lgpl">GNU Lesser General Public License, version 3</a><br>
-                <a href="https://github.com/alemart/martins-js" target="_blank" rel="external">https://github.com/alemart/martins-js</a>
+                <a href="https://github.com/alemart/encantar-js" target="_blank" rel="external">https://github.com/alemart/encantar-js</a>
             </li>
             <li>
                 Speedy Vision: GPU-accelerated Computer Vision for JavaScript<br>

demos/hello-world/README.html

@@ -2,7 +2,7 @@
 <html>
     <head>
         <meta charset="utf-8">
-        <title>MARTINS.js WebAR template</title>
+        <title>encantAR.js WebAR template</title>
         <style>
         li + li {
             margin-top: 1em;
@@ -42,12 +42,12 @@
         <img src="qr-code.gif" alt="QR code" class="qr-code">
 
         <h2>Share</h2>
-        <p>This application is powered by <a href="https://alemart.github.io/martins-js" target="_blank">MARTINS.js: GPU-accelerated Augmented Reality for the web</a>.</p>
+        <p>This application is powered by <a href="https://alemart.github.io/encantar-js" target="_blank">encantAR.js: GPU-accelerated Augmented Reality for the web</a>.</p>
         <div>
-            <a href="https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Falemart.github.io/martins-js&quote=%23martins-js" target="_blank" rel="external" class="button"><img src="../assets/facebook.png" alt="Share on Facebook"></a>
-            <a href="https://twitter.com/intent/tweet?url=https%3A%2F%2Falemart.github.io/martins-js&hashtags=martins-js" target="_blank" rel="external" class="button"><img src="../assets/twitter.png" alt="Share on X"></a>
-            <a href="https://wa.me/?text=https%3A%2F%2Falemart.github.io/martins-js" target="_blank" rel="external" class="button"><img src="../assets/whatsapp.png" alt="Share via WhatsApp"></a>
-            <a href="https://t.me/share/url?url=https%3A%2F%2Falemart.github.io/martins-js" target="_blank" rel="external" class="button"><img src="../assets/telegram.png" alt="Share via Telegram"></a>
+            <a href="https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Falemart.github.io/encantar-js&quote=%23encantar-js" target="_blank" rel="external" class="button"><img src="../assets/facebook.png" alt="Share on Facebook"></a>
+            <a href="https://twitter.com/intent/tweet?url=https%3A%2F%2Falemart.github.io/encantar-js&hashtags=encantar-js" target="_blank" rel="external" class="button"><img src="../assets/twitter.png" alt="Share on X"></a>
+            <a href="https://wa.me/?text=https%3A%2F%2Falemart.github.io/encantar-js" target="_blank" rel="external" class="button"><img src="../assets/whatsapp.png" alt="Share via WhatsApp"></a>
+            <a href="https://t.me/share/url?url=https%3A%2F%2Falemart.github.io/encantar-js" target="_blank" rel="external" class="button"><img src="../assets/telegram.png" alt="Share via Telegram"></a>
         </div>
     </body>
 </html>

demos/hello-world/demo.js

@@ -1,9 +1,3 @@
-/**
- * @file MARTINS.js WebAR template: Hello, world!
- * @author Alexandre Martins (https://github.com/alemart)
- * @license LGPL-3.0-or-later
- */
-
 window.addEventListener('load', async function() {
     try {
         const session = await startARSession();

demos/hello-world/index.html

@@ -3,9 +3,9 @@
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR template</title>
+        <title>encantAR.js WebAR template</title>
         <link href="demo.css" rel="stylesheet">
-        <script src="../../dist/martins.min.js"></script>
+        <script src="../../dist/encantar.min.js"></script>
         <script src="demo.js"></script>
     </head>
     <body>

demos/hello-world/video.html

@@ -3,9 +3,9 @@
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR template</title>
+        <title>encantAR.js WebAR template</title>
         <link href="demo.css" rel="stylesheet">
-        <script src="../../dist/martins.min.js"></script>
+        <script src="../../dist/encantar.min.js"></script>
         <script src="demo.js"></script>
     </head>
     <body>

demos/touch-three/NOTICE.html

@@ -17,10 +17,10 @@
         <p>This application contains free and open-source software and this page sets forth the corresponding attribution notices.</p>
         <ol>
             <li>
-                MARTINS.js: GPU-accelerated Augmented Reality for the web<br>
+                encantAR.js: GPU-accelerated Augmented Reality for the web<br>
                 Copyright &copy; 2022-present Alexandre Martins<br>
                 License: <a href="#lgpl">GNU Lesser General Public License, version 3</a><br>
-                <a href="https://github.com/alemart/martins-js" target="_blank" rel="external">https://github.com/alemart/martins-js</a>
+                <a href="https://github.com/alemart/encantar-js" target="_blank" rel="external">https://github.com/alemart/encantar-js</a>
             </li>
             <li>
                 Speedy Vision: GPU-accelerated Computer Vision for JavaScript<br>

demos/touch-three/README.html

@@ -2,7 +2,7 @@
 <html>
     <head>
         <meta charset="utf-8">
-        <title>MARTINS.js WebAR demo with three.js and touch interaction</title>
+        <title>encantAR.js WebAR demo with three.js and touch interaction</title>
         <style>
         li + li {
             margin-top: 1em;
@@ -42,12 +42,12 @@
         <img src="qr-code.gif" alt="QR code" class="qr-code">
 
         <h2>Share</h2>
-        <p>This application is powered by <a href="https://alemart.github.io/martins-js" target="_blank">MARTINS.js: GPU-accelerated Augmented Reality for the web</a>.</p>
+        <p>This application is powered by <a href="https://alemart.github.io/encantar-js" target="_blank">encantAR.js: GPU-accelerated Augmented Reality for the web</a>.</p>
         <div>
-            <a href="https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Falemart.github.io/martins-js&quote=%23martins-js" target="_blank" rel="external" class="button"><img src="../assets/facebook.png" alt="Share on Facebook"></a>
-            <a href="https://twitter.com/intent/tweet?url=https%3A%2F%2Falemart.github.io/martins-js&hashtags=martins-js" target="_blank" rel="external" class="button"><img src="../assets/twitter.png" alt="Share on X"></a>
-            <a href="https://wa.me/?text=https%3A%2F%2Falemart.github.io/martins-js" target="_blank" rel="external" class="button"><img src="../assets/whatsapp.png" alt="Share via WhatsApp"></a>
-            <a href="https://t.me/share/url?url=https%3A%2F%2Falemart.github.io/martins-js" target="_blank" rel="external" class="button"><img src="../assets/telegram.png" alt="Share via Telegram"></a>
+            <a href="https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Falemart.github.io/encantar-js&quote=%23encantar-js" target="_blank" rel="external" class="button"><img src="../assets/facebook.png" alt="Share on Facebook"></a>
+            <a href="https://twitter.com/intent/tweet?url=https%3A%2F%2Falemart.github.io/encantar-js&hashtags=encantar-js" target="_blank" rel="external" class="button"><img src="../assets/twitter.png" alt="Share on X"></a>
+            <a href="https://wa.me/?text=https%3A%2F%2Falemart.github.io/encantar-js" target="_blank" rel="external" class="button"><img src="../assets/whatsapp.png" alt="Share via WhatsApp"></a>
+            <a href="https://t.me/share/url?url=https%3A%2F%2Falemart.github.io/encantar-js" target="_blank" rel="external" class="button"><img src="../assets/telegram.png" alt="Share via Telegram"></a>
         </div>
     </body>
 </html>

demos/touch-three/demo.js

@@ -1,9 +1,3 @@
-/**
- * @file MARTINS.js WebAR demo with three.js and touch interaction
- * @author Alexandre Martins (https://github.com/alemart)
- * @license LGPL-3.0-or-later
- */
-
 window.addEventListener('load', () => {
 
     const my = { };
@@ -187,7 +181,7 @@ window.addEventListener('load', () => {
         return session;
     }
 
-    // link MARTINS.js to THREE.js
-    linkMartinsToTHREE(startARSession, animate, initialize);
+    // enchant!
+    encantar(startARSession, animate, initialize);
 
 });

demos/touch-three/index.html

@@ -3,13 +3,13 @@
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR demo with three.js and touch interaction</title>
+        <title>encantAR.js WebAR demo with three.js and touch interaction</title>
         <link href="demo.css" rel="stylesheet">
-        <script src="../../dist/martins.min.js"></script>
+        <script src="../../dist/encantar.min.js"></script>
         <script src="https://cdn.jsdelivr.net/npm/three@0.147.0/build/three.min.js"></script>
         <script src="https://cdn.jsdelivr.net/npm/three@0.147.0/examples/js/loaders/FontLoader.js"></script>
         <script src="https://cdn.jsdelivr.net/npm/three@0.147.0/examples/js/geometries/TextGeometry.js"></script>
-        <script src="../assets/three-with-martins.js"></script>
+        <script src="../assets/three-with-encantar.js"></script>
         <script src="demo.js"></script>
     </head>
     <body>

demos/touch-three/video.html

@@ -3,13 +3,13 @@
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR demo with three.js and touch interaction</title>
+        <title>encantAR.js WebAR demo with three.js and touch interaction</title>
         <link href="demo.css" rel="stylesheet">
-        <script src="../../dist/martins.min.js"></script>
+        <script src="../../dist/encantar.min.js"></script>
         <script src="https://cdn.jsdelivr.net/npm/three@0.147.0/build/three.min.js"></script>
         <script src="https://cdn.jsdelivr.net/npm/three@0.147.0/examples/js/loaders/FontLoader.js"></script>
         <script src="https://cdn.jsdelivr.net/npm/three@0.147.0/examples/js/geometries/TextGeometry.js"></script>
-        <script src="../assets/three-with-martins.js"></script>
+        <script src="../assets/three-with-encantar.js"></script>
         <script src="demo.js"></script>
     </head>
     <body>

docs/api/martins.md

@@ -1,6 +1,6 @@
 # Martins
 
-The `Martins` namespace is the entry point of the features and components of MARTINS.js.
+The `Martins` namespace is the entry point of the features and components of encantAR.js.
 
 I have documented the instantiation of the components of the engine in their respective pages.
 
@@ -16,7 +16,7 @@ The [settings](settings.md) of the engine.
 
 `Martins.version: string, read-only`
 
-The version of MARTINS.js.
+The version of encantAR.js.
 
 ## Methods
 

docs/api/speedy-matrix.md

@@ -1,6 +1,6 @@
 # SpeedyMatrix
 
-[Speedy](speedy.md) includes its own fast implementation of matrices. They are used extensively in MARTINS.js.
+[Speedy](speedy.md) includes its own fast implementation of matrices. They are used extensively in encantAR.js.
 
 ## Properties
 

docs/api/speedy.md

@@ -1,8 +1,8 @@
 # Speedy
 
-MARTINS.js is built using [Speedy Vision](https://github.com/alemart/speedy-vision){ ._blank }, a GPU-accelerated Computer Vision library which is another project of mine.
+encantAR.js is built using [Speedy Vision](https://github.com/alemart/speedy-vision){ ._blank }, a GPU-accelerated Computer Vision library which is another project of mine.
 
-Many features provided by Speedy Vision are very useful (e.g., matrices). I have decided to include some of them in parts of the MARTINS.js API for convenience.
+Many features provided by Speedy Vision are very useful (e.g., matrices). I have decided to include some of them in parts of the encantAR.js API for convenience.
 
 In this documentation, I provide a quick reference of some of the classes used in Speedy Vision. This reference is minimal. For a more complete reference, please visit the [website of the project](https://github.com/alemart/speedy-vision){ ._blank }.
 

docs/demos.md

@@ -14,25 +14,25 @@ Please read the [guidelines](#guidelines) before you play with the demos. Feel f
 
 Create an augmented scene with [A-Frame](https://aframe.io){ ._blank }. This is the easiest demo to edit!
 
-[Launch demo](/martins-js/demos/hello-aframe/README.html){ ._blank .md-button }
+[Launch demo](/encantar-js/demos/hello-aframe/README.html){ ._blank .md-button }
 
 ### WebAR with three.js
 
 Create an augmented scene with [three.js](https://threejs.org){ ._blank }.
 
-[Launch demo](/martins-js/demos/hello-three/README.html){ ._blank .md-button }
+[Launch demo](/encantar-js/demos/hello-three/README.html){ ._blank .md-button }
 
 ### WebAR with WebGL only
 
 Create an augmented scene without additional libraries.
 
-[Launch demo](/martins-js/demos/hello-webgl/README.html){ ._blank .md-button }
+[Launch demo](/encantar-js/demos/hello-webgl/README.html){ ._blank .md-button }
 
 ### Hello, world!
 
 A basic template to help you get started.
 
-[Launch demo](/martins-js/demos/hello-world/README.html){ ._blank .md-button }
+[Launch demo](/encantar-js/demos/hello-world/README.html){ ._blank .md-button }
 
 ## Interactive demos
 
@@ -40,7 +40,7 @@ A basic template to help you get started.
 
 Have virtual elements respond to touch input.
 
-[Launch demo](/martins-js/demos/touch-three/README.html){ ._blank .md-button }
+[Launch demo](/encantar-js/demos/touch-three/README.html){ ._blank .md-button }
 
 ## Guidelines
 
@@ -60,8 +60,8 @@ Try the demos on your own machine:
 * Run on a console:
 
 ```sh
-git clone git@github.com:alemart/martins-js.git
-cd martins-js
+git clone git@github.com:alemart/encantar-js.git
+cd encantar-js
 npm start
 ```
 

docs/faq.md

@@ -1,10 +1,8 @@
 # Questions & Answers
 
-## What is MARTINS.js?
+## What is encantAR.js?
 
-MARTINS.js is a GPU-accelerated Augmented Reality engine for the web. It's a standalone WebAR technology for creating AR experiences that run in web browsers. Users don't need specialized hardware nor dedicated software - only a modern web browser.
-
-MARTINS is a recursive acronym for MARTINS Augmented Reality Technology for Internet Software. It also happens to be my name. See, AR is part of my name. Can you believe it? :sunglasses:
+encantAR.js is a standalone GPU-accelerated Augmented Reality engine for the web. The name derives from the Portuguese and Spanish word _encantar_, which means: to enchant, to delight, to love, to fascinate, to put a magical spell.
 
 ## What is WebAR?
 
@@ -12,11 +10,11 @@ Refer to the [concepts](./getting-started/concepts.md).
 
 ## Is this WebXR?
 
-No, MARTINS.js is not WebXR. The WebXR API allows you to access functionalities of VR and AR-capable devices in web browsers. It relies on other technologies, such as Google's ARCore or Apple's ARKit, to run the show. Those technologies are great, but they are supported on specific devices, which may or may not match your users' devices. On the other hand, MARTINS.js is fully standalone and is built from scratch using standard web technologies such as WebGL2 and WebAssembly, which are widely available. My intention is to give it broad compatibility.
+No, encantAR.js is not WebXR. The WebXR API allows you to access functionalities of VR and AR-capable devices in web browsers. It relies on other technologies, such as Google's ARCore or Apple's ARKit, to run the show. Those technologies are great, but they are supported on specific devices, which may or may not match your users' devices. On the other hand, encantAR.js is fully standalone and is built from scratch using standard web technologies such as WebGL2 and WebAssembly, which are widely available. My intention is to give it broad compatibility.
 
 ## Why do my models appear "laid down" in AR?
 
-MARTINS.js uses a right-handed coordinate system with the Z-axis pointing "up". The same convention is used in [Blender](https://www.blender.org){ ._blank }. When exporting your own models, make sure that the Z-axis points "up" and that the ground plane is the XY-plane. If your models appear "laid down" in AR, this is probably the issue.
+encantAR.js uses a right-handed coordinate system with the Z-axis pointing "up". The same convention is used in [Blender](https://www.blender.org){ ._blank }. When exporting your own models, make sure that the Z-axis points "up" and that the ground plane is the XY-plane. If your models appear "laid down" in AR, this is probably the issue.
 
 !!! info "Fix with code"
 
@@ -26,6 +24,6 @@ MARTINS.js uses a right-handed coordinate system with the Z-axis pointing "up".
 
 [Get in touch!](https://github.com/alemart)
 
-## I love WebAR!
+## I am enchanted!
 
 I know! :wink:

docs/getting-started/activate-your-webcam.md

@@ -4,7 +4,7 @@ In this section we're going to learn how to use your webcam to capture the video
 
 ## Change the source of data
 
-Instead of using a video file, we're going to use your webcam. We simply need to change the source of data and instruct MARTINS.js to use your webcam. We'll do it with 1 new line of code!
+Instead of using a video file, we're going to use your webcam. We simply need to change the source of data and instruct encantAR.js to use your webcam. We'll do it with 1 new line of code!
 
 ```js title="ar-demo.js" hl_lines="20-22"
 async function startARSession()
@@ -51,8 +51,8 @@ Let's also comment (or remove) the `<video>` tag from the HTML file - we no long
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR demo</title>
-        <script src="martins.js"></script>
+        <title>encantAR.js WebAR demo</title>
+        <script src="encantar.js"></script>
         <script src="ar-demo.js"></script>
         <style>body { background-color: #3d5afe; }</style>
     </head>
@@ -81,7 +81,7 @@ Open <http://localhost:8000>{ ._blank } and... ta-da! The web browser will ask f
 
 !!! tip "Check your physical scene"
 
-    Good lighting conditions are important for a good user experience. Even though the MARTINS.js can handle various lighting conditions, you should get your physical scene appropriately illuminated.
+    Good lighting conditions are important for a good user experience. Even though the encantAR.js can handle various lighting conditions, you should get your physical scene appropriately illuminated.
 
     When developing your own WebAR experiences, ask yourself:
     
@@ -125,9 +125,9 @@ In order to display that scan gimmick, we need to create a HUD (<em>Heads-Up Dis
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR demo</title>
+        <title>encantAR.js WebAR demo</title>
         <!-- <script> tags of the rendering engine of your choice -->
-        <script src="martins.js"></script>
+        <script src="encantar.js"></script>
         <script src="ar-demo.js"></script>
         <style>
         body { background-color: #3d5afe; }

docs/getting-started/concepts.md

@@ -16,9 +16,9 @@ Let me clarify what I mean by terms such as Augmented Reality and WebAR:
 
 4. A **WebAR experience** is an Augmented Reality experience developed using WebAR technology.
 
-5. **MARTINS.js** is a WebAR technology. I also call it a WebAR engine. Lots of computations have to be performed behind the scenes in order to make an Augmented Reality experience possible. MARTINS.js uses the GPU[^2] to accelerate many of those computations. In fact, the GPU and the CPU[^3] are used together. This approach improves the performance of the WebAR experience and ultimately leads to a better user experience.
+5. **encantAR.js** is a WebAR technology. I also call it a WebAR engine. Lots of computations have to be performed behind the scenes in order to make an Augmented Reality experience possible. encantAR.js uses the GPU[^2] to accelerate many of those computations. In fact, the GPU and the CPU[^3] are used together. This approach improves the performance of the WebAR experience and ultimately leads to a better user experience.
 
-Now that those terms are clarified, I say this: you can use MARTINS.js to create amazing WebAR experiences! :wink:
+Now that those terms are clarified, I say this: you can use encantAR.js to create amazing WebAR experiences! :wink:
 
 [^1]: This definition of AR experience is convenient in different ways. For example, it makes the term "WebAR experience", which is arguably better than "WebAR app" (no apps are downloaded), well-defined. I make a distinction between AR experience and experience of AR. An experience of AR is an event in consciousness in which AR is experienced. I sometimes use the latter definition.
 [^2]: Graphics Processing Unit
@@ -26,7 +26,7 @@ Now that those terms are clarified, I say this: you can use MARTINS.js to create
 
 ## Practical concepts
 
-Let me explain some concepts that you'll see over and over again when developing WebAR experiences with MARTINS.js:
+Let me explain some concepts that you'll see over and over again when developing WebAR experiences with encantAR.js:
 
 1. The experience of Augmented Reality is created by augmenting the physical scene with the virtual scene.
 

docs/getting-started/create-the-augmented-scene.md

@@ -4,9 +4,9 @@ Now that the image is being tracked, the next step is to render a virtual scene
 
 ## Pick a 3D rendering technology
 
-MARTINS.js is not a 3D rendering technology. It is an Augmented Reality technology that provides the data you need in order to augment your physical scenes. There are free and open-source 3D rendering technologies for the web that you can find online and use with MARTINS.js. Popular solutions include: A-Frame, Babylon.js and Three.js. You can also use other solutions. MARTINS.js lets you pick any 3D rendering technology.
+encantAR.js is not a 3D rendering technology. It is an Augmented Reality technology that provides the data you need in order to augment your physical scenes. There are free and open-source 3D rendering technologies for the web that you can find online and use with encantAR.js. Popular solutions include: A-Frame, Babylon.js and Three.js. You can also use other solutions. encantAR.js lets you pick any 3D rendering technology.
 
-Once you pick a 3D rendering technology, you need to integrate it with MARTINS.js. There is a code that is responsible for that integration. I call it a _glue code_. Among other things, a glue code transports the tracking results from MARTINS.js to the 3D rendering technology of your choice - it really is a "glue" connecting them.
+Once you pick a 3D rendering technology, you need to integrate it with encantAR.js. There is a code that is responsible for that integration. I call it a _glue code_. Among other things, a glue code transports the tracking results from encantAR.js to the 3D rendering technology of your choice - it really is a "glue" connecting them.
 
 ## Write the glue code
 
@@ -32,7 +32,7 @@ Let me tell you a bit more about the 3D rendering technologies I just mentioned.
 
 ### A-Frame
 
-[A-Frame](https://aframe.io){ ._blank } is an open-source framework used to build virtual reality (VR) experiences for the web. When you combine it with MARTINS.js, you become able to use it to create AR experiences too - without the need of special hardware or software.
+[A-Frame](https://aframe.io){ ._blank } is an open-source framework used to build virtual reality (VR) experiences for the web. When you combine it with encantAR.js, you become able to use it to create AR experiences too - without the need of special hardware or software.
 
 A-Frame is built on top of [Three.js](#threejs) and extends it in powerful ways. It introduces a HTML-based declarative approach for [scene graphs](https://en.wikipedia.org/wiki/Scene_graph){ ._blank }, empowering them with the [Entity-Component-System](https://en.wikipedia.org/wiki/Entity_component_system){ ._blank }, a software pattern commonly used in game development. Sounds complicated? It is not!
 
@@ -44,13 +44,13 @@ A-Frame is easy for beginners and pleasing for experts. A simple scene is declar
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR demo</title>
+        <title>encantAR.js WebAR demo</title>
         <!-- include A-Frame -->
         <script src="aframe-vX.Y.Z.min.js"></script>
-        <script src="martins.js"></script>
+        <script src="encantar.js"></script>
         <script src="ar-demo.js"></script>
         <!-- this is my glue code for A-Frame -->
-        <script src="aframe-with-martins.js"></script>
+        <script src="aframe-with-encantar.js"></script>
         <style>body { background-color: #3d5afe; }</style>
     </head>
     <body>

docs/getting-started/index.md

@@ -1,8 +1,8 @@
-# Welcome to MARTINS.js!
+# Welcome to encantAR.js!
 
-[![GitHub release (latest by date)](https://img.shields.io/github/v/release/alemart/martins-js)](https://github.com/alemart/martins-js/releases/) ![GitHub file size in bytes on a specified ref (branch/commit/tag)](https://img.shields.io/github/size/alemart/martins-js/dist/martins.min.js?branch=master&label=minified%20js) [![GitHub Repo stars](https://img.shields.io/github/stars/alemart/martins-js?logo=github)](https://github.com/alemart/martins-js/stargazers) [![GitHub Sponsors](https://img.shields.io/github/sponsors/alemart?logo=github)](https://github.com/sponsors/alemart/)
+[![GitHub release (latest by date)](https://img.shields.io/github/v/release/alemart/encantar-js)](https://github.com/alemart/encantar-js/releases/) ![GitHub file size in bytes on a specified ref (branch/commit/tag)](https://img.shields.io/github/size/alemart/encantar-js/dist/encantar.min.js?branch=master&label=minified%20js) [![GitHub Repo stars](https://img.shields.io/github/stars/alemart/encantar-js?logo=github)](https://github.com/alemart/encantar-js/stargazers) [![GitHub Sponsors](https://img.shields.io/github/sponsors/alemart?logo=github)](https://github.com/sponsors/alemart/)
 
-Create amazing Augmented Reality experiences with **MARTINS.js**, a GPU-accelerated Augmented Reality engine for the web.
+Create amazing Augmented Reality experiences with **encantAR.js**, a GPU-accelerated Augmented Reality engine for the web.
 
 [Get started](./introduction.md){ .md-button .md-button--primary } [Try a demo](../demo.md){ .md-button .md-button } [:heart:{ .heart } Support my work](../support-my-work.md){ .md-button }
 
@@ -11,17 +11,17 @@ Create amazing Augmented Reality experiences with **MARTINS.js**, a GPU-accelera
 * **Runs everywhere**: on Android, on iOS, and even on Desktop computers. No need of AR-capable devices.
 * **Image tracking**. Use it to track detailed images such as: book covers, cartoons and photos.
 
-## Why use MARTINS.js?
+## Why use encantAR.js?
 
-* **No need to download apps!** MARTINS.js is a WebAR engine: it runs in web browsers. Users can access the AR experiences immediately.
-* **Easy to get started!** MARTINS.js can be used with a `<script>` tag in your page. A static HTML page is enough to get started.
-* **Fast and powerful!** MARTINS.js is GPU-accelerated. It uses WebGL2 and WebAssembly for turbocharged performance.
-* **Fully standalone!** MARTINS.js is built from scratch using standard web technologies. No need for additional hardware or software!
+* **No need to download apps!** encantAR.js is a WebAR engine: it runs in web browsers. Users can access the AR experiences immediately.
+* **Easy to get started!** encantAR.js can be used with a `<script>` tag in your page. A static HTML page is enough to get started.
+* **Fast and powerful!** encantAR.js is GPU-accelerated. It uses WebGL2 and WebAssembly for turbocharged performance.
+* **Fully standalone!** encantAR.js is built from scratch using standard web technologies. No need for additional hardware or software!
 * **Free and open-source!** Get started right away!
 
 ## Browser compatibility
 
-MARTINS.js is compatible with all major web browsers:
+encantAR.js is compatible with all major web browsers:
 
 | Chrome | Edge | Firefox | Opera | Safari* |
 |:------:|:----:|:-------:|:-----:|:-------:|
@@ -29,8 +29,8 @@ MARTINS.js is compatible with all major web browsers:
 
 \* use Safari 15.2 or later.
 
-MARTINS.js requires WebGL2 and WebAssembly.
+encantAR.js requires WebGL2 and WebAssembly.
 
 ## About
 
-MARTINS.js is developed by [Alexandre Martins](https://github.com/alemart) and released under the [LGPL](../license.md). It is based on [Speedy Vision](https://github.com/alemart/speedy-vision).
+encantAR.js is developed by [Alexandre Martins](https://github.com/alemart) and released under the [LGPL](../license.md). It is based on [Speedy Vision](https://github.com/alemart/speedy-vision).

docs/getting-started/next-steps.md

@@ -1,6 +1,6 @@
 # Next steps
 
-Congratulations! You have created your first WebAR experience with MARTINS.js! :sunglasses:
+Congratulations! You have created your first WebAR experience with encantAR.js! :sunglasses:
 
 Let me tell you some of the steps you can take from now on.
 
@@ -84,12 +84,12 @@ So far we've just created a static HTML page. The next step is to make your page
 
 !!! tip "Use the minified code"
 
-    When deploying your WebAR experiences, make sure to include the minified `martins.min.js` file instead of the regular `martins.js`. The latter is suitable for development. The former, for production.
+    When deploying your WebAR experiences, make sure to include the minified `encantar.min.js` file instead of the regular `encantar.js`. The latter is suitable for development. The former, for production.
 
 ## Support my work
 
 If you came this far in the guide, WebAR probably excites you. It is definitely something you want. I know, it is awesome! The possibilities are endless. Even better than getting your creative juices boiling with enthusiasm is the feeling of joy I have for sharing this work with you.
 
-I develop MARTINS.js independently. Creating this WebAR engine required a lot of time, effort, skill and specialized knowledge. Please support my work today, so that I can make it even more awesome!
+I develop encantAR.js independently. Creating this WebAR engine required a lot of time, effort, skill and specialized knowledge. Please support my work today, so that I can make it even more awesome!
 
 [:heart:{ .heart } Support my work](../support-my-work.md){ .md-button }

docs/getting-started/set-up-a-web-server.md

@@ -7,14 +7,14 @@ Let's prepare our local environment in order to create our first WebAR experienc
 Let's create a file structure for our AR experience:
 
 1. Create a new folder called `ar-demo` in your filesystem
-2. Download the [latest release of MARTINS.js](../download.md){ ._blank } and extract `dist/martins.js` to `ar-demo/`
+2. Download the [latest release of encantAR.js](../download.md){ ._blank } and extract `dist/encantar.js` to `ar-demo/`
 3. Create a new empty file called `index.html` and store it in `ar-demo/`
 
 You will have the following file structure:
 
     ar-demo/
     ├── index.html
-    └── martins.js
+    └── encantar.js
 
 ## Add boilerplate code
 
@@ -26,8 +26,8 @@ Use the code editor of your choice to write the following content to `index.html
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR demo</title>
-        <script src="martins.js"></script>
+        <title>encantAR.js WebAR demo</title>
+        <script src="encantar.js"></script>
         <style>body { background-color: #3d5afe; }</style>
     </head>
     <body>

docs/getting-started/set-up-the-session.md

@@ -12,8 +12,8 @@ We begin by creating the viewport. Remember that the viewport is the area in whi
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR demo</title>
-        <script src="martins.js"></script>
+        <title>encantAR.js WebAR demo</title>
+        <script src="encantar.js"></script>
         <script src="ar-demo.js"></script>
         <style>body { background-color: #3d5afe; }</style>
     </head>

docs/getting-started/set-up-the-tracker.md

@@ -23,8 +23,8 @@ Next, let's add the reference image to our web page. Add an `<img>` tag to the `
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR demo</title>
-        <script src="martins.js"></script>
+        <title>encantAR.js WebAR demo</title>
+        <script src="encantar.js"></script>
         <style>body { background-color: #3d5afe; }</style>
     </head>
     <body>
@@ -50,8 +50,8 @@ Once you see that the image is being properly loaded, there is no need to keep i
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR demo</title>
-        <script src="martins.js"></script>
+        <title>encantAR.js WebAR demo</title>
+        <script src="encantar.js"></script>
         <style>body { background-color: #3d5afe; }</style>
     </head>
     <body>
@@ -75,7 +75,7 @@ This is the expected directory structure at this point:
 
     ar-demo/
     ├── index.html
-    ├── martins.js
+    ├── encantar.js
     ├── my-reference-image.webp
     ├── my-video.mp4
     └── my-video.webm
@@ -88,8 +88,8 @@ Let's include the test video in our page. Add a `<video>` tag as follows:
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR demo</title>
-        <script src="martins.js"></script>
+        <title>encantAR.js WebAR demo</title>
+        <script src="encantar.js"></script>
         <style>body { background-color: #3d5afe; }</style>
     </head>
     <body>
@@ -108,7 +108,7 @@ In order to track the reference image in our video, we need an Image Tracker. Re
 
 Before we track anything with an Image Tracker, we must tell it what to track. There are two steps to this: first, we instantiate an Image Tracker. Next, we link our reference image to it.
 
-We'll be writing a little bit of JavaScript code now. In order to keep our code clean, we'll be writing the JavaScript code to a new file. Let's add a `<script>` tag below `martins.js` as follows:
+We'll be writing a little bit of JavaScript code now. In order to keep our code clean, we'll be writing the JavaScript code to a new file. Let's add a `<script>` tag below `encantar.js` as follows:
 
 ```html title="index.html" hl_lines="8"
 <!doctype html>
@@ -116,8 +116,8 @@ We'll be writing a little bit of JavaScript code now. In order to keep our code
     <head>
         <meta charset="utf-8">
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        <title>MARTINS.js WebAR demo</title>
-        <script src="martins.js"></script>
+        <title>encantAR.js WebAR demo</title>
+        <script src="encantar.js"></script>
         <script src="ar-demo.js"></script>
         <style>body { background-color: #3d5afe; }</style>
     </head>
@@ -154,14 +154,14 @@ window.onload = async function()
 
 The `Martins` namespace holds the various elements featured by the engine. We'll be using it extensively.
 
-MARTINS.js only requires standard web technologies that have been around for a while. Still, it's a good practice to check if those technologies are supported by the target system. If they are not, we display a message and quit. If they are, we instantiate an Image Tracker.
+encantAR.js only requires standard web technologies that have been around for a while. Still, it's a good practice to check if those technologies are supported by the target system. If they are not, we display a message and quit. If they are, we instantiate an Image Tracker.
 
 Before moving on, make sure that you have the following directory structure at this point:
 
     ar-demo/
     ├── ar-demo.js
     ├── index.html
-    ├── martins.js
+    ├── encantar.js
     ├── my-reference-image.webp
     ├── my-video.mp4
     └── my-video.webm

docs_overrides/demo.html

@@ -3,7 +3,7 @@
     <head>
         <meta charset="utf-8">
         <meta http-equiv="refresh" content="0; url='{{ 'demos/hello-webgl/README.html' | url }}'">
-        <title>MARTINS.js WebAR demo</title>
+        <title>encantAR.js WebAR demo</title>
     </head>
     <body>
         <p>Redirecting to <a href="{{ 'demos/hello-webgl/README.html' | url }}">{{ 'demos/hello-webgl/README.html' | url }}</a>...</p>

docs_overrides/download.html

@@ -2,10 +2,10 @@
 <html>
     <head>
         <meta charset="utf-8">
-        <meta http-equiv="refresh" content="0; url='https://github.com/alemart/martins-js/releases'">
-        <title>Download MARTINS.js</title>
+        <meta http-equiv="refresh" content="0; url='https://github.com/alemart/encantar-js/releases'">
+        <title>Download encantAR.js</title>
     </head>
     <body>
-        <p>Redirecting to <a href="https://github.com/alemart/martins-js/releases">https://github.com/alemart/martins-js/releases</a>...</p>
+        <p>Redirecting to <a href="https://github.com/alemart/encantar-js/releases">https://github.com/alemart/encantar-js/releases</a>...</p>
     </body>
 </html>

docs_overrides/main.html

@@ -12,7 +12,7 @@
 
 {% block libs %}
 {{ super() }}
-<script data-goatcounter="https://martins-js.goatcounter.com/count" async src="//gc.zgo.at/count.js"></script>
+<script data-goatcounter="https://encantar-js.goatcounter.com/count" async src="//gc.zgo.at/count.js"></script>
 {% endblock %}
 
 {% block _announce %}

docs_overrides/partials/share.html

@@ -9,7 +9,7 @@
 </a>
 
 <!-- Sharingbutton Twitter -->
-<a class="resp-sharing-button__link" href="https://twitter.com/intent/tweet/?text=%23MARTINSjs%20%23WebAR&amp;url={{ page.canonical_url | urlencode }}" target="_blank" rel="noopener" aria-label="">
+<a class="resp-sharing-button__link" href="https://twitter.com/intent/tweet/?text=%23encantar-js%20%23webar%20%23augmented-reality&amp;url={{ page.canonical_url | urlencode }}" target="_blank" rel="noopener" aria-label="">
   <div class="resp-sharing-button resp-sharing-button--twitter resp-sharing-button--small"><div aria-hidden="true" class="resp-sharing-button__icon resp-sharing-button__icon--solid">
     <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M23.44 4.83c-.8.37-1.5.38-2.22.02.93-.56.98-.96 1.32-2.02-.88.52-1.86.9-2.9 1.1-.82-.88-2-1.43-3.3-1.43-2.5 0-4.55 2.04-4.55 4.54 0 .36.03.7.1 1.04-3.77-.2-7.12-2-9.36-4.75-.4.67-.6 1.45-.6 2.3 0 1.56.8 2.95 2 3.77-.74-.03-1.44-.23-2.05-.57v.06c0 2.2 1.56 4.03 3.64 4.44-.67.2-1.37.2-2.06.08.58 1.8 2.26 3.12 4.25 3.16C5.78 18.1 3.37 18.74 1 18.46c2 1.3 4.4 2.04 6.97 2.04 8.35 0 12.92-6.92 12.92-12.93 0-.2 0-.4-.02-.6.9-.63 1.96-1.22 2.56-2.14z"/></svg>
     </div>

docs_overrides/support-my-work.html

@@ -3,7 +3,7 @@
     <head>
         <meta charset="utf-8">
         <meta http-equiv="refresh" content="0; url='https://github.com/sponsors/alemart'">
-        <title>MARTINS.js - Support my work</title>
+        <title>encantAR.js - Support my work</title>
     </head>
     <body>
         <p>Redirecting to <a href="https://github.com/sponsors/alemart">GitHub Sponsors</a>...</p>

mkdocs.yml

@@ -1,17 +1,16 @@
-site_name: "MARTINS.js: GPU-accelerated Augmented Reality for the web"
-site_url: https://alemart.github.io/martins-js
+site_name: "encantAR.js: GPU-accelerated Augmented Reality for the web"
+site_url: https://alemart.github.io/encantar-js
 site_author: Alexandre Martins
 site_description: Open source WebAR engine. Runs everywhere. Easy to get started.
 copyright: Copyright © 2022 - present Alexandre Martins
 
-repo_name: alemart/martins-js
-repo_url: https://github.com/alemart/martins-js
+repo_name: alemart/encantar-js
+repo_url: https://github.com/alemart/encantar-js
 
 theme:
   name: material
   custom_dir: docs_overrides
   features: [ 'navigation.tabs', 'navigation.tabs.sticky' ]
-  logo: img/martins-icon.png
 
 extra_css: [ 'style/extra.css' ]
 extra_javascript: [ 'js/extra.js' ]

package-lock.json

@@ -1,11 +1,11 @@
 {
-  "name": "martins-js",
+  "name": "encantar-js",
   "version": "0.2.1-wip",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
-      "name": "martins-js",
+      "name": "encantar-js",
       "version": "0.2.1-wip",
       "license": "LGPL-3.0-or-later",
       "dependencies": {

package.json

@@ -1,11 +1,11 @@
 {
-  "name": "martins-js",
+  "name": "encantar-js",
   "version": "0.2.1-wip",
   "description": "GPU-accelerated Augmented Reality for the web",
   "author": "Alexandre Martins <alemartf@gmail.com> (https://github.com/alemart)",
-  "homepage": "https://github.com/alemart/martins-js",
+  "homepage": "https://github.com/alemart/encantar-js",
   "license": "LGPL-3.0-or-later",
-  "repository": "github:alemart/martins-js",
+  "repository": "github:alemart/encantar-js",
   "funding": "https://github.com/sponsors/alemart",
   "keywords": [
     "augmented reality",
@@ -21,12 +21,12 @@
     "webgl2",
     "wasm"
   ],
-  "main": "dist/martins.js",
+  "main": "dist/encantar.js",
   "scripts": {
     "start": "webpack serve --mode development --env PORT=8000 --env minimize=1",
     "build-dev": "npm run update && npm run clean && webpack --mode development",
     "build": "npm run update && npm run clean && webpack --mode production && webpack --mode production --env minimize=1",
-    "clean": "rm -rf dist/martins*.js",
+    "clean": "rm -rf dist/encantar*.js",
     "update": "npm update speedy-vision",
     "deploy": "mkdocs gh-deploy",
     "test": "echo \"Error: no test specified\" && exit 1"

src/core/frame.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/core/gizmos.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/core/hud.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/core/session.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *
@@ -287,7 +287,7 @@ export class Session extends AREventTarget<SessionEventType>
 
             // is the engine supported?
             if(!Session.isSupported())
-                throw new NotSupportedError('You need a browser/device compatible with WebGL2 and WebAssembly in order to experience Augmented Reality with the MARTINS.js engine');
+                throw new NotSupportedError('You need a browser/device compatible with WebGL2 and WebAssembly in order to experience Augmented Reality with encantar.js');
 
             // block multiple immersive sessions
             if(mode !== 'inline' && Session.count > 0)

src/core/settings.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/core/stats-panel.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *
@@ -195,7 +195,7 @@ export class StatsPanel
         container.style.fontSize = '14px';
 
         // all sanitized
-        container.innerText = 'MARTINS.js ' + Martins.version;
+        container.innerText = 'encantAR.js ' + Martins.version;
 
         print('<br>');
         print('FPS: <span class="_ar_fps"></span> | ');

src/core/stats.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/core/time.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/core/viewport.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/geometry/camera-model.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/geometry/pose.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/geometry/transform.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/geometry/view.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/geometry/viewer-pose.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/geometry/viewer.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/main.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *
@@ -28,9 +28,9 @@ import { TrackerFactory } from './trackers/tracker-factory';
 import { SourceFactory } from './sources/source-factory';
 import { Viewport, ViewportSettings } from './core/viewport';
 import { Utils } from './utils/utils';
-declare const __MARTINS_VERSION__: string;
-declare const __MARTINS_DEVELOPMENT_MODE__: string;
-declare const __MARTINS_WEBSITE__: string;
+declare const __AR_VERSION__: string;
+declare const __AR_DEVELOPMENT_MODE__: string;
+declare const __AR_WEBSITE__: string;
 
 /**
  * GPU-accelerated Augmented Reality for the web
@@ -86,10 +86,10 @@ export default class Martins
      */
     static get version(): string
     {
-        if(__MARTINS_DEVELOPMENT_MODE__)
-            return __MARTINS_VERSION__ + '-dev';
+        if(__AR_DEVELOPMENT_MODE__)
+            return __AR_VERSION__ + '-dev';
         else
-            return __MARTINS_VERSION__;
+            return __AR_VERSION__;
     }
 
     /**
@@ -118,7 +118,7 @@ Object.freeze(Martins);
 
 // Display a notice
 Utils.log(
-    `MARTINS.js version ${Martins.version}. ` +
+    `encantAR.js version ${Martins.version}. ` +
     `GPU-accelerated Augmented Reality for the web by Alexandre Martins. ` +
-    __MARTINS_WEBSITE__
+    __AR_WEBSITE__
 );

src/sources/camera-source.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/sources/canvas-source.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/sources/source-factory.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/sources/source.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/sources/video-source.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/trackers/image-tracker/image-tracker-event.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/trackers/image-tracker/image-tracker.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/trackers/image-tracker/reference-image-database.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/trackers/image-tracker/reference-image.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/trackers/image-tracker/settings.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/trackers/image-tracker/states/initial.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/trackers/image-tracker/states/pre-tracking.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/trackers/image-tracker/states/scanning.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/trackers/image-tracker/states/state.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/trackers/image-tracker/states/tracking.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/trackers/image-tracker/states/training.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/trackers/tracker-factory.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/trackers/tracker.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/utils/ar-events.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/utils/asap.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/utils/errors.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/utils/resolution.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *

src/utils/utils.ts

@@ -1,5 +1,5 @@
 /*
- * MARTINS.js
+ * encantar.js
  * GPU-accelerated Augmented Reality for the web
  * Copyright (C) 2022-2024 Alexandre Martins <alemartf(at)gmail.com>
  *
@@ -42,7 +42,7 @@ export class Utils
      */
     static log(message: string, ...args: any[]): void
     {
-        console.log('[martins-js]', message, ...args);
+        console.log('[encantar-js]', message, ...args);
     }
 
     /**
@@ -52,7 +52,7 @@ export class Utils
      */
     static warning(message: string, ...args: any[]): void
     {
-        console.warn('[martins-js]', message, ...args);
+        console.warn('[encantar-js]', message, ...args);
     }
 
     /**
@@ -62,7 +62,7 @@ export class Utils
      */
     static error(message: string, ...args: any[]): void
     {
-        console.error('[martins-js]', message, ...args);
+        console.error('[encantar-js]', message, ...args);
     }
 
     /**

webpack.config.js

@@ -9,7 +9,7 @@ module.exports = (env, argv) => ({
     devtool: argv.mode == 'development' ? 'source-map' : undefined,
 
     output: {
-        filename: !env.minimize ? 'martins.js' : 'martins.min.js',
+        filename: !env.minimize ? 'encantar.js' : 'encantar.min.js',
         path: path.resolve(__dirname, 'dist'),
         publicPath: '/dist/',
         library: {
@@ -32,7 +32,7 @@ module.exports = (env, argv) => ({
     plugins: [
         new webpack.BannerPlugin({
             banner: ((({ author, version, year, homepage, description, date }) => ([
-                `MARTINS.js version ${version}`,
+                `encantAR.js version ${version}`,
                 `${description}`,
                 `Copyright ${year} ${author}`,
                 `${homepage}`,
@@ -42,14 +42,14 @@ module.exports = (env, argv) => ({
             ].join('\n')))({
                 ...pack,
                 'date': new Date().toISOString(),
-                'year': [ ...(new Set([2022, new Date().getFullYear()])) ].join('-'),
+                'year': [2022, new Date().getFullYear()].join('-'),
                 'author': pack.author.replace('@', '(at)'),
             }))
         }),
         new webpack.DefinePlugin({
-            '__MARTINS_VERSION__': JSON.stringify(pack.version),
-            '__MARTINS_DEVELOPMENT_MODE__': argv.mode == 'development',
-            '__MARTINS_WEBSITE__': JSON.stringify(pack.homepage),
+            '__AR_VERSION__': JSON.stringify(pack.version),
+            '__AR_DEVELOPMENT_MODE__': argv.mode == 'development',
+            '__AR_WEBSITE__': JSON.stringify(pack.homepage),
         }),
         new webpack.IgnorePlugin({
             resourceRegExp: /\.ignore\./i,