npm - @realsee/five-webgpu - Versions diffs - 1.0.0-alpha.5 → 1.0.0-alpha.7 - Mend

@@ -0,0 +1,14 @@
+import type { Direction } from '../typing';
+import * as THREE from 'three/webgpu';
+export declare class DirectionGroup extends THREE.Group {
+    direction: Direction;
+    constructor(direction?: Direction);
+}
+export declare class DirectionLine<T extends THREE.BufferGeometry, K extends THREE.Material> extends THREE.Line<T, K> {
+    direction: Direction;
+    constructor(geometry?: T, material?: K, direction?: Direction);
+}
+export declare class DirectionMesh<T extends THREE.BufferGeometry, K extends THREE.Material> extends THREE.Mesh<T, K> {
+    direction: Direction;
+    constructor(geometry?: T, material?: K, direction?: Direction);
+}

@@ -0,0 +1,5 @@
+import * as THREE from 'three/webgpu';
+export declare function getMouseRaycaster(camera: THREE.Camera, mouse: {
+    x: number;
+    y: number;
+}, element: HTMLElement): THREE.Raycaster | undefined;

@@ -0,0 +1,8 @@
+import * as THREE from 'three/webgpu';
+/**
+ * @description 获取正交相机的方向
+ */
+export declare function getOrthographicCameraDirection(pose: {
+    longitude: number;
+    latitude: number;
+}): THREE.Vector3;

@@ -0,0 +1,8 @@
+import * as THREE from 'three/webgpu';
+/**
+ * @description: 在指定中心点上，使用 quaternion 旋转物体。
+ * @param {THREE.Object3D} object 旋转对象
+ * @param {THREE.Quaternion} quaternion 旋转四元数
+ * @param {THREE.Vector3} rotateCenter 旋转中心
+ */
+export default function setObjectQuaternion(object: THREE.Object3D, quaternion: THREE.Quaternion, rotateCenter: THREE.Vector3): void;

@@ -0,0 +1,27 @@
+import * as THREE from 'three/webgpu';
+/** 将世界坐标投影为屏幕像素坐标 */
+export declare function projectToScreen(camera: THREE.Camera, container: HTMLElement | null | undefined, point: THREE.Vector3): THREE.Vector2;
+/** 估算某方向上线段的像素与世界长度的比例（世界单位/像素） */
+export declare function computeWorldPerPixel(camera: THREE.Camera, container: HTMLElement | null | undefined, center: THREE.Vector3, direction: THREE.Vector3): number | undefined;
+/** 计算直线长度：随相机距离/视口变化自适应，限制在可视范围内 */
+export declare function computeGuideLength(camera: THREE.Camera, center: THREE.Vector3): number;
+export type SolidGuideOptions = {
+    color?: number;
+    renderOrder?: number;
+};
+export declare class SolidGuideLine {
+    private camera;
+    private container;
+    private defaults;
+    constructor(camera: THREE.Camera, container: HTMLElement | null | undefined, defaults?: SolidGuideOptions);
+    /** 创建无限长直线（Line + LineBasicMaterial），穿过整个平面 */
+    createSolidLine(center: THREE.Vector3, direction: THREE.Vector3, options?: SolidGuideOptions): THREE.Line<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.LineBasicMaterial, THREE.Object3DEventMap>;
+    /** 更新已创建的直线，使其始终穿过整个平面 */
+    updateSolidLine(line: THREE.Line<THREE.BufferGeometry, THREE.LineBasicMaterial>, center: THREE.Vector3, direction: THREE.Vector3, options?: SolidGuideOptions): void;
+    /** 计算"无限"直线的长度，确保穿过整个可视区域 */
+    private computeInfiniteLineLength;
+    /** 释放直线的几何与材质 */
+    dispose(line?: THREE.Line<THREE.BufferGeometry, THREE.LineBasicMaterial>): void;
+    /** 更新默认配置 */
+    updateDefaults(options: SolidGuideOptions): void;
+}

@@ -0,0 +1,8 @@
+export declare function createElement(style?: Partial<CSSStyleDeclaration>, tagName?: string): HTMLElement;
+export declare function setStyle(element: HTMLElement, style?: Partial<CSSStyleDeclaration>): HTMLElement;
+export declare function tipsDom(style?: Partial<CSSStyleDeclaration>): {
+    element: HTMLElement;
+    show: () => void;
+    hide: () => void;
+    setLeftTop: (left: string, top: string) => void;
+};

@@ -0,0 +1,49 @@
+import { Five } from '@realsee/five-webgpu';
+import { BasePlugin } from '../BasePlugin';
+import type * as PluginType from './typing';
+export declare class Controller extends BasePlugin.Controller<PluginType.State, PluginType.EventMap, PluginType.ServerData, PluginType.PluginData> {
+    /** 当前使用的数据 */
+    data?: PluginType.PluginData;
+    /** 插件当前状态 */
+    state: PluginType.State;
+    /** config 的原始值 */
+    private _config;
+    get config(): {
+        maxOpacity: number;
+    };
+    private group;
+    private canvas?;
+    private ctx?;
+    private canvasTexture?;
+    private startTime?;
+    private updateState;
+    /**
+     * 更改插件 Config
+     * @param config - 插件属性 `config` 的子集。
+     * @param options - 参数
+     */
+    updateConfig(config: Partial<PluginType.Config>, options?: BasePlugin.BaseOptions): void;
+    /** 光柱材质及其 uniform 节点集合（等价于 five 版本的 ShaderMaterial.uniforms） */
+    private materialUniforms;
+    private mesh;
+    private panoMesh;
+    constructor(five: Five, params?: PluginType.Params);
+    load(data: PluginType.ServerData): Promise<void>;
+    private stop;
+    private drawLine;
+    private anime;
+    private _enable;
+    private _disable;
+    /**
+     * 启用插件，让插件能够响应交互
+     */
+    enable(options?: BasePlugin.BaseOptions): void;
+    /**
+     * 禁用插件，让插件停止响应交互
+     */
+    disable(options?: BasePlugin.BaseOptions): void;
+    /** 更改插件 State */
+    setState(state: Partial<PluginType.State>, options?: BasePlugin.BaseOptions): void;
+    /** 销毁插件，移除所有副作用，销毁后将不响应任何 API */
+    dispose: () => void;
+}

@@ -0,0 +1,5 @@
+import type { Five } from '@realsee/five-webgpu';
+import type * as PanoAnimePluginType from './typing';
+import { Controller } from './Controller';
+export declare const PanoAnimePlugin: (five: Five, params?: PanoAnimePluginType.Params) => Controller;
+export type { PanoAnimePluginType, Controller as PanoAnimeController };

@@ -0,0 +1,37 @@
+import { BasePlugin } from '../BasePlugin';
+export type PluginData = {};
+export type ServerData = {};
+/** 插件配置 */
+export interface Config {
+    maxOpacity: number;
+}
+/** 插件初始化参数 */
+export interface Params {
+    config?: Partial<Config>;
+    initialState?: Partial<State>;
+}
+/** 插件状态 */
+export interface State extends BasePlugin.State {
+    /** 插件是否启用 */
+    enabled: boolean;
+    /** 插件整体是否可见 */
+    visible: boolean;
+}
+export interface ConfigChangeEvent {
+    /** 变更前的 config */
+    prevConfig: Config;
+    /** 变更后的 config */
+    config: Config;
+    /** 是否是用户操作 */
+    userAction: boolean;
+}
+/** 插件事件 */
+export interface EventMap extends BasePlugin.EventMap<State, PluginData> {
+    drawingChange: (drawing: boolean) => void;
+    /** config 变更的回调 */
+    configChange: (event: {
+        prevConfig: Config;
+        config: Config;
+        userAction: boolean;
+    }) => void;
+}

@@ -1,2 +1,8 @@
+export * from './BackgroundPlugin';
+export * from './Object3DHelperPlugin';
+export * from './PanoAnimePlugin';
+export * from './CSS2DPlugin';
+export * from './CSS3DPlugin';
+export * from './FloorplanPlugin';
 export { GaussianSplattingEntranceAnimationPlugin, type GaussianSplattingEntranceAnimationPluginType, type GaussianSplattingEntranceAnimationController, } from './GaussianSplattingEntranceAnimationPlugin';
 export { BasePlugin } from './BasePlugin';

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