@realsee/dnalogel 3.42.0-alpha-tag.44 → 3.42.0

package/CHANGELOG.md

@@ -1,13 +1,18 @@
 # CHANGELOG
 ## 3.42.0-alpha-tag.14
 - feat(PanoTagPlugin)
-  1. 优化fov变化时标签位置的计算
-  2. 可通过 `config.simulate3D` 启用模拟3d的近大远小的效果
-  3. 添加 `loaded` 事件，load完成后触发
-  4. 添加 `tagsLengthChange` 事件，调用`addTag()`, `clearTags()`, `tag.destroy()` 等方法 使标签数量发生变化时触发
-  5. 性能优化
-- fix(reblink): 修复将 Dom 的 opacity 主动设置为 0 时，反向闪烁动画不生效的问题。
-- feat(Util): 新增 `Util.lookObject` 和 `Util.lookPoint`, 模型态下以最佳视角查看一个物体或坐标点。
+  1. 优化fov变化时标签位置的计算。
+  2. 可通过 `globalConfig.simulate3D` 启用模拟3d的近大远小的效果，默认关闭。
+  3. 添加 `tag.find()` 方法，移动至适当位置找到此标签。
+  4. 添加 `loaded` 事件，load完成后触发。
+  5. 添加 `tagsLengthChange` 事件，调用`addTag()`, `clearTags()`, `tag.destroy()` 等方法 使标签数量发生变化时触发。
+  6. 移除方法中的 `withAnimation` 参数，现在默认 `show`, `hide`, `enable` 全部带fade动画。
+  7. 展示性能优化，加载速度优化。
+- feat(Util): 
+  1. `Util.lookObject`,模型态下以最佳视角查看一个物体。
+  2. `Util.lookPoint`: 模型态下以最佳视角查看一个坐标点。
+  3. `Util.reblink`: 修复将 dom 的 opacity 主动设置为 0 时，反向闪烁动画不生效的问题。
+- chore(Object3DHelperPlugin): 优化一些代码。
 
 ## 3.41.7
 - chore(*): update `BasePlugin`

package/dist/ModelMakerPlugin/Controller.d.ts

@@ -3,14 +3,13 @@ import * as BasePlugin from '../base/BasePluginWithData';
 import type * as PluginType from './typings';
 import * as THREE from 'three';
 import type { ModelMakerBaseItem } from './item/baseItem';
-import type { FiveDomEvents } from '../shared-utils/five/FiveDomEvents';
 export declare class Controller extends BasePlugin.Controller<PluginType.State, PluginType.EventMap, PluginType.ServerData, PluginType.ServerData> {
     state: PluginType.State;
     items: ModelMakerBaseItem[];
     group: THREE.Group;
-    fiveDomEvents: FiveDomEvents;
     protected data: PluginType.ServerData;
     private tagRendererMap;
+    private fiveDomEvents;
     private zFightingOffset;
     private tagWrapper;
     private occlusionVisibility;

package/dist/Object3DHelperPlugin/Controller.d.ts

@@ -6,26 +6,87 @@ import type { Object3DHelperState, ObjectHelperControllers, PositionFrom, ScaleC
 import type { HelperConfig, HelperOffset, Object3DHelperPluginEventMap, Object3DHelperPluginState } from './typings';
 export declare const PLUGIN = "Object3DHelperPlugin";
 export type AddObject3DHelperConfig = {
+    /**
+     * @description 辅助坐标轴的位置，基于 object local 坐标系。
+     * ```markdown
+     * 'boundingBox': 物体 boundingBox 的中心
+     * 'boundingSphere': 物体 boundingSphere 的中心
+     * `THREE.Vector3`: 指定 Vector3
+     * `(object3D) => THREE.Vector3`: 指定 Vector3
+     * ```
+     * @default 'objectPosition'
+     */
     positionFrom?: PositionFrom;
+    /**
+     * @description 辅助坐标轴的位置偏移量
+     */
     offset?: HelperOffset;
+    /**
+     * @description 辅助坐标轴的y轴方向
+     */
     yAxis?: THREE.Vector3;
+    /**
+     * @description 辅助坐标轴的x轴方向
+     */
     xAxis?: THREE.Vector3;
+    /**
+     * @description 辅助坐标轴的z轴方向
+     */
     zAxis?: THREE.Vector3;
+    /**
+     * @description 位移的配置
+     */
     moveHelper?: HelperConfig<{
+        /**
+         * @description 是否开启X轴位移功能
+         */
         xArrowEnable?: boolean;
+        /**
+         * @description 是否开启Y轴位移功能
+         */
         yArrowEnable?: boolean;
+        /**
+         * @description 是否开启Z轴位移功能
+         */
         zArrowEnable?: boolean;
     }>;
+    /**
+     * @description 旋转的配置
+     */
     rotateHelper?: HelperConfig<{
+        /**
+         * @description 是否开启X轴旋转功能
+         */
         yzCircleEnable?: boolean;
+        /**
+         * @description 是否开启Y轴旋转功能
+         */
         xzCircleEnable?: boolean;
+        /**
+         * @description 是否开启Z轴旋转功能
+         */
         xyCircleEnable?: boolean;
+        /**
+         * @description 旋转时的角度提示
+         */
         angleTipsEnable?: boolean;
     }>;
+    /**
+     * @description 缩放的配置
+     */
     scaleHelper?: HelperConfig<{
+        /**
+         * @description 缩放 handlers 的位置
+         */
         positions?: Array<ScalePosition> | (() => Array<ScalePosition>);
+        /**
+         * @description 缩放 handler 被拖动后的回调
+         */
         scaleCallback?: ScaleCallback;
     }>;
+    /**
+     * @description 物体包围盒
+     */
     boundingBoxHelper?: HelperConfig;
 };
 export declare class Object3DHelperController extends BasePlugin.Controller<Object3DHelperPluginState, Object3DHelperPluginEventMap> {

package/dist/PanoTagPlugin/controller/Tag/BaseTag.d.ts

@@ -84,6 +84,7 @@ export declare abstract class BaseTag<C extends TagContentType = TagContentType,
     initialConfig: TagData['config'];
     private computedConfig;
     cache: Cache;
+    entryFromModel?: boolean;
     get sharedCache(): Cache;
     constructor(plugin: PanoTagPluginController, tagData: TagData);
     /**
@@ -105,6 +106,10 @@ export declare abstract class BaseTag<C extends TagContentType = TagContentType,
      * @description 展开
      */
     unfold(): void;
+    /**
+     * @description 展开自己，收起其他标签
+     */
+    unfoldAndFoldOthers(): void;
     /**
      * @description 收起
      */
@@ -140,7 +145,6 @@ export declare abstract class BaseTag<C extends TagContentType = TagContentType,
      */
     set(tag: PartialObjectDeep<Tag<C>>, deepMerge?: boolean): void;
     updateConfig(): void;
-    updateVisibleState(): void;
     updateVisible(): void;
     updateZIndex(): void;
     getConfig(tagData?: TagData, params?: {
@@ -159,6 +163,15 @@ export declare abstract class BaseTag<C extends TagContentType = TagContentType,
         value: boolean;
         reason?: any;
     };
+    /**
+     * @description 计算标签可见性
+     */
+    protected computeVisibleByFiveMode(config: Exclude<Extract<TagConfig['visibleConfig'], Record<any, any>>, Function>, mode: Mode): {
+        value: boolean;
+        reason: string;
+        visibleFiveMode: (Mode | "all" | Mode[] | "PanoramaLike" | "ModelLike") | ((tag: import("../..").TagInstance) => Mode | "all" | Mode[] | "PanoramaLike" | "ModelLike");
+        mode: Mode;
+    };
     /** 通过射线检测标签可用性 */
     protected computeVisibleByIntersect(panoIndex?: number): {
         value: boolean;

package/dist/PanoTagPlugin/controller/Tag/PointTag.d.ts

@@ -7,6 +7,10 @@ export declare class PointTag<C extends TagContentType = TagContentType> extends
     private __Object__;
     private requestIdleCallbackId?;
     constructor(plugin: PanoTagPluginController, tagData: TagData);
+    /**
+     * @description 展开自己，收起其他标签
+     */
+    unfoldAndFoldOthers(): void;
     onClick(params: Pick<TagClickParams, 'target'>): void;
     updateVisible(): void;
     applyVisible(): void;

package/dist/PanoTagPlugin/controller/index.d.ts

@@ -119,10 +119,6 @@ declare class PanoTagPluginController extends TagRender {
     private handleHide;
     private handleEnable;
     private handleDisable;
-    /**
-     * @description 添加 cameraUpdate, panoArrived 等事件监听
-     */
-    private addEventListener;
     private addResizeListener;
     private addResizeObserver;
     private handleFiveModeChange;
@@ -136,6 +132,10 @@ declare class PanoTagPluginController extends TagRender {
     private onFiveEveryReady;
     private setUnfoldedByCamera;
     private changeTagMode;
+    /**
+     * @description 添加 cameraUpdate, panoArrived 等事件监听
+     */
+    private addEventListener;
     render: () => void;
 }
 export default PanoTagPluginController;

package/dist/PanoTagPlugin/typings/tag/TagConfig.d.ts

@@ -59,6 +59,11 @@ export interface TagConfig<C extends TagContentType = TagContentType> {
          * ```
          */
         visibleFiveMode?: TagVisibleMode | ((tag: TagInstance) => TagVisibleMode);
+        /**
+         * @description 全景标签在模型中可见，点击后进入全景看向标签
+         * @default false
+         */
+        entryFromModel?: boolean;
         /**
          * @description 当 visibleFiveMode 包含 'Floorplan' 或者 'MapView' 时，是否仅在当前楼层模型下可见
          * @default false