@needle-tools/engine 2.29.0-pre → 2.30.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.30.0-pre] - 2022-10-12
+- Add: Quest 2 passthrough support
+- Add: UI Graphic components now support ``raycastTarget`` again
+- Add: VideoPlayer now supports ``materialTarget`` option which allows for assigning any renderer in the scene that should be used as a video canvas
+- Changed: updated three-mesh-ui dependency version
+- Changed: updated needle-gltfTransform extensions package, fixing an issue with passthrough of texture json pointers
+- Changed: selecting SpectatorCam now requires click (instead of just listening to pointer up event)
+- Fix: Avatars using instanced materials should now update transforms correctly again
+
 ## [2.29.0-pre] - 2022-10-10
 - Add: Context.removeCamera method
 - Add: SpectatorCam allows to follow other users across devices by clicking on respective avatar (e.g. clicking SyncedCam avatar or WebXR avatar, ESC or long press to stop spectating)

package/dist/needle-engine.d.ts

@@ -57,7 +57,7 @@ declare module "engine/engine_utils" {
     type deepClonePredicate = (owner: any, propertyName: string, current: any) => boolean;
     export function deepClone(obj: any, predicate?: deepClonePredicate): any;
     export function delay(milliseconds: number): Promise<void>;
-    export function getPath(glbLocation: SourceIdentifier | undefined, path: string): string;
+    export function getPath(source: SourceIdentifier | undefined, uri: string): string;
     export type WriteCallback = (data: any) => void;
     export class Watch {
         subscribeWrite(callback: WriteCallback): void;
@@ -960,7 +960,7 @@ declare module "engine/extensions/NEEDLE_deferred_texture" {
     import { Context } from "engine/engine_setup";
     export const EXTENSION_NAME = "NEEDLE_deferred_texture";
     export class NEEDLE_deferred_texture implements GLTFLoaderPlugin {
-        static assignTextureLOD(context: Context, material: Material, level?: number): void;
+        static assignTextureLOD(context: Context, source: SourceIdentifier | undefined, material: Material, level?: number): void;
         get name(): string;
         private parser;
         private sourceId;
@@ -1018,6 +1018,7 @@ declare module "engine-components/Renderer" {
         private _isInstancingEnabled;
         private handles;
         private prevLayers;
+        private clearInstancingState;
         setInstancingEnabled(enabled: boolean): boolean;
         start(): void;
         onEnable(): void;
@@ -1584,6 +1585,7 @@ declare module "engine/engine_serialization" {
     import { serializeObject, deserializeObject } from "engine/engine_serialization_core";
     import * as builtin from "engine/engine_serialization_builtin_serializer";
     export { serializeObject, deserializeObject, builtin };
+    export { serializeable } from "engine/engine_serialization_decorator";
 }
 declare module "engine/extensions/NEEDLE_components" {
     import { GLTF, GLTFLoaderPlugin, GLTFParser } from "three/examples/jsm/loaders/GLTFLoader";
@@ -2411,20 +2413,27 @@ declare module "engine-components/WebXRController" {
 declare module "engine-components/WebARSessionRoot" {
     import { Behaviour } from "engine-components/Component";
     import * as THREE from 'three';
-    import { XRPose } from "three";
+    import { Matrix4, XRPose } from "three";
     import { WebAR } from "engine-components/WebXR";
     export class WebARSessionRoot extends Behaviour {
         webAR: WebAR | null;
+        get rig(): THREE.Object3D | undefined;
         invertForward: boolean;
         get arScale(): number;
         set arScale(val: number);
+        private readonly _initalMatrix;
+        private readonly _selectStartFn;
+        private readonly _selectEndFn;
+        start(): void;
         private _arScale;
         private _rig;
         private _startPose;
         private _placementPose;
         private _isTouching;
+        private _rigStartPose;
         onBegin(session: THREE.XRSession): void;
-        onUpdate(rig: THREE.Object3D | null, _session: THREE.XRSession, pose: XRPose | null | undefined): void;
+        onUpdate(rig: THREE.Object3D | null, _session: THREE.XRSession, pose: XRPose | null | undefined): boolean;
+        placeAt(rig: THREE.Object3D | null, mat: Matrix4): void;
         onEnd(rig: THREE.Object3D | null, _session: THREE.XRSession): void;
         private onSelectStart;
         private onSelectEnd;
@@ -2471,7 +2480,7 @@ declare module "engine-components/WebXR" {
         static createARButton(webXR: WebXR, opts?: CreateButtonOptions): HTMLButtonElement;
         static resetButtonStyles(button: any): void;
         endSession(): void;
-        get Rig(): THREE.Object3D | null;
+        get Rig(): THREE.Object3D;
         private controllers;
         get Controllers(): WebXRController[];
         get LeftController(): WebXRController | null;
@@ -2511,7 +2520,8 @@ declare module "engine-components/WebXR" {
         private onEnterXR_HandleMirrorWindow;
     }
     export class WebAR {
-        private webxr;
+        get webxr(): WebXR;
+        private _webxr;
         private reticle;
         private hitTestSource;
         private reticleActive;
@@ -2524,9 +2534,11 @@ declare module "engine-components/WebXR" {
         constructor(webxr: WebXR);
         private arDomOverlay;
         private arOverlayElement;
+        private noHitTestAvailable;
+        private didPlaceARSessionRoot;
         getAROverlayContainer(): HTMLElement | null;
         setReticleActive(active: boolean): void;
-        onBegin(session: THREE.XRSession): void;
+        onBegin(session: THREE.XRSession): Promise<void>;
         onEnd(_session: THREE.XRSession): void;
         onUpdate(session: THREE.XRSession, frame: THREE.XRFrame): void;
     }
@@ -2865,10 +2877,12 @@ declare module "engine-components/DragControls" {
 }
 declare module "engine-components/ui/Interfaces" {
     export interface ICanvasGroup {
+        get isCanvasGroup(): boolean;
         blocksRaycasts: boolean;
         interactable: boolean;
     }
     export interface IGraphic {
+        get isGraphic(): boolean;
         raycastTarget: boolean;
     }
 }
@@ -3073,6 +3087,10 @@ declare module "engine/engine_setup" {
         OnAfterRender = 4,
         PhysicsStep = 10
     }
+    export enum XRSessionMode {
+        ImmersiveVR = "immersive-vr",
+        ImmersiveAR = "immersive-ar"
+    }
     export type OnBeforeRenderCallback = (renderer: THREE.WebGLRenderer, scene: THREE.Scene, camera: THREE.Camera, geometry: THREE.BufferGeometry, material: THREE.Material, group: THREE.Group) => void;
     export class Context {
         private static _current;
@@ -3091,6 +3109,7 @@ declare module "engine/engine_setup" {
         get domX(): number;
         get domY(): number;
         get isInXR(): boolean;
+        xrSessionMode: XRSessionMode | undefined;
         get xrSession(): THREE.XRSession | null;
         get arOverlayElement(): HTMLElement;
         scene: THREE.Scene;
@@ -3755,11 +3774,20 @@ declare module "engine-components/VideoPlayer" {
         Direct = 2,
         APIOnly = 3
     }
+    export enum VideoRenderMode {
+        CameraFarPlane = 0,
+        CameraNearPlane = 1,
+        RenderTexture = 2,
+        MaterialOverride = 3
+    }
     export class VideoPlayer extends Behaviour {
         renderer: THREE.Object3D | null;
         playOnAwake: boolean;
         playOnEnable?: boolean;
-        targetMaterialProperty?: string;
+        private renderMode?;
+        private targetMaterialProperty?;
+        private targetMaterialRenderer?;
+        private targetTexture?;
         private time;
         private _playbackSpeed;
         get playbackSpeed(): number;
@@ -3808,6 +3836,7 @@ declare module "engine-components/ScreenCapture" {
         private captureStream;
         open(force?: boolean): Promise<void>;
         close(): void;
+        private handleNetworkedVideo;
     }
 }
 declare module "engine-components/ShadowCatcher" {
@@ -4140,10 +4169,14 @@ declare module "engine-components/Volume" {
     export class VolumeProfile {
         components?: VolumeComponent[];
         apply(context: Context): void;
+        unapply(context: Context): void;
+        private onUpdate;
     }
     export class Volume extends Behaviour {
         sharedProfile?: VolumeProfile;
+        awake(): void;
         onEnable(): void;
+        onDisable(): void;
     }
 }
 declare module "engine-components/WebXRGrabRendering" {
@@ -4575,6 +4608,7 @@ declare module "engine-components/ui/Graphic" {
     import { Texture } from 'three';
     import { RectTransform } from "engine-components/ui/RectTransform";
     export class Graphic extends BaseUIComponent implements IGraphic {
+        get isGraphic(): boolean;
         get color(): RGBAColor;
         set color(col: RGBAColor);
         protected onColorChanged(): void;
@@ -4726,6 +4760,7 @@ declare module "engine-components/ui/CanvasGroup" {
     export class CanvasGroup extends Behaviour implements ICanvasGroup {
         get alpha(): number;
         set alpha(val: number);
+        get isCanvasGroup(): boolean;
         private _alpha;
         interactable: boolean;
         blocksRaycasts: boolean;
@@ -5060,6 +5095,7 @@ declare module "engine/engine" {
         LoadingOptions: typeof engine_setup.LoadingOptions;
         ContextArgs: typeof engine_setup.ContextArgs;
         FrameEvent: typeof engine_setup.FrameEvent;
+        XRSessionMode: typeof engine_setup.XRSessionMode;
         Context: typeof engine_setup.Context;
     };
     export { engine as engine };