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

package/lib/engine-components/SpriteRenderer.d.ts

@@ -1,48 +1,48 @@
-import { Behaviour } from "./Component.js";
-import * as THREE from "three";
-import { RGBAColor } from "./js-extensions/RGBAColor.js";
-export declare enum SpriteDrawMode {
-    Simple = 0,
-    Sliced = 1,
-    Tiled = 2
-}
-declare class Vec2 {
-    x: number;
-    y: number;
-}
-export declare class Sprite {
-    guid?: string;
-    texture?: THREE.Texture;
-    triangles: Array<number>;
-    uv: Array<Vec2>;
-    vertices: Array<Vec2>;
-    _geometry?: THREE.BufferGeometry;
-}
-export declare class SpriteSheet {
-    sprites: Sprite[];
-}
-export declare class SpriteData {
-    spriteSheet?: SpriteSheet;
-    index: number;
-    update(): void;
-}
-export declare class SpriteRenderer extends Behaviour {
-    drawMode: SpriteDrawMode;
-    size: Vec2;
-    color?: RGBAColor;
-    sharedMaterial?: THREE.Material;
-    get sprite(): SpriteData | undefined;
-    set sprite(value: SpriteData | undefined | number);
-    set spriteIndex(value: number);
-    get spriteIndex(): number;
-    get spriteFrames(): number;
-    private _spriteSheet?;
-    private _currentSprite?;
-    transparent: boolean;
-    cutoutThreshold: number;
-    castShadows: boolean;
-    awake(): void;
-    start(): void;
-    private updateSprite;
-}
-export {};
+import { Behaviour } from "./Component.js";
+import * as THREE from "three";
+import { RGBAColor } from "./js-extensions/RGBAColor.js";
+export declare enum SpriteDrawMode {
+    Simple = 0,
+    Sliced = 1,
+    Tiled = 2
+}
+declare class Vec2 {
+    x: number;
+    y: number;
+}
+export declare class Sprite {
+    guid?: string;
+    texture?: THREE.Texture;
+    triangles: Array<number>;
+    uv: Array<Vec2>;
+    vertices: Array<Vec2>;
+    _geometry?: THREE.BufferGeometry;
+}
+export declare class SpriteSheet {
+    sprites: Sprite[];
+}
+export declare class SpriteData {
+    spriteSheet?: SpriteSheet;
+    index: number;
+    update(): void;
+}
+export declare class SpriteRenderer extends Behaviour {
+    drawMode: SpriteDrawMode;
+    size: Vec2;
+    color?: RGBAColor;
+    sharedMaterial?: THREE.Material;
+    get sprite(): SpriteData | undefined;
+    set sprite(value: SpriteData | undefined | number);
+    set spriteIndex(value: number);
+    get spriteIndex(): number;
+    get spriteFrames(): number;
+    private _spriteSheet?;
+    private _currentSprite?;
+    transparent: boolean;
+    cutoutThreshold: number;
+    castShadows: boolean;
+    awake(): void;
+    start(): void;
+    private updateSprite;
+}
+export {};

package/lib/engine-components/SpriteRenderer.js

@@ -1,258 +1,258 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-import { Behaviour } from "./Component.js";
-import * as THREE from "three";
-import { serializable, serializeable } from "../engine/engine_serialization_decorator.js";
-import { Material, NearestFilter, Texture } from "three";
-import { RGBAColor } from "./js-extensions/RGBAColor.js";
-import { getParam } from "../engine/engine_utils.js";
-const debug = getParam("debugspriterenderer");
-const showWireframe = getParam("wireframe");
-class SpriteUtils {
-    static cache = {};
-    static getOrCreateGeometry(sprite) {
-        if (sprite._geometry)
-            return sprite._geometry;
-        if (sprite.guid) {
-            if (SpriteUtils.cache[sprite.guid]) {
-                if (debug)
-                    console.log("Take cached geometry for sprite", sprite.guid);
-                return SpriteUtils.cache[sprite.guid];
-            }
-        }
-        const geo = new THREE.BufferGeometry();
-        sprite._geometry = geo;
-        const vertices = new Float32Array(sprite.triangles.length * 3);
-        const uvs = new Float32Array(sprite.triangles.length * 2);
-        for (let i = 0; i < sprite.triangles.length; i += 1) {
-            const index = sprite.triangles[i];
-            vertices[i * 3] = -sprite.vertices[index].x;
-            vertices[i * 3 + 1] = sprite.vertices[index].y;
-            vertices[i * 3 + 2] = 0;
-            const uv = sprite.uv[index];
-            uvs[i * 2] = uv.x;
-            uvs[i * 2 + 1] = 1 - uv.y;
-        }
-        geo.setAttribute("position", new THREE.BufferAttribute(vertices, 3));
-        geo.setAttribute("uv", new THREE.BufferAttribute(uvs, 2));
-        if (sprite.guid)
-            this.cache[sprite.guid] = geo;
-        if (debug)
-            console.log("Built sprite geometry", sprite, geo);
-        return geo;
-    }
-}
-/// <summary>
-///   <para>SpriteRenderer draw mode.</para>
-/// </summary>
-export var SpriteDrawMode;
-(function (SpriteDrawMode) {
-    /// <summary>
-    ///   <para>Displays the full sprite.</para>
-    /// </summary>
-    SpriteDrawMode[SpriteDrawMode["Simple"] = 0] = "Simple";
-    /// <summary>
-    ///   <para>The SpriteRenderer will render the sprite as a 9-slice image where the corners will remain constant and the other sections will scale.</para>
-    /// </summary>
-    SpriteDrawMode[SpriteDrawMode["Sliced"] = 1] = "Sliced";
-    /// <summary>
-    ///   <para>The SpriteRenderer will render the sprite as a 9-slice image where the corners will remain constant and the other sections will tile.</para>
-    /// </summary>
-    SpriteDrawMode[SpriteDrawMode["Tiled"] = 2] = "Tiled";
-})(SpriteDrawMode || (SpriteDrawMode = {}));
-class Vec2 {
-    x;
-    y;
-}
-export class Sprite {
-    guid;
-    texture;
-    triangles;
-    uv;
-    vertices;
-    _geometry;
-}
-__decorate([
-    serializable()
-], Sprite.prototype, "guid", void 0);
-__decorate([
-    serializable(Texture)
-], Sprite.prototype, "texture", void 0);
-__decorate([
-    serializeable()
-], Sprite.prototype, "triangles", void 0);
-__decorate([
-    serializeable()
-], Sprite.prototype, "uv", void 0);
-__decorate([
-    serializeable()
-], Sprite.prototype, "vertices", void 0);
-const $spriteTexOwner = Symbol("spriteOwner");
-export class SpriteSheet {
-    sprites;
-}
-__decorate([
-    serializable(Sprite)
-], SpriteSheet.prototype, "sprites", void 0);
-export class SpriteData {
-    spriteSheet;
-    index = 0;
-    update() {
-        if (!this.spriteSheet)
-            return;
-        const index = this.index;
-        if (index < 0 || index >= this.spriteSheet.sprites.length)
-            return;
-        const slice = this.spriteSheet.sprites[index];
-        const tex = slice?.texture;
-        if (!tex)
-            return;
-        tex.colorSpace = THREE.SRGBColorSpace;
-        if (tex.minFilter == NearestFilter && tex.magFilter == NearestFilter)
-            tex.anisotropy = 1;
-        tex.needsUpdate = true;
-    }
-}
-__decorate([
-    serializable(SpriteSheet)
-], SpriteData.prototype, "spriteSheet", void 0);
-__decorate([
-    serializable()
-], SpriteData.prototype, "index", void 0);
-export class SpriteRenderer extends Behaviour {
-    drawMode = SpriteDrawMode.Simple;
-    size = { x: 1, y: 1 };
-    color;
-    sharedMaterial;
-    get sprite() {
-        return this._spriteSheet;
-    }
-    set sprite(value) {
-        if (value === this._spriteSheet)
-            return;
-        if (typeof value === "number") {
-            const index = Math.floor(value);
-            if (index === value)
-                this.spriteIndex = index;
-            return;
-        }
-        else {
-            this._spriteSheet = value;
-            this.updateSprite();
-        }
-    }
-    set spriteIndex(value) {
-        if (!this._spriteSheet)
-            return;
-        this._spriteSheet.index = value;
-        this.updateSprite();
-    }
-    get spriteIndex() {
-        return this._spriteSheet?.index ?? 0;
-    }
-    get spriteFrames() {
-        return this._spriteSheet?.spriteSheet?.sprites.length ?? 0;
-    }
-    _spriteSheet;
-    _currentSprite;
-    // additional data
-    transparent = true;
-    cutoutThreshold = 0;
-    castShadows = false;
-    awake() {
-        this._currentSprite = undefined;
-        if (debug) {
-            console.log("Awake", this.name, this, this.sprite);
-        }
-    }
-    start() {
-        if (!this._currentSprite)
-            this.updateSprite();
-        else if (this.gameObject)
-            this.gameObject.add(this._currentSprite);
-    }
-    updateSprite() {
-        if (!this.__didAwake)
-            return;
-        if (!this.sprite?.spriteSheet?.sprites)
-            return;
-        const sprite = this.sprite.spriteSheet.sprites[this.spriteIndex];
-        if (!sprite) {
-            if (debug)
-                console.warn("Sprite not found", this.spriteIndex, this.sprite.spriteSheet.sprites);
-            return;
-        }
-        if (!this._currentSprite) {
-            const mat = new THREE.MeshBasicMaterial({ color: 0xffffff, side: THREE.DoubleSide });
-            if (!mat)
-                return;
-            if (showWireframe)
-                mat.wireframe = true;
-            if (this.color) {
-                if (!mat["color"])
-                    mat["color"] = new THREE.Color();
-                mat["color"].copy(this.color);
-                mat["opacity"] = this.color.alpha;
-            }
-            mat.transparent = true;
-            if (sprite.texture && !mat.wireframe) {
-                let tex = sprite.texture;
-                // the sprite renderer modifies the textue offset 
-                // so we need to clone the texture 
-                // if the same texture is used multiple times
-                if (tex[$spriteTexOwner] !== undefined && tex[$spriteTexOwner] !== this && this.spriteFrames > 1) {
-                    tex = sprite.texture = tex.clone();
-                }
-                tex[$spriteTexOwner] = this;
-                mat["map"] = tex;
-            }
-            this.sharedMaterial = mat;
-            this._currentSprite = new THREE.Mesh(SpriteUtils.getOrCreateGeometry(sprite), mat);
-        }
-        else {
-            this._currentSprite.geometry = SpriteUtils.getOrCreateGeometry(sprite);
-            this._currentSprite.material["map"] = sprite.texture;
-        }
-        if (this._currentSprite.parent !== this.gameObject) {
-            if (this.drawMode === SpriteDrawMode.Tiled)
-                this._currentSprite.scale.set(this.size.x, this.size.y, 1);
-            if (this.gameObject)
-                this.gameObject.add(this._currentSprite);
-        }
-        if (this._currentSprite) {
-            this._currentSprite.layers.set(this.layer);
-        }
-        if (this.sharedMaterial) {
-            this.sharedMaterial.alphaTest = this.cutoutThreshold;
-            this.sharedMaterial.transparent = this.transparent;
-        }
-        this._currentSprite.castShadow = this.castShadows;
-        this._spriteSheet?.update();
-    }
-}
-__decorate([
-    serializable()
-], SpriteRenderer.prototype, "drawMode", void 0);
-__decorate([
-    serializable(RGBAColor)
-], SpriteRenderer.prototype, "color", void 0);
-__decorate([
-    serializable(Material)
-], SpriteRenderer.prototype, "sharedMaterial", void 0);
-__decorate([
-    serializable(SpriteData)
-], SpriteRenderer.prototype, "sprite", null);
-__decorate([
-    serializable()
-], SpriteRenderer.prototype, "transparent", void 0);
-__decorate([
-    serializable()
-], SpriteRenderer.prototype, "cutoutThreshold", void 0);
-__decorate([
-    serializable()
-], SpriteRenderer.prototype, "castShadows", void 0);
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Behaviour } from "./Component.js";
+import * as THREE from "three";
+import { serializable, serializeable } from "../engine/engine_serialization_decorator.js";
+import { Material, NearestFilter, Texture } from "three";
+import { RGBAColor } from "./js-extensions/RGBAColor.js";
+import { getParam } from "../engine/engine_utils.js";
+const debug = getParam("debugspriterenderer");
+const showWireframe = getParam("wireframe");
+class SpriteUtils {
+    static cache = {};
+    static getOrCreateGeometry(sprite) {
+        if (sprite._geometry)
+            return sprite._geometry;
+        if (sprite.guid) {
+            if (SpriteUtils.cache[sprite.guid]) {
+                if (debug)
+                    console.log("Take cached geometry for sprite", sprite.guid);
+                return SpriteUtils.cache[sprite.guid];
+            }
+        }
+        const geo = new THREE.BufferGeometry();
+        sprite._geometry = geo;
+        const vertices = new Float32Array(sprite.triangles.length * 3);
+        const uvs = new Float32Array(sprite.triangles.length * 2);
+        for (let i = 0; i < sprite.triangles.length; i += 1) {
+            const index = sprite.triangles[i];
+            vertices[i * 3] = -sprite.vertices[index].x;
+            vertices[i * 3 + 1] = sprite.vertices[index].y;
+            vertices[i * 3 + 2] = 0;
+            const uv = sprite.uv[index];
+            uvs[i * 2] = uv.x;
+            uvs[i * 2 + 1] = 1 - uv.y;
+        }
+        geo.setAttribute("position", new THREE.BufferAttribute(vertices, 3));
+        geo.setAttribute("uv", new THREE.BufferAttribute(uvs, 2));
+        if (sprite.guid)
+            this.cache[sprite.guid] = geo;
+        if (debug)
+            console.log("Built sprite geometry", sprite, geo);
+        return geo;
+    }
+}
+/// <summary>
+///   <para>SpriteRenderer draw mode.</para>
+/// </summary>
+export var SpriteDrawMode;
+(function (SpriteDrawMode) {
+    /// <summary>
+    ///   <para>Displays the full sprite.</para>
+    /// </summary>
+    SpriteDrawMode[SpriteDrawMode["Simple"] = 0] = "Simple";
+    /// <summary>
+    ///   <para>The SpriteRenderer will render the sprite as a 9-slice image where the corners will remain constant and the other sections will scale.</para>
+    /// </summary>
+    SpriteDrawMode[SpriteDrawMode["Sliced"] = 1] = "Sliced";
+    /// <summary>
+    ///   <para>The SpriteRenderer will render the sprite as a 9-slice image where the corners will remain constant and the other sections will tile.</para>
+    /// </summary>
+    SpriteDrawMode[SpriteDrawMode["Tiled"] = 2] = "Tiled";
+})(SpriteDrawMode || (SpriteDrawMode = {}));
+class Vec2 {
+    x;
+    y;
+}
+export class Sprite {
+    guid;
+    texture;
+    triangles;
+    uv;
+    vertices;
+    _geometry;
+}
+__decorate([
+    serializable()
+], Sprite.prototype, "guid", void 0);
+__decorate([
+    serializable(Texture)
+], Sprite.prototype, "texture", void 0);
+__decorate([
+    serializeable()
+], Sprite.prototype, "triangles", void 0);
+__decorate([
+    serializeable()
+], Sprite.prototype, "uv", void 0);
+__decorate([
+    serializeable()
+], Sprite.prototype, "vertices", void 0);
+const $spriteTexOwner = Symbol("spriteOwner");
+export class SpriteSheet {
+    sprites;
+}
+__decorate([
+    serializable(Sprite)
+], SpriteSheet.prototype, "sprites", void 0);
+export class SpriteData {
+    spriteSheet;
+    index = 0;
+    update() {
+        if (!this.spriteSheet)
+            return;
+        const index = this.index;
+        if (index < 0 || index >= this.spriteSheet.sprites.length)
+            return;
+        const slice = this.spriteSheet.sprites[index];
+        const tex = slice?.texture;
+        if (!tex)
+            return;
+        tex.colorSpace = THREE.SRGBColorSpace;
+        if (tex.minFilter == NearestFilter && tex.magFilter == NearestFilter)
+            tex.anisotropy = 1;
+        tex.needsUpdate = true;
+    }
+}
+__decorate([
+    serializable(SpriteSheet)
+], SpriteData.prototype, "spriteSheet", void 0);
+__decorate([
+    serializable()
+], SpriteData.prototype, "index", void 0);
+export class SpriteRenderer extends Behaviour {
+    drawMode = SpriteDrawMode.Simple;
+    size = { x: 1, y: 1 };
+    color;
+    sharedMaterial;
+    get sprite() {
+        return this._spriteSheet;
+    }
+    set sprite(value) {
+        if (value === this._spriteSheet)
+            return;
+        if (typeof value === "number") {
+            const index = Math.floor(value);
+            if (index === value)
+                this.spriteIndex = index;
+            return;
+        }
+        else {
+            this._spriteSheet = value;
+            this.updateSprite();
+        }
+    }
+    set spriteIndex(value) {
+        if (!this._spriteSheet)
+            return;
+        this._spriteSheet.index = value;
+        this.updateSprite();
+    }
+    get spriteIndex() {
+        return this._spriteSheet?.index ?? 0;
+    }
+    get spriteFrames() {
+        return this._spriteSheet?.spriteSheet?.sprites.length ?? 0;
+    }
+    _spriteSheet;
+    _currentSprite;
+    // additional data
+    transparent = true;
+    cutoutThreshold = 0;
+    castShadows = false;
+    awake() {
+        this._currentSprite = undefined;
+        if (debug) {
+            console.log("Awake", this.name, this, this.sprite);
+        }
+    }
+    start() {
+        if (!this._currentSprite)
+            this.updateSprite();
+        else if (this.gameObject)
+            this.gameObject.add(this._currentSprite);
+    }
+    updateSprite() {
+        if (!this.__didAwake)
+            return;
+        if (!this.sprite?.spriteSheet?.sprites)
+            return;
+        const sprite = this.sprite.spriteSheet.sprites[this.spriteIndex];
+        if (!sprite) {
+            if (debug)
+                console.warn("Sprite not found", this.spriteIndex, this.sprite.spriteSheet.sprites);
+            return;
+        }
+        if (!this._currentSprite) {
+            const mat = new THREE.MeshBasicMaterial({ color: 0xffffff, side: THREE.DoubleSide });
+            if (!mat)
+                return;
+            if (showWireframe)
+                mat.wireframe = true;
+            if (this.color) {
+                if (!mat["color"])
+                    mat["color"] = new THREE.Color();
+                mat["color"].copy(this.color);
+                mat["opacity"] = this.color.alpha;
+            }
+            mat.transparent = true;
+            if (sprite.texture && !mat.wireframe) {
+                let tex = sprite.texture;
+                // the sprite renderer modifies the textue offset 
+                // so we need to clone the texture 
+                // if the same texture is used multiple times
+                if (tex[$spriteTexOwner] !== undefined && tex[$spriteTexOwner] !== this && this.spriteFrames > 1) {
+                    tex = sprite.texture = tex.clone();
+                }
+                tex[$spriteTexOwner] = this;
+                mat["map"] = tex;
+            }
+            this.sharedMaterial = mat;
+            this._currentSprite = new THREE.Mesh(SpriteUtils.getOrCreateGeometry(sprite), mat);
+        }
+        else {
+            this._currentSprite.geometry = SpriteUtils.getOrCreateGeometry(sprite);
+            this._currentSprite.material["map"] = sprite.texture;
+        }
+        if (this._currentSprite.parent !== this.gameObject) {
+            if (this.drawMode === SpriteDrawMode.Tiled)
+                this._currentSprite.scale.set(this.size.x, this.size.y, 1);
+            if (this.gameObject)
+                this.gameObject.add(this._currentSprite);
+        }
+        if (this._currentSprite) {
+            this._currentSprite.layers.set(this.layer);
+        }
+        if (this.sharedMaterial) {
+            this.sharedMaterial.alphaTest = this.cutoutThreshold;
+            this.sharedMaterial.transparent = this.transparent;
+        }
+        this._currentSprite.castShadow = this.castShadows;
+        this._spriteSheet?.update();
+    }
+}
+__decorate([
+    serializable()
+], SpriteRenderer.prototype, "drawMode", void 0);
+__decorate([
+    serializable(RGBAColor)
+], SpriteRenderer.prototype, "color", void 0);
+__decorate([
+    serializable(Material)
+], SpriteRenderer.prototype, "sharedMaterial", void 0);
+__decorate([
+    serializable(SpriteData)
+], SpriteRenderer.prototype, "sprite", null);
+__decorate([
+    serializable()
+], SpriteRenderer.prototype, "transparent", void 0);
+__decorate([
+    serializable()
+], SpriteRenderer.prototype, "cutoutThreshold", void 0);
+__decorate([
+    serializable()
+], SpriteRenderer.prototype, "castShadows", void 0);
 //# sourceMappingURL=SpriteRenderer.js.map

package/lib/engine-components/SyncedCamera.d.ts

@@ -1,27 +1,27 @@
-import { Behaviour } from "./Component.js";
-import { AssetReference } from "../engine/engine_addressables.js";
-declare type UserCamInfo = {
-    obj: THREE.Object3D;
-    lastUpdate: number;
-    userId: string;
-};
-export declare class SyncedCamera extends Behaviour {
-    static instances: UserCamInfo[];
-    getCameraObject(userId: string): THREE.Object3D | null;
-    cameraPrefab: THREE.Object3D | null | AssetReference;
-    private _lastWorldPosition;
-    private _lastWorldQuaternion;
-    private _model;
-    private _needsUpdate;
-    private _lastUpdateTime;
-    private remoteCams;
-    private userToCamMap;
-    private _camTimeoutInSeconds;
-    private _receiveCallback;
-    awake(): Promise<void>;
-    onEnable(): void;
-    onDisable(): void;
-    update(): void;
-    private onReceivedRemoteCameraInfoBin;
-}
-export {};
+import { Behaviour } from "./Component.js";
+import { AssetReference } from "../engine/engine_addressables.js";
+declare type UserCamInfo = {
+    obj: THREE.Object3D;
+    lastUpdate: number;
+    userId: string;
+};
+export declare class SyncedCamera extends Behaviour {
+    static instances: UserCamInfo[];
+    getCameraObject(userId: string): THREE.Object3D | null;
+    cameraPrefab: THREE.Object3D | null | AssetReference;
+    private _lastWorldPosition;
+    private _lastWorldQuaternion;
+    private _model;
+    private _needsUpdate;
+    private _lastUpdateTime;
+    private remoteCams;
+    private userToCamMap;
+    private _camTimeoutInSeconds;
+    private _receiveCallback;
+    awake(): Promise<void>;
+    onEnable(): void;
+    onDisable(): void;
+    update(): void;
+    private onReceivedRemoteCameraInfoBin;
+}
+export {};