modern-canvas 0.25.2 → 0.26.0

package/dist/scene/2d/element/Element2D.d.ts

@@ -107,6 +107,11 @@ export declare class Element2D extends Node2D implements Rectangulable {
     protected _updateGlobalAabb(): void;
     protected _updateMask(): void;
     protected _updateGlobalDisplay(): void;
+    /**
+     * 批量修改：fn 内对 style 的多次改动只在结束时合并触发一次 text.update()（文字重栅格）。
+     * 否则逐个改 width/height/fontSize 会各自重栅一次（如 resize 时每帧重栅 3 次）。
+     */
+    batch(fn: () => void): void;
     protected _beginBatch(): void;
     protected _endBatch(): void;
     onUpdateStyleProperty(key: string, value: any, oldValue: any): void;

package/dist/scene/2d/element/Element2DText.d.ts

@@ -27,7 +27,16 @@ export declare class Element2DText extends CoreObject implements NormalizedText
     set textContent(val: string);
     protected _textContent: string;
     protected _autoDrawMode?: TextDrawMode;
+    protected _atlasEligible: boolean;
+    protected _textureStale: boolean;
     protected _texture: CanvasTexture;
+    protected _tiles: {
+        texture: CanvasTexture;
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }[];
     protected _textureMap: Map<string, {
         texture: Texture2D | undefined;
         box: RectangleLike;
@@ -37,6 +46,9 @@ export declare class Element2DText extends CoreObject implements NormalizedText
     protected _updateProperty(key: string, value: any, oldValue: any): void;
     load(): Promise<void>;
     update(): void;
+    protected _rasterTexture(): void;
+    protected _renderTiles(width: number, height: number, pixelRatio: number, maxTile: number): void;
+    protected _releaseTiles(): void;
     protected _updateTextureMap(): void;
     protected _updateTexture(key: string, fill: NormalizedFill | undefined, box: BoundingBox): Promise<void>;
     protected _loadTexture(fill: NormalizedFill, box: any): Promise<Texture2D | undefined>;
@@ -48,6 +60,9 @@ export declare class Element2DText extends CoreObject implements NormalizedText
     useTextureDraw(): boolean;
     protected _pathDraw(ctx: CanvasContext): void;
     protected _textureDraw(ctx: CanvasContext): void;
+    protected _drawTextureRect(ctx: CanvasContext, texture: Texture2D, rx: number, ry: number, rw: number, rh: number): void;
+    protected _computeAtlasEligible(): boolean;
+    protected _atlasDraw(ctx: CanvasContext): boolean;
     draw(): void;
     process(_delta: number): void;
 }

package/dist/scene/resources/textures/GlyphAtlas.d.ts

@@ -0,0 +1,35 @@
+import { CanvasTexture } from './CanvasTexture';
+export interface GlyphSlot {
+    texture: CanvasTexture;
+    u0: number;
+    v0: number;
+    u1: number;
+    v1: number;
+}
+export type GlyphRasterFn = (ctx: CanvasRenderingContext2D) => void;
+interface AtlasPage {
+    texture: CanvasTexture;
+    ctx: CanvasRenderingContext2D;
+    penX: number;
+    penY: number;
+    rowH: number;
+}
+/**
+ * 共享字形 atlas：把每个唯一字形（字 + 字体 + 字号桶 + 字重 + 斜体 + 颜色）只栅格化一次到
+ * 共享纹理页，文字渲染时改为「逐字形 quad 批渲染」（见 Element2DText._atlasDraw）。同一纹理的
+ * quad 经 GlBatch2DSystem 自动塌缩进 ~1 个 draw call，编辑/缩放/resize 只重定位 quad，不再整篇重栅。
+ */
+export declare class GlyphAtlas {
+    readonly superSample = 2;
+    protected _pages: AtlasPage[];
+    protected _slots: Map<string, GlyphSlot | null>;
+    protected _newPage(): AtlasPage;
+    /**
+     * 取（必要时栅格化）一个字形 slot。`inkW/inkH` 为字形 ink 盒的逻辑尺寸；`raster` 在
+     * 已预置变换的 2D 上下文里绘制该字形。返回 null 表示该字形超过单页容量（调用方应回退到整段栅格）。
+     */
+    acquire(key: string, inkW: number, inkH: number, raster: GlyphRasterFn): GlyphSlot | null;
+    clear(): void;
+}
+export declare const sharedGlyphAtlas: GlyphAtlas;
+export {};

package/dist/scene/resources/textures/index.d.ts

@@ -1,6 +1,7 @@
 export * from './AnimatedTexture';
 export * from './CanvasTexture';
 export * from './ColorTexture';
+export * from './GlyphAtlas';
 export * from './GradientTexture';
 export * from './PixelsTexture';
 export * from './Texture2D';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "modern-canvas",
   "type": "module",
-  "version": "0.25.2",
+  "version": "0.26.0",
   "packageManager": "pnpm@10.19.0",
   "description": "A JavaScript WebGL rendering engine. only the ESM.",
   "author": "wxm",
@@ -65,7 +65,7 @@
     "modern-font": "^0.6.1",
     "modern-idoc": "^0.12.3",
     "modern-path2d": "^1.8.6",
-    "modern-text": "^2.0.9"
+    "modern-text": "^2.1.0"
   },
   "peerDependencies": {
     "echarts": "^5 || ^6",