@woosh/meep-engine 2.46.29 → 2.46.30

package/editor/tools/v2/TransformControls.js

@@ -0,0 +1,1782 @@
+import {
+    BoxGeometry,
+    BufferGeometry,
+    CylinderGeometry,
+    DoubleSide,
+    Euler,
+    Float32BufferAttribute,
+    LineBasicMaterial,
+    Matrix4,
+    MeshBasicMaterial,
+    OctahedronGeometry,
+    PlaneGeometry,
+    Quaternion,
+    Raycaster,
+    SphereGeometry,
+    TorusGeometry,
+    Vector3
+} from 'three';
+import { ShadedGeometry } from "../../../src/engine/graphics/ecs/mesh-v2/ShadedGeometry.js";
+import { DrawMode } from "../../../src/engine/graphics/ecs/mesh-v2/DrawMode.js";
+import { EntityNode } from "../../../src/engine/ecs/parent/EntityNode.js";
+import { Transform } from "../../../src/engine/ecs/transform/Transform.js";
+import { ShadedGeometryFlags } from "../../../src/engine/graphics/ecs/mesh-v2/ShadedGeometryFlags.js";
+import { SurfacePoint3 } from "../../../src/core/geom/3d/SurfacePoint3.js";
+import { FrameRunner } from "../../../src/engine/graphics/FrameRunner.js";
+import { assert } from "../../../src/core/assert.js";
+
+const _raycaster = new Raycaster();
+
+const _tempVector = new Vector3();
+const _tempVector2 = new Vector3();
+const _tempQuaternion = new Quaternion();
+const _unit = {
+    X: new Vector3(1, 0, 0),
+    Y: new Vector3(0, 1, 0),
+    Z: new Vector3(0, 0, 1)
+};
+
+const _changeEvent = { type: 'change' };
+const _mouseDownEvent = { type: 'mouseDown' };
+const _mouseUpEvent = { type: 'mouseUp', mode: null };
+const _objectChangeEvent = { type: 'objectChange' };
+
+/**
+ * @readonly
+ * @type {Transform}
+ */
+const _tempTransform = new Transform();
+
+class GizmoNode extends EntityNode {
+    constructor() {
+        super();
+
+        /**
+         *
+         * @type {boolean}
+         * @private
+         */
+        this._visible = true;
+        /**
+         *
+         * @type {EntityComponentDataset|null}
+         * @private
+         */
+        this.__ecd = null;
+
+        this.entity.add(new Transform());
+    }
+
+    build(ecd) {
+        this.__ecd = ecd;
+
+        if (this._visible) {
+            super.build(ecd);
+        }
+    }
+
+    set visible(v) {
+        if (this._visible === v) {
+            return;
+        }
+
+        this._visible = v;
+
+        if (this.__ecd !== null) {
+
+            if (v) {
+                super.build(this.__ecd);
+            } else {
+                this.destroy();
+            }
+
+        }
+    }
+
+    get visible() {
+        return this._visible;
+    }
+
+    update() {
+        // do nothing
+        const children = this.children;
+        const n = children.length;
+        for (let i = 0; i < n; i++) {
+            const child = children[i];
+            if (!(child instanceof GizmoNode)) {
+                continue;
+            }
+
+            if (!child.isBuilt) {
+                continue;
+            }
+
+            child.update();
+        }
+    }
+}
+
+class TransformControls extends GizmoNode {
+
+    /**
+     *
+     * @param {THREE.Camera} camera
+     * @param {HTMLElement} domElement
+     * @param {boolean} [autoUpdate] Will attempt to update automatically, unnecessary computation can be avoided by manually invoking "update" function each frame instead
+     */
+    constructor(camera, domElement, autoUpdate = true) {
+
+        super();
+
+        if (domElement === undefined) {
+
+            console.warn('THREE.TransformControls: The second parameter "domElement" is now mandatory.');
+            domElement = document;
+
+        }
+
+        this.isTransformControls = true;
+        this.visible = false;
+
+        this.domElement = domElement;
+
+        try {
+            this.domElement.style.touchAction = 'none'; // disable touch scroll
+        } catch (e) {
+            //
+            console.error("Failed to disable touch scroll on domElement:", e);
+        }
+
+        const _gizmo = new TransformControlsGizmo();
+        this._gizmo = _gizmo;
+        this.addChild(_gizmo);
+
+        const _plane = new TransformControlsPlane();
+        this._plane = _plane;
+        this.addChild(_plane);
+
+        const scope = this;
+
+        // Defined getter, setter and store for a property
+        function defineProperty(propName, defaultValue) {
+
+            let propValue = defaultValue;
+
+            Object.defineProperty(scope, propName, {
+
+                get: function () {
+
+                    return propValue !== undefined ? propValue : defaultValue;
+
+                },
+
+                set: function (value) {
+
+                    if (propValue !== value) {
+
+                        propValue = value;
+                        _plane[propName] = value;
+                        _gizmo[propName] = value;
+
+                        scope.entity.sendEvent(propName + '-changed', value);
+
+                    }
+
+                }
+
+            });
+
+            scope[propName] = defaultValue;
+            _plane[propName] = defaultValue;
+            _gizmo[propName] = defaultValue;
+
+        }
+
+        // Define properties with getters/setter
+        // Setting the defined property will automatically trigger change event
+        // Defined properties are passed down to gizmo and plane
+
+        defineProperty('camera', camera);
+        defineProperty('object', undefined);
+        defineProperty('enabled', true);
+        defineProperty('axis', null);
+        defineProperty('mode', 'translate');
+        defineProperty('translationSnap', null);
+        defineProperty('rotationSnap', null);
+        defineProperty('scaleSnap', null);
+        defineProperty('space', 'world');
+        defineProperty('size', 1);
+        defineProperty('dragging', false);
+        defineProperty('showX', true);
+        defineProperty('showY', true);
+        defineProperty('showZ', true);
+
+        // Reusable utility variables
+
+        const worldPosition = new Vector3();
+        const worldPositionStart = new Vector3();
+        const worldQuaternion = new Quaternion();
+        const worldQuaternionStart = new Quaternion();
+        const cameraPosition = new Vector3();
+        const cameraQuaternion = new Quaternion();
+        const pointStart = new Vector3();
+        const pointEnd = new Vector3();
+        const rotationAxis = new Vector3();
+        const rotationAngle = 0;
+        const eye = new Vector3();
+
+        // TODO: remove properties unused in plane and gizmo
+
+        defineProperty('worldPosition', worldPosition);
+        defineProperty('worldPositionStart', worldPositionStart);
+        defineProperty('worldQuaternion', worldQuaternion);
+        defineProperty('worldQuaternionStart', worldQuaternionStart);
+        defineProperty('cameraPosition', cameraPosition);
+        defineProperty('cameraQuaternion', cameraQuaternion);
+        defineProperty('pointStart', pointStart);
+        defineProperty('pointEnd', pointEnd);
+        defineProperty('rotationAxis', rotationAxis);
+        defineProperty('rotationAngle', rotationAngle);
+        defineProperty('eye', eye);
+
+        this._offset = new Vector3();
+        this._startNorm = new Vector3();
+        this._endNorm = new Vector3();
+        this._cameraScale = new Vector3(1, 1, 1);
+
+        this._parentPosition = new Vector3();
+        this._parentQuaternion = new Quaternion();
+        this._parentQuaternionInv = new Quaternion();
+        this._parentScale = new Vector3(1, 1, 1);
+
+        this._worldScaleStart = new Vector3(1, 1, 1);
+        this._worldQuaternionInv = new Quaternion();
+        this._worldScale = new Vector3(1, 1, 1);
+
+        this._positionStart = new Vector3();
+        this._quaternionStart = new Quaternion();
+        this._scaleStart = new Vector3(1, 1, 1);
+
+        this._getPointer = getPointer.bind(this);
+        this._onPointerDown = onPointerDown.bind(this);
+        this._onPointerHover = onPointerHover.bind(this);
+        this._onPointerMove = onPointerMove.bind(this);
+        this._onPointerUp = onPointerUp.bind(this);
+
+        this.domElement.addEventListener('pointerdown', this._onPointerDown);
+        this.domElement.addEventListener('pointermove', this._onPointerHover);
+        this.domElement.addEventListener('pointerup', this._onPointerUp);
+
+        if (autoUpdate) {
+            const fr = new FrameRunner(this.update.bind(this));
+            this.on.built.add(fr.startup, fr);
+            this.on.destroyed.add(fr.shutdown, fr);
+        }
+    }
+
+
+    // updateMatrixWorld  updates key transformation variables
+    update() {
+
+        if (this.object !== undefined) {
+
+            this._parentPosition.set(0, 0, 0);
+            this._parentScale.set(1, 1, 1);
+            this._parentQuaternion.set(0, 0, 0, 1);
+
+            this.worldPosition.copy(this.object_transform.position);
+            this.worldQuaternion.copy(this.object_transform.rotation);
+            this._worldScale.copy(this.object_transform.scale);
+
+            this._parentQuaternionInv.copy(this._parentQuaternion).invert();
+            this._worldQuaternionInv.copy(this.worldQuaternion).invert();
+
+        }
+
+        this.camera.updateMatrixWorld();
+        this.camera.matrixWorld.decompose(this.cameraPosition, this.cameraQuaternion, this._cameraScale);
+
+        this.eye.copy(this.cameraPosition).sub(this.worldPosition).normalize();
+
+        super.update();
+    }
+
+    pointerHover(pointer) {
+
+        if (this.object === undefined || this.dragging === true) return;
+
+        _raycaster.setFromCamera(pointer, this.camera);
+
+        const intersect = intersectObjectWithRay(this._gizmo.picker[this.mode], _raycaster);
+
+        if (intersect) {
+
+            this.axis = intersect.node.name;
+
+        } else {
+
+            this.axis = null;
+
+        }
+
+    }
+
+    pointerDown(pointer) {
+
+        if (this.object === undefined || this.dragging === true || pointer.button !== 0) return;
+
+        const ot = this.object_transform;
+
+        if (this.axis !== null) {
+
+            _raycaster.setFromCamera(pointer, this.camera);
+
+            const planeIntersect = intersectObjectWithRay(this._plane, _raycaster, true);
+
+            if (planeIntersect) {
+
+                this._positionStart.copy(ot.position);
+                this._quaternionStart.copy(ot.rotation);
+                this._scaleStart.copy(ot.scale);
+
+                this.worldPositionStart.copy(ot.position);
+                this.worldQuaternionStart.copy(ot.rotation);
+                this._worldScaleStart.copy(ot.scale);
+
+                this.pointStart.copy(planeIntersect.contact.position).sub(this.worldPositionStart);
+
+            }
+
+            this.dragging = true;
+            _mouseDownEvent.mode = this.mode;
+            this.dispatchEvent(_mouseDownEvent);
+
+        }
+
+    }
+
+    /**
+     *
+     * @param {{type:string}} event
+     */
+    dispatchEvent(event) {
+        this.entity.sendEvent(event.type, event);
+    }
+
+    pointerMove(pointer) {
+
+        const axis = this.axis;
+        const mode = this.mode;
+        const object = this.object;
+
+
+        let space = this.space;
+
+        if (mode === 'scale') {
+
+            space = 'local';
+
+        } else if (axis === 'E' || axis === 'XYZE' || axis === 'XYZ') {
+
+            space = 'world';
+
+        }
+
+        if (object === undefined || axis === null || this.dragging === false || pointer.button !== -1) return;
+
+        const object_transform = this.object_transform;
+
+        _raycaster.setFromCamera(pointer, this.camera);
+
+        const planeIntersect = intersectObjectWithRay(this._plane, _raycaster, true);
+
+        if (!planeIntersect) return;
+
+        this.pointEnd.copy(planeIntersect.contact.position).sub(this.worldPositionStart);
+
+        if (mode === 'translate') {
+
+            // Apply translate
+
+            this._offset.copy(this.pointEnd).sub(this.pointStart);
+
+            if (space === 'local' && axis !== 'XYZ') {
+
+                this._offset.applyQuaternion(this._worldQuaternionInv);
+
+            }
+
+            if (axis.indexOf('X') === -1) this._offset.x = 0;
+            if (axis.indexOf('Y') === -1) this._offset.y = 0;
+            if (axis.indexOf('Z') === -1) this._offset.z = 0;
+
+            if (space === 'local' && axis !== 'XYZ') {
+
+                this._offset.applyQuaternion(this._quaternionStart).divide(this._parentScale);
+
+            } else {
+
+                this._offset.applyQuaternion(this._parentQuaternionInv).divide(this._parentScale);
+
+            }
+
+
+            _tempTransform.position.copy(this._offset);
+            _tempTransform.position.add(this._positionStart);
+
+            // Apply translation snap
+
+            if (this.translationSnap) {
+
+                if (space === 'local') {
+
+                    _tempTransform.position.applyQuaternion(_tempQuaternion.copy(this._quaternionStart).invert());
+
+                    if (axis.search('X') !== -1) {
+
+                        _tempTransform.position.setX(Math.round(object.position.x / this.translationSnap) * this.translationSnap);
+
+                    }
+
+                    if (axis.search('Y') !== -1) {
+
+                        _tempTransform.position.setY(Math.round(object.position.y / this.translationSnap) * this.translationSnap);
+
+                    }
+
+                    if (axis.search('Z') !== -1) {
+
+                        _tempTransform.position.setZ(Math.round(object.position.z / this.translationSnap) * this.translationSnap);
+
+                    }
+
+                    _tempTransform.position.applyQuaternion(this._quaternionStart);
+
+                }
+
+                if (space === 'world') {
+
+                    if (object.parent) {
+
+                        _tempTransform.position.add(_tempVector.setFromMatrixPosition(object.parent.matrixWorld));
+
+                    }
+
+                    if (axis.search('X') !== -1) {
+
+                        _tempTransform.position.setX(Math.round(object.position.x / this.translationSnap) * this.translationSnap);
+
+                    }
+
+                    if (axis.search('Y') !== -1) {
+
+                        _tempTransform.position.setY(Math.round(object.position.y / this.translationSnap) * this.translationSnap);
+
+                    }
+
+                    if (axis.search('Z') !== -1) {
+
+                        _tempTransform.position.setZ(Math.round(object.position.z / this.translationSnap) * this.translationSnap);
+
+                    }
+
+                    if (object.parent) {
+
+                        _tempTransform.position.sub(_tempVector.setFromMatrixPosition(object.parent.matrixWorld));
+
+                    }
+
+                }
+
+            }
+            // write
+            object_transform.position.copy(_tempTransform.position);
+
+        } else if (mode === 'scale') {
+
+            if (axis.search('XYZ') !== -1) {
+
+                let d = this.pointEnd.length() / this.pointStart.length();
+
+                if (this.pointEnd.dot(this.pointStart) < 0) d *= -1;
+
+                _tempVector2.set(d, d, d);
+
+            } else {
+
+                _tempVector.copy(this.pointStart);
+                _tempVector2.copy(this.pointEnd);
+
+                _tempVector.applyQuaternion(this._worldQuaternionInv);
+                _tempVector2.applyQuaternion(this._worldQuaternionInv);
+
+                _tempVector2.divide(_tempVector);
+
+                if (axis.search('X') === -1) {
+
+                    _tempVector2.x = 1;
+
+                }
+
+                if (axis.search('Y') === -1) {
+
+                    _tempVector2.y = 1;
+
+                }
+
+                if (axis.search('Z') === -1) {
+
+                    _tempVector2.z = 1;
+
+                }
+
+            }
+
+            // Apply scale
+
+            _tempTransform.scale.copy(this._scaleStart);
+            _tempTransform.scale.multiply(_tempVector2);
+
+            // console.log(this._scaleStart,_tempVector2,_tempVector);
+
+            if (this.scaleSnap) {
+
+                if (axis.search('X') !== -1) {
+
+                    _tempTransform.scale.setX(Math.round(_tempTransform.scale.x / this.scaleSnap) * this.scaleSnap || this.scaleSnap);
+
+                }
+
+                if (axis.search('Y') !== -1) {
+
+                    _tempTransform.scale.setY(Math.round(_tempTransform.scale.y / this.scaleSnap) * this.scaleSnap || this.scaleSnap);
+
+                }
+
+                if (axis.search('Z') !== -1) {
+
+                    _tempTransform.scale.setZ(Math.round(_tempTransform.scale.z / this.scaleSnap) * this.scaleSnap || this.scaleSnap);
+
+                }
+
+            }
+
+            object_transform.scale.copy(_tempTransform.scale);
+
+        } else if (mode === 'rotate') {
+
+            this._offset.copy(this.pointEnd).sub(this.pointStart);
+
+            const ROTATION_SPEED = 20 / this.worldPosition.distanceTo(_tempVector.setFromMatrixPosition(this.camera.matrixWorld));
+
+            if (axis === 'E') {
+
+                this.rotationAxis.copy(this.eye);
+                this.rotationAngle = this.pointEnd.angleTo(this.pointStart);
+
+                this._startNorm.copy(this.pointStart).normalize();
+                this._endNorm.copy(this.pointEnd).normalize();
+
+                this.rotationAngle *= (this._endNorm.cross(this._startNorm).dot(this.eye) < 0 ? 1 : -1);
+
+            } else if (axis === 'XYZE') {
+
+                this.rotationAxis.copy(this._offset).cross(this.eye).normalize();
+                this.rotationAngle = this._offset.dot(_tempVector.copy(this.rotationAxis).cross(this.eye)) * ROTATION_SPEED;
+
+            } else if (axis === 'X' || axis === 'Y' || axis === 'Z') {
+
+                this.rotationAxis.copy(_unit[axis]);
+
+                _tempVector.copy(_unit[axis]);
+
+                if (space === 'local') {
+
+                    _tempVector.applyQuaternion(this.worldQuaternion);
+
+                }
+
+                this.rotationAngle = this._offset.dot(_tempVector.cross(this.eye).normalize()) * ROTATION_SPEED;
+
+            }
+
+            // Apply rotation snap
+
+            if (this.rotationSnap) this.rotationAngle = Math.round(this.rotationAngle / this.rotationSnap) * this.rotationSnap;
+
+            // Apply rotate
+            if (space === 'local' && axis !== 'E' && axis !== 'XYZE') {
+
+                _tempTransform.rotation.copy(this._quaternionStart);
+                _tempTransform.rotation.multiply(_tempQuaternion.setFromAxisAngle(this.rotationAxis, this.rotationAngle)).normalize();
+
+            } else {
+
+                this.rotationAxis.applyQuaternion(this._parentQuaternionInv);
+                _tempTransform.rotation.copy(_tempQuaternion.setFromAxisAngle(this.rotationAxis, this.rotationAngle));
+                _tempTransform.rotation.multiply(this._quaternionStart);
+                _tempTransform.rotation.normalize();
+
+            }
+
+            object_transform.rotation.copy(_tempTransform.rotation);
+        }
+
+
+        this.dispatchEvent(_changeEvent);
+        this.dispatchEvent(_objectChangeEvent);
+
+    }
+
+    pointerUp(pointer) {
+
+        if (pointer.button !== 0) return;
+
+        if (this.dragging && (this.axis !== null)) {
+
+            _mouseUpEvent.mode = this.mode;
+            this.dispatchEvent(_mouseUpEvent);
+
+        }
+
+        this.dragging = false;
+        this.axis = null;
+
+    }
+
+    dispose() {
+
+        this.domElement.removeEventListener('pointerdown', this._onPointerDown);
+        this.domElement.removeEventListener('pointermove', this._onPointerHover);
+        this.domElement.removeEventListener('pointermove', this._onPointerMove);
+        this.domElement.removeEventListener('pointerup', this._onPointerUp);
+
+    }
+
+    /**
+     * Set current object
+     * @param {number} entity
+     * @returns {TransformControls}
+     */
+    attach(entity) {
+        assert.isNonNegativeInteger(entity, 'entity');
+
+        this.object = entity;
+
+        this.visible = true;
+
+        return this;
+
+    }
+
+    /**
+     *
+     * @returns {Transform|undefined}
+     */
+    get object_transform() {
+        const ecd = this.entity.dataset;
+
+        return ecd.getComponent(this.object, Transform);
+    }
+
+    // Detatch from object
+    detach() {
+
+        this.object = undefined;
+
+        this.visible = false;
+        this.axis = null;
+
+        return this;
+
+    }
+
+    reset() {
+
+        if (!this.enabled) return;
+
+        if (this.dragging) {
+
+            this.object_transform.position.copy(this._positionStart);
+            this.object_transform.rotation.copy(this._quaternionStart);
+            this.object_transform.scale.copy(this._scaleStart);
+
+            this.dispatchEvent(_changeEvent);
+            this.dispatchEvent(_objectChangeEvent);
+
+            this.pointStart.copy(this.pointEnd);
+
+        }
+
+    }
+
+    getRaycaster() {
+
+        return _raycaster;
+
+    }
+
+    // TODO: deprecate
+
+    getMode() {
+
+        return this.mode;
+
+    }
+
+    setMode(mode) {
+
+        this.mode = mode;
+
+    }
+
+    setTranslationSnap(translationSnap) {
+
+        this.translationSnap = translationSnap;
+
+    }
+
+    setRotationSnap(rotationSnap) {
+
+        this.rotationSnap = rotationSnap;
+
+    }
+
+    setScaleSnap(scaleSnap) {
+
+        this.scaleSnap = scaleSnap;
+
+    }
+
+    setSize(size) {
+
+        this.size = size;
+
+    }
+
+    setSpace(space) {
+
+        this.space = space;
+
+    }
+
+}
+
+// mouse / touch event handlers
+
+function getPointer(event) {
+
+    if (this.domElement.ownerDocument.pointerLockElement) {
+
+        return {
+            x: 0,
+            y: 0,
+            button: event.button
+        };
+
+    } else {
+
+        const rect = this.domElement.getBoundingClientRect();
+
+        return {
+            x: (event.clientX - rect.left) / rect.width * 2 - 1,
+            y: -(event.clientY - rect.top) / rect.height * 2 + 1,
+            button: event.button
+        };
+
+    }
+
+}
+
+function onPointerHover(event) {
+
+    if (!this.enabled) return;
+
+    switch (event.pointerType) {
+
+        case 'mouse':
+        case 'pen':
+            this.pointerHover(this._getPointer(event));
+            break;
+
+    }
+
+}
+
+function onPointerDown(event) {
+
+    if (!this.enabled) return;
+
+    if (!document.pointerLockElement) {
+
+        this.domElement.setPointerCapture(event.pointerId);
+
+    }
+
+    this.domElement.addEventListener('pointermove', this._onPointerMove);
+
+    this.pointerHover(this._getPointer(event));
+    this.pointerDown(this._getPointer(event));
+
+}
+
+function onPointerMove(event) {
+
+    if (!this.enabled) return;
+
+    this.pointerMove(this._getPointer(event));
+
+}
+
+function onPointerUp(event) {
+
+    if (!this.enabled) return;
+
+    this.domElement.releasePointerCapture(event.pointerId);
+
+    this.domElement.removeEventListener('pointermove', this._onPointerMove);
+
+    this.pointerUp(this._getPointer(event));
+
+}
+
+/**
+ *
+ * @param {EntityNode} object
+ * @param {Raycaster} raycaster
+ * @param {boolean} [includeInvisible]
+ * @returns {boolean|{contact:SurfacePoint3,entity:number, node:EntityNode}}
+ */
+function intersectObjectWithRay(object, raycaster, includeInvisible = false) {
+    /**
+     *
+     * @type {{contact:SurfacePoint3,entity:number, node:EntityNode}[]}
+     */
+    const contacts = [];
+
+    const ray = raycaster.ray;
+    const ray_array = [
+        ray.origin.x, ray.origin.y, ray.origin.z, ray.direction.x, ray.direction.y, ray.direction.z
+    ];
+
+    object.traverse(node => {
+
+        const sg = node.entity.getComponent(ShadedGeometry);
+
+        const transform = node.transform;
+
+        if (!sg) {
+            return;
+        }
+
+        if (!sg.getFlag(ShadedGeometryFlags.Visible) && !includeInvisible) {
+            return;
+        }
+
+
+        const contact = new SurfacePoint3();
+        if (sg.query_raycast_nearest(contact, ray_array, transform.matrix)) {
+
+            contacts.push({
+                contact,
+                entity: node.entity.entity,
+                node
+            });
+        }
+    });
+
+    if (contacts.length <= 0) {
+        return false;
+    }
+
+    // sort contacts by distance
+    contacts.sort((a, b) => {
+        return a.contact.position.distanceSqrTo(ray.origin) - b.contact.position.distanceSqrTo(ray.origin);
+    });
+
+    return contacts[0];
+}
+
+//
+
+// Reusable utility variables
+
+const _tempEuler = new Euler();
+const _alignVector = new Vector3(0, 1, 0);
+const _zeroVector = new Vector3(0, 0, 0);
+const _lookAtMatrix = new Matrix4();
+const _tempQuaternion2 = new Quaternion();
+const _identityQuaternion = new Quaternion();
+const _dirVector = new Vector3();
+const _tempMatrix = new Matrix4();
+
+const _unitX = new Vector3(1, 0, 0);
+const _unitY = new Vector3(0, 1, 0);
+const _unitZ = new Vector3(0, 0, 1);
+
+const _v1 = new Vector3();
+const _v2 = new Vector3();
+const _v3 = new Vector3();
+
+class TransformControlsGizmo extends GizmoNode {
+
+    constructor() {
+
+        super();
+
+        this.isTransformControlsGizmo = true;
+
+        this.type = 'TransformControlsGizmo';
+
+        // shared materials
+
+        const gizmoMaterial = new MeshBasicMaterial({
+            depthTest: false,
+            depthWrite: false,
+            fog: false,
+            toneMapped: false,
+            transparent: true
+        });
+
+        const gizmoLineMaterial = new LineBasicMaterial({
+            depthTest: false,
+            depthWrite: false,
+            fog: false,
+            toneMapped: false,
+            transparent: true
+        });
+
+        // Make unique material for each axis/color
+
+        const matInvisible = gizmoMaterial.clone();
+        matInvisible.opacity = 0.15;
+
+        const matHelper = gizmoLineMaterial.clone();
+        matHelper.opacity = 0.5;
+
+        const matRed = gizmoMaterial.clone();
+        matRed.color.setHex(0xff0000);
+
+        const matGreen = gizmoMaterial.clone();
+        matGreen.color.setHex(0x00ff00);
+
+        const matBlue = gizmoMaterial.clone();
+        matBlue.color.setHex(0x0000ff);
+
+        const matRedTransparent = gizmoMaterial.clone();
+        matRedTransparent.color.setHex(0xff0000);
+        matRedTransparent.opacity = 0.5;
+
+        const matGreenTransparent = gizmoMaterial.clone();
+        matGreenTransparent.color.setHex(0x00ff00);
+        matGreenTransparent.opacity = 0.5;
+
+        const matBlueTransparent = gizmoMaterial.clone();
+        matBlueTransparent.color.setHex(0x0000ff);
+        matBlueTransparent.opacity = 0.5;
+
+        const matWhiteTransparent = gizmoMaterial.clone();
+        matWhiteTransparent.opacity = 0.25;
+
+        const matYellowTransparent = gizmoMaterial.clone();
+        matYellowTransparent.color.setHex(0xffff00);
+        matYellowTransparent.opacity = 0.25;
+
+        const matYellow = gizmoMaterial.clone();
+        matYellow.color.setHex(0xffff00);
+
+        const matGray = gizmoMaterial.clone();
+        matGray.color.setHex(0x787878);
+
+        // reusable geometry
+
+        const arrowGeometry = new CylinderGeometry(0, 0.04, 0.1, 12);
+        arrowGeometry.translate(0, 0.05, 0);
+
+        const scaleHandleGeometry = new BoxGeometry(0.08, 0.08, 0.08);
+        scaleHandleGeometry.translate(0, 0.04, 0);
+
+        const lineGeometry = new BufferGeometry();
+        lineGeometry.setAttribute('position', new Float32BufferAttribute([0, 0, 0, 1, 0, 0], 3));
+
+        const lineGeometry2 = new CylinderGeometry(0.0075, 0.0075, 0.5, 3);
+        lineGeometry2.translate(0, 0.25, 0);
+
+        function CircleGeometry(radius, arc) {
+
+            const geometry = new TorusGeometry(radius, 0.0075, 3, 64, arc * Math.PI * 2);
+            geometry.rotateY(Math.PI / 2);
+            geometry.rotateX(Math.PI / 2);
+            return geometry;
+
+        }
+
+        // Special geometry for transform helper. If scaled with position vector it spans from [0,0,0] to position
+
+        function TranslateHelperGeometry() {
+
+            const geometry = new BufferGeometry();
+
+            geometry.setAttribute('position', new Float32BufferAttribute([0, 0, 0, 1, 1, 1], 3));
+
+            return geometry;
+
+        }
+
+        // Gizmo definitions - custom hierarchy definitions for setupGizmo() function
+
+        const gizmoTranslate = {
+            X: [
+                [ShadedGeometry.from(arrowGeometry, matRed, DrawMode.Triangles), [0.5, 0, 0], [0, 0, -Math.PI / 2]],
+                [ShadedGeometry.from(arrowGeometry, matRed, DrawMode.Triangles), [-0.5, 0, 0], [0, 0, Math.PI / 2]],
+                [ShadedGeometry.from(lineGeometry2, matRed, DrawMode.Triangles), [0, 0, 0], [0, 0, -Math.PI / 2]]
+            ],
+            Y: [
+                [ShadedGeometry.from(arrowGeometry, matGreen, DrawMode.Triangles), [0, 0.5, 0]],
+                [ShadedGeometry.from(arrowGeometry, matGreen, DrawMode.Triangles), [0, -0.5, 0], [Math.PI, 0, 0]],
+                [ShadedGeometry.from(lineGeometry2, matGreen, DrawMode.Triangles)]
+            ],
+            Z: [
+                [ShadedGeometry.from(arrowGeometry, matBlue, DrawMode.Triangles), [0, 0, 0.5], [Math.PI / 2, 0, 0]],
+                [ShadedGeometry.from(arrowGeometry, matBlue, DrawMode.Triangles), [0, 0, -0.5], [-Math.PI / 2, 0, 0]],
+                [ShadedGeometry.from(lineGeometry2, matBlue, DrawMode.Triangles), null, [Math.PI / 2, 0, 0]]
+            ],
+            XYZ: [
+                [ShadedGeometry.from(new OctahedronGeometry(0.1, 0), matWhiteTransparent.clone(), DrawMode.Triangles), [0, 0, 0]]
+            ],
+            XY: [
+                [ShadedGeometry.from(new BoxGeometry(0.15, 0.15, 0.01), matBlueTransparent.clone(), DrawMode.Triangles), [0.15, 0.15, 0]]
+            ],
+            YZ: [
+                [ShadedGeometry.from(new BoxGeometry(0.15, 0.15, 0.01), matRedTransparent.clone(), DrawMode.Triangles), [0, 0.15, 0.15], [0, Math.PI / 2, 0]]
+            ],
+            XZ: [
+                [ShadedGeometry.from(new BoxGeometry(0.15, 0.15, 0.01), matGreenTransparent.clone(), DrawMode.Triangles), [0.15, 0, 0.15], [-Math.PI / 2, 0, 0]]
+            ]
+        };
+
+        const pickerTranslate = {
+            X: [
+                [ShadedGeometry.from(new CylinderGeometry(0.2, 0, 0.6, 4), matInvisible, DrawMode.Triangles), [0.3, 0, 0], [0, 0, -Math.PI / 2]],
+                [ShadedGeometry.from(new CylinderGeometry(0.2, 0, 0.6, 4), matInvisible, DrawMode.Triangles), [-0.3, 0, 0], [0, 0, Math.PI / 2]]
+            ],
+            Y: [
+                [ShadedGeometry.from(new CylinderGeometry(0.2, 0, 0.6, 4), matInvisible, DrawMode.Triangles), [0, 0.3, 0]],
+                [ShadedGeometry.from(new CylinderGeometry(0.2, 0, 0.6, 4), matInvisible, DrawMode.Triangles), [0, -0.3, 0], [0, 0, Math.PI]]
+            ],
+            Z: [
+                [ShadedGeometry.from(new CylinderGeometry(0.2, 0, 0.6, 4), matInvisible, DrawMode.Triangles), [0, 0, 0.3], [Math.PI / 2, 0, 0]],
+                [ShadedGeometry.from(new CylinderGeometry(0.2, 0, 0.6, 4), matInvisible, DrawMode.Triangles), [0, 0, -0.3], [-Math.PI / 2, 0, 0]]
+            ],
+            XYZ: [
+                [ShadedGeometry.from(new OctahedronGeometry(0.2, 0), matInvisible, DrawMode.Triangles)]
+            ],
+            XY: [
+                [ShadedGeometry.from(new BoxGeometry(0.2, 0.2, 0.01), matInvisible, DrawMode.Triangles), [0.15, 0.15, 0]]
+            ],
+            YZ: [
+                [ShadedGeometry.from(new BoxGeometry(0.2, 0.2, 0.01), matInvisible, DrawMode.Triangles), [0, 0.15, 0.15], [0, Math.PI / 2, 0]]
+            ],
+            XZ: [
+                [ShadedGeometry.from(new BoxGeometry(0.2, 0.2, 0.01), matInvisible, DrawMode.Triangles), [0.15, 0, 0.15], [-Math.PI / 2, 0, 0]]
+            ]
+        };
+
+        const helperTranslate = {
+            START: [
+                [ShadedGeometry.from(new OctahedronGeometry(0.01, 2), matHelper, DrawMode.Triangles), null, null, null, 'helper']
+            ],
+            END: [
+                [ShadedGeometry.from(new OctahedronGeometry(0.01, 2), matHelper, DrawMode.Triangles), null, null, null, 'helper']
+            ],
+            DELTA: [
+                [ShadedGeometry.from(TranslateHelperGeometry(), matHelper, DrawMode.Lines), null, null, null, 'helper']
+            ],
+            X: [
+                [ShadedGeometry.from(lineGeometry, matHelper.clone(), DrawMode.Lines), [-1e3, 0, 0], null, [1e6, 1, 1], 'helper']
+            ],
+            Y: [
+                [ShadedGeometry.from(lineGeometry, matHelper.clone(), DrawMode.Lines), [0, -1e3, 0], [0, 0, Math.PI / 2], [1e6, 1, 1], 'helper']
+            ],
+            Z: [
+                [ShadedGeometry.from(lineGeometry, matHelper.clone(), DrawMode.Lines), [0, 0, -1e3], [0, -Math.PI / 2, 0], [1e6, 1, 1], 'helper']
+            ]
+        };
+
+        const gizmoRotate = {
+            XYZE: [
+                [ShadedGeometry.from(CircleGeometry(0.5, 1), matGray, DrawMode.Triangles), null, [0, Math.PI / 2, 0]]
+            ],
+            X: [
+                [ShadedGeometry.from(CircleGeometry(0.5, 0.5), matRed, DrawMode.Triangles)]
+            ],
+            Y: [
+                [ShadedGeometry.from(CircleGeometry(0.5, 0.5), matGreen, DrawMode.Triangles), null, [0, 0, -Math.PI / 2]]
+            ],
+            Z: [
+                [ShadedGeometry.from(CircleGeometry(0.5, 0.5), matBlue, DrawMode.Triangles), null, [0, Math.PI / 2, 0]]
+            ],
+            E: [
+                [ShadedGeometry.from(CircleGeometry(0.75, 1), matYellowTransparent, DrawMode.Triangles), null, [0, Math.PI / 2, 0]]
+            ]
+        };
+
+        const helperRotate = {
+            AXIS: [
+                [ShadedGeometry.from(lineGeometry, matHelper.clone(), DrawMode.Lines), [-1e3, 0, 0], null, [1e6, 1, 1], 'helper']
+            ]
+        };
+
+        const pickerRotate = {
+            XYZE: [
+                [ShadedGeometry.from(new SphereGeometry(0.25, 10, 8), matInvisible, DrawMode.Triangles)]
+            ],
+            X: [
+                [ShadedGeometry.from(new TorusGeometry(0.5, 0.1, 4, 24), matInvisible, DrawMode.Triangles), [0, 0, 0], [0, -Math.PI / 2, -Math.PI / 2]],
+            ],
+            Y: [
+                [ShadedGeometry.from(new TorusGeometry(0.5, 0.1, 4, 24), matInvisible, DrawMode.Triangles), [0, 0, 0], [Math.PI / 2, 0, 0]],
+            ],
+            Z: [
+                [ShadedGeometry.from(new TorusGeometry(0.5, 0.1, 4, 24), matInvisible, DrawMode.Triangles), [0, 0, 0], [0, 0, -Math.PI / 2]],
+            ],
+            E: [
+                [ShadedGeometry.from(new TorusGeometry(0.75, 0.1, 2, 24), matInvisible, DrawMode.Triangles)]
+            ]
+        };
+
+        const gizmoScale = {
+            X: [
+                [ShadedGeometry.from(scaleHandleGeometry, matRed), [0.5, 0, 0], [0, 0, -Math.PI / 2]],
+                [ShadedGeometry.from(lineGeometry2, matRed), [0, 0, 0], [0, 0, -Math.PI / 2]],
+                [ShadedGeometry.from(scaleHandleGeometry, matRed), [-0.5, 0, 0], [0, 0, Math.PI / 2]],
+            ],
+            Y: [
+                [ShadedGeometry.from(scaleHandleGeometry, matGreen), [0, 0.5, 0]],
+                [ShadedGeometry.from(lineGeometry2, matGreen)],
+                [ShadedGeometry.from(scaleHandleGeometry, matGreen), [0, -0.5, 0], [0, 0, Math.PI]],
+            ],
+            Z: [
+                [ShadedGeometry.from(scaleHandleGeometry, matBlue), [0, 0, 0.5], [Math.PI / 2, 0, 0]],
+                [ShadedGeometry.from(lineGeometry2, matBlue), [0, 0, 0], [Math.PI / 2, 0, 0]],
+                [ShadedGeometry.from(scaleHandleGeometry, matBlue), [0, 0, -0.5], [-Math.PI / 2, 0, 0]]
+            ],
+            XY: [
+                [ShadedGeometry.from(new BoxGeometry(0.15, 0.15, 0.01), matBlueTransparent), [0.15, 0.15, 0]]
+            ],
+            YZ: [
+                [ShadedGeometry.from(new BoxGeometry(0.15, 0.15, 0.01), matRedTransparent), [0, 0.15, 0.15], [0, Math.PI / 2, 0]]
+            ],
+            XZ: [
+                [ShadedGeometry.from(new BoxGeometry(0.15, 0.15, 0.01), matGreenTransparent), [0.15, 0, 0.15], [-Math.PI / 2, 0, 0]]
+            ],
+            XYZ: [
+                [ShadedGeometry.from(new BoxGeometry(0.1, 0.1, 0.1), matWhiteTransparent.clone())],
+            ]
+        };
+
+        const pickerScale = {
+            X: [
+                [ShadedGeometry.from(new CylinderGeometry(0.2, 0, 0.6, 4), matInvisible), [0.3, 0, 0], [0, 0, -Math.PI / 2]],
+                [ShadedGeometry.from(new CylinderGeometry(0.2, 0, 0.6, 4), matInvisible), [-0.3, 0, 0], [0, 0, Math.PI / 2]]
+            ],
+            Y: [
+                [ShadedGeometry.from(new CylinderGeometry(0.2, 0, 0.6, 4), matInvisible), [0, 0.3, 0]],
+                [ShadedGeometry.from(new CylinderGeometry(0.2, 0, 0.6, 4), matInvisible), [0, -0.3, 0], [0, 0, Math.PI]]
+            ],
+            Z: [
+                [ShadedGeometry.from(new CylinderGeometry(0.2, 0, 0.6, 4), matInvisible), [0, 0, 0.3], [Math.PI / 2, 0, 0]],
+                [ShadedGeometry.from(new CylinderGeometry(0.2, 0, 0.6, 4), matInvisible), [0, 0, -0.3], [-Math.PI / 2, 0, 0]]
+            ],
+            XY: [
+                [ShadedGeometry.from(new BoxGeometry(0.2, 0.2, 0.01), matInvisible), [0.15, 0.15, 0]],
+            ],
+            YZ: [
+                [ShadedGeometry.from(new BoxGeometry(0.2, 0.2, 0.01), matInvisible), [0, 0.15, 0.15], [0, Math.PI / 2, 0]],
+            ],
+            XZ: [
+                [ShadedGeometry.from(new BoxGeometry(0.2, 0.2, 0.01), matInvisible), [0.15, 0, 0.15], [-Math.PI / 2, 0, 0]],
+            ],
+            XYZ: [
+                [ShadedGeometry.from(new BoxGeometry(0.2, 0.2, 0.2), matInvisible), [0, 0, 0]],
+            ]
+        };
+
+        const helperScale = {
+            X: [
+                [ShadedGeometry.from(lineGeometry, matHelper.clone(), DrawMode.Lines), [-1e3, 0, 0], null, [1e6, 1, 1], 'helper']
+            ],
+            Y: [
+                [ShadedGeometry.from(lineGeometry, matHelper.clone(), DrawMode.Lines), [0, -1e3, 0], [0, 0, Math.PI / 2], [1e6, 1, 1], 'helper']
+            ],
+            Z: [
+                [ShadedGeometry.from(lineGeometry, matHelper.clone(), DrawMode.Lines), [0, 0, -1e3], [0, -Math.PI / 2, 0], [1e6, 1, 1], 'helper']
+            ]
+        };
+
+        // Creates an Object3D with gizmos described in custom hierarchy definition.
+
+        /**
+         *
+         * @returns {EntityNode}
+         */
+        function setupGizmo(gizmoMap) {
+
+            const gizmo = new GizmoNode();
+
+            for (const name in gizmoMap) {
+
+                const gizmo_elements = gizmoMap[name];
+
+                for (let i = gizmo_elements.length; i--;) {
+                    const gizmo_element = gizmo_elements[i];
+
+                    /**
+                     * @type {ShadedGeometry}
+                     */
+                    const shaded_geometry = gizmo_element[0].clone();
+
+                    // disable shadows
+                    shaded_geometry.clearFlag(ShadedGeometryFlags.CastShadow | ShadedGeometryFlags.ReceiveShadow);
+
+                    // make it so that gizmo is always drawn using direct mode
+                    shaded_geometry.draw_method = 0;
+                    shaded_geometry.setFlag(ShadedGeometryFlags.DrawMethodLocked);
+
+                    const node = new GizmoNode();
+                    const transform = node.entity.getComponent(Transform);
+                    node.entity.add(shaded_geometry);
+
+                    /**
+                     * @type {number[]|undefined}
+                     */
+                    const position = gizmo_element[1];
+
+                    /**
+                     * @type {number[]|undefined}
+                     */
+                    const rotation = gizmo_element[2];
+
+                    /**
+                     * @type {number[]|undefined}
+                     */
+                    const scale = gizmo_element[3];
+
+                    /**
+                     * @type {string|undefined}
+                     */
+                    const tag = gizmo_element[4];
+
+                    // name and tag properties are essential for picking and updating logic.
+                    node.name = name;
+                    node.tag = tag;
+
+                    if (position) {
+
+                        transform.position.set(position[0], position[1], position[2]);
+
+                    }
+
+                    if (rotation) {
+
+                        transform.rotation.fromEulerAnglesXYZ(rotation[0], rotation[1], rotation[2]);
+
+                    }
+
+                    if (scale) {
+
+                        transform.scale.set(scale[0], scale[1], scale[2]);
+
+                    }
+
+                    const tempGeometry = shaded_geometry.geometry.clone();
+                    const m4 = new Matrix4();
+                    transform.toMatrix4(m4.elements);
+                    tempGeometry.applyMatrix4(m4);
+
+                    shaded_geometry.geometry = tempGeometry;
+                    // TODO add support for render order to ShadedGeometry
+                    shaded_geometry.renderOrder = Infinity;
+
+                    transform.makeIdentity();
+
+                    gizmo.addChild(node);
+
+                }
+
+            }
+
+            return gizmo;
+
+        }
+
+        // Gizmo creation
+
+        /**
+         *
+         * @type {Object<EntityNode>}
+         */
+        this.gizmo = {};
+        /**
+         *
+         * @type {Object<EntityNode>}
+         */
+        this.picker = {};
+        /**
+         *
+         * @type {Object<EntityNode>}
+         */
+        this.helper = {};
+
+        this.addChild(this.gizmo['translate'] = setupGizmo(gizmoTranslate));
+        this.addChild(this.gizmo['rotate'] = setupGizmo(gizmoRotate));
+        this.addChild(this.gizmo['scale'] = setupGizmo(gizmoScale));
+        this.addChild(this.picker['translate'] = setupGizmo(pickerTranslate));
+        this.addChild(this.picker['rotate'] = setupGizmo(pickerRotate));
+        this.addChild(this.picker['scale'] = setupGizmo(pickerScale));
+        this.addChild(this.helper['translate'] = setupGizmo(helperTranslate));
+        this.addChild(this.helper['rotate'] = setupGizmo(helperRotate));
+        this.addChild(this.helper['scale'] = setupGizmo(helperScale));
+
+        // Pickers should be hidden always
+
+        this.picker['translate'].visible = false;
+        this.picker['rotate'].visible = false;
+        this.picker['scale'].visible = false;
+    }
+
+    // updateMatrixWorld will update transformations and appearance of individual handles
+
+    update(force) {
+
+        const space = (this.mode === 'scale') ? 'local' : this.space; // scale always oriented to local rotation
+
+        const quaternion = (space === 'local') ? this.worldQuaternion : _identityQuaternion;
+
+        // Show only gizmos for current transform mode
+
+        this.gizmo['translate'].visible = this.mode === 'translate';
+        this.gizmo['rotate'].visible = this.mode === 'rotate';
+        this.gizmo['scale'].visible = this.mode === 'scale';
+
+        this.helper['translate'].visible = this.mode === 'translate';
+        this.helper['rotate'].visible = this.mode === 'rotate';
+        this.helper['scale'].visible = this.mode === 'scale';
+
+        /**
+         *
+         * @type {(GizmoNode|{name:string,tag:string})[]}
+         */
+        let handles = [];
+        handles = handles.concat(this.picker[this.mode].children);
+        handles = handles.concat(this.gizmo[this.mode].children);
+        handles = handles.concat(this.helper[this.mode].children);
+
+        for (let i = 0; i < handles.length; i++) {
+
+            const handle = handles[i];
+
+            // hide aligned to camera
+
+            handle.visible = true;
+            handle.transform.rotation.fromEulerAnglesXYZ(0, 0, 0);
+            handle.transform.position.copy(this.worldPosition);
+
+            let factor;
+
+            if (this.camera.isOrthographicCamera) {
+
+                factor = (this.camera.top - this.camera.bottom) / this.camera.zoom;
+
+            } else {
+
+                factor = this.worldPosition.distanceTo(this.cameraPosition) * Math.min(1.9 * Math.tan(Math.PI * this.camera.fov / 360) / this.camera.zoom, 7);
+
+            }
+
+            if (factor === 0) {
+                // prevent 0 size
+                factor = 1e-10;
+            }
+
+            handle.transform.scale.setScalar(factor * this.size / 4);
+
+            // TODO: simplify helpers and consider decoupling from gizmo
+
+            if (handle.tag === 'helper') {
+                handle.visible = false;
+
+                if (handle.name === 'AXIS') {
+
+                    handle.transform.position.copy(this.worldPositionStart);
+                    handle.visible = !!this.axis;
+
+                    if (this.axis === 'X') {
+
+                        _tempQuaternion.setFromEuler(_tempEuler.set(0, 0, 0));
+                        handle.transform.rotation.copy(quaternion);
+                        handle.transform.rotation.multiply(_tempQuaternion);
+
+                        if (Math.abs(_alignVector.copy(_unitX).applyQuaternion(quaternion).dot(this.eye)) > 0.9) {
+
+                            handle.visible = false;
+
+                        }
+
+                    }
+
+                    if (this.axis === 'Y') {
+
+                        _tempQuaternion.setFromEuler(_tempEuler.set(0, 0, Math.PI / 2));
+                        handle.transform.rotation.copy(quaternion);
+                        handle.transform.rotation.multiply(_tempQuaternion);
+
+                        if (Math.abs(_alignVector.copy(_unitY).applyQuaternion(quaternion).dot(this.eye)) > 0.9) {
+
+                            handle.visible = false;
+
+                        }
+
+                    }
+
+                    if (this.axis === 'Z') {
+
+                        _tempQuaternion.setFromEuler(_tempEuler.set(0, Math.PI / 2, 0));
+                        handle.transform.rotation.copy(quaternion);
+                        handle.transform.rotation.multiply(_tempQuaternion);
+
+                        if (Math.abs(_alignVector.copy(_unitZ).applyQuaternion(quaternion).dot(this.eye)) > 0.9) {
+
+                            handle.visible = false;
+
+                        }
+
+                    }
+
+                    if (this.axis === 'XYZE') {
+
+                        _tempQuaternion.setFromEuler(_tempEuler.set(0, Math.PI / 2, 0));
+                        _alignVector.copy(this.rotationAxis);
+                        handle.transform.rotation.setFromRotationMatrix(_lookAtMatrix.lookAt(_zeroVector, _alignVector, _unitY));
+                        handle.transform.rotation.multiply(_tempQuaternion);
+                        handle.visible = this.dragging;
+
+                    }
+
+                    if (this.axis === 'E') {
+
+                        handle.visible = false;
+
+                    }
+
+
+                } else if (handle.name === 'START') {
+
+                    handle.transform.position.copy(this.worldPositionStart);
+                    handle.visible = this.dragging;
+
+                } else if (handle.name === 'END') {
+
+                    handle.transform.position.copy(this.worldPosition);
+                    handle.visible = this.dragging;
+
+                } else if (handle.name === 'DELTA') {
+
+                    handle.transform.position.copy(this.worldPositionStart);
+                    handle.transform.rotation.copy(this.worldQuaternionStart);
+                    _tempVector.set(1e-10, 1e-10, 1e-10).add(this.worldPositionStart).sub(this.worldPosition).multiplyScalar(-1);
+                    _tempVector.applyQuaternion(this.worldQuaternionStart.clone().invert());
+                    handle.transform.scale.copy(_tempVector);
+                    handle.visible = this.dragging;
+
+                } else {
+
+                    handle.transform.rotation.copy(quaternion);
+
+                    if (this.dragging) {
+
+                        handle.transform.position.copy(this.worldPositionStart);
+
+                    } else {
+
+                        handle.transform.position.copy(this.worldPosition);
+
+                    }
+
+                    if (this.axis) {
+
+                        handle.visible = this.axis.search(handle.name) !== -1;
+
+                    }
+
+                }
+
+                // If updating helper, skip rest of the loop
+                continue;
+
+            }
+
+            // Align handles to current local or world rotation
+
+            handle.transform.rotation.copy(quaternion);
+
+            if (this.mode === 'translate' || this.mode === 'scale') {
+
+                // Hide translate and scale axis facing the camera
+
+                const AXIS_HIDE_TRESHOLD = 0.99;
+                const PLANE_HIDE_TRESHOLD = 0.2;
+
+                if (handle.name === 'X') {
+
+                    if (Math.abs(_alignVector.copy(_unitX).applyQuaternion(quaternion).dot(this.eye)) > AXIS_HIDE_TRESHOLD) {
+
+                        handle.transform.scale.set(1e-10, 1e-10, 1e-10);
+                        handle.visible = false;
+
+                    }
+
+                }
+
+                if (handle.name === 'Y') {
+
+                    if (Math.abs(_alignVector.copy(_unitY).applyQuaternion(quaternion).dot(this.eye)) > AXIS_HIDE_TRESHOLD) {
+
+                        handle.transform.scale.set(1e-10, 1e-10, 1e-10);
+                        handle.visible = false;
+
+                    }
+
+                }
+
+                if (handle.name === 'Z') {
+
+                    if (Math.abs(_alignVector.copy(_unitZ).applyQuaternion(quaternion).dot(this.eye)) > AXIS_HIDE_TRESHOLD) {
+
+                        handle.transform.scale.set(1e-10, 1e-10, 1e-10);
+                        handle.visible = false;
+
+                    }
+
+                }
+
+                if (handle.name === 'XY') {
+
+                    if (Math.abs(_alignVector.copy(_unitZ).applyQuaternion(quaternion).dot(this.eye)) < PLANE_HIDE_TRESHOLD) {
+
+                        handle.transform.scale.set(1e-10, 1e-10, 1e-10);
+                        handle.visible = false;
+
+                    }
+
+                }
+
+                if (handle.name === 'YZ') {
+
+                    if (Math.abs(_alignVector.copy(_unitX).applyQuaternion(quaternion).dot(this.eye)) < PLANE_HIDE_TRESHOLD) {
+
+                        handle.transform.scale.set(1e-10, 1e-10, 1e-10);
+                        handle.visible = false;
+
+                    }
+
+                }
+
+                if (handle.name === 'XZ') {
+
+                    if (Math.abs(_alignVector.copy(_unitY).applyQuaternion(quaternion).dot(this.eye)) < PLANE_HIDE_TRESHOLD) {
+
+                        handle.transform.scale.set(1e-10, 1e-10, 1e-10);
+                        handle.visible = false;
+
+                    }
+
+                }
+
+            } else if (this.mode === 'rotate') {
+
+                // Align handles to current local or world rotation
+
+                _tempQuaternion2.copy(quaternion);
+                _alignVector.copy(this.eye).applyQuaternion(_tempQuaternion.copy(quaternion).invert());
+
+                if (handle.name.search('E') !== -1) {
+
+                    handle.transform.rotation.setFromRotationMatrix(_lookAtMatrix.lookAt(this.eye, _zeroVector, _unitY));
+
+                }
+
+                if (handle.name === 'X') {
+
+                    _tempQuaternion.setFromAxisAngle(_unitX, Math.atan2(-_alignVector.y, _alignVector.z));
+                    _tempQuaternion.multiplyQuaternions(_tempQuaternion2, _tempQuaternion);
+                    handle.transform.rotation.copy(_tempQuaternion);
+
+                }
+
+                if (handle.name === 'Y') {
+
+                    _tempQuaternion.setFromAxisAngle(_unitY, Math.atan2(_alignVector.x, _alignVector.z));
+                    _tempQuaternion.multiplyQuaternions(_tempQuaternion2, _tempQuaternion);
+                    handle.transform.rotation.copy(_tempQuaternion);
+
+                }
+
+                if (handle.name === 'Z') {
+
+                    _tempQuaternion.setFromAxisAngle(_unitZ, Math.atan2(_alignVector.y, _alignVector.x));
+                    _tempQuaternion.multiplyQuaternions(_tempQuaternion2, _tempQuaternion);
+                    handle.transform.rotation.copy(_tempQuaternion);
+
+                }
+
+            }
+
+            // Hide disabled axes
+            handle.visible = handle.visible && (handle.name.indexOf('X') === -1 || this.showX);
+            handle.visible = handle.visible && (handle.name.indexOf('Y') === -1 || this.showY);
+            handle.visible = handle.visible && (handle.name.indexOf('Z') === -1 || this.showZ);
+            handle.visible = handle.visible && (handle.name.indexOf('E') === -1 || (this.showX && this.showY && this.showZ));
+
+            // highlight selected axis
+            const sg = handle.entity.getComponent(ShadedGeometry);
+
+            sg.material._color = sg.material._color || sg.material.color.clone();
+            sg.material._opacity = sg.material._opacity || sg.material.opacity;
+
+            sg.material.color.copy(sg.material._color);
+            sg.material.opacity = sg.material._opacity;
+
+            if (this.enabled && this.axis) {
+
+                if (handle.name === this.axis) {
+
+                    sg.material.color.setHex(0xffff00);
+                    sg.material.opacity = 1.0;
+
+                } else if (this.axis.split('').some(function (a) {
+
+                    return handle.name === a;
+
+                })) {
+
+                    sg.material.color.setHex(0xffff00);
+                    sg.material.opacity = 1.0;
+
+                }
+
+            }
+
+        }
+
+        super.update();
+    }
+
+}
+
+//
+
+class TransformControlsPlane extends GizmoNode {
+
+    constructor() {
+
+        super();
+
+        this.entity.add(ShadedGeometry.from(new PlaneGeometry(100000, 100000, 2, 2),
+            new MeshBasicMaterial({
+                visible: false,
+                wireframe: true,
+                side: DoubleSide,
+                transparent: true,
+                opacity: 0.1,
+                toneMapped: false
+            })));
+
+        this.isTransformControlsPlane = true;
+
+        this.type = 'TransformControlsPlane';
+
+
+        this.transform.rotation.onChanged.add(console.warn);
+    }
+
+    update() {
+
+        let space = this.space;
+
+        const transform = this.transform;
+
+        transform.position.copy(this.worldPosition);
+
+        if (this.mode === 'scale') space = 'local'; // scale always oriented to local rotation
+
+        _v1.copy(_unitX).applyQuaternion(space === 'local' ? this.worldQuaternion : _identityQuaternion);
+        _v2.copy(_unitY).applyQuaternion(space === 'local' ? this.worldQuaternion : _identityQuaternion);
+        _v3.copy(_unitZ).applyQuaternion(space === 'local' ? this.worldQuaternion : _identityQuaternion);
+
+        // Align the plane for current transform mode, axis and space.
+
+        _alignVector.copy(_v2);
+
+        switch (this.mode) {
+
+            case 'translate':
+            case 'scale':
+                switch (this.axis) {
+
+                    case 'X':
+                        _alignVector.copy(this.eye).cross(_v1);
+                        _dirVector.copy(_v1).cross(_alignVector);
+                        break;
+                    case 'Y':
+                        _alignVector.copy(this.eye).cross(_v2);
+                        _dirVector.copy(_v2).cross(_alignVector);
+                        break;
+                    case 'Z':
+                        _alignVector.copy(this.eye).cross(_v3);
+                        _dirVector.copy(_v3).cross(_alignVector);
+                        break;
+                    case 'XY':
+                        _dirVector.copy(_v3);
+                        break;
+                    case 'YZ':
+                        _dirVector.copy(_v1);
+                        break;
+                    case 'XZ':
+                        _alignVector.copy(_v3);
+                        _dirVector.copy(_v2);
+                        break;
+                    case 'XYZ':
+                    case 'E':
+                        _dirVector.set(0, 0, 0);
+                        break;
+
+                }
+
+                break;
+            case 'rotate':
+            default:
+                // special case for rotate
+                _dirVector.set(0, 0, 0);
+
+        }
+
+        if (_dirVector.length() === 0) {
+
+            // If in rotate mode, make the plane parallel to camera
+            transform.rotation.copy(this.cameraQuaternion);
+
+        } else {
+
+            _tempMatrix.lookAt(_tempVector.set(0, 0, 0), _dirVector, _alignVector);
+
+            transform.rotation.setFromRotationMatrix(_tempMatrix);
+
+        }
+
+        super.update();
+    }
+
+}
+
+export { TransformControls, TransformControlsGizmo, TransformControlsPlane };