@realsee/dnalogel 2.29.0-dev.3 → 2.30.0

package/dist/CurrentPanoImagePlugin/Controller.d.ts

@@ -0,0 +1,93 @@
+import type { BaseOptions } from '../base/BasePlugin';
+import type { Five } from '@realsee/five';
+import * as BasePlugin from '../base/BasePlugin';
+import type * as PluginType from './typings';
+export declare class CurrentPanoImagePluginController extends BasePlugin.Controller<PluginType.State, PluginType.EventMap> {
+    /** 插件当前状态 */
+    state: PluginType.State;
+    /** 插件配置项 */
+    get config(): {
+        width: number;
+        yOffset: number;
+        yRotate: number;
+        imageURL: string;
+        staticPrefix?: string;
+        i18n?: (key: string) => string;
+    };
+    /** 是否已经被销毁 */
+    get disposed(): boolean;
+    /** 查询问题使用的调试对象 */
+    checkMsg: {
+        meshVisible: string;
+    };
+    private group;
+    private mesh;
+    private textureLoadingPromise?;
+    private opacityAnimeTween?;
+    /** 是否正在走点动画中 */
+    private isInPanoMoveAnime;
+    /** 上一次走点的全景图索引 */
+    private lastArrivedPanoIndex;
+    /** config 的原始值 */
+    private _config;
+    /** disposed 的原始值 */
+    private _disposed;
+    constructor(five: Five, params?: PluginType.Params);
+    /**
+     * 启用插件，响应用户操作并展示UI
+     * @param options
+     */
+    enable(options?: Required<BaseOptions>): void;
+    /** 禁用插件
+     * @param `options` `<Option> | <undefined>`
+     * @param `options.userAction` `<boolean> | <undefined>` 是否是用户操作。默认是 true。
+     */
+    disable(options?: BasePlugin.BaseOptions): void;
+    /** 插件内容整体展示
+     * @param `options` `<Partial<BaseOptions>> | <undefined>`
+     * @param `options.userAction` `<boolean> | <undefined>` 是否是用户操作。默认是 true。
+     */
+    show(options?: Partial<PluginType.ShowHideOptions>): Promise<void>;
+    /** 插件内容整体隐藏
+     * @param `options` `<Partial<BaseOptions>> | <undefined>`
+     * @param `options.userAction` `<boolean> | <undefined>` 是否是用户操作。默认是 true。
+     */
+    hide(options?: Partial<PluginType.ShowHideOptions>): Promise<void>;
+    /** 更改插件 State
+     * @param `state` `<Partial<Plugin.State>>` 插件属性 `state` 的子集。
+     * @param `options` `<Option> | <undefined>`
+     * @param `options.userAction` `<boolean> | <undefined>` 是否是用户操作。默认是 true。
+     */
+    setState(state: Partial<PluginType.State>, options?: BasePlugin.BaseOptions): void;
+    /** 更改插件 Config
+     * @param `config` `<Partial<Plugin.Config>>` 插件属性 `config` 的子集。
+     * @param `options` `<Option> | <undefined>`
+     */
+    updateConfig(config: Partial<PluginType.Config>, options?: BasePlugin.BaseOptions): void;
+    /**
+     * 销毁插件
+     * @todo 销毁贴图时，最好还是直接销毁贴图吧，this.mesh?.material.map 这种都是很深层的引用了。THREE 的建议我看也是自己去管理和销毁公共贴图。
+     */
+    dispose: () => void;
+    private updateState;
+    private updateMeshVisible;
+    /** 根据点位更新 Mesh 坐标 */
+    private updateMeshPosition;
+    /** 重新加载贴图，调用时会先清除已有的贴图 */
+    private reloadTexture;
+    /** north_rad 变化时，需要更新模型的旋转角度 */
+    private updateMeshQuaternion;
+    private checkMeshVisible;
+    private _enable;
+    private _disable;
+    private _show;
+    private _hide;
+    /** 贴图加载完成的回调 */
+    private onTextureLoaded;
+    private onFiveWillLoad;
+    /** 走点前 */
+    private onFivePanoWillArrive;
+    /** 走点后 */
+    private onFivePanoArrived;
+    private onFiveModeChange;
+}

package/dist/CurrentPanoImagePlugin/index.d.ts

@@ -0,0 +1,7 @@
+import type { FivePlugin } from '@realsee/five';
+import type * as CurrentPanoImagePluginType from './typings';
+import { CurrentPanoImagePluginController } from './Controller';
+export declare const CurrentPanoImagePlugin: FivePlugin<CurrentPanoImagePluginType.Params, CurrentPanoImagePluginController>;
+export default CurrentPanoImagePlugin;
+export type CurrentPanoImagePluginExportType = CurrentPanoImagePluginController;
+export type { CurrentPanoImagePluginType };

package/dist/CurrentPanoImagePlugin/typings.d.ts

@@ -0,0 +1,58 @@
+import type * as BasePlugin from '../base/BasePlugin';
+export interface Config extends BasePlugin.Config {
+    /** 贴图宽度，单位：米 */
+    width: number;
+    /** 高度偏移量，单位：米 */
+    yOffset: number;
+    /** 沿着 Y 轴正方向旋转角度，单位：弧度 */
+    yRotate: number;
+    /** 贴图 URL */
+    imageURL: string;
+}
+export interface State extends BasePlugin.State {
+    visible: boolean;
+}
+export interface ShowHideOptions extends BasePlugin.BaseOptions {
+    userAction: boolean;
+}
+export interface EventMap extends BasePlugin.EventMap<State> {
+    /** visible 从 false 到 true 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    show: (event: {
+        userAction: boolean;
+    }) => void;
+    /** visible 从 true 到 false 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    hide: (event: {
+        userAction: boolean;
+    }) => void;
+    /** enabled 从 false 到 true 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    enable: (event: {
+        userAction: boolean;
+    }) => void;
+    /** enabled 从 true 到 false 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    disable: (event: {
+        userAction: boolean;
+    }) => void;
+    /** config 变更的回调
+     * @param event.prevConfig 变更前的 config
+     * @param event.config 变更后的 config
+     * @param event.userAction 是否是用户操作
+     */
+    configChange: (event: {
+        prevConfig: Config;
+        config: Config;
+        userAction: boolean;
+    }) => void;
+}
+/** 插件初始化参数 */
+export interface Params {
+    config?: Partial<Config>;
+    initialState?: Partial<State>;
+}