@mlightcad/mtext-renderer 0.3.7 → 0.4.1

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

@@ -10763,10 +10763,19 @@ 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 {
@@ -12002,7 +12011,7 @@ class xl {
         this.textStyle.font.toLowerCase(),
         a.fontSize
       )
-    }), this._currentContext.setColorFromHex(a.byLayerColor), this._currentContext.fontFace.family = this.textStyle.font.toLowerCase(), this._currentContext.widthFactor = { value: a.widthFactor, isRelative: !0 }, this._currentContext.oblique = e.obliqueAngle || 0, this._maxFontSize = 0, this._currentHorizontalAlignment = a.horizontalAlignment, this._currentIndent = 0, this._currentLeftMargin = 0, this._currentRightMargin = 0, this.initLineParams();
+    }), this._currentContext.setColorFromHex(e.color), this._currentContext.fontFace.family = this.textStyle.font.toLowerCase(), this._currentContext.widthFactor = { value: a.widthFactor, isRelative: !0 }, this._currentContext.oblique = e.obliqueAngle || 0, this._maxFontSize = 0, this._currentHorizontalAlignment = a.horizontalAlignment, this._currentIndent = 0, this._currentLeftMargin = 0, this._currentRightMargin = 0, this.initLineParams();
   }
   get fontManager() {
     return this._fontManager;