@mlightcad/mtext-renderer 0.7.0 → 0.7.1

package/lib/font/fontManager.d.ts

@@ -36,7 +36,7 @@ export declare class FontManager {
     /** Mapping of original font names to their replacements */
     protected fontMapping: FontMapping;
     /** Map of loaded fonts, keyed by font name */
-    protected fontMap: Map<string, BaseFont>;
+    protected loadedFontMap: Map<string, BaseFont>;
     /** List of font file names that have been loaded */
     protected fileNames: string[];
     /** Record of characters that are not supported by any loaded font */

package/lib/font/meshFont.d.ts

@@ -2,18 +2,48 @@ import { Font, FontData as ThreeFontData } from 'three/examples/jsm/loaders/Font
 import { BaseFont } from './baseFont';
 import { FontData } from './font';
 import { MeshTextShape } from './meshTextShape';
+interface MeshGlyph {
+    ha: number;
+    x_min: number;
+    x_max: number;
+    o?: string | undefined;
+}
 /**
  * Represents the data structure for mesh-based fonts.
  * Extends the base ThreeFontData interface with additional properties specific to mesh fonts.
  */
 export interface MeshFontData extends ThreeFontData {
+    /** A map of glyphs keyed by character */
+    glyphs: Record<string, MeshGlyph>;
+    /** The full font family name */
+    familyName: string;
+    /** The font ascender */
+    ascender: number;
+    /** The font descender */
+    descender: number;
+    /** Underline position in font units */
+    underlinePosition: number;
+    /** Underline thickness in font units */
+    underlineThickness: number;
+    /** Font bounding box */
+    boundingBox: {
+        xMin: number;
+        xMax: number;
+        yMin: number;
+        yMax: number;
+    };
+    /** Font resolution (usually unitsPerEm) */
+    resolution: number;
     /** Scale factor used to adjust the size of characters when rendering */
     scaleFactor: number;
+    /** Original font information table */
+    original_font_information: Record<string, string>;
 }
 /**
  * Represents a mesh-based font (e.g., TTF, OTF, WOFF).
  * This class extends BaseFont to provide specific functionality for mesh fonts,
- * including character shape generation and scale factor management.
+ * including character shape generation, scale factor management, and
+ * **lazy glyph loading** to reduce memory consumption.
  */
 export declare class MeshFont extends BaseFont {
     /** Scale factor used to adjust the size of characters */
@@ -24,11 +54,24 @@ export declare class MeshFont extends BaseFont {
     readonly type = "mesh";
     /** The parsed font data */
     readonly data: MeshFontData;
+    /** Internal opentype.js font instance used for on-demand glyph parsing */
+    private readonly opentypeFont;
+    /** Glyph cache to limit memory usage */
+    private readonly glyphCache;
     /**
      * Creates a new instance of MeshFont.
-     * @param data - Either a MeshFontData object containing font information or an ArrayBuffer containing raw font data
+     * @param fontData - Either a MeshFontData object containing font information or an ArrayBuffer containing raw font data
      */
     constructor(fontData: FontData);
+    /**
+     * Parses a mesh font from raw binary data.
+     * This function converts raw font data (e.g., TTF, OTF, WOFF) into a MeshFontData object
+     * that can be used by the MeshFont class.
+     *
+     * @param data - The raw font data as an ArrayBuffer
+     * @returns An object containing the opentype font and parsed metadata
+     */
+    private parseMeshFont;
     /**
      * Return true if this font contains glyph of the specified character. Otherwise, return false.
      * @param char - The character to check
@@ -41,6 +84,12 @@ export declare class MeshFont extends BaseFont {
      * @returns True if this font contains glyph of the specified character code. Otherwise, return false.
      */
     hasCode(code: number): boolean;
+    /**
+     * Loads glyph data lazily when requested.
+     * Parsed glyphs are cached in an LRU cache to limit memory usage.
+     * @param char - The character whose glyph should be loaded
+     */
+    private _loadGlyphIfNeeded;
     /**
      * Generates shapes for a text string
      * @param text - The text to generate shapes for
@@ -76,3 +125,4 @@ export declare class MeshFont extends BaseFont {
      */
     getNotFoundTextShape(size: number): MeshTextShape;
 }
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mlightcad/mtext-renderer",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "AutoCAD MText renderer based on Three.js",
   "license": "MIT",
   "author": "MLight Lee <mlight.lee@outlook.com>",