@needle-tools/engine 2.52.0-pre → 2.53.0-pre

package/CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to this package will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [2.53.0-pre] - 2022-12-08
+- Add: InstantiateIdProvider constructor can now take string too for initializing seed
+- Add: USDZExpoter component enabling ``Open in Quicklook`` option by default when running on iOS Safari
+- Fix: Light intensity
+- Fix: Add workaround texture image encoding issue: https://github.com/needle-tools/needle-engine-support/issues/109
+- Fix: OrbitControls.enableKeys
+- Fix: Remove warning message about missing ``serializable`` when the reference is really missing
+- Fix: ``context.domX`` and ``domY`` using wrong values when in AR mode
+
 ## [2.52.0-pre] - 2022-12-05
 - Add iOS platform util methods
 - Add ``?debugrig`` to render XRRig gizmo

package/dist/needle-engine.d.ts

@@ -426,6 +426,7 @@ declare module "engine/engine_serialization_core" {
         objectToNode?: ObjectToNodeMap;
         context?: Context;
         path?: string;
+        type?: Constructor<any>;
         /** holds information if a field was undefined before serialization. This gives us info if we might want to warn the user about missing attributes */
         implementationInformation?: ImplementationInformation;
         constructor(root: THREE.Object3D);
@@ -704,7 +705,7 @@ declare module "engine/engine_networking_instantiate" {
         set seed(val: number);
         private _originalSeed;
         private _seed;
-        constructor(seed: number);
+        constructor(seed: string | number);
         reset(): void;
         generateUUID(str?: string): any;
         initialize(strOrNumber: string | number): void;
@@ -2378,13 +2379,13 @@ declare module "engine/extensions/NEEDLE_render_objects" {
     }
     export const EXTENSION_NAME = "NEEDLE_render_objects";
 }
-declare module "engine/extensions/NEEDLE_deferred_texture" {
+declare module "engine/extensions/NEEDLE_progressive" {
     import { Material } from "three";
     import { GLTF, GLTFLoaderPlugin, GLTFParser } from "three/examples/jsm/loaders/GLTFLoader";
     import { SourceIdentifier } from "engine/engine_types";
     import { Context } from "engine/engine_setup";
-    export const EXTENSION_NAME = "NEEDLE_deferred_texture";
-    export class NEEDLE_deferred_texture implements GLTFLoaderPlugin {
+    export const EXTENSION_NAME = "NEEDLE_progressive";
+    export class NEEDLE_progressive implements GLTFLoaderPlugin {
         static assignTextureLOD(context: Context, source: SourceIdentifier | undefined, material: Material, level?: number): void;
         get name(): string;
         private parser;
@@ -2430,12 +2431,18 @@ declare module "engine-components/EventList" {
         removeAllEventListeners(): void;
     }
 }
+declare module "engine/engine_texture" {
+    import { WebGLRenderTarget } from "three";
+    export class RenderTexture extends WebGLRenderTarget {
+    }
+}
 declare module "engine/engine_serialization_builtin_serializer" {
     import * as THREE from "three";
     import { RGBAColor } from "engine-components/js-extensions/RGBAColor";
     import { SerializationContext, TypeSerializer } from "engine/engine_serialization_core";
     import { Behaviour, GameObject } from "engine-components/Component";
     import { EventList } from "engine-components/EventList";
+    import { RenderTexture } from "engine/engine_texture";
     class ColorSerializer extends TypeSerializer {
         constructor();
         onDeserialize(data: any): THREE.Color | RGBAColor | void;
@@ -2479,6 +2486,11 @@ declare module "engine/engine_serialization_builtin_serializer" {
         onDeserialize(data: EventListData, context: SerializationContext): EventList | undefined | null;
     }
     export const eventListSerializer: EventListSerializer;
+    export class RenderTextureSerializer extends TypeSerializer {
+        constructor();
+        onSerialize(_data: any, _context: SerializationContext): void;
+        onDeserialize(data: any, context: SerializationContext): RenderTexture | undefined;
+    }
 }
 declare module "engine/engine_serialization" {
     import { serializeObject, deserializeObject } from "engine/engine_serialization_core";
@@ -5438,35 +5450,6 @@ declare module "engine-components/debug/LogStats" {
         run(): Generator<undefined, void, unknown>;
     }
 }
-declare module "engine-components/export/GltfExport" {
-    import { Behaviour } from "engine-components/Component";
-    import { Object3D } from "three";
-    import { BoxHelperComponent } from "engine-components/BoxHelperComponent";
-    type ExportOptions = {
-        binary: boolean;
-        pivot?: THREE.Vector3;
-    };
-    export const componentsArrayExportKey = "$___Export_Components";
-    export class GltfExportBox extends BoxHelperComponent {
-        sceneRoot?: THREE.Object3D;
-        start(): void;
-        updateGltfBox(): Generator<undefined, void, unknown>;
-    }
-    export class GltfExport extends Behaviour {
-        binary: boolean;
-        objects: Object3D[];
-        private exporter?;
-        private ext?;
-        exportNow(name: string): Promise<void>;
-        export(objectsToExport: Object3D[], opts?: ExportOptions): Promise<any>;
-        private static saveArrayBuffer;
-        private static saveJson;
-        private static save;
-        private static collectAnimations;
-        private static calculateCenter;
-        private static filterTopmostParent;
-    }
-}
 declare module "engine-components/timeline/SignalAsset" {
     import { EventList } from "engine-components/EventList";
     import { Behaviour } from "engine-components/Component";
@@ -5736,8 +5719,9 @@ declare module "engine-components/ui/Utils" {
         revoke: () => void;
     };
     /** internal method to proxy a field to detect changes */
+    /**@deprecated use watcher instead */
     export function onChange<T extends object>(caller: T, field: string, callback: (newValue: any, oldValue: any) => void): RevocableProxy;
-    /** internal method to schedula a function at a specific moment in the update loop */
+    /** internal method to schedule a function at a specific moment in the update loop */
     export function scheduleAction(caller: Behaviour, action: Function, timing?: FrameEvent): void;
 }
 declare module "engine-components/ui/RectTransform" {
@@ -5810,6 +5794,8 @@ declare module "engine-components/ui/Graphic" {
         protected onBeforeCreate(_opts: any): void;
         protected onCreate(opts: any): void;
         protected onAfterCreated(): void;
+        /** used internally to ensure textures assigned to UI use linear encoding */
+        static textureCache: Map<Texture, Texture>;
         protected setTexture(tex: Texture | null | undefined): Promise<void>;
         protected onAfterAddedToScene(): void;
     }
@@ -6103,6 +6089,167 @@ declare module "engine-components/ui/SpatialHtml" {
         start(): void;
     }
 }
+declare module "engine-components/export/gltf/GltfExport" {
+    import { Behaviour } from "engine-components/Component";
+    import { Object3D } from "three";
+    import { BoxHelperComponent } from "engine-components/BoxHelperComponent";
+    type ExportOptions = {
+        binary: boolean;
+        pivot?: THREE.Vector3;
+    };
+    export const componentsArrayExportKey = "$___Export_Components";
+    export class GltfExportBox extends BoxHelperComponent {
+        sceneRoot?: THREE.Object3D;
+        start(): void;
+        updateGltfBox(): Generator<undefined, void, unknown>;
+    }
+    export class GltfExport extends Behaviour {
+        binary: boolean;
+        objects: Object3D[];
+        private exporter?;
+        private ext?;
+        exportNow(name: string): Promise<void>;
+        export(objectsToExport: Object3D[], opts?: ExportOptions): Promise<any>;
+        private static saveArrayBuffer;
+        private static saveJson;
+        private static save;
+        private static collectAnimations;
+        private static calculateCenter;
+        private static filterTopmostParent;
+    }
+}
+declare module "engine-components/export/usdz/types" {
+    import { Object3D, Matrix4, Material, BufferGeometry } from "three";
+    /** implementation is in three */
+    export class USDZDocument {
+        name: string;
+        get isDocumentRoot(): boolean;
+        add(obj: USDZObject): any;
+        remove(obj: USDZObject): any;
+        traverse(callback: (obj: USDZObject) => void): any;
+        findById(uuid: string): USDZObject | undefined;
+        get isDynamic(): boolean;
+    }
+    /** implementation is in three */
+    export class USDZObject {
+        static createEmptyParent(parent: USDZObject): any;
+        uuid: string;
+        name: string;
+        matrix: Matrix4;
+        material: Material;
+        geometry: BufferGeometry;
+        parent: USDZObject | USDZDocument | null;
+        children: USDZObject[];
+        _eventListeners: {
+            [event: string]: Function[];
+        };
+        isDynamic: boolean;
+        is(obj: Object3D): boolean;
+        isEmpty(): boolean;
+        clone(): any;
+        getPath(): any;
+        add(child: USDZObject): any;
+        remove(child: USDZObject): any;
+        addEventListener(evt: string, listener: Function): any;
+        removeEventListener(evt: string, listener: Function): any;
+    }
+}
+declare module "engine-components/export/usdz/Extension" {
+    import { USDZObject } from "engine-components/export/usdz/types";
+    export interface IUSDZExporterExtension {
+        get extensionName(): string;
+        onBeforeBuildDocument?(context: any): any;
+        onAfterBuildDocument?(context: any): any;
+        onExportObject?(object: any, model: USDZObject, context: any): any;
+        onAfterSerialize?(context: any): any;
+        onAfterHierarchy?(context: any): any;
+    }
+}
+declare module "engine-components/export/usdz/extensions/Animation" {
+    import { Object3D } from "three";
+    import { USDZObject } from "three/examples/jsm/exporters/USDZExporter";
+    import { IUSDZExporterExtension } from "engine-components/export/usdz/Extension";
+    export interface UsdzAnimation {
+        createAnimation(ext: AnimationExtension, model: USDZObject, context: any): any;
+    }
+    export type AnimationClipCollection = Array<{
+        root: Object3D;
+        clips: Array<THREE.AnimationClip>;
+    }>;
+    export class RegisteredAnimationInfo {
+        get start(): number;
+        get duration(): number;
+        private ext;
+        private root;
+        private clip;
+        constructor(ext: AnimationExtension, root: THREE.Object3D, clip: THREE.AnimationClip);
+    }
+    export class TransformData {
+        clip: THREE.AnimationClip;
+        pos?: THREE.KeyframeTrack;
+        rot?: THREE.KeyframeTrack;
+        scale?: THREE.KeyframeTrack;
+        get frameRate(): number;
+        private ext;
+        private root;
+        private target;
+        constructor(ext: AnimationExtension, root: Object3D, target: Object3D, clip: THREE.AnimationClip);
+        addTrack(track: any): void;
+        getFrames(): number;
+        getDuration(): number;
+        getStartTime(arr: TransformData[]): number;
+    }
+    export class AnimationExtension implements IUSDZExporterExtension {
+        get extensionName(): string;
+        private dict;
+        private rootTargetMap;
+        getStartTime01(root: Object3D, clip: THREE.AnimationClip): number;
+        registerAnimation(root: Object3D, clip: THREE.AnimationClip): RegisteredAnimationInfo | null;
+        onAfterHierarchy(_context: any): void;
+        private serializers;
+        onAfterBuildDocument(_context: any): void;
+        onExportObject(object: any, model: USDZObject, _context: any): void;
+    }
+}
+declare module "engine-components/export/usdz/utils/quicklook" {
+    import { Context } from "engine/engine_setup";
+    export function ensureQuicklookLinkIsCreated(context: Context): HTMLAnchorElement;
+}
+declare module "engine-components/export/usdz/utils/timeutils" {
+    export function getFormattedDate(): string;
+}
+declare module "engine-components/export/usdz/utils/animationutils" {
+    import { Object3D } from "three";
+    import { AnimationExtension } from "engine-components/export/usdz/extensions/Animation";
+    export function registerAnimatorsImplictly(root: Object3D, ext: AnimationExtension): void;
+}
+declare module "engine-components/export/usdz/USDZExporter" {
+    import * as THREE from "three";
+    import { IUSDZExporterExtension } from "engine-components/export/usdz/Extension";
+    import { Behaviour } from "engine-components/Component";
+    export type QuickLookOverlay = {
+        callToAction?: string;
+        checkoutTitle?: string;
+        checkoutSubtitle?: string;
+    };
+    export class USDZExporter extends Behaviour {
+        objectToExport?: THREE.Object3D;
+        autoExportAnimations: boolean;
+        extensions: IUSDZExporterExtension[];
+        private link;
+        private webxr?;
+        start(): void;
+        onEnable(): void;
+        onDisable(): void;
+        exportAsync(): Promise<void>;
+        private lastCallback?;
+        private quicklookCallback;
+        private buildQuicklookOverlay;
+        private _arButton?;
+        private createQuicklookButton;
+        private resetStyles;
+    }
+}
 declare module "engine-components/codegen/components" {
     export class __Ignore {
     }
@@ -6229,8 +6376,6 @@ declare module "engine-components/codegen/components" {
     export { Avatar_MouthShapes } from "engine-components/avatar/Avatar_MouthShapes";
     export { Avatar_MustacheShake } from "engine-components/avatar/Avatar_MustacheShake";
     export { LogStats } from "engine-components/debug/LogStats";
-    export { GltfExportBox } from "engine-components/export/GltfExport";
-    export { GltfExport } from "engine-components/export/GltfExport";
     export { RGBAColor } from "engine-components/js-extensions/RGBAColor";
     export { PlayableDirector } from "engine-components/timeline/PlayableDirector";
     export { SignalAsset } from "engine-components/timeline/SignalAsset";
@@ -6266,6 +6411,12 @@ declare module "engine-components/codegen/components" {
     export { RectTransform } from "engine-components/ui/RectTransform";
     export { SpatialHtml } from "engine-components/ui/SpatialHtml";
     export { Text } from "engine-components/ui/Text";
+    export { GltfExportBox } from "engine-components/export/gltf/GltfExport";
+    export { GltfExport } from "engine-components/export/gltf/GltfExport";
+    export { USDZExporter } from "engine-components/export/usdz/USDZExporter";
+    export { RegisteredAnimationInfo } from "engine-components/export/usdz/extensions/Animation";
+    export { TransformData } from "engine-components/export/usdz/extensions/Animation";
+    export { AnimationExtension } from "engine-components/export/usdz/extensions/Animation";
 }
 declare module "needle-engine" {
     import "engine/engine_element";