@realsee/dnalogel 3.78.1-alpha.1 → 3.79.0

package/dist/GuideLinePlugin/Controller.d.ts

@@ -6,13 +6,20 @@ import type { Config as BaseConfig } from '../base/BasePlugin';
 import { GuideLineItem } from './GuideLineItem';
 import CruisePluginController from '../CruisePlugin/Work';
 export declare const pluginFlag: (name: string) => string;
-type Config = BaseConfig;
+type Config = BaseConfig & {
+    /**
+     * @description 格式化距离函数，用于将米转换为显示文本（包含单位）
+     * @param distanceInMeter 距离（单位：米）
+     * @returns 格式化后的距离字符串，例如 "10m" 或 "32'10""
+     */
+    formatDistance?: (distanceInMeter: number) => string;
+};
 export default class Controller extends BasePluginWithData.Controller<PluginState, EventMap, PluginServerData, PluginData> {
     readonly name = "GuideLinePlugin";
     readonly cruisePlugin: CruisePluginController;
     /** GuideLineItem 索引 */
     readonly itemMap: Map<string | number, GuideLineItem>;
-    get config(): BaseConfig;
+    get config(): Config;
     state: {
         visible: boolean;
         enabled: boolean;
@@ -54,6 +61,31 @@ export default class Controller extends BasePluginWithData.Controller<PluginStat
     getGuideLineItemByID(id: string | number): GuideLineItem;
     /** 移除一个 GuideLineItem */
     removeGuideLineItem(item: GuideLineItem): void;
+    /**
+     * 动态更新距离格式化函数，立即刷新所有路线标签的距离显示。
+     * 不传参时恢复为默认格式（i18n('全程') + 距离 + i18n('米')）。
+     * @param fn 格式化函数，输入米数，返回带单位的完整字符串
+     * @example
+     *   // 室内英制：英尺 + 英寸（如 "5'10""）
+     *   plugin.setDistanceFormatter((m) => {
+     *     const totalInches = Math.round(m * 39.3701)
+     *     const feet = Math.floor(totalInches / 12)
+     *     const inches = totalInches % 12
+     *     return `${feet}'${inches}"`
+     *   })
+     *   // 室外英制：英里（如 "1.24 mi"）
+     *   plugin.setDistanceFormatter((m) => `${(m * 0.000621371).toFixed(2)} mi`)
+     *   // 自动切换：近距离用英尺，远距离用英里
+     *   plugin.setDistanceFormatter((m) => {
+     *     if (m < 300) return `${Math.round(m * 3.28084)} ft`
+     *     return `${(m * 0.000621371).toFixed(2)} mi`
+     *   })
+     *   // 恢复默认（i18n '米'）
+     *   plugin.setDistanceFormatter()
+     */
+    setDistanceFormatter(fn?: (distanceInMeter: number) => string): void;
+    /** 更新所有 tag 的距离显示（当 formatDistance 函数改变时调用） */
+    private updateTagDistances;
     /** 全量更新 tag */
     updateTagsEnable(): void;
     /** 清空所有 GuideLineItem */

package/dist/GuideLinePlugin/GuideLineModeItem.d.ts

@@ -23,8 +23,8 @@ declare class GuideLineModeItem {
     /** THREE Curve 路径上的点 */
     get curvePoints(): THREE.Vector3[];
     name: string;
-    startTagContainer: GuideLineTagContainer;
-    endTagContainer: GuideLineTagContainer;
+    startTagContainer?: GuideLineTagContainer;
+    endTagContainer?: GuideLineTagContainer;
     path: PluginType.PathItem[];
     geometryStyle: PluginType.GuideLineGeometryStyle;
     materialStyle: PluginType.GuideLineMaterialStyle;
@@ -32,6 +32,9 @@ declare class GuideLineModeItem {
     readonly group: THREE.Group;
     readonly mesh: THREE.Mesh<THREE.BufferGeometry, THREE.ShaderMaterial>;
     visible: boolean | null;
+    /** 保存原始的 tag 数据，用于更新距离显示 */
+    private startTagData;
+    private endTagData;
     private five;
     private mode;
     private _curvePath;
@@ -117,6 +120,8 @@ declare class GuideLineModeItem {
     setVisibleFloorIndexes(floorIndexes: number[]): void;
     setStartTag(tag: Tag | PluginType.ModelGuideLineTagData | null): void;
     setEndTag(tag: Tag | PluginType.ModelGuideLineTagData | null): void;
+    /** 更新 tag 的距离显示（当 formatDistance 函数改变时调用） */
+    updateTagDistance(): void;
     /** 闪烁 */
     flicker(): void;
     /** 求起点到 panoIndex 曲线长度