@realsee/dnalogel 3.71.0 → 3.71.1-alpha.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # CHANGELOG
 
+## 3.71.1-alpha.2
+
+- feat(ModelMakerPlugin): 支持传入自定义颜色高亮标签以及扫光动画
+- feat(ModelMakerPlugin): 支持隐藏/显示部分或全部item，扫光传入的颜色应用到面
+- feat(Utils.lookObject): 支持minDistance和minLatitude
+
 ## 3.71.0
 
 - chore(PanoTagPlugin): 调整修改默认碰撞检测的误差值
@@ -8,6 +14,14 @@
 
 - chore(MarketingTag): 调整商品标签的价格单位文案展示位置到价格后面
 
+## 3.70.9
+
+- fix(Sculpt): 修复Prism扫光在沙盘下消失的问题
+
+## 3.70.8
+
+- feat(Sculpt): 支持Prism进行扫光
+
 ## 3.70.7
 
 - fix(MapviewFloorplanPlugin, ModelFloorplanPlugin): 修复Floorplan插件初始index错误的问题

package/dist/ModelMakerPlugin/Controller.d.ts

@@ -2,6 +2,15 @@ import { type Five, type Mode as FiveMode } from '@realsee/five';
 import * as THREE from 'three';
 import * as BasePlugin from '../base/BasePluginWithData';
 import type { MarkerItem, State, ServerData, ItemType, ElementRenderer, EventMap } from './typings';
+/**
+ * 盒子动画配置选项
+ */
+export interface BoxAnimationConfig {
+    /** 动画颜色，默认为 #4DF0FF */
+    color?: string;
+    /** 是否在动画期间隐藏标签并在完成后缓动显示，默认为 false */
+    hideLabels?: boolean;
+}
 export declare class Controller extends BasePlugin.Controller<State, EventMap, ServerData, ServerData> {
     state: State;
     items: MarkerItem[];
@@ -16,6 +25,9 @@ export declare class Controller extends BasePlugin.Controller<State, EventMap, S
     private fiveEveryReadyListenerDisposer?;
     private originalOpacities;
     private originalTagOpacities;
+    private highlightedItem;
+    private originalTagStyles;
+    private originalModelColors;
     constructor(five: Five, config?: {
         tagContainerZIndex?: number;
         /**
@@ -39,14 +51,16 @@ export declare class Controller extends BasePlugin.Controller<State, EventMap, S
     /**
      * Force finish all active box animations immediately
      * @param id Optional box item ID. If not provided, finishes all active box animations.
+     * @param restoreLabels Whether to restore labels immediately. Defaults to true.
      */
-    forceFinishBoxAnimation(id?: string | number): void;
+    forceFinishBoxAnimation(id?: string | number, restoreLabels?: boolean): void;
     /**
      * Play the up-and-down animation for a box mesh
      * @param id Optional box item ID. If not provided, plays animation for all box items.
+     * @param config Animation configuration options
      * @returns Promise that resolves when all animations are complete
      */
-    playBoxAnimation(id?: string | number): Promise<void>;
+    playBoxAnimation(id?: string | number, config?: BoxAnimationConfig): Promise<void>;
     enable(): void;
     disable(): void;
     show(): void;
@@ -73,8 +87,73 @@ export declare class Controller extends BasePlugin.Controller<State, EventMap, S
      * @param itemTypes 模型类型数组
      */
     showItemsByType(itemTypes: ItemType[] | ItemType): void;
+    /**
+     * 根据条件隐藏模型项目
+     * @param condition 判断函数，返回 true 的项目将被隐藏
+     * @example
+     * // 隐藏所有 ID 大于 10 的项目
+     * controller.hideItemsByCondition(item => item.rawData.id > 10)
+     *
+     * // 隐藏所有红色的盒子
+     * controller.hideItemsByCondition(item =>
+     *   item.type === 'box' && item.rawData.object_data.color === '#FF0000'
+     * )
+     */
+    hideItemsByCondition(condition: (item: MarkerItem) => boolean): void;
+    /**
+     * 根据条件显示模型项目
+     * @param condition 判断函数，返回 true 的项目将被显示
+     * @example
+     * // 显示所有棱柱类型的项目
+     * controller.showItemsByCondition(item => item.type === 'prism')
+     *
+     * // 显示所有透明度大于 0.5 的项目
+     * controller.showItemsByCondition(item =>
+     *   (item.rawData.object_data.opacity ?? 0.4) > 0.5
+     * )
+     */
+    showItemsByCondition(condition: (item: MarkerItem) => boolean): void;
+    /**
+     * 根据条件设置模型项目的可见性
+     * @param condition 判断函数，返回 true 的项目将应用指定的可见性状态
+     * @param visible 是否可见，true 为显示，false 为隐藏
+     * @example
+     * // 隐藏所有小于指定面积的项目
+     * controller.setItemsVisibility(item => getItemArea(item) < 100, false)
+     *
+     * // 显示所有包含特定标签的项目
+     * controller.setItemsVisibility(item =>
+     *   item.rawData.label?.includes('important'), true
+     * )
+     */
+    setItemsVisibility(condition: (item: MarkerItem) => boolean, visible: boolean): void;
+    /**
+     * 显示所有模型项目
+     * @example
+     * // 恢复所有项目的可见性
+     * controller.showAllItems()
+     */
+    showAllItems(): void;
+    /**
+     * 隐藏所有模型项目
+     * @example
+     * // 隐藏所有项目
+     * controller.hideAllItems()
+     */
+    hideAllItems(): void;
     dispose(): void;
     protected onWorkCodeChange(): void;
+    /**
+     * 应用高亮样式到指定项目
+     * @param item 要高亮的项目
+     * @param color 高亮颜色
+     */
+    private applyHighlightStyles;
+    /**
+     * 移除指定项目的高亮样式
+     * @param item 要移除高亮的项目
+     */
+    private removeHighlightStyles;
     /**
      * 设置棱柱体模型的透明度
      * @param id 模型id
@@ -96,7 +175,32 @@ export declare class Controller extends BasePlugin.Controller<State, EventMap, S
     private handleDisable;
     private onFiveEveryReady;
     private updateTagRenderer;
+    /**
+     * 高亮指定的模型项目
+     * @param id 模型项目的ID
+     * @param color 高亮颜色，默认为 #FF7700
+     */
+    highlightItem(id: string | number, color?: string): void;
+    /**
+     * 重置所有高亮
+     */
+    resetHighlight(): void;
+    /**
+     * 获取当前高亮的项目ID
+     */
+    getHighlightedItemId(): string | number | null;
     getPrismItems(): MarkerItem[];
     getPolygonItems(): MarkerItem[];
     getBoxItems(): MarkerItem[];
+    /**
+     * 隐藏指定项目的标签
+     * @param items 要隐藏标签的项目数组
+     */
+    private hideItemLabels;
+    /**
+     * 缓动显示指定项目的标签
+     * @param items 要显示标签的项目数组
+     * @param duration 缓动持续时间（毫秒）
+     */
+    private easeInItemLabels;
 }

package/dist/ModelMakerPlugin/index.d.ts

@@ -1,5 +1,6 @@
 import type * as ModelMakerPluginType from './typings';
 import { Controller } from './Controller';
+import type { BoxAnimationConfig } from './Controller';
 export declare const ModelMakerPlugin: (five: import("@realsee/five").Five, config?: {
     tagContainerZIndex?: number;
     occlusionVisibility?: boolean | import("@realsee/five").Mode[];
@@ -7,3 +8,4 @@ export declare const ModelMakerPlugin: (five: import("@realsee/five").Five, conf
 }) => ModelMakerPluginType.ModelMakerController;
 export type { Controller as ModelMakerPluginInstance };
 export type { ModelMakerPluginType };
+export type { BoxAnimationConfig };

package/dist/Sculpt/Meshes/Prism.d.ts

@@ -18,6 +18,7 @@ export interface PrismData extends AreaData {
 export declare class PrismMesh extends IObject3D {
     name: string;
     private five?;
+    private animatedBoxMesh?;
     private activeAnimations;
     private activeEaseInAnimations;
     get topPosition(): THREE.Vector3;
@@ -75,15 +76,21 @@ export declare class PrismMesh extends IObject3D {
     /**
      * 播放盒子上下动画
      * @param id 盒子项目ID
+     * @param color 动画颜色，默认为浅蓝色 (#4DF0FF)
      * @returns Promise，动画完成时解析
      */
-    playBoxAnimation(id: string | number): Promise<void>;
+    playBoxAnimation(id: string | number, color?: string): Promise<void>;
     /**
      * 强制立即完成所有活动的盒子动画
      * @param id 可选的盒子项目ID。如果未提供，完成所有活动的盒子动画。
      */
     forceFinishBoxAnimation(id?: string | number): void;
     private playEaseInAnimation;
+    /**
+     * 创建或更新动画盒子网格
+     * @param color 动画颜色
+     */
+    private createOrUpdateAnimatedBoxMesh;
     /**
      * 显示盒子模型的最终状态（完全可见且不透明度完整）
      */