@realsee/five-webgpu 1.0.0-alpha.5 → 1.0.0-alpha.7

package/five/webxr/xrManager.d.ts

@@ -0,0 +1,174 @@
+import * as THREE from "three/webgpu";
+import { InputSourceTracker } from "./inputSourceTracker";
+import { DeviceType, DeviceProfile, DeviceProfileOverride } from "./deviceProfile";
+export type { DeviceType } from "./deviceProfile";
+export interface XRManagerOptions {
+    /** 期望参考空间类型，默认 'local-floor'（需求 10） */
+    referenceSpaceType?: XRReferenceSpaceType;
+    /** 0..1，XR_Layer 支持 fixedFoveation 时设置（需求 1.13） */
+    foveation?: number;
+    /** 调用方覆盖 Device_Profile（需求 11.4） */
+    deviceProfile?: DeviceProfileOverride;
+    /** 首帧超时，默认 5000ms（需求 2.9） */
+    firstFrameTimeoutMs?: number;
+    /** 眼图集 MSAA 采样数，默认 0，透传给 RenderTargetBridge */
+    atlasSamples?: number;
+}
+export interface XRManagerCallbacks {
+    onSessionStart(session: XRSession, device: DeviceType): void;
+    onSessionEnd(device: DeviceType): void;
+    /**
+     * 会话结束归还流程中、`inputs.clear()` 之前调用，供控制器重置按键状态（需求 8.9）。
+     * 回调抛错不会中断归还。
+     */
+    onSessionEnding?(): void;
+    /** session 'select' 事件，供 gaze / transient-pointer 走点（需求 9.4） */
+    onSelect?(source: XRInputSource): void;
+    /** inputsourceschange，供控制器创建 / 移除手柄模型（需求 7.3、7.5） */
+    onInputSourcesChange?(added: readonly XRInputSource[], removed: readonly XRInputSource[]): void;
+}
+export interface FrameInfo {
+    time: number;
+    /** Head_Pose 为 null 或 views 数量不是 1/2 时为 false（需求 3.6） */
+    hasPose: boolean;
+    /** 仅 hasPose 时有效 */
+    headOrientation: THREE.Quaternion;
+    /** 各 view 平移均值（需求 6.2），仅 hasPose 时有效 */
+    headLocal: THREE.Vector3;
+    /** 与 Eye_Camera 对应的 view 列表，保持 Head_Pose.views 顺序；viewport 为 XRViewport 语义（左下原点） */
+    views: ReadonlyArray<{
+        eye: 0 | 1;
+        viewport: THREE.Vector4;
+    }>;
+}
+export declare class XRManager {
+    /**
+     * 后端是否支持 XR（后端非 WebGPU 即可）。
+     * 以实际 backend 为准：`backend.isWebGPUBackend !== true`。
+     */
+    static isBackendXRCapable(renderer: THREE.WebGPURenderer): boolean;
+    /** 浏览器是否暴露了 WebXR 入口（只检查 `navigator.xr` 是否存在，不发起权限请求）。 */
+    static isBrowserXRCapable(): boolean;
+    /** 恒为长度 2 的元组，会话内（实际是整个 XRManager 生命周期内）同一对实例（需求 3.1） */
+    readonly eyeCameras: readonly [THREE.PerspectiveCamera, THREE.PerspectiveCamera];
+    readonly inputs: InputSourceTracker;
+    readonly device: DeviceType;
+    readonly profile: Readonly<DeviceProfile>;
+    get isPresenting(): boolean;
+    get session(): XRSession | null;
+    get frame(): XRFrame | null;
+    /** 实际采用的参考空间类型，未进入或已结束时为 null（需求 10.5） */
+    get referenceSpaceType(): XRReferenceSpaceType | null;
+    private readonly renderer;
+    private readonly options;
+    private readonly callbacks;
+    private readonly bridge;
+    private _isPresenting;
+    private _session;
+    private _frame;
+    private _referenceSpaceType;
+    private refSpace;
+    private layer;
+    /** enter 流程进行中 */
+    private entering;
+    /** enter 流程已完成且尚未归还 */
+    private entered;
+    /** 进入期间会话已结束（需求 1.11） */
+    private endedDuringEnter;
+    private snapshot;
+    private readonly listeners;
+    private firstFrameArrived;
+    private firstFrameWaiter;
+    private frameNo;
+    private submittedNear;
+    private submittedFar;
+    private readonly offset;
+    private readonly info;
+    /** 池化的 view 条目，最多 2 个 */
+    private readonly viewPool;
+    /** 当前帧有效的 view（`info.views` 指向它） */
+    private readonly frameViews;
+    private readonly bridgeEyes;
+    private readonly tmpViewport;
+    private readonly tmpSize;
+    constructor(renderer: THREE.WebGPURenderer, options: XRManagerOptions, callbacks: XRManagerCallbacks);
+    /**
+     * 进入 XR（design 4.1 的 11 个步骤）。
+     * 幂等：进入中或已进入时直接返回。失败时回滚到进入前状态并抛出原始错误。
+     */
+    enter(session: XRSession): Promise<void>;
+    /**
+     * 主动退出：已进入时调用一次 `session.end()`，归还由随后的 `end` 事件完成（需求 1.5）。
+     * `end()` reject 时在本地完成归还且不外抛（需求 1.12）。未进入时直接返回。
+     */
+    exit(): Promise<void>;
+    /**
+     * 析构，幂等。
+     * - 进入中：中止进入（enter 会以“会话在进入过程中已结束”reject）并尝试结束会话；
+     * - 已进入：同步完成本地归还，再尝试 `session.end()`（其后到达的 end 事件因监听已移除而被忽略）；
+     * - 未进入：直接返回。
+     */
+    dispose(): void;
+    /**
+     * 每帧第一步（design 4.2）：计算 Head_Pose、更新两个 Eye_Camera 与手柄位姿、同步深度范围、统计诊断。
+     *
+     * 返回的 `FrameInfo` 是内部复用的对象，仅在下一次 `beginFrame` 之前有效。
+     * 尚未就绪（参考空间还没解析完，例如 `Five.changeMode` 提前 `setContext(session)` 后到达的帧）时返回 `hasPose = false`，
+     * 且不计入首帧、不计入统计。
+     *
+     * @param station Station_Position（five Camera 位置）
+     */
+    beginFrame(frame: XRFrame, time: number, station: THREE.Vector3, near: number, far: number): FrameInfo;
+    /**
+     * 渲染本帧：清图集一次 → 逐眼 render → 解析 pass。
+     * `hasPose` 为假或尚未就绪返回 `false`（本帧被跳过）；否则返回 `true`。
+     * `renderer.render` 抛错时由 Bridge 恢复状态后原样抛出。
+     */
+    renderEyes(scene: THREE.Scene): boolean;
+    /** 以 target ray 填充射线，返回本帧是否已填充（需求 6.8） */
+    fillRaycaster(source: XRInputSource, raycaster: THREE.Raycaster): boolean;
+    private markNoPose;
+    /**
+     * 建立眼映射并读取各 view 的 viewport，写入 `frameViews`（需求 3.2）。
+     * `left` / `none` → 0，`right` → 1；该下标已被前一个 view 占用时取另一只。
+     * 任一 view 取不到 viewport 时返回 false，调用方按无姿态处理（此时尚未改动任何 Eye_Camera）。
+     */
+    private collectViews;
+    /** near/far 与最近一次提交值不同时才更新一次 renderState（需求 1.10） */
+    private syncDepthRange;
+    private notifyFirstFrame;
+    private throwIfEnded;
+    private waitFirstFrame;
+    /** 把 `session.inputSources` 里尚未追踪的输入源补进来并通知控制器 */
+    private syncExistingInputSources;
+    private listen;
+    private removeListeners;
+    /** 稳定的箭头函数字段，保证 add / remove 用同一个引用 */
+    private onSessionEndEvent;
+    private onInputSourcesChangeEvent;
+    private onSelectEvent;
+    /** 沿用同一参考空间对象；Station_Position 不变，下一帧 beginFrame 会依据新 Head_Pose 重算 */
+    private onReferenceSpaceReset;
+    /** 记录渲染器状态（视口、autoClear*、pixelRatio、尺寸）。不主动调用 setPixelRatio / setSize。 */
+    private captureRendererState;
+    /** 恢复记录点；仅在值不同时才还原（避免无谓的 setPixelRatio / setSize 重置视口） */
+    private restoreRendererState;
+    /** 仅当 AnimationFrameLoop 的 context 仍是本 session 时才置 null，避免误清别人的 context */
+    private releaseFrameSource;
+    /** 清空会话相关引用（不含回调） */
+    private clearReferences;
+    /**
+     * 进入失败的回滚（幂等）：移除监听、`bridge.dispose`、`setContext(null)`、恢复渲染器状态、清引用。
+     * 不调用任何回调；不结束 session（交给调用方决定）。
+     */
+    private rollback;
+    /**
+     * 会话结束归还（`end` 事件 / `exit` 中 `end()` reject / `dispose` 共用），固定顺序（design 4.1）：
+     * isPresenting=false → onSessionEnding → inputs.clear → bridge.dispose → 移除监听 → setContext(null)
+     * → 恢复渲染器状态 → 清引用 → onSessionEnd。
+     * `_session` 已为 null 时（重复调用）直接忽略。
+     */
+    private teardown;
+    /** fire-and-forget 结束会话，吞掉可能的 reject（会话可能已在结束中） */
+    private endQuietly;
+}

package/five/work/index.d.ts

@@ -1,4 +1,4 @@
-export { parseWork, type ParseOptions, Work, type WorkCubeImage, type WorkImage, type WorkInitial, type WorkModel, type WorkModelLayer, type WorkObserver, type WorkTile, type WorkVideo, } from './work';
+export { parseWork, type ParseOptions, Work, type WorkCubeHdrGainmapImage, type WorkCubeImage, type WorkImage, type WorkInitial, type WorkModel, type WorkModelLayer, type WorkObserver, type WorkTile, type WorkVideo, } from './work';
 export { type WorkInitialJson, type WorkJson, type WorkModelJson, type WorkModelLayerJson, type WorkObserverJson, type WorkPanoramaJson, type WorkPanoramasJson, } from './workJsonType';
 export { workToJson, } from './workJson';
 export { type LoosePanoWork, type LooseWork, type LooseWorkInitial, type LooseWorkModel, type LooseWorkObserver, type LooseWorkPanorama, type LooseWorkVideo, type LooseWorkWithExtrinsics, } from './looseWorkType';

package/five/work/looseWorkType.d.ts

@@ -20,7 +20,8 @@ export interface LooseWorkPanorama {
     size_list?: number[];
     derived_id?: number;
     derived_id_str?: string;
-    hdr_config?: string;
+    hdr?: boolean;
+    gainmap_cfg?: string;
     gainmap_right?: string;
     gainmap_left?: string;
     gainmap_up?: string;

package/five/work/work.d.ts

@@ -2,7 +2,7 @@ import * as THREE from "three/webgpu";
 import type { Mode } from "../application/mode";
 import type { TilesetHeader } from "../model/tile3d/header";
 import type { LooseWork, LoosePanoWork } from "./looseWorkType";
-import { CubeFace, GainMapFace } from "../types/cube";
+import { CubeFace } from "../types/cube";
 import type { PanoId } from "../utils/pano";
 /** 全景视频贴片 */
 export interface WorkVideo {
@@ -14,9 +14,18 @@ export interface WorkVideo {
     /** 视频源长宽尺寸 */
     size: THREE.Vector2;
 }
-export interface WorkCubeImage extends Record<CubeFace | GainMapFace, string> {
+/** HDR gainmap 六视图 */
+export interface WorkCubeHdrGainmapImage extends Record<CubeFace, string> {
+    /** HDR 配置数据地址 */
+    cfg: string;
+}
+export interface WorkCubeImage extends Record<CubeFace, string> {
     work: Work;
-    hdrConfig?: string;
+    /**
+     * HDR gainmap 六视图 + 配置
+     * @description 该点位无 HDR 数据时不存在该字段
+     */
+    gainmap?: WorkCubeHdrGainmapImage;
 }
 export interface WorkTile extends WorkCubeImage {
     /** 层级 */
@@ -183,13 +192,17 @@ export interface Work {
     observers: readonly WorkObserver[];
 }
 export declare class Work {
-    jsonp: boolean;
+    observerBox: THREE.Box3;
+    readonly jsonp: boolean;
+    readonly shortPath: boolean;
+    readonly disableGainmap: boolean;
+    /**
+     * @deprecated 标准数据不混合 panoHDR 数据。而是直接包含 hdr 标识
+     */
     panoHDR?: {
         baseURL: string;
         manifest: any;
     };
-    shortPath: boolean;
-    observerBox: THREE.Box3;
     /**
      * 控制参数
      * @deprecated 通过 work.transform 替换
@@ -231,7 +244,17 @@ export type ParseOptions = {
     shortPath?: boolean;
     /** 资源使用 jsonp 方式发布 */
     jsonp?: boolean;
-    /** 全景 HDR */
+    /**
+     * 不解析 HDR gainmap 数据，点位按「无 HDR」处理
+     * @description 显式 `gainmap_*` 字段、`hdr` 标识推导、`panoHDR` 注入的 gainmap 都会被跳过，
+     * 因此 `images.gainmap` / `tile.gainmap` 不存在；此时即使 `useHDR` 打开也按 SDR 渲染。
+     * 注意：`work.toJSON()` 的 `hdr` 标记由 gainmap 是否存在推导，会一并变为 false。
+     */
+    disableGainmap?: boolean;
+    /**
+     * 全景 HDR
+     * @deprecated 标准数据不混合 panoHDR 数据。而是直接包含 hdr 标识
+     */
     panoHDR?: {
         baseURL: string;
         manifest: any;

package/five/work/workJsonType.d.ts

@@ -58,13 +58,14 @@ export interface WorkPanoramaJson {
     loadable?: boolean;
     derived_id?: number;
     derived_id_str?: string;
-    size_list: number[];
     up: string;
     down: string;
     right: string;
     left: string;
     front: string;
     back: string;
+    size_list: number[];
+    hdr?: boolean;
     video?: {
         source: string;
         matrix: number[];

package/gltf-loader/gltf-object.d.ts

@@ -0,0 +1,17 @@
+import * as THREE from "three/webgpu";
+/**
+ * GLTF 对象
+ */
+declare class GLTFObject extends THREE.Group {
+    needsRender: boolean;
+    /**
+     * mixer 为对应当前对象的动画混合器
+     * @description
+     * 通过 `gltf.animations` 可以获取动画帧。
+     * 通过 `gltf.scene.mixer.clipAction(gltf.animations[0]).play()` 即可播放动画。
+     */
+    mixer: THREE.AnimationMixer;
+    constructor(rootObject?: THREE.Object3D);
+    clone(): this;
+}
+export { GLTFObject };

package/gltf-loader/index.d.ts

@@ -0,0 +1,45 @@
+import * as THREE from "three/webgpu";
+import type { LoadResultType } from "@realsee/five-webgpu";
+import { GLTFObject } from "./gltf-object";
+/**
+ * GLTFLoader 返回数据
+ * @description
+ * 一般情况下，gltf.scene 为模型对象，直接通过 `five.scene.add(gltf.scene)` 即可添加到场景
+ * Five 的模型单位 1 为 1米，载入的模型单位标准不一，请自行 scale。
+ * 如果涉及模型内置动画，GLTF 已经帮你封装了，通过 `gltf.animations` 可以获取动画帧。gltf.scene.mixer 为对应的 动画混合器。
+ * 通过 `gltf.scene.mixer.clipAction(gltf.animations[0]).play()` 即可播放动画。
+ *
+ * 数据由 `@realsee/five-webgpu` 的 `loadGltf` 提供，字段与 `LoadResultType` 保持一致。
+ * 注意 `loadGltf` 以 `{ modelUpAxis: 'Y', upAxis: 'Y' }` 加载，模型保持 glTF 原始的 Y-up 朝向，不会自动旋转到 Five 的 Z-up 坐标系。
+ */
+interface GLTF extends LoadResultType<GLTFObject> {
+    /** 场景列表，本实现中固定为 `[ scene ]` */
+    scenes: GLTFObject[];
+    /** `loadGltf` 不提供相机信息，该字段仅为兼容旧 API 保留，运行时为 `undefined` */
+    cameras?: THREE.Camera[];
+}
+/**
+ * GLTF 模型加载器
+ * @description
+ * 实现基于 `@realsee/five-webgpu` 的 `loadGltf`，因此不再接受 LoadingManager 参数，也不再提供 parse 方法。
+ *
+ * @example
+ * ```
+ * const gltfLoader = new GLTFLoader();
+ * gltfLoader.load("https://vr-public.realsee-cdn.cn/release/static/image/release/five/demo/gltf/plants/scene.gltf", ({ scene }) => {
+ *   five.scene.add(scene);
+ * });
+ * ```
+ */
+declare class GLTFLoader {
+    static get version(): string;
+    /**
+     * 加载模型
+     * @param url - 模型 URL
+     * @param onLoad - 加载完成回调
+     * @param onProgress - 加载进度回调
+     * @param onError - 加载错误回调
+     */
+    load(url: string, onLoad: (gltf: GLTF) => void, onProgress?: (event: ProgressEvent) => void, onError?: (event: ErrorEvent) => void): void;
+}
+export { GLTFObject, GLTFLoader, GLTF };

package/gltf-loader/index.js

@@ -0,0 +1,255 @@
+/**
+ * @license
+ * @realsee/five-webgpu
+ * Generated: 10/14/2026
+ * Version: 1.0.0-alpha.7
+ * Terms:
+ * Realsee SDK License Agreement
+ * Update: July 28, 2021
+ * THIS LICENSE AGREEMENT BETWEEN YOU AND 【BEIKE REALSEE TECHNOLOGY (HK) 
+ * LIMITED】(“Realsee”) FORMS A LEGALLY BINDING CONTRACT BETWEEN YOU AND REALSEE IN 
+ * RELATION TO YOUR USE OF THE SDK. This License Agreement accompanies the Realsee 
+ * Software Development Kit(s) for the software and related explanatory materials 
+ * (the "SDK") and includes any upgrades, modified versions, updates, additions, 
+ * and copies of the SDK licensed to You by Realsee.
+ * BY DOWNLOADING, INSTALLING, OR OTHERWISE ACCESSING OR USING THE SDK, YOU AGREE 
+ * THAT YOU HAVE READ, UNDERSTOOD, AND AGREE TO BE BOUND BY THIS AGREEMENT. YOU ARE 
+ * AGREEING ON YOUR OWN BEHALF AND/OR ON BEHALF OF YOUR COMPANY OR ORGANIZATION TO 
+ * THE TERMS AND CONDITIONS STATED BELOW.
+ * This Agreement applies to Your use of the SDK in the country in which You 
+ * legally install it (“Territory”) and is subject to the laws of such Territory 
+ * and further subject to Section 12 below. Different terms, conditions, and 
+ * limitations may apply to the use of the SDK in any additional countries.
+ * 1. DEFINITIONS.
+ * “Agreement” means this Realsee SDK License Agreement.
+ * “Developer”, “You” and “Your” means the person(s) or entity acquiring or using 
+ * the SDK or otherwise exercising rights under the terms of this Agreement.
+ * “Documentation” means the technical or other specifications or documentation 
+ * that Realsee may provide to You for use in connection with the SDK.
+ * “Integrated Product” means any software, website, or on-line service developed 
+ * by You based on or using the SDK (collectively, the “Integrated Product”).
+ * “Intellectual Property” means any patents, patent rights, trademarks, service 
+ * marks, registered and unregistered designs, applications for any of the 
+ * foregoing, copyright, and any other similar protected rights in any country and 
+ * to the extent recognised by any relevant jurisdiction as intellectual property, 
+ * trade secrets, know-how and confidential information. Realsee reserves all 
+ * rights not expressly granted to You.
+ * “Realsee” means [Beike Realsee Technology (HK) Limited, a company incorporated 
+ * and validly existing under the laws of Hong Kong].
+ * “SDK” means the Realsee-proprietary Software Development Kits (SDK) provided 
+ * hereunder, includes all development tools (including any compiler and debugger), 
+ * application programming interfaces (“APIs”), libraries, binary utilities, header 
+ * files, Documentation, content, data, code samples, and other materials provided 
+ * to You in connection with this Agreement, whether delivered through a download, 
+ * or any other media or form, and is licensed, not sold, to You by Realsee for use 
+ * only under the terms of this Agreement. The terms of this Agreement will govern 
+ * any updates provided by Realsee that replace and/or supplement the original SDK 
+ * delivered to You, unless such update is accompanied by a separate license, in 
+ * which case the terms of such license will govern.
+ * 2. LICENSED USES AND RESTRICTIONS.
+ * 2.1 Subject to the restrictions contained in this Section 2, Realsee grants to 
+ * You during the term, a limited, non-exclusive, revocable, non-sublicensable, 
+ * non-transferable license to install and use the SDK within the Territory only 
+ * for the purpose of internal development.
+ * 2.2 Restrictions. You acknowledge and agree that, You shall not, and shall 
+ * ensure that Your affiliates, employees, agents, representatives, officers, 
+ * representatives, and subcontractors do not (directly or indirectly):
+ * 2.2.1 decompile, reverse engineer, disassemble or attempt to derive the source 
+ * code of, those components of the SDK provided in object code form, or any part 
+ * thereof;
+ * 2.2.2 remove, alter, or obscure any copyright notice or other proprietary rights 
+ * notice on any part of the SDK;
+ * 2.2.3 sell, assign, pledge, rent, lease, lend, upload to or host on any website 
+ * or server for use by any third party except You, redistribute, or sublicense the 
+ * SDK (or any part thereof), or operate the SDK (or any part thereof) in the 
+ * capacity of a service bureau or other hosted services provider, in whole or in 
+ * part, nor may You enable others to do so;
+ * 2.2.4 or alter, modify, customize or improve the SDK, or any part thereof;
+ * 2.2.5 use the SDK (or any part thereof) for any illegal purpose, in any manner 
+ * that is inconsistent with the terms of this Agreement, or to engage in any 
+ * illegal activity;
+ * 2.2.6 use the SDK (or any part thereof) in any manner that may damage the 
+ * operation of Realsee’s products or services; or
+ * 2.2.7 use the SDK or any information contained therein or otherwise provided by 
+ * Realsee for the purpose of developing, or having developed, any product 
+ * competitive with any Realsee product or service, as determined by Realsee in its 
+ * sole discretion;
+ * 2.2.8 include any portion of the SDK in Your Developer products.
+ * 2.3 Realsee has the right to impose reasonable conditions such as a reasonable 
+ * fee for use of the SDK in Integrated Product in the future.
+ * 2.4 You may make a limited number of copies of the SDK to be used by Your 
+ * employees or consultants as provided herein, and not for general business 
+ * purposes, and such employees or consultants shall be subject to the obligations 
+ * and restrictions in this Agreement.
+ * 2.5 All licenses not expressly granted in this Agreement are reserved and no 
+ * other licenses, immunity, or rights, express or implied, are granted by Realsee, 
+ * by implication, estoppel, or otherwise.
+ * 3. CONFIDENTIALITY.
+ * The SDK and all source code, Documentation, specifications, engineering details, 
+ * and related information pertaining to the SDK, whether in oral, written, 
+ * graphic, or electronic form, are and shall remain the confidential and 
+ * proprietary information of Realsee or its licensors (collectively, the 
+ * “Confidential Information”). You shall (i) disclose Confidential Information to 
+ * only those directors and employees (collectively, “Affiliates”) whose duties 
+ * justify their need to know such information and who have been clearly informed 
+ * of their obligation to maintain the confidential, proprietary, and/or trade 
+ * secret status of such Confidential Information; and (ii) use Confidential 
+ * Information solely in accordance with the license granted hereunder. In any 
+ * event, You and Your Affiliates shall treat Confidential Information as strictly 
+ * confidential and shall use the same care to prevent disclosure of such 
+ * information as You use with respect to Your own similar confidential and/or 
+ * proprietary information, which shall not be less than the care a reasonable 
+ * person would use under similar circumstances. All Confidential Information, and 
+ * any copies thereof, shall be returned promptly to Realsee upon request. You 
+ * shall ensure that Your Affiliates comply with the provisions of this Section 3, 
+ * and You shall be liable for any breach of this Section 3 resulting from the act 
+ * or omission of any of Your Affiliates. You shall not disclose Confidential 
+ * Information to any third party, including, without limitation, any of Your 
+ * subcontractors.
+ * 4. PROPRIETARY RIGHTS.
+ * 4.1 As between You and Realsee, Realsee and/or its licensors retain ownership of 
+ * all right, title, and interest in, to, and under the SDK, including, without 
+ * limitation, all patents, copyrights, trade secrets, trademarks and other 
+ * intellectual property and other proprietary rights therein, and reserve all 
+ * rights not expressly granted to You.
+ * 4.2 The items contained in the SDK are the intellectual property of Realsee and 
+ * its licensors and are protected by PRC copyright and patent law, international 
+ * treaty provisions and applicable laws of the country in which it is being used. 
+ * You agree to protect all copyright and other ownership interests of Realsee 
+ * and/or its licensors in all items in the SDK supplied under this License 
+ * Agreement. You agree that all copies of the items in the SDK, reproduced for any 
+ * reason by You, contain the same copyright notices, and other proprietary notices 
+ * as appropriate, as appear on or in the original items delivered by Realsee in 
+ * the SDK. Realsee and/or its licensors retain title and ownership of the items in 
+ * the SDK, the media on which it is loaded, and all subsequent copies, regardless 
+ * of the form or media in or on which the original and other copies may exist. 
+ * Except as stated above, this Agreement does not grant You any rights to patents, 
+ * copyrights, trade secrets, trademarks or any other rights in respect to the 
+ * items in the SDK.
+ * 5. TERM AND TERMINATION.
+ * 5.1 This Agreement is effective until terminated. Realsee has the right to 
+ * terminate this Agreement immediately, without judicial intervention, if You fail 
+ * to comply with any term herein. Upon any such termination You must remove all 
+ * full and partial copies of the items in the SDK from Your computer and 
+ * discontinue the use of the items in the SDK.
+ * 5.2 Realsee may at any time, terminate the Agreement with You if: (A) You have 
+ * breached any provision of the Agreement; or (B) Realsee is required to do so by 
+ * law; or (C) Realsee decides to no longer provide the SDK or certain parts of the 
+ * SDK to users in the country in which You are resident or from which You use the 
+ * service, or the provision of the SDK or certain SDK services to You by Realsee 
+ * is, in Realsee's sole discretion, no longer legally or commercially viable.
+ * 5.3 When the Agreement comes to an end, all of the legal rights, obligations and 
+ * liabilities that You and Realsee have benefited from, been subject to (or which 
+ * have accrued over time whilst the Agreement has been in force) or which are 
+ * expressed to continue indefinitely, shall be unaffected by this cessation, and 
+ * the provisions of Section 3, 4, 6, 7 and 8 shall continue to apply to such 
+ * rights, obligations and liabilities indefinitely.
+ * 6. DISCLAIMER OF WARRANTY.
+ * YOU EXPRESSLY ACKNOWLEDGE AND AGREE THAT, TO THE EXTENT PERMITTED BY APPLICABLE 
+ * LAW, USE OF THE SDK (OR ANY PART THEREOF) IS AT YOUR SOLE RISK AND THAT THE 
+ * ENTIRE RISK AS TO SATISFACTORY QUALITY, PERFORMANCE, ACCURACY, AND EFFORT IS 
+ * WITH YOU. REALSEE LICENSES THE SDK TO YOU ONLY ON AN "AS-IS" BASIS. REALSEE 
+ * MAKES NO REPRESENTATION WITH RESPECT TO THE ADEQUACY OF ANY ITEMS IN THE SDK, 
+ * WHETHER OR NOT USED BY YOU IN THE DEVELOPMENT OF INTEGRATED PRODUCT, FOR ANY 
+ * PARTICULAR PURPOSE OR WITH RESPECT TO THEIR ADEQUACY TO PRODUCE ANY PARTICULAR 
+ * RESULT. REALSEE AND ITS LICENSORS SHALL NOT BE LIABLE FOR LOSS OR DAMAGE ARISING 
+ * OUT OF THIS AGREEMENT OR FROM THE DISTRIBUTION OR USE OF INTEGRATED PRODUCT 
+ * CONTAINING PORTIONS OF THE SDK. REALSEE AND ITS LICENSORS DISCLAIM ALL 
+ * WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED 
+ * CONDITIONS OR WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 
+ * OR NONINFRINGEMENT OF ANY THIRD PARTY RIGHT IN RESPECT OF THE ITEMS IN THE SDK 
+ * OR ANY SERVICES RELATED TO THE SDK.
+ * REALSEE IS UNDER NO OBLIGATION TO PROVIDE ANY SUPPORT UNDER THIS LICENSE 
+ * AGREEMENT, INCLUDING UPGRADES OR FUTURE VERSIONS OF THE SDK OR ANY PORTIONS 
+ * THEREOF, TO YOU, END USER OR TO ANY OTHER PARTY.
+ * 7. LIMITATION OF LIABILITY.
+ * TO THE EXTENT NOT PROHIBITED BY APPLICABLE LAW, IN NO EVENT WILL REALSEE OR ITS 
+ * LICENSORS BE LIABLE FOR ANY DIRECT, INCIDENTAL, SPECIAL, INDIRECT, OR 
+ * CONSEQUENTIAL DAMAGES, INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF USE, 
+ * LOSS OF BUSINESS, REVENUE, OR PROFITS, LOSS OF OPPORTUNITY (WHETHER DIRECT OR 
+ * INDIRECT), CORRUPTION OR LOSS OF DATA, LOSS OF REPUTATION OR SAVINGS, DOWNTIME, 
+ * OR DAMAGE TO, LOSS OF OR REPLACEMENT OF DATA OR TRANSACTIONS, COST OF 
+ * PROCUREMENT OF SUBSTITUTE SERVICES, BUSINESS INTERRUPTION, OR ANY OTHER 
+ * COMMERCIAL DAMAGES OR LOSSES, ARISING OUT OF OR RELATED TO YOUR USE OR INABILITY 
+ * TO USE THE SDK (OR ANY PART THEREOF), ANY INTEGRATED PRODUCT, OR ANY THIRD PARTY 
+ * SOFTWARE, APPLICATIONS, OR SERVICES IN CONJUNCTION WITH THE SDK (OR ANY PART 
+ * THEREOF), HOWEVER CAUSED, REGARDLESS OF THE THEORY OF LIABILITY (CONTRACT, TORT, 
+ * OR OTHERWISE) AND EVEN IF REALSEE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH 
+ * DAMAGES. IN NO EVENT WILL REALSEE’S TOTAL LIABILITY TO YOU FOR ALL DAMAGES 
+ * EXCEED ONE HUNDRED DOLLARS ($100.00). THE FOREGOING LIMITATIONS WILL APPLY EVEN 
+ * IF THE ABOVE STATED REMEDY FAILS OF ITS ESSENTIAL PURPOSE. THE LIMITATIONS 
+ * CONTAINED IN SECTIONS 6 AND THIS SECTION 7 ARE A FUNDAMENTAL PART OF THE BASIS 
+ * OF REALSEE’S BARGAIN HEREUNDER, AND REALSEE WOULD NOT ENTER INTO THIS AGREEMENT 
+ * OR PROVIDE YOU WITH ACCESS TO THE SDK ABSENT SUCH LIMITATIONS.
+ * 8. INDEMNIFICATION.
+ * To the extent permitted by applicable law, You agree to indemnify, defend and 
+ * hold harmless Realsee, its affiliates and each of their directors, officers, 
+ * employees, independent contractors, and agents (each a “Realsee Indemnified 
+ * Party”) from any and all claims, losses, liabilities, damages, expenses, and 
+ * costs (including without limitation attorneys’ fees and court costs) incurred by 
+ * a Realsee Indemnified Party as a result of: (i) Your non-compliance with any 
+ * terms of this Agreement; (ii) Your use of the SDK (or any part thereof); or 
+ * (iii) Your use of any Integrated Product, including any claim that Integrated 
+ * Product infringes the copyright, trademark, trade secret or other intellectual 
+ * property right of a third party.
+ * 9. ACKNOWLEDGEMENTS.
+ * Portions of the SDK may utilize or include third party software and other 
+ * copyrighted material. Acknowledgments, licensing terms, and disclaimers for such 
+ * material are contained in Documentation for the SDK or may otherwise accompany 
+ * such material, and Your use of such materials governed by their respective 
+ * terms. In the event of conflict between the terms of this Agreement and an 
+ * applicable open source or third party agreement, the open source or third party 
+ * agreement will control solely with respect to the open source software or third 
+ * party software. Moreover, You shall not subject any items (including not limited 
+ * to source code, object code, and any software)  included in the SDK to any open 
+ * source license.
+ * 10. NON-BLOCKING OF REALSEE DEVELOPMENT.
+ * You acknowledge that Realsee is currently developing or may develop technologies 
+ * and products in the future that have or may have design and/or functionality 
+ * similar to Integrated Product that You may develop based on Your license herein. 
+ * Nothing in this Agreement shall impair, limit or curtail Realsee's right to 
+ * continue with its development, maintenance and/or distribution of Realsee's 
+ * technology or products.
+ * 11. GENERAL.
+ * 11.1 Export Control. You may not use or otherwise export or re-export the SDK 
+ * (or any part thereof) except as authorized by United States law and the laws of 
+ * the jurisdiction(s) in which the SDK (or any part thereof) was obtained. In 
+ * particular, but without limitation, the SDK may not be exported or re-exported 
+ * (i) into any U.S. embargoed countries or (ii) to anyone on the U.S. Treasury 
+ * Department's list of Specially Designated Nationals or the U.S. Department of 
+ * Commerce Denied Person's List or Entity List. By using the SDK (or any part 
+ * thereof), You represent and warrant that You are not located in any such country 
+ * or on any such list.
+ * 11.2 Governing Law. This Agreement and the rights of the parties hereunder shall 
+ * be governed by and construed in accordance with the laws of People’s Republic of 
+ * China (for purpose of this Agreement, excluding Hong Kong, Taiwan, and Macau), 
+ * without reference to its conflict of laws principles. Any dispute, controversy 
+ * or claim arising from or in connection with this Agreement, or the breach, 
+ * termination or invalidity thereof, shall be submitted to China International 
+ * Economic and Trade Arbitration Commission (“CIETAC”) for arbitration in Beijing 
+ * which shall be conducted in accordance with the CIETAC's arbitration rules in 
+ * effect at the time of applying for arbitration. The arbitral award is final and 
+ * binding upon both parties.
+ * 11.3 Severability. If any provision of this Agreement is held by a court of 
+ * competent jurisdiction to be unenforceable for any reason, the remaining 
+ * provisions hereof will be unaffected and remain in full force and effect.
+ * 11.4. Modifications. Realsee reserves the right, from time to time, with or 
+ * without notice to You, to make revisions to this Agreement in our sole and 
+ * absolute discretion.  The most current version of this Agreement will supersede 
+ * all previous versions and shall be made available on the website where the SDK 
+ * is made available, or by such other means as Realsee may determine in its 
+ * discretion. Any modified versions of this Agreement hereto shall take effect 
+ * from the time that it is made available. You shall be responsible for regularly 
+ * checking for notice of any such modifications. You agree that Your continued use 
+ * of the SDK constitutes Your agreement to the modified Agreement.
+ * 11.5 Relationship of the Parties. This Agreement will not be construed as 
+ * creating an agency, partnership, joint venture, fiduciary duty, or any other 
+ * form of legal association between You and Realsee, and You will not represent to 
+ * the contrary, whether expressly, by implication, appearance, or otherwise.
+ * 11.6 Entire Agreement; Governing Language. This Agreement constitutes the entire 
+ * agreement between You and Realsee with respect to the use of the SDK licensed 
+ * hereunder and supersedes all prior understandings regarding such subject matter. 
+ * No amendment to or modification of this Agreement will be binding unless in 
+ * writing and signed by Realsee. You and Realsee hereto confirm that this 
+ * Agreement and all related documents shall be drafted in English.
+*/Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require("@realsee/five-webgpu"),l=require("three/webgpu");l=s(l,1);var u=class extends l.Group{constructor(e){super(),this.needsRender=!0,e&&e.children.length&&this.add(...e.children),this.mixer=new l.AnimationMixer(this)}clone(){let e=super.clone(!0);return e.mixer=new l.AnimationMixer(e),e.needsRender=!0,e}};function d(e){let t=new u(e.scene);return t.position.copy(e.scene.position),t.quaternion.copy(e.scene.quaternion),t.scale.copy(e.scene.scale),Object.assign(Object.assign({},e),{scene:t,scenes:[t]})}var f=class{static get version(){return`1.0.0-alpha.7`}load(e,t,n,r){(0,c.loadGltf)(e,{modelUpAxis:`Y`,upAxis:`Y`,onDownloadProgress(e,t,r){n&&n(new ProgressEvent(`progress`,{lengthComputable:typeof r==`number`,loaded:t==null?0:t,total:r==null?0:r}))}}).then(e=>{t(d(e))}).catch(e=>{r?r(new ErrorEvent(`error`,{error:e,message:e instanceof Error?e.message:String(e)})):console.error(e)})}};exports.GLTFLoader=f,exports.GLTFObject=u;