@mlightcad/mtext-renderer 0.4.4 → 0.4.5

package/dist/font/baseFont.d.ts

@@ -1,4 +1,5 @@
 import { BaseTextShape } from './baseTextShape';
+import { CharGeometryCache } from './charGeometryCache';
 import { FontType } from './font';
 
 /**
@@ -14,6 +15,17 @@ export declare abstract class BaseFont {
      * This data is used to render characters and calculate metrics.
      */
     abstract readonly data: unknown;
+    /**
+     * Caching of font character geometries to improve text rendering performance.
+     */
+    cache: CharGeometryCache;
+    constructor();
+    /**
+     * Return true if this font contains glyph of the specified character. Otherwise, return false.
+     * @param char - The character to check
+     * @returns True if this font contains glyph of the specified character. Otherwise, return false.
+     */
+    abstract hasChar(char: string): boolean;
     /**
      * Record of characters that are not supported by this font.
      * Maps character strings to their occurrence count.

package/dist/font/charGeometryCache.d.ts

@@ -0,0 +1,43 @@
+import * as THREE from 'three';
+/**
+ * Manages caching of font character geometries to improve text rendering performance.
+ */
+export declare class CharGeometryCache {
+    private cache;
+    constructor();
+    /**
+     * Returns true if the geometry of the specified character exists in the cache.
+     * Otherwise, returns false.
+     * @param char One character.
+     * @param size The font size.
+     * @returns True if the geometry of the specified character exists in the cache.
+     * Otherwise, returns false.
+     */
+    hasGeometry(char: string, size: number): boolean;
+    /**
+     * Get the geometry for a single character from cache if available.
+     * The cache key includes both character and size.
+     * @param char The character to get geometry from cache.
+     * @param size The font size.
+     * @returns The geometry for a single character from cache if avaiable.
+     * Return undefined if the character not found in cache.
+     */
+    getGeometry(char: string, size: number): THREE.BufferGeometry | undefined;
+    /**
+     * Set the geometry to cache for a single character.
+     * @param char The character to set geometry for.
+     * @param size The font size.
+     * @param geometry The geometry to set.
+     */
+    setGeometry(char: string, size: number, geometry: THREE.BufferGeometry): void;
+    /**
+     * Dispose all cached geometries.
+     */
+    dispose(): void;
+    /**
+     * Generates cache key by character and font size.
+     * @param char One character.
+     * @param size The font size.
+     */
+    private generateKey;
+}

package/dist/font/fontManager.d.ts

@@ -76,6 +76,22 @@ export declare class FontManager {
      * @returns The original font name if found, or the replacement font name if not found
      */
     findAndReplaceFont(fontName: string): string;
+    /**
+     * Gets font by font name. Return undefined if not found.
+     * @param fontName - The font name to find
+     * @param recordMissedFonts - Record the font name to property `missedFonts` in this class
+     * if the specified font name not found.
+     * @returns The font with the specified font name, or undefined if not found
+     */
+    getFontByName(fontName: string, recordMissedFonts?: boolean): BaseFont | undefined;
+    /**
+     * Gets the first font which contains the specified character.
+     * @param char - The character to get the shape for
+     * @param fontName - The name of the font to use
+     * @param size - The size of the character
+     * @returns The text shape for the character, or undefined if not found
+     */
+    getFontByChar(char: string): BaseFont | undefined;
     /**
      * Gets the text shape for a specific character with the specified font and size
      * @param char - The character to get the shape for

package/dist/font/meshFont.d.ts

@@ -29,6 +29,12 @@ export declare class MeshFont extends BaseFont {
      * @param data - Either a MeshFontData object containing font information or an ArrayBuffer containing raw font data
      */
     constructor(data: MeshFontData | ArrayBuffer);
+    /**
+     * Return true if this font contains glyph of the specified character. Otherwise, return false.
+     * @param char - The character to check
+     * @returns True if this font contains glyph of the specified character. Otherwise, return false.
+     */
+    hasChar(char: string): boolean;
     /**
      * Generates shapes for a text string
      * @param text - The text to generate shapes for

package/dist/font/shxFont.d.ts

@@ -12,6 +12,12 @@ export declare class ShxFont extends BaseFont {
     readonly type = "shx";
     readonly data: ShxFontData;
     constructor(data: ShxFontData | ArrayBuffer);
+    /**
+     * Return true if this font contains glyph of the specified character. Otherwise, return false.
+     * @param char - The character to check
+     * @returns True if this font contains glyph of the specified character. Otherwise, return false.
+     */
+    hasChar(char: string): boolean;
     generateShapes(text: string, size: number): ShxTextShape[];
     /**
      * SHX font always has fixed scale factor 1.

package/dist/font/shxTextShape.d.ts

@@ -1,5 +1,6 @@
 import { Point, ShxShape } from '@mlightcad/shx-parser';
 import { BaseTextShape } from './baseTextShape';
+import { ShxFont } from './shxFont';
 
 import * as THREE from 'three';
 /**
@@ -10,12 +11,14 @@ import * as THREE from 'three';
 export declare class ShxTextShape extends BaseTextShape {
     /** The shape data for this character */
     private readonly shape;
+    private readonly font;
+    private readonly fontSize;
     /**
      * Creates a new instance of ShxTextShape
      * @param char - The character this shape represents
      * @param shape - The shape data for this character
      */
-    constructor(char: string, shape: ShxShape);
+    constructor(char: string, fontSize: number, shape: ShxShape, font: ShxFont);
     protected calcWidth(): number;
     offset(offset: Point): ShxTextShape;
     /**