@aibee/crc-bmap 0.14.28 → 0.14.29

package/lib/src/elements/poi2.d.ts

@@ -1,5 +1,6 @@
 import { Context } from "../context/context";
-import { Box2, DataTexture, Object3D, Object3DEventMap, Sprite, Vector3 } from "three";
+import { Box2, DataTexture, Mesh, Object3D, Object3DEventMap, ShaderMaterial, Sprite, Vector3 } from "three";
+import type { TextLayoutResult } from "../utils/text-layout";
 export interface PoiOptions2 {
     text: string;
     icon: string;
@@ -14,13 +15,12 @@ export interface PoiOptions2 {
         z: number;
     };
     text_font_size: number;
+    /** 文字字重：400（常规）/'bold'、700（加粗）。不同字重使用独立的 SDF 图集 */
+    text_font_weight: string | number;
+    /** 文字描边宽度，单位 CSS 像素（0 表示不描边） */
+    text_outline_width: number;
     icon_rotate: number;
     depth_test: boolean;
-    text_texture?: DataTexture;
-    text_texture_width?: number;
-    text_texture_height?: number;
-    text_texture_offset_x?: number;
-    text_texture_offset_y?: number;
     hide_text: boolean;
     icon_border?: {
         width: number;
@@ -50,16 +50,18 @@ export type PoiOptionsParam2 = Partial<PoiOptions2>;
 export declare class Poi2 extends Object3D<PoiEventMap2> {
     context: Context;
     options: PoiOptions2;
-    spriteText?: Sprite;
     spriteIcon?: Sprite;
+    /** SDF 文字网格 */
+    meshText?: Mesh;
+    /** SDF 文字背景块网格 */
+    meshBackground?: Mesh;
+    /** 文字垂直 pivot（对应原 Sprite.center.y） */
+    private textCenterY;
     box: Box2;
     boxHelper?: HTMLDivElement;
     private _shouldShow;
-    textTextureMap: Record<string, {
-        texture: DataTexture;
-        lines: number;
-        textAspect: number;
-    }>;
+    /** 文字布局结果（按 textTextureKey 缓存） */
+    textLayoutMap: Record<string, TextLayoutResult>;
     textTextureRectMap: Record<string, {
         width: number;
         height: number;
@@ -67,7 +69,15 @@ export declare class Poi2 extends Object3D<PoiEventMap2> {
         aspect: number;
     }>;
     constructor(context: Context, options: PoiOptionsParam2);
+    /** 当前文字使用的 SDF 字体规格：字重不同即对应不同图集 */
+    get sdfFontSpec(): import("../factory").SdfFontSpec;
     get textTexture(): DataTexture | null;
+    /** 当前文字渲染对象 */
+    get textObject(): Mesh | undefined;
+    /** 当前文字材质列表（字形分布在多张图集页时，每页对应一个材质） */
+    get textMaterials(): ShaderMaterial[];
+    /** 合并各图集页的几何；只有一页时直接复用，避免无谓开销 */
+    private mergeTextParts;
     get textTextureRect(): {
         width: number;
         height: number;
@@ -82,7 +92,6 @@ export declare class Poi2 extends Object3D<PoiEventMap2> {
     get iconHeight(): number;
     get textWidth(): number;
     get textHeight(): number;
-    get hasOriginTexture(): boolean;
     get initedTextRect(): true | "" | {
         width: number;
         height: number;
@@ -99,10 +108,18 @@ export declare class Poi2 extends Object3D<PoiEventMap2> {
     get textTextureKey(): string;
     _initTextTexture: () => Promise<void>;
     initTextTexture: () => Promise<void>;
+    /** 计算文字的 SDF 布局（含换行），度量来自共享字形图集；结果会缓存到 textLayoutMap */
+    private layoutText;
     _initTextTextureRect: () => Promise<void>;
     initTextTextureRect: () => Promise<void>;
     initText(): Promise<void>;
+    /** 构建文字背景块（圆角矩形） */
+    private initBackgroundMesh;
     initSize(): void;
+    /** pivot（textCenterY）变化后重建文字与背景几何 */
+    private rebuildTextMeshes;
+    /** 背景块几何：以文字 pivot 为原点，尺寸按 SDF 布局换算 */
+    private buildBackgroundGeometry;
     init(): Promise<void>;
     protected _initScale: ({ zoom }: {
         zoom: number;

package/lib/src/elements/text-texture.d.ts

@@ -24,6 +24,8 @@ export declare class TextTexture extends Object3D {
     mesh?: Mesh;
     constructor(context: Context, options: TextTextureOptionsParam[]);
     init(): Promise<void>;
+    private createMaterial;
+    private get materials();
     setOpacity(opacity: number): void;
     dispose(): void;
 }

package/lib/src/factory/index.d.ts

@@ -1,5 +1,6 @@
 export * from './material';
-export * from './text-texture';
+export * from './sdf-text';
+export * from './sdf-material';
 export * from './img-texture';
 export * from './unique-key';
 export * from './model';

package/lib/src/factory/sdf-material.d.ts

@@ -0,0 +1,50 @@
+import { ShaderMaterial, Texture } from "three";
+/**
+ * tiny-sdf 默认 cutoff。
+ * 注意：tiny-sdf 的距离场编码为 `data = 255 * (1 - cutoff) - (255 / radius) * distance`，
+ * 因此字形边界对应的采样值是 `1 - cutoff`（默认 0.75），而不是 0.5。
+ */
+export declare const DEFAULT_SDF_CUTOFF = 0.25;
+export declare const DEFAULT_SDF_EDGE: number;
+export interface SdfTextMaterialOptions {
+    atlas: Texture;
+    /** 填充色，默认黑色 */
+    fillColor?: string;
+    /** 填充不透明度，默认 1 */
+    fillOpacity?: number;
+    /** 描边色，默认白色 */
+    outlineColor?: string;
+    /** 描边不透明度，默认 1 */
+    outlineOpacity?: number;
+    /** 描边宽度（屏幕像素），默认 1 */
+    outlineWidth?: number;
+    /** 整体不透明度，默认 1 */
+    opacity?: number;
+    /** 距离场边界值，默认 1 - tiny-sdf cutoff = 0.75 */
+    edge?: number;
+    depthTest?: boolean;
+    depthWrite?: boolean;
+    /** 是否始终面向相机（POI 文字需要），默认 false */
+    billboard?: boolean;
+}
+/**
+ * 创建 SDF 文字材质。
+ * 距离场边缘宽度使用屏幕空间导数(fwidth)自适应，因此任意缩放都保持锐利。
+ */
+export declare function createSdfTextMaterial(options: SdfTextMaterialOptions): ShaderMaterial;
+export interface SdfBackgroundMaterialOptions {
+    color?: string;
+    opacity?: number;
+    /** 圆角半径，单位为归一化(基于高度)后的长度 */
+    radius?: number;
+    /** 背景块归一化宽高（与几何一致，用于 SDF 计算） */
+    size: {
+        width: number;
+        height: number;
+    };
+    depthTest?: boolean;
+    /** 是否始终面向相机，默认 false */
+    billboard?: boolean;
+}
+/** 创建文字背景块（圆角矩形）材质，用于 `text_background` */
+export declare function createSdfBackgroundMaterial(options: SdfBackgroundMaterialOptions): ShaderMaterial;

package/lib/src/factory/sdf-text.d.ts

@@ -0,0 +1,107 @@
+import { DataTexture } from "three";
+/**
+ * 影响字形生成与图集分组的字体规格。
+ * SDF 与最终显示字号无关，这里固定一个足够大的基准字号即可支持任意缩放。
+ */
+export interface SdfFontSpec {
+    fontFamily: string;
+    fontSize: number;
+    fontWeight: string | number;
+    /** 距离场可线性编码的半径（参考像素）：外侧可编码距离 = radius × (1 - cutoff) */
+    radius: number;
+    cutoff: number;
+    /** 字形位图四周的 SDF padding（参考像素），决定描边的最大可用宽度 */
+    buffer: number;
+    /** 行距（在 fontSize 之上追加的参考像素），与 SDF padding 解耦 */
+    lineGap: number;
+}
+/**
+ * 默认字体规格。
+ * 基准字号决定 SDF 的精度与可放大倍率：字号越大，距离场纹素越多，
+ * 在高 DPR 屏幕上重采样时越锐利（也越占图集空间）。
+ */
+export declare const defaultSdfFontSpec: SdfFontSpec;
+/** 单字符在图集中的位置与度量（长度单位为 SDF 基准字号像素） */
+export interface GlyphRecord {
+    u0: number;
+    v0: number;
+    u1: number;
+    v1: number;
+    width: number;
+    height: number;
+    glyphWidth: number;
+    glyphHeight: number;
+    glyphLeft: number;
+    glyphTop: number;
+    glyphAdvance: number;
+    blank?: boolean;
+    /** 所在图集页索引（同一字体规格可能有多页，渲染时按页分组选纹理） */
+    page?: number;
+}
+/** 单张 SDF 图集（一页）。一个字体规格的字形放满一页后会追加新页。 */
+export interface SdfAtlasPage {
+    index: number;
+    buffer: Uint8Array;
+    texture: DataTexture;
+    cursorX: number;
+    cursorY: number;
+    rowHeight: number;
+}
+export interface SdfAtlas {
+    key: string;
+    spec: SdfFontSpec;
+    size: number;
+    /** 允许的最大页数（按显存预算推导，见 calcMaxPages） */
+    maxPages: number;
+    /** 图集页列表（至少一页）；字形通过 record.page 指向所属页 */
+    pages: SdfAtlasPage[];
+    charMap: Map<string, GlyphRecord>;
+}
+export declare class SdfTextFactory {
+    private static atlases;
+    private static timer;
+    private static worker;
+    private static workerFailed;
+    private static dbReady;
+    private static warnedFull;
+    private static maxTextureSize;
+    static getSpec(partial?: Partial<SdfFontSpec>): SdfFontSpec;
+    static getFontKey(spec: SdfFontSpec): string;
+    /**
+     * 读取设备支持的最大纹理边长（结果缓存）。
+     * 通过一个临时 WebGL 上下文查询 MAX_TEXTURE_SIZE，随后立即释放该上下文。
+     */
+    private static getMaxTextureSize;
+    /** 图集实际边长：不超过设备支持的最大纹理尺寸，也不低于下限 */
+    static getAtlasSize(): number;
+    /** 获取（必要时创建）某个字体规格对应的共享图集 */
+    static getAtlas(partial?: Partial<SdfFontSpec>): SdfAtlas;
+    /** 图集第一页纹理（单页场景的常用入口） */
+    static getTexture(partial?: Partial<SdfFontSpec>): DataTexture;
+    /** 该字体规格的全部图集页纹理（多页时按字形所属页取用） */
+    static getTextures(partial?: Partial<SdfFontSpec>): DataTexture[];
+    static getGlyph(char: string, partial?: Partial<SdfFontSpec>): GlyphRecord | null;
+    /**
+     * 确保 text 中所有字符均已就绪（已写入图集）。
+     * 命中内存/持久缓存则直接复用，仅对缺失字符执行生成。
+     */
+    static ensureText(text: string, partial?: Partial<SdfFontSpec>): Promise<SdfAtlas>;
+    private static createAtlas;
+    /** 新建一张图集页（独立的缓冲与纹理） */
+    private static createPage;
+    private static generateMissing;
+    /** 将字形数据写入图集（shelf packing），返回度量记录 */
+    private static insertGlyph;
+    /** 判断某页还能否放下指定尺寸的字形（shelf packing 规则） */
+    private static pageCanFit;
+    /** 选择可容纳该字形的图集页；所有页都放不下时新建一页 */
+    private static pickPage;
+    private static generate;
+    private static getWorker;
+    /** 主线程分帧生成（不支持 OffscreenCanvas 时的回退路径） */
+    private static generateInMainThread;
+    private static initDb;
+    private static readFromDb;
+    private static writeToDb;
+    static dispose(): void;
+}

package/lib/src/utils/index-db.d.ts

@@ -8,7 +8,8 @@ export declare enum MAP_DB_TABLES {
     POI_TEXT = "poi_text_1",// poi文本
     POI_TEXT_RECT = "poi_text_rect",// poi文本
     LAZY_TEXTURE = "lazy_texture",// poi纹理
-    LAZY_POI = "lazy_poi"
+    LAZY_POI = "lazy_poi",// 车位poi
+    SDF_GLYPH = "sdf_glyph_1"
 }
 /**
  * 获取indexDb连接

package/lib/src/utils/index.d.ts

@@ -13,6 +13,7 @@ export * from './os';
 export * from './events';
 export * from './event-name';
 export * from './obj-utils';
+export * from './text-layout';
 export * from './ajax';
 export * from './path';
 export * from './road';

package/lib/src/utils/text-layout.d.ts

@@ -0,0 +1,57 @@
+import { BufferGeometry } from "three";
+import type { GlyphRecord, SdfFontSpec } from "../factory/sdf-text";
+/** 与旧位图实现一致的参考字号（旧实现固定 28px 字体） */
+export declare const SDF_REFERENCE_FONT_SIZE = 28;
+export interface PositionedGlyph {
+    char: string;
+    record: GlyphRecord;
+    /** 字形位图左边界（相对文本块左下角） */
+    x: number;
+    /** 字形位图底边界（相对文本块左下角，向上为正） */
+    y: number;
+}
+export interface TextLayoutResult {
+    lines: string[];
+    glyphs: PositionedGlyph[];
+    /** 布局宽度（SDF 基准字号像素） */
+    width: number;
+    /** 布局高度（SDF 基准字号像素） */
+    height: number;
+    /** 宽高比 */
+    aspect: number;
+    /** 行数 */
+    linesCount: number;
+}
+type MeasureFn = (str: string) => number;
+/**
+ * 按括号/空格/中文逐字规则换行。
+ * 逻辑与旧 `TextTextureFactory.splitText` 保持一致，仅把度量方式换成字形 advance 累加。
+ */
+export declare function splitTextByMeasure(text: string, maxWidth: number, measure: MeasureFn): string[];
+/**
+ * 对文字进行 SDF 布局。
+ * @param text 文本
+ * @param charMap 字符 → 字形度量（来自 SdfTextFactory 图集）
+ * @param spec 字体规格
+ * @param maxWidth 最大行宽（逻辑像素，基于 SDF_REFERENCE_FONT_SIZE）
+ */
+export declare function layoutSdfText(text: string, charMap: Map<string, GlyphRecord>, spec: SdfFontSpec, maxWidth?: number): TextLayoutResult;
+interface BuildGeometryOptions {
+    /** 垂直 pivot（0 = 底部，0.5 = 居中，1 = 顶部），对应 Sprite.center.y */
+    pivotY?: number;
+    /** 水平 pivot，对应 Sprite.center.x，默认 0.5 */
+    pivotX?: number;
+}
+/** 某个图集页对应的那部分文字几何 */
+export interface SdfTextGeometryPart {
+    /** 字形所属图集页索引，用于选择对应纹理 */
+    page: number;
+    geometry: BufferGeometry;
+}
+/**
+ * 由布局结果构建逐字 quad 几何。
+ * 几何归一化到高度 = 1（宽度 = aspect），并以 pivot 为原点，便于复用 Sprite 的 scale/position 语义。
+ * 字形可能分布在多张图集页上，因此按页分组返回；调用方需为每一页提供一个材质。
+ */
+export declare function buildSdfTextGeometry(layout: TextLayoutResult, options?: BuildGeometryOptions): SdfTextGeometryPart[];
+export {};