@splnlss/3d-story-viewer 0.8.2 → 0.8.3

package/build/types/src/viewer/GlobeManager.d.ts

@@ -4,14 +4,24 @@ export class GlobeManager extends EventDispatcher {
     camera: any;
     renderer: any;
     tiles: TilesRenderer<import("3d-tiles-renderer").TilesRendererEventMap>;
+    destinationTileCamera: PerspectiveCamera;
+    destinationTileResolution: number;
+    destinationTileTimeout: number;
+    previousAutoDisableRendererCulling: boolean;
     dracoLoader: any;
     ownsDecoders: boolean;
     decoders: any;
     apiToken: any;
     googleMapsToken: any;
     initTiles(): void;
+    attachTileLoadListener(): void;
+    /** The renderer shares one cache and request scheduler between both registered cameras. */
+    setDestinationTilePrefetch(target: any): void;
+    updateDestinationTileResolution(): void;
+    clearDestinationTilePrefetch(): void;
     update(): void;
     dispose(): void;
 }
 import { EventDispatcher } from '../modules/EventDispatcher';
 import { TilesRenderer } from '3d-tiles-renderer';
+import { PerspectiveCamera } from 'three';

package/build/types/src/viewer/WebXRSession.d.ts

@@ -23,6 +23,7 @@ export class WebXRSession {
     starting: any;
     bridge: {
         getHeadPose: () => import("./XRPlayerRig.js").XRHeadPose;
+        getHeadForward: () => import("three").Vector3Tuple;
         getControllerWorldRay: (controller: any) => {
             origin: import("three").Vector3Tuple;
             direction: import("three").Vector3Tuple;
@@ -30,6 +31,7 @@ export class WebXRSession {
         setNavigationCue: (cue: any) => void;
         setTerrainCredits: (credits: any) => void;
         setPlayerPose(pose: any): void;
+        setVisualBlend(blend: any): void;
         hasUi(): boolean;
         setNavigationLimit(reason: any): void;
         setComfortMoving(moving: any): void;

package/build/types/src/viewer/XRPlayerRig.d.ts

@@ -1,9 +1,18 @@
-/** @typedef {{worldEcef: [number, number, number], geodetic: {longitude: number, latitude: number, altitude: number}, headingDegrees: number, localHeadOffset: [number, number, number]}} XRHeadPose */
 /** Keeps metre-scale tracked poses separate from double-precision WGS84 ECEF positions. */
 export class XRPlayerRig {
     /** @param {Matrix4} initialCameraWorld @param {XRRigidTransform} initialHeadPose */
     constructor(initialCameraWorld: Matrix4, initialHeadPose: XRRigidTransform);
     headLocal: Matrix4;
+    /** @type {Matrix4 | null} */
+    trackingReference: Matrix4 | null;
+    /** @type {Matrix4 | null} */
+    visualReference: Matrix4 | null;
+    /** @type {{pitchDegrees: number, rollDegrees: number} | null} */
+    visualOrientation: {
+        pitchDegrees: number;
+        rollDegrees: number;
+    } | null;
+    visualBlend: number;
     worldFromLocal: Matrix4;
     anchor: {
         longitude: number;
@@ -14,6 +23,18 @@ export class XRPlayerRig {
     updateHeadPose(pose: XRRigidTransform): void;
     getWorldFromLocalMatrix(): Matrix4;
     getWorldHeadMatrix(): Matrix4;
+    getVisualWorldFromLocalMatrix(): Matrix4;
+    getVisualWorldHeadMatrix(): Matrix4;
+    getVisualHeadForward(): import("three").Vector3Tuple;
+    poseFromWorld(world: any): {
+        worldEcef: import("three").Vector3Tuple;
+        geodetic: {
+            longitude: number;
+            latitude: number;
+            altitude: number;
+        };
+        headingDegrees: number;
+    };
     /** @returns {XRHeadPose} WGS84 degrees, ellipsoidal altitude metres, ECEF metres, local-floor metres. */
     getHeadPose(): XRHeadPose;
     getNavigationFrame(): Matrix4;
@@ -26,13 +47,10 @@ export class XRPlayerRig {
      * Places the tracked head at a WGS84 ellipsoidal position plus ENU metres.
      * Heading is clockwise degrees from true north. Physical room-scale motion remains tracked.
      */
-    setPose({ anchor, east, north, up, headingDegrees }: {
-        anchor: any;
-        east?: number;
-        north?: number;
-        up?: number;
-        headingDegrees: any;
-    }): void;
+    /** @param {XRPlayerPose} pose */
+    setPose({ anchor, east, north, up, headingDegrees, trackingReference, visualOrientation }: XRPlayerPose): void;
+    /** Fade the authored camera correction while retaining live six-degree head tracking. */
+    setVisualBlend(blend: any): void;
     reanchor(headingDegrees: any): void;
 }
 export type XRHeadPose = {
@@ -44,5 +62,31 @@ export type XRHeadPose = {
     };
     headingDegrees: number;
     localHeadOffset: [number, number, number];
+    localHeadOrientation: [number, number, number, number];
+    displayedOrientation: {
+        pitch: number;
+        yaw: number;
+        roll: number;
+    };
+};
+export type XRTrackingReference = {
+    position: [number, number, number];
+    orientation: [number, number, number, number];
+};
+export type XRPlayerPose = {
+    anchor: {
+        longitude: number;
+        latitude: number;
+        altitude: number;
+    };
+    east?: number;
+    north?: number;
+    up?: number;
+    headingDegrees: number;
+    trackingReference?: XRTrackingReference;
+    visualOrientation?: {
+        pitchDegrees: number;
+        rollDegrees: number;
+    } | null;
 };
 import { Matrix4 } from 'three';

package/build/types/src/viewer/XRRenderBridge.d.ts

@@ -9,6 +9,7 @@ export function createXRRenderBridge(viewer: import("./index.js").default, initi
     showAttribution?: boolean;
 }): {
     getHeadPose: () => import("./XRPlayerRig.js").XRHeadPose;
+    getHeadForward: () => import("three").Vector3Tuple;
     getControllerWorldRay: (controller: any) => {
         origin: import("three").Vector3Tuple;
         direction: import("three").Vector3Tuple;
@@ -16,6 +17,7 @@ export function createXRRenderBridge(viewer: import("./index.js").default, initi
     setNavigationCue: (cue: any) => void;
     setTerrainCredits: (credits: any) => void;
     setPlayerPose(pose: any): void;
+    setVisualBlend(blend: any): void;
     hasUi(): boolean;
     setNavigationLimit(reason: any): void;
     setComfortMoving(moving: any): void;

package/build/types/src/viewer/index.d.ts

@@ -46,6 +46,7 @@ declare class Viewer extends EventDispatcher {
     transitionControls: TransitionControls;
     tileDecoders: TileDecoders;
     globeManager: GlobeManager;
+    _onGlobeTileLoaded: () => void;
     /** @type {ViewerCoords} */
     cameraCoords: ViewerCoords;
     /** @type {ViewerCoords} */
@@ -118,20 +119,14 @@ declare class Viewer extends EventDispatcher {
             };
         }[];
     };
-    /** @param {{ anchor: { longitude: number, latitude: number, altitude: number }, east?: number, north?: number, up?: number, headingDegrees: number }} pose */
-    setXRPlayerPose(pose: {
-        anchor: {
-            longitude: number;
-            latitude: number;
-            altitude: number;
-        };
-        east?: number;
-        north?: number;
-        up?: number;
-        headingDegrees: number;
-    }): void;
+    /** @param {import('./XRPlayerRig.js').XRPlayerPose} pose */
+    setXRPlayerPose(pose: import("./XRPlayerRig.js").XRPlayerPose): void;
+    /** @param {number} blend 1 keeps the saved camera pitch, 0 restores natural tracked orientation. */
+    setXRVisualBlend(blend: number): void;
     /** @returns {import('./XRPlayerRig.js').XRHeadPose | null} */
     getXRHeadPose(): import("./XRPlayerRig.js").XRHeadPose | null;
+    /** @returns {number[] | null} Displayed head-forward unit vector in WGS84 ECEF axes. */
+    getXRHeadForward(): number[] | null;
     /** @param {{ray: {position: number[], orientation: number[]} | null}} controller @returns {{origin: number[], direction: number[]} | null} */
     getXRControllerWorldRay(controller: {
         ray: {
@@ -256,6 +251,20 @@ declare class Viewer extends EventDispatcher {
      * @param {number} [duration]
      */
     focusCamera(lon: number, lat: number, alt: number, distance?: number, pitch?: number, duration?: number): Promise<void>;
+    /**
+     * Temporarily load Google 3D tiles around a WGS84 destination without changing the live view.
+     * Position and altitude use degrees and WGS84 ellipsoidal metres; rotation uses degrees.
+     * @param {{longitude:number, latitude:number, altitude:number, pitch:number, yaw:number, roll:number, resolutionPixels:128|256} | null} target
+     */
+    setDestinationTilePrefetch(target: {
+        longitude: number;
+        latitude: number;
+        altitude: number;
+        pitch: number;
+        yaw: number;
+        roll: number;
+        resolutionPixels: 128 | 256;
+    } | null): void;
     /**
      * @param {number} [pitch]
      * @param {number} [yaw]
@@ -276,6 +285,7 @@ export namespace ViewerEvents {
     let CONTENT_LAYER_LOAD_PROGRESS: "content-layer-load-progress";
     let CONTENT_LAYER_READY: "content-layer-ready";
     let CONTENT_LAYER_ERROR: "content-layer-error";
+    let GLOBE_TILE_LOADED: "globe-tile-loaded";
 }
 import { EventDispatcher } from '../modules/EventDispatcher';
 import { WebXRSession } from './WebXRSession.js';

package/build/viewer.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./main-yri0wVzb.cjs"),t=require("./index-XZNzHig1.cjs");exports.Viewer=e.Viewer,exports.ViewerEvents=e.ViewerEvents,exports.computeElevation=t.computeElevation;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./main-DOWS9MQ7.cjs"),t=require("./index-XZNzHig1.cjs");exports.Viewer=e.Viewer,exports.ViewerEvents=e.ViewerEvents,exports.computeElevation=t.computeElevation;

package/build/viewer.js

@@ -1,5 +1,5 @@
-import { V, a } from "./main-BUCkukV4.js";
-import { by } from "./index-BgprA821.js";
+import { V, a } from "./main-CEG3MR57.js";
+import { by } from "./index-a8PLKOvo.js";
 export {
   V as Viewer,
   a as ViewerEvents,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@splnlss/3d-story-viewer",
-    "version": "0.8.2",
+    "version": "0.8.3",
     "publishConfig": {
         "access": "public",
         "registry": "https://registry.npmjs.org/"