npm - @realsee/dnalogel - Versions diffs - 3.71.0 → 3.71.1-alpha.1 - Mend

@realsee/dnalogel 3.71.0 → 3.71.1-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (496) hide show

package/docs/variables/modelRoomLabelPluginServerParams.html CHANGED Viewed

	@@ -1 +1 @@
1	- <!DOCTYPE html><html class="default" lang="en"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>modelRoomLabelPluginServerParams \| 如视空间交互插件合集 - v3.71.0</title><meta name="description" content="Documentation for 如视空间交互插件合集"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><link rel="stylesheet" href="../assets/custom.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") \|\| "os";document.body.style.display="none";setTimeout(() => app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><div class="table-cell" id="tsd-search" data-base=".."><div class="field"><label for="tsd-search-field" class="tsd-widget tsd-toolbar-icon search no-caption"><svg width="16" height="16" viewBox="0 0 16 16" fill="none"><use href="../assets/icons.svg#icon-search"></use></svg></label><input type="text" id="tsd-search-field" aria-label="Search"/></div><div class="field"><div id="tsd-toolbar-links"></div></div><ul class="results"><li class="state loading">Preparing search index...</li><li class="state failure">The search index is not available</li></ul><a href="../index.html" class="title">如视空间交互插件合集 - v3.71.0</a></div><div class="table-cell" id="tsd-widgets"><a href="#" class="tsd-widget tsd-toolbar-icon menu no-caption" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb"><li><a href="../modules.html">如视空间交互插件合集</a></li><li><a href="modelRoomLabelPluginServerParams.html">modelRoomLabelPluginServerParams</a></li></ul><h1>Variable modelRoomLabelPluginServerParams<code class="tsd-tag">Const</code></h1></div><div class="tsd-signature"><span class="tsd-kind-variable">model<wbr/>Room<wbr/>Label<wbr/>Plugin<wbr/>Server<wbr/>Params</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-symbol">{ </span><br/><span> </span><span class="tsd-kind-property">name</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">string</span><span class="tsd-signature-symbol">; </span><br/><span> </span><span class="tsd-kind-property">version</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">number</span><span class="tsd-signature-symbol">; </span><br/><span class="tsd-signature-symbol">}</span><span class="tsd-signature-symbol"> = ...</span></div><aside class="tsd-sources"><ul><li>Defined in plugins/src/ModelRoomLabelPlugin/index.ts:9</li></ul></aside></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><h3><svg width="20" height="20" viewBox="0 0 24 24" fill="none"><use href="../assets/icons.svg#icon-chevronDown"></use></svg>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="../assets/icons.svg#icon-1"></use></svg><span>如视空间交互插件合集 - v3.71.0</span></a><ul class="tsd-small-nested-navigation" id="tsd-nav-container" data-base=".."><li>Loading...</li></ul></nav></div></div></div><footer></footer><div class="overlay"></div></body></html>
1	+ <!DOCTYPE html><html class="default" lang="en"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>modelRoomLabelPluginServerParams \| 如视空间交互插件合集 - v3.71.1-alpha.1</title><meta name="description" content="Documentation for 如视空间交互插件合集"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><link rel="stylesheet" href="../assets/custom.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") \|\| "os";document.body.style.display="none";setTimeout(() => app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><div class="table-cell" id="tsd-search" data-base=".."><div class="field"><label for="tsd-search-field" class="tsd-widget tsd-toolbar-icon search no-caption"><svg width="16" height="16" viewBox="0 0 16 16" fill="none"><use href="../assets/icons.svg#icon-search"></use></svg></label><input type="text" id="tsd-search-field" aria-label="Search"/></div><div class="field"><div id="tsd-toolbar-links"></div></div><ul class="results"><li class="state loading">Preparing search index...</li><li class="state failure">The search index is not available</li></ul><a href="../index.html" class="title">如视空间交互插件合集 - v3.71.1-alpha.1</a></div><div class="table-cell" id="tsd-widgets"><a href="#" class="tsd-widget tsd-toolbar-icon menu no-caption" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb"><li><a href="../modules.html">如视空间交互插件合集</a></li><li><a href="modelRoomLabelPluginServerParams.html">modelRoomLabelPluginServerParams</a></li></ul><h1>Variable modelRoomLabelPluginServerParams<code class="tsd-tag">Const</code></h1></div><div class="tsd-signature"><span class="tsd-kind-variable">model<wbr/>Room<wbr/>Label<wbr/>Plugin<wbr/>Server<wbr/>Params</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-symbol">{ </span><br/><span> </span><span class="tsd-kind-property">name</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">string</span><span class="tsd-signature-symbol">; </span><br/><span> </span><span class="tsd-kind-property">version</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">number</span><span class="tsd-signature-symbol">; </span><br/><span class="tsd-signature-symbol">}</span><span class="tsd-signature-symbol"> = ...</span></div><aside class="tsd-sources"><ul><li>Defined in plugins/src/ModelRoomLabelPlugin/index.ts:9</li></ul></aside></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><h3><svg width="20" height="20" viewBox="0 0 24 24" fill="none"><use href="../assets/icons.svg#icon-chevronDown"></use></svg>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="../assets/icons.svg#icon-1"></use></svg><span>如视空间交互插件合集 - v3.71.1-alpha.1</span></a><ul class="tsd-small-nested-navigation" id="tsd-nav-container" data-base=".."><li>Loading...</li></ul></nav></div></div></div><footer></footer><div class="overlay"></div></body></html>

package/libs/ModelMakerPlugin/Controller.d.ts CHANGED Viewed

@@ -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;
 }