@mlightcad/mtext-renderer 0.4.0 → 0.4.2

package/README.md

@@ -232,6 +232,20 @@ const mtext = new MText(
 scene.add(mtext);
 ```
 
+If all of fonts or certain fonts are not needed any more after rendering, you can call method `release` of class `FontManager` to free memory occupied by them. Based on testing, one Chinese mesh font file may take 40M memory.
+
+```typescript
+// ---
+// FontManager: Releasing Fonts
+// ---
+// To release all loaded fonts and free memory:
+fontManager.release();
+
+// To release a specific font by name (e.g., 'simsun'):
+fontManager.release('simsun');
+// Returns true if the font was found and released, false otherwise.
+```
+
 ## License
 
 MIT

package/dist/font/fontManager.d.ts

@@ -128,7 +128,16 @@ export declare class FontManager {
      */
     getUnsupportedChar(): Record<string, number>;
     /**
-     * Releases all loaded fonts and clears the font map
+     * Releases loaded fonts from memory.
+     *
+     * - If no argument is provided, all loaded fonts are released and the font map is cleared.
+     * - If a font name is provided, only that specific font is released from the font map.
+     *
+     * This is useful for freeing up memory, especially when working with large font files (e.g., Chinese mesh fonts).
+     * Notes: Based on testing, one Chinese mesh font file may take 40M memory.
+     *
+     * @param fontToRelease - (Optional) The name of the font to release. If omitted, all fonts are released.
+     * @returns `true` if the operation succeeded (all fonts released or the specified font was found and deleted), `false` if the specified font was not found.
      */
-    release(): void;
+    release(fontToRelease?: string): boolean;
 }

package/dist/index.js

@@ -9408,7 +9408,7 @@ class un extends gn {
     return new Sr("?", e, this);
   }
 }
-let Q = class {
+class Q {
   /**
    * Converts an unsigned byte to a signed byte as used in SHX format.
    * Values > 127 are converted to their signed equivalent (-128 to -1).
@@ -9563,7 +9563,7 @@ let Q = class {
       `Position ${e} is out of range for the data length ${this.data.byteLength}!`
     );
   }
-};
+}
 var $ = /* @__PURE__ */ ((t) => (t.SHAPES = "shapes", t.BIGFONT = "bigfont", t.UNIFONT = "unifont", t))($ || {});
 let nl = class {
   parse(e) {
@@ -10763,13 +10763,22 @@ class Ue {
     return this.unsupportedChars;
   }
   /**
-   * Releases all loaded fonts and clears the font map
+   * Releases loaded fonts from memory.
+   *
+   * - If no argument is provided, all loaded fonts are released and the font map is cleared.
+   * - If a font name is provided, only that specific font is released from the font map.
+   *
+   * This is useful for freeing up memory, especially when working with large font files (e.g., Chinese mesh fonts).
+   * Notes: Based on testing, one Chinese mesh font file may take 40M memory.
+   *
+   * @param fontToRelease - (Optional) The name of the font to release. If omitted, all fonts are released.
+   * @returns `true` if the operation succeeded (all fonts released or the specified font was found and deleted), `false` if the specified font was not found.
    */
-  release() {
-    this.fontMap.clear();
+  release(e) {
+    return e == null ? (this.fontMap.clear(), !0) : this.fontMap.delete(e);
   }
 }
-class Cl {
+class Fl {
   /**
    * Creates a new instance of DefaultFontLoader
    */
@@ -11379,6 +11388,26 @@ class gl {
                 }
                 s += "\\M";
                 continue;
+              case "U":
+                if (this.scanner.peek() === "+") {
+                  this.scanner.consume(1);
+                  const c = this.scanner.tail.match(/^[0-9A-Fa-f]{4,8}/);
+                  if (c) {
+                    const f = c[0];
+                    this.scanner.consume(f.length);
+                    const h = parseInt(f, 16);
+                    let p = "";
+                    try {
+                      p = String.fromCodePoint(h);
+                    } catch {
+                      p = "▯";
+                    }
+                    return s ? [1, s] : [1, p];
+                  }
+                  this.scanner.consume(-1);
+                }
+                s += "\\U";
+                continue;
               default:
                 if (l)
                   try {
@@ -12480,7 +12509,7 @@ class xl {
   }
 }
 const Bt = /* @__PURE__ */ new R.Vector3(), we = /* @__PURE__ */ new R.Vector3(), Pt = /* @__PURE__ */ new R.Vector3(), It = /* @__PURE__ */ new R.Quaternion(), Gt = /* @__PURE__ */ new R.Matrix4(), dn = /* @__PURE__ */ new R.Matrix4(), vn = /* @__PURE__ */ new R.Vector3(1, 0, 0);
-class wl extends R.Object3D {
+class Cl extends R.Object3D {
   /**
    * Extracts all unique font names used in an MText string.
    * This function searches for font commands in the format \f{fontname}| or \f{fontname}; and returns a set of unique font names.
@@ -12698,7 +12727,7 @@ class wl extends R.Object3D {
       this.getBoxes(n[a], r);
   }
 }
-class El {
+class wl {
   constructor() {
     this.lineBasicMaterials = {}, this.meshBasicMaterials = {}, this.unsupportedTextStyles = {};
   }
@@ -12716,12 +12745,12 @@ class El {
 export {
   gn as BaseFont,
   yn as BaseTextShape,
-  Cl as DefaultFontLoader,
+  Fl as DefaultFontLoader,
   dr as EventManager,
   Se as FontFactory,
   Ue as FontManager,
-  wl as MText,
+  Cl as MText,
   hl as MTextAttachmentPoint,
   Ze as MTextFlowDirection,
-  El as StyleManager
+  wl as StyleManager
 };