@needle-tools/engine 3.28.6-beta → 3.28.7-beta.1

package/src/engine/engine_gizmos.ts

@@ -1,322 +1,322 @@
-import { BufferAttribute, Line, BoxGeometry, EdgesGeometry, Color, LineSegments, LineBasicMaterial, Object3D, Mesh, SphereGeometry, type ColorRepresentation, Vector3, Box3, Quaternion, CylinderGeometry, AxesHelper } from 'three';
-import { Context } from './engine_setup.js';
-import { getWorldPosition, lookAtObject, setWorldPositionXYZ } from './engine_three_utils.js';
-import type { Vec3, Vec4 } from './engine_types.js';
-import ThreeMeshUI, { Inline, Text } from "three-mesh-ui"
-import { getParam } from './engine_utils.js';
-import { type Options } from 'three-mesh-ui/build/types/core/elements/MeshUIBaseElement.js';
-
-const _tmp = new Vector3();
-const _tmp2 = new Vector3();
-const _quat = new Quaternion();
-
-const debug = getParam("debuggizmos");
-const defaultColor: ColorRepresentation = 0x888888;
-
-export type LabelHandle = {
-    setText(str: string);
-}
-declare type ColorWithAlpha = Color & { a: number };
-
-export class Gizmos {
-
-    /**
-     * Draw a label in the scene or attached to an object (if a parent is provided)
-     * @returns a handle to the label that can be used to change the text
-     */
-    static DrawLabel(position: Vec3, text: string, size: number = .1, duration: number = 9999, color?: ColorRepresentation, backgroundColor?: ColorRepresentation | ColorWithAlpha, parent?: Object3D,) {
-        if (!color) color = defaultColor;
-        const element = Internal.getTextLabel(duration, text, size, color, backgroundColor);
-        if (parent instanceof Object3D) parent.add(element);
-        element.position.x = position.x;
-        element.position.y = position.y;
-        element.position.z = position.z;
-        return element as LabelHandle;
-    }
-
-    static DrawRay(origin: Vec3, dir: Vec3, color: ColorRepresentation = defaultColor, duration: number = 0, depthTest: boolean = true) {
-        const obj = Internal.getLine(duration);
-        const positions = obj.geometry.getAttribute("position");
-        positions.setXYZ(0, origin.x, origin.y, origin.z);
-        _tmp.set(dir.x, dir.y, dir.z).multiplyScalar(999999999);
-        positions.setXYZ(1, origin.x + _tmp.x, origin.y + _tmp.y, origin.z + _tmp.z);
-        positions.needsUpdate = true;
-        obj.material["color"].set(color);
-        obj.material["depthTest"] = depthTest;
-        obj.material["depthWrite"] = false;
-    }
-
-    static DrawDirection(pt: Vec3, direction: Vec3 | Vec4, color: ColorRepresentation = defaultColor, duration: number = 0, depthTest: boolean = true, lengthFactor: number = 1) {
-        const obj = Internal.getLine(duration);
-        const positions = obj.geometry.getAttribute("position");
-        positions.setXYZ(0, pt.x, pt.y, pt.z);
-        if (direction["w"] !== undefined) {
-            _tmp.set(0, 0, -lengthFactor);
-            _quat.set(direction["x"], direction["y"], direction["z"], direction["w"]);
-            _tmp.applyQuaternion(_quat);
-        }
-        else {
-            _tmp.set(direction.x, direction.y, direction.z);
-            _tmp.multiplyScalar(lengthFactor);
-        }
-        positions.setXYZ(1, pt.x + _tmp.x, pt.y + _tmp.y, pt.z + _tmp.z);
-        positions.needsUpdate = true;
-        obj.material["color"].set(color);
-        obj.material["depthTest"] = depthTest;
-        obj.material["depthWrite"] = false;
-
-    }
-
-    static DrawLine(pt0: Vec3, pt1: Vec3, color: ColorRepresentation = defaultColor, duration: number = 0, depthTest: boolean = true) {
-        const obj = Internal.getLine(duration);
-
-        const positions = obj.geometry.getAttribute("position");
-        positions.setXYZ(0, pt0.x, pt0.y, pt0.z);
-        positions.setXYZ(1, pt1.x, pt1.y, pt1.z);
-        positions.needsUpdate = true;
-        obj.material["color"].set(color);
-        obj.material["depthTest"] = depthTest;
-        obj.material["depthWrite"] = false;
-    }
-
-    static DrawWireSphere(center: Vec3, radius: number, color: ColorRepresentation = defaultColor, duration: number = 0, depthTest: boolean = true) {
-        const obj = Internal.getSphere(radius, duration, true);
-        setWorldPositionXYZ(obj, center.x, center.y, center.z);
-        obj.material["color"].set(color);
-        obj.material["depthTest"] = depthTest;
-        obj.material["depthWrite"] = false;
-    }
-
-    static DrawSphere(center: Vec3, radius: number, color: ColorRepresentation = defaultColor, duration: number = 0, depthTest: boolean = true) {
-        const obj = Internal.getSphere(radius, duration, false);
-        setWorldPositionXYZ(obj, center.x, center.y, center.z);
-        obj.material["color"].set(color);
-        obj.material["depthTest"] = depthTest;
-        obj.material["depthWrite"] = false;
-    }
-
-    static DrawWireBox(center: Vec3, size: Vec3, color: ColorRepresentation = defaultColor, duration: number = 0, depthTest: boolean = true) {
-        const obj = Internal.getBox(duration);
-        obj.position.set(center.x, center.y, center.z);
-        obj.scale.set(size.x, size.y, size.z);
-        obj.material["color"].set(color);
-        obj.material["depthTest"] = depthTest;
-        obj.material["wireframe"] = true;
-        obj.material["depthWrite"] = false;
-    }
-
-    static DrawWireBox3(box: Box3, color: ColorRepresentation = defaultColor, duration: number = 0, depthTest: boolean = true) {
-        const obj = Internal.getBox(duration);
-        obj.position.copy(box.getCenter(_tmp));
-        obj.scale.copy(box.getSize(_tmp));
-        obj.material["color"].set(color);
-        obj.material["depthTest"] = depthTest;
-        obj.material["wireframe"] = true;
-        obj.material["depthWrite"] = false;
-    }
-
-    private static _up = new Vector3(0, 1, 0);
-    static DrawArrow(pt0: Vec3, pt1: Vec3, color: ColorRepresentation = defaultColor, duration: number = 0, depthTest: boolean = true, wireframe: boolean = false) {
-        const obj = Internal.getArrowHead(duration);
-        obj.position.set(pt1.x, pt1.y, pt1.z);
-        obj.quaternion.setFromUnitVectors(this._up.set(0, 1, 0), _tmp.set(pt1.x, pt1.y, pt1.z).sub(_tmp2.set(pt0.x, pt0.y, pt0.z)).normalize());
-        const dist = _tmp.set(pt1.x, pt1.y, pt1.z).sub(_tmp2.set(pt0.x, pt0.y, pt0.z)).length();
-        const scale = dist * 0.1;
-        obj.scale.set(scale, scale, scale);
-        obj.material["color"].set(color);
-        obj.material["depthTest"] = depthTest;
-        obj.material["wireframe"] = wireframe;
-        this.DrawLine(pt0, pt1, color, duration, depthTest);
-    }
-}
-
-const box: BoxGeometry = new BoxGeometry(1, 1, 1);
-export function CreateWireCube(col: ColorRepresentation | null = null): LineSegments {
-    const color = new Color(col ?? 0xdddddd);
-    // const material = new MeshBasicMaterial();
-    // material.color = new Color(col ?? 0xdddddd);
-    // material.wireframe = true;
-    // const box = new Mesh(box, material);
-    // box.name = "BOX_GIZMO";
-    const edges = new EdgesGeometry(box);
-    const line = new LineSegments(edges, new LineBasicMaterial({ color: color }));
-    return line;
-}
-
-
-
-const $cacheSymbol = Symbol("GizmoCache");
-class Internal {
-    // private static createdLines: number = 0;
-
-    private static readonly familyName = "needle-gizmos";
-    private static ensureFont() {
-        let fontFamily = ThreeMeshUI.FontLibrary.getFontFamily(this.familyName);
-
-        if (!fontFamily) {
-            fontFamily = ThreeMeshUI.FontLibrary.addFontFamily(this.familyName);
-            const variant = fontFamily.addVariant("normal", "normal", "./include/needle/arial-msdf.json", "./include/needle/arial.png") as any as ThreeMeshUI.FontVariant;
-            variant?.addEventListener('ready', () => {
-                ThreeMeshUI.update();
-            });
-        }
-    }
-
-    static getTextLabel(duration: number, text: string, size: number, color: ColorRepresentation, backgroundColor?: ColorRepresentation | ColorWithAlpha): Text & LabelHandle {
-        this.ensureFont();
-        let element = this.textLabelCache.pop();
-
-        let opacity = 1;
-        if (backgroundColor && typeof backgroundColor === "string" && backgroundColor?.length >= 8 && backgroundColor.startsWith("#")) {
-            opacity = parseInt(backgroundColor.substring(7), 16) / 255;
-            backgroundColor = backgroundColor.substring(0, 7);
-            if (debug)
-                console.log(backgroundColor, opacity);
-        }
-        else if (typeof backgroundColor === "object" && backgroundColor["a"] !== undefined) {
-            opacity = backgroundColor["a"]
-        }
-
-        const props: Options = {
-            boxSizing: 'border-box',
-            fontFamily: this.familyName,
-            width: "auto",
-            fontSize: size,
-            color: color,
-            lineHeight: .75,
-            backgroundColor: backgroundColor ?? undefined,
-            backgroundOpacity: opacity,
-            textContent: text,
-            borderRadius: 1 * size,
-            padding: 1 * size,
-        };
-
-        if (!element) {
-            element = new Text(props);
-            const global = this;
-            const labelHandle = element as LabelHandle & Text;
-            labelHandle.setText = function (str: string) {
-                this.set({ textContent: str, whiteSpace: 'pre' });
-                global.tmuiNeedsUpdate = true;
-            };
-        }
-        else {
-            element.set(props);
-            // const handle = element as any as LabelHandle;
-            // handle.setText(text);
-        }
-        this.tmuiNeedsUpdate = true;
-        element.layers.disableAll();
-        element.layers.enable(2);
-        this.registerTimedObject(Context.Current, element, duration, this.textLabelCache);
-        return element as Text & LabelHandle;
-    }
-
-    static getBox(duration: number): Mesh {
-        let box = this.boxesCache.pop();
-        if (!box) {
-            const geo: BoxGeometry = new BoxGeometry(1, 1, 1);
-            box = new Mesh(geo);
-        }
-        this.registerTimedObject(Context.Current, box, duration, this.boxesCache);
-        return box;
-    }
-
-    static getLine(duration: number): Line {
-        let line = this.linesCache.pop();
-        if (!line) {
-            line = new Line();
-            let positions = line.geometry.getAttribute("position");
-            if (!positions) {
-                positions = new BufferAttribute(new Float32Array(2 * 3), 3);
-                line.geometry.setAttribute("position", positions);
-            }
-        }
-        this.registerTimedObject(Context.Current, line, duration, this.linesCache);
-        return line;
-    }
-
-    static getSphere(radius: number, duration: number, wireframe: boolean): Mesh {
-        let sphere = this.spheresCache.pop();
-        if (!sphere) {
-            sphere = new Mesh(new SphereGeometry(1, 8, 8));
-        }
-        sphere.scale.set(radius, radius, radius);
-        sphere.material["wireframe"] = wireframe;
-        this.registerTimedObject(Context.Current, sphere, duration, this.spheresCache);
-        return sphere;
-    }
-
-    static getArrowHead(duration: number): Mesh {
-        let arrowHead = this.arrowHeadsCache.pop();
-        if (!arrowHead) {
-            arrowHead = new Mesh(new CylinderGeometry(0, .5, 1, 8));
-        }
-        this.registerTimedObject(Context.Current, arrowHead, duration, this.arrowHeadsCache);
-        return arrowHead;
-    }
-
-    private static linesCache: Array<Line> = [];
-    private static spheresCache: Mesh[] = [];
-    private static boxesCache: Mesh[] = [];
-    private static arrowHeadsCache: Mesh[] = [];
-    private static textLabelCache: Array<Text> = [];
-
-    private static registerTimedObject(context: Context, object: Object3D, duration: number, cache: Array<Object3D>) {
-        if (!this.contextPostRenderCallbacks.get(context)) {
-            const cb = () => { this.onPostRender(context, this.timedObjectsBuffer, this.timesBuffer) };
-            this.contextPostRenderCallbacks.set(context, cb);
-            context.post_render_callbacks.push(cb);
-        }
-        if (!this.contextBeforeRenderCallbacks.get(context)) {
-            const cb = () => { this.onBeforeRender(context, this.timedObjectsBuffer) };
-            this.contextBeforeRenderCallbacks.set(context, cb);
-            context.pre_render_callbacks.push(cb);
-        }
-        object.renderOrder = 999999;
-        object.layers.disableAll();
-        object.layers.enable(2);
-        object[$cacheSymbol] = cache;
-        this.timedObjectsBuffer.push(object);
-        this.timesBuffer.push(Context.Current.time.time + duration);
-        context.scene.add(object);
-    }
-
-
-    private static timedObjectsBuffer = new Array<Object3D>();
-    private static timesBuffer = new Array<number>();
-    private static contextPostRenderCallbacks = new Map<Context, () => void>();
-    private static contextBeforeRenderCallbacks = new Map<Context, () => void>();
-    private static tmuiNeedsUpdate = false;
-
-    private static onBeforeRender(ctx: Context, objects: Array<Object3D>) {
-        // const cameraWorldPosition = getWorldPosition(ctx.mainCamera!, _tmp);
-        if (this.tmuiNeedsUpdate) {
-            ThreeMeshUI.update();
-        }
-        for (let i = 0; i < objects.length; i++) {
-            const obj = objects[i];
-            if (ctx.mainCamera && obj instanceof ThreeMeshUI.MeshUIBaseElement) {
-                const isInXR = ctx.isInVR;
-                const keepUp = isInXR;
-                const copyRotation = !isInXR;
-                lookAtObject(obj, ctx.mainCamera, keepUp, copyRotation);
-            }
-        }
-    }
-
-    private static onPostRender(ctx: Context, objects: Array<Object3D>, times: Array<number>) {
-        const time = ctx.time.time;
-        for (let i = 0; i < objects.length; i++) {
-            const obj = objects[i];
-            if (time > times[i]) {
-                const cache = obj[$cacheSymbol];
-                cache.push(obj);
-                obj.removeFromParent();
-                objects.splice(i, 1);
-                times.splice(i, 1);
-            }
-        }
-    }
-
+import { BufferAttribute, Line, BoxGeometry, EdgesGeometry, Color, LineSegments, LineBasicMaterial, Object3D, Mesh, SphereGeometry, type ColorRepresentation, Vector3, Box3, Quaternion, CylinderGeometry, AxesHelper } from 'three';
+import { Context } from './engine_setup.js';
+import { getWorldPosition, lookAtObject, setWorldPositionXYZ } from './engine_three_utils.js';
+import type { Vec3, Vec4 } from './engine_types.js';
+import ThreeMeshUI, { Inline, Text } from "three-mesh-ui"
+import { getParam } from './engine_utils.js';
+import { type Options } from 'three-mesh-ui/build/types/core/elements/MeshUIBaseElement.js';
+
+const _tmp = new Vector3();
+const _tmp2 = new Vector3();
+const _quat = new Quaternion();
+
+const debug = getParam("debuggizmos");
+const defaultColor: ColorRepresentation = 0x888888;
+
+export type LabelHandle = {
+    setText(str: string);
+}
+declare type ColorWithAlpha = Color & { a: number };
+
+export class Gizmos {
+
+    /**
+     * Draw a label in the scene or attached to an object (if a parent is provided)
+     * @returns a handle to the label that can be used to change the text
+     */
+    static DrawLabel(position: Vec3, text: string, size: number = .1, duration: number = 9999, color?: ColorRepresentation, backgroundColor?: ColorRepresentation | ColorWithAlpha, parent?: Object3D,) {
+        if (!color) color = defaultColor;
+        const element = Internal.getTextLabel(duration, text, size, color, backgroundColor);
+        if (parent instanceof Object3D) parent.add(element);
+        element.position.x = position.x;
+        element.position.y = position.y;
+        element.position.z = position.z;
+        return element as LabelHandle;
+    }
+
+    static DrawRay(origin: Vec3, dir: Vec3, color: ColorRepresentation = defaultColor, duration: number = 0, depthTest: boolean = true) {
+        const obj = Internal.getLine(duration);
+        const positions = obj.geometry.getAttribute("position");
+        positions.setXYZ(0, origin.x, origin.y, origin.z);
+        _tmp.set(dir.x, dir.y, dir.z).multiplyScalar(999999999);
+        positions.setXYZ(1, origin.x + _tmp.x, origin.y + _tmp.y, origin.z + _tmp.z);
+        positions.needsUpdate = true;
+        obj.material["color"].set(color);
+        obj.material["depthTest"] = depthTest;
+        obj.material["depthWrite"] = false;
+    }
+
+    static DrawDirection(pt: Vec3, direction: Vec3 | Vec4, color: ColorRepresentation = defaultColor, duration: number = 0, depthTest: boolean = true, lengthFactor: number = 1) {
+        const obj = Internal.getLine(duration);
+        const positions = obj.geometry.getAttribute("position");
+        positions.setXYZ(0, pt.x, pt.y, pt.z);
+        if (direction["w"] !== undefined) {
+            _tmp.set(0, 0, -lengthFactor);
+            _quat.set(direction["x"], direction["y"], direction["z"], direction["w"]);
+            _tmp.applyQuaternion(_quat);
+        }
+        else {
+            _tmp.set(direction.x, direction.y, direction.z);
+            _tmp.multiplyScalar(lengthFactor);
+        }
+        positions.setXYZ(1, pt.x + _tmp.x, pt.y + _tmp.y, pt.z + _tmp.z);
+        positions.needsUpdate = true;
+        obj.material["color"].set(color);
+        obj.material["depthTest"] = depthTest;
+        obj.material["depthWrite"] = false;
+
+    }
+
+    static DrawLine(pt0: Vec3, pt1: Vec3, color: ColorRepresentation = defaultColor, duration: number = 0, depthTest: boolean = true) {
+        const obj = Internal.getLine(duration);
+
+        const positions = obj.geometry.getAttribute("position");
+        positions.setXYZ(0, pt0.x, pt0.y, pt0.z);
+        positions.setXYZ(1, pt1.x, pt1.y, pt1.z);
+        positions.needsUpdate = true;
+        obj.material["color"].set(color);
+        obj.material["depthTest"] = depthTest;
+        obj.material["depthWrite"] = false;
+    }
+
+    static DrawWireSphere(center: Vec3, radius: number, color: ColorRepresentation = defaultColor, duration: number = 0, depthTest: boolean = true) {
+        const obj = Internal.getSphere(radius, duration, true);
+        setWorldPositionXYZ(obj, center.x, center.y, center.z);
+        obj.material["color"].set(color);
+        obj.material["depthTest"] = depthTest;
+        obj.material["depthWrite"] = false;
+    }
+
+    static DrawSphere(center: Vec3, radius: number, color: ColorRepresentation = defaultColor, duration: number = 0, depthTest: boolean = true) {
+        const obj = Internal.getSphere(radius, duration, false);
+        setWorldPositionXYZ(obj, center.x, center.y, center.z);
+        obj.material["color"].set(color);
+        obj.material["depthTest"] = depthTest;
+        obj.material["depthWrite"] = false;
+    }
+
+    static DrawWireBox(center: Vec3, size: Vec3, color: ColorRepresentation = defaultColor, duration: number = 0, depthTest: boolean = true) {
+        const obj = Internal.getBox(duration);
+        obj.position.set(center.x, center.y, center.z);
+        obj.scale.set(size.x, size.y, size.z);
+        obj.material["color"].set(color);
+        obj.material["depthTest"] = depthTest;
+        obj.material["wireframe"] = true;
+        obj.material["depthWrite"] = false;
+    }
+
+    static DrawWireBox3(box: Box3, color: ColorRepresentation = defaultColor, duration: number = 0, depthTest: boolean = true) {
+        const obj = Internal.getBox(duration);
+        obj.position.copy(box.getCenter(_tmp));
+        obj.scale.copy(box.getSize(_tmp));
+        obj.material["color"].set(color);
+        obj.material["depthTest"] = depthTest;
+        obj.material["wireframe"] = true;
+        obj.material["depthWrite"] = false;
+    }
+
+    private static _up = new Vector3(0, 1, 0);
+    static DrawArrow(pt0: Vec3, pt1: Vec3, color: ColorRepresentation = defaultColor, duration: number = 0, depthTest: boolean = true, wireframe: boolean = false) {
+        const obj = Internal.getArrowHead(duration);
+        obj.position.set(pt1.x, pt1.y, pt1.z);
+        obj.quaternion.setFromUnitVectors(this._up.set(0, 1, 0), _tmp.set(pt1.x, pt1.y, pt1.z).sub(_tmp2.set(pt0.x, pt0.y, pt0.z)).normalize());
+        const dist = _tmp.set(pt1.x, pt1.y, pt1.z).sub(_tmp2.set(pt0.x, pt0.y, pt0.z)).length();
+        const scale = dist * 0.1;
+        obj.scale.set(scale, scale, scale);
+        obj.material["color"].set(color);
+        obj.material["depthTest"] = depthTest;
+        obj.material["wireframe"] = wireframe;
+        this.DrawLine(pt0, pt1, color, duration, depthTest);
+    }
+}
+
+const box: BoxGeometry = new BoxGeometry(1, 1, 1);
+export function CreateWireCube(col: ColorRepresentation | null = null): LineSegments {
+    const color = new Color(col ?? 0xdddddd);
+    // const material = new MeshBasicMaterial();
+    // material.color = new Color(col ?? 0xdddddd);
+    // material.wireframe = true;
+    // const box = new Mesh(box, material);
+    // box.name = "BOX_GIZMO";
+    const edges = new EdgesGeometry(box);
+    const line = new LineSegments(edges, new LineBasicMaterial({ color: color }));
+    return line;
+}
+
+
+
+const $cacheSymbol = Symbol("GizmoCache");
+class Internal {
+    // private static createdLines: number = 0;
+
+    private static readonly familyName = "needle-gizmos";
+    private static ensureFont() {
+        let fontFamily = ThreeMeshUI.FontLibrary.getFontFamily(this.familyName);
+
+        if (!fontFamily) {
+            fontFamily = ThreeMeshUI.FontLibrary.addFontFamily(this.familyName);
+            const variant = fontFamily.addVariant("normal", "normal", "./include/needle/arial-msdf.json", "./include/needle/arial.png") as any as ThreeMeshUI.FontVariant;
+            variant?.addEventListener('ready', () => {
+                ThreeMeshUI.update();
+            });
+        }
+    }
+
+    static getTextLabel(duration: number, text: string, size: number, color: ColorRepresentation, backgroundColor?: ColorRepresentation | ColorWithAlpha): Text & LabelHandle {
+        this.ensureFont();
+        let element = this.textLabelCache.pop();
+
+        let opacity = 1;
+        if (backgroundColor && typeof backgroundColor === "string" && backgroundColor?.length >= 8 && backgroundColor.startsWith("#")) {
+            opacity = parseInt(backgroundColor.substring(7), 16) / 255;
+            backgroundColor = backgroundColor.substring(0, 7);
+            if (debug)
+                console.log(backgroundColor, opacity);
+        }
+        else if (typeof backgroundColor === "object" && backgroundColor["a"] !== undefined) {
+            opacity = backgroundColor["a"]
+        }
+
+        const props: Options = {
+            boxSizing: 'border-box',
+            fontFamily: this.familyName,
+            width: "auto",
+            fontSize: size,
+            color: color,
+            lineHeight: .75,
+            backgroundColor: backgroundColor ?? undefined,
+            backgroundOpacity: opacity,
+            textContent: text,
+            borderRadius: 1 * size,
+            padding: 1 * size,
+        };
+
+        if (!element) {
+            element = new Text(props);
+            const global = this;
+            const labelHandle = element as LabelHandle & Text;
+            labelHandle.setText = function (str: string) {
+                this.set({ textContent: str, whiteSpace: 'pre' });
+                global.tmuiNeedsUpdate = true;
+            };
+        }
+        else {
+            element.set(props);
+            // const handle = element as any as LabelHandle;
+            // handle.setText(text);
+        }
+        this.tmuiNeedsUpdate = true;
+        element.layers.disableAll();
+        element.layers.enable(2);
+        this.registerTimedObject(Context.Current, element, duration, this.textLabelCache);
+        return element as Text & LabelHandle;
+    }
+
+    static getBox(duration: number): Mesh {
+        let box = this.boxesCache.pop();
+        if (!box) {
+            const geo: BoxGeometry = new BoxGeometry(1, 1, 1);
+            box = new Mesh(geo);
+        }
+        this.registerTimedObject(Context.Current, box, duration, this.boxesCache);
+        return box;
+    }
+
+    static getLine(duration: number): Line {
+        let line = this.linesCache.pop();
+        if (!line) {
+            line = new Line();
+            let positions = line.geometry.getAttribute("position");
+            if (!positions) {
+                positions = new BufferAttribute(new Float32Array(2 * 3), 3);
+                line.geometry.setAttribute("position", positions);
+            }
+        }
+        this.registerTimedObject(Context.Current, line, duration, this.linesCache);
+        return line;
+    }
+
+    static getSphere(radius: number, duration: number, wireframe: boolean): Mesh {
+        let sphere = this.spheresCache.pop();
+        if (!sphere) {
+            sphere = new Mesh(new SphereGeometry(1, 8, 8));
+        }
+        sphere.scale.set(radius, radius, radius);
+        sphere.material["wireframe"] = wireframe;
+        this.registerTimedObject(Context.Current, sphere, duration, this.spheresCache);
+        return sphere;
+    }
+
+    static getArrowHead(duration: number): Mesh {
+        let arrowHead = this.arrowHeadsCache.pop();
+        if (!arrowHead) {
+            arrowHead = new Mesh(new CylinderGeometry(0, .5, 1, 8));
+        }
+        this.registerTimedObject(Context.Current, arrowHead, duration, this.arrowHeadsCache);
+        return arrowHead;
+    }
+
+    private static linesCache: Array<Line> = [];
+    private static spheresCache: Mesh[] = [];
+    private static boxesCache: Mesh[] = [];
+    private static arrowHeadsCache: Mesh[] = [];
+    private static textLabelCache: Array<Text> = [];
+
+    private static registerTimedObject(context: Context, object: Object3D, duration: number, cache: Array<Object3D>) {
+        if (!this.contextPostRenderCallbacks.get(context)) {
+            const cb = () => { this.onPostRender(context, this.timedObjectsBuffer, this.timesBuffer) };
+            this.contextPostRenderCallbacks.set(context, cb);
+            context.post_render_callbacks.push(cb);
+        }
+        if (!this.contextBeforeRenderCallbacks.get(context)) {
+            const cb = () => { this.onBeforeRender(context, this.timedObjectsBuffer) };
+            this.contextBeforeRenderCallbacks.set(context, cb);
+            context.pre_render_callbacks.push(cb);
+        }
+        object.renderOrder = 999999;
+        object.layers.disableAll();
+        object.layers.enable(2);
+        object[$cacheSymbol] = cache;
+        this.timedObjectsBuffer.push(object);
+        this.timesBuffer.push(Context.Current.time.time + duration);
+        context.scene.add(object);
+    }
+
+
+    private static timedObjectsBuffer = new Array<Object3D>();
+    private static timesBuffer = new Array<number>();
+    private static contextPostRenderCallbacks = new Map<Context, () => void>();
+    private static contextBeforeRenderCallbacks = new Map<Context, () => void>();
+    private static tmuiNeedsUpdate = false;
+
+    private static onBeforeRender(ctx: Context, objects: Array<Object3D>) {
+        // const cameraWorldPosition = getWorldPosition(ctx.mainCamera!, _tmp);
+        if (this.tmuiNeedsUpdate) {
+            ThreeMeshUI.update();
+        }
+        for (let i = 0; i < objects.length; i++) {
+            const obj = objects[i];
+            if (ctx.mainCamera && obj instanceof ThreeMeshUI.MeshUIBaseElement) {
+                const isInXR = ctx.isInVR;
+                const keepUp = isInXR;
+                const copyRotation = !isInXR;
+                lookAtObject(obj, ctx.mainCamera, keepUp, copyRotation);
+            }
+        }
+    }
+
+    private static onPostRender(ctx: Context, objects: Array<Object3D>, times: Array<number>) {
+        const time = ctx.time.time;
+        for (let i = 0; i < objects.length; i++) {
+            const obj = objects[i];
+            if (time > times[i]) {
+                const cache = obj[$cacheSymbol];
+                cache.push(obj);
+                obj.removeFromParent();
+                objects.splice(i, 1);
+                times.splice(i, 1);
+            }
+        }
+    }
+
 }