encantar-js/demos/hello-three/demo.js

/**
 * Augmented Reality demo using the three.js plugin for encantar.js
 * @author Alexandre Martins <alemartf(at)gmail.com> (https://github.com/alemart/encantar-js)
 */

import * as THREE from 'three';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
import { encantar, ARDemo } from 'three-with-encantar';

/**
 * Utilities for the Demo
 */
class Utils
{
    static async loadGLTF(filepath, yAxisIsUp = true)
    {
        const loader = new GLTFLoader();
        const gltf = await loader.loadAsync(filepath);

        // glTF defines +y as up. We expect +z to be up (when XY is the ground plane)
        if(yAxisIsUp)
            gltf.scene.rotateX(Math.PI / 2);

        return gltf;
    }

    static createAnimationAction(gltf, name = null, loop = THREE.LoopRepeat)
    {
        const mixer = new THREE.AnimationMixer(gltf.scene);
        const clips = gltf.animations;

        if(clips.length == 0)
            throw new Error('No animation clips');

        if(name === null) {
            const sortedNames = clips.map(clip => clip.name).sort();
            name = sortedNames[0];
        }

        const clip = THREE.AnimationClip.findByName(clips, name);
        const action = mixer.clipAction(clip);
        action.loop = loop;

        return action;
    }

    static createImagePlane(imagepath)
    {
        const texture = new THREE.TextureLoader().load(imagepath);
        const geometry = new THREE.PlaneGeometry(1, 1);
        const material = new THREE.MeshBasicMaterial({
            map: texture,
            side: THREE.DoubleSide,
        });
        const mesh = new THREE.Mesh(geometry, material);

        return mesh;
    }

    static switchToFrontView(ar)
    {
        // top view is the default
        ar.root.rotation.set(-Math.PI / 2, 0, 0);
    }

    static referenceImageName(ar)
    {
        if(ar.frame === null)
            return null;

        for(const result of ar.frame.results) {
            if(result.tracker.is('image-tracker')) {
                if(result.trackables.length > 0) {
                    const trackable = result.trackables[0];
                    return trackable.referenceImage.name;
                }
            }
        }

        return null;
    }
}

/**
 * Augmented Reality Demo
 */
class EnchantedDemo extends ARDemo
{
    /**
     * Constructor
     */
    constructor()
    {
        super();

        this._objects = { };
        this._initialized = false;
    }

    /**
     * Start the AR session
     * @returns {Promise<Session>}
     */
    async startSession()
    {
        if(!AR.isSupported()) {
            throw new Error(
                'This device is not compatible with this AR experience.\n\n' +
                'User agent: ' + navigator.userAgent
            );
        }

        const tracker = AR.Tracker.Image();
        await tracker.database.add([
        {
            name: 'mage',
            image: document.getElementById('mage')
        },
        {
            name: 'cat',
            image: document.getElementById('cat')
        }
        ]);

        const viewport = AR.Viewport({
            container: document.getElementById('ar-viewport'),
            hudContainer: document.getElementById('ar-hud')
        });

        const video = document.getElementById('my-video');
        const useWebcam = (video === null);
        const source = useWebcam ? AR.Source.Camera() : AR.Source.Video(video);

        const session = await AR.startSession({
            mode: 'immersive',
            viewport: viewport,
            trackers: [ tracker ],
            sources: [ source ],
            stats: true,
            gizmos: true,
        });

        const scan = document.getElementById('scan');
        if(scan)
            scan.style.pointerEvents = 'none';

        tracker.addEventListener('targetfound', event => {
            session.gizmos.visible = false;
            if(scan)
                scan.hidden = true;

            this._onTargetFound(event.referenceImage);
        });

        tracker.addEventListener('targetlost', event => {
            session.gizmos.visible = true;
            if(scan)
                scan.hidden = false;

            this._onTargetLost(event.referenceImage);
        });

        return session;
    }

    /**
     * Preload resources before starting the AR session
     * @returns {Promise<void>}
     */
    async preload()
    {
        // preload meshes
        const [ mage, cat ] = await Promise.all([
            Utils.loadGLTF('../assets/mage.glb'),
            Utils.loadGLTF('../assets/cat.glb')
        ]);

        // save references
        this._objects.gltf = { mage, cat };
    }

    /**
     * Initialization
     * @returns {void}
     */
    init()
    {
        const ar = this.ar;

        // Change the point of view. All virtual objects are descendants of
        // ar.root, a node that is automatically aligned to the physical scene.
        // Adjusting ar.root will adjust all virtual objects.
        Utils.switchToFrontView(ar);
        ar.root.position.set(0, -0.8, 0);

        // Initialize objects
        this._initLight();
        this._initText();
        this._initMagicCircle();
        this._initMage();
        this._initCat();

        // done!
        this._initialized = true;
    }

    /**
     * Animation loop
     * @returns {void}
     */
    update()
    {
        const ar = this.ar;
        const delta = ar.session.time.delta; // given in seconds

        // animate the objects of the scene
        this._animateMagicCircle(delta);
        this._animateMage(delta);
        this._animateCat(delta);
    }


    // ------------------------------------------------------------------------


    _initLight()
    {
        const ambientLight = new THREE.AmbientLight(0xffffff);
        ambientLight.intensity = 1.0 * Math.PI;

        const ar = this.ar;
        ar.scene.add(ambientLight);
    }

    _initMagicCircle()
    {
        // create a magic circle
        const magicCircle = Utils.createImagePlane('../assets/magic-circle.png');
        magicCircle.material.transparent = true;
        magicCircle.material.opacity = 1;
        magicCircle.scale.set(4, 4, 1);

        // make it a child of ar.root
        const ar = this.ar;
        ar.root.add(magicCircle);

        // save a reference
        this._objects.magicCircle = magicCircle;
    }

    _initText()
    {
        const text = Utils.createImagePlane('../assets/it-works.png');
        text.material.transparent = true;
        text.material.opacity = 1;
        text.position.set(0, -0.5, 2);
        text.scale.set(3, 1.5, 1);
        text.rotateX(Math.PI / 2);

        const ar = this.ar;
        ar.root.add(text);

        this._objects.text = text;
    }

    _initMage()
    {
        // load the mage
        const gltf = this._objects.gltf.mage;
        const mage = gltf.scene;
        mage.scale.set(0.7, 0.7, 0.7);

        // prepare the animation of the mage
        const mageAction = Utils.createAnimationAction(gltf, 'Idle');
        mageAction.play();

        // make the mage a child of ar.root
        const ar = this.ar;
        ar.root.add(mage);

        // save references
        this._objects.mage = mage;
        this._objects.mageAction = mageAction;
    }

    _initCat()
    {
        const gltf = this._objects.gltf.cat;
        const cat = gltf.scene;
        cat.scale.set(0.7, 0.7, 0.7);

        const catAction = Utils.createAnimationAction(gltf, 'Cheer');
        catAction.play();

        const ar = this.ar;
        ar.root.add(cat);

        this._objects.cat = cat;
        this._objects.catAction = catAction;
    }

    _animate(action, delta)
    {
        const mixer = action.getMixer();
        mixer.update(delta);
    }

    _animateMage(delta)
    {
        this._animate(this._objects.mageAction, delta);
    }

    _animateCat(delta)
    {
        this._animate(this._objects.catAction, delta);
    }

    _animateMagicCircle(delta)
    {
        const TWO_PI = 2.0 * Math.PI;
        const ROTATIONS_PER_SECOND = 1.0 / 8.0;

        this._objects.magicCircle.rotateZ(-TWO_PI * ROTATIONS_PER_SECOND * delta);
    }

    _onTargetFound(referenceImage)
    {
        // make sure that the scene is initialized
        if(!this._initialized) {
            alert(`Target \"${referenceImage.name}\" was found, but the 3D scene is not yet initialized!`);
            return;
        }

        // change the scene based on the tracked image
        switch(referenceImage.name) {
            case 'mage':
                this._objects.mage.visible = true;
                this._objects.cat.visible = false;
                this._objects.text.visible = false;
                this._objects.magicCircle.material.color.set(0xbeefff);
                break;

            case 'cat':
                this._objects.mage.visible = false;
                this._objects.cat.visible = true;
                this._objects.text.visible = true;
                this._objects.magicCircle.material.color.set(0xffffaa);
                break;
        }
    }

    _onTargetLost(referenceImage)
    {
    }
}

/**
 * Start the Demo
 * @returns {void}
 */
function main()
{
    const demo = new EnchantedDemo();

    encantar(demo).catch(error => {
        alert(error.message);
    });
}

if(document.readyState == 'loading')
    document.addEventListener('DOMContentLoaded', main);
else
    main(); // es-module-shims