@mlightcad/mtext-renderer 0.11.0 → 0.11.1

package/lib/font/baseFont.d.ts

@@ -60,6 +60,10 @@ export declare abstract class BaseFont {
      * @returns The shape data for the character code, or undefined if not found
      */
     abstract getCodeShape(code: number, size: number): BaseTextShape | undefined;
+    /**
+     * Gets a named SHX shape glyph when supported by the font implementation.
+     */
+    getShapeByName(_name: string, _size: number): BaseTextShape | undefined;
     /**
      * Gets the scale factor for this font.
      * This is used to adjust the size of characters when rendering.

package/lib/font/fontManager.d.ts

@@ -184,6 +184,14 @@ export declare class FontManager {
      * @returns The text shape for the character, or undefined if not found
      */
     getCharShape(char: string, fontName: string, size: number): BaseTextShape | undefined;
+    /**
+     * Resolves a named SHX shape glyph from the specified font.
+     */
+    getShapeByName(name: string, fontName: string, size: number): BaseTextShape | undefined;
+    /**
+     * Resolves an SHX shape glyph by numeric character code from the specified font.
+     */
+    getShapeByCode(code: number, fontName: string, size: number): BaseTextShape | undefined;
     /**
      * Gets the text shape from the first loaded default font that contains the character.
      * Used after primary and optional bigFont lookups per AutoCAD text-style semantics.

package/lib/font/shxFont.d.ts

@@ -55,6 +55,12 @@ export declare class ShxFont extends BaseFont {
      * @returns The shape data for the character code, or undefined if not found
      */
     getCodeShape(code: number, size: number): ShxTextShape | undefined;
+    /**
+     * Gets the shape data for a named SHX shape at a given size.
+     *
+     * Shape names are matched case-insensitively via the underlying SHX parser.
+     */
+    getShapeByName(name: string, size: number): ShxTextShape | undefined;
     /** True when the SHX glyph has drawable strokes or a non-zero pen advance. */
     private static hasRenderableStrokes;
     /**

package/lib/renderer/index.d.ts

@@ -1,6 +1,7 @@
 export * from './colorUtils';
 export * from './constants';
 export * from './mtext';
+export * from './shape';
 export * from './mtextDataUtils';
 export * from './styleManager';
 export * from './types';

package/lib/renderer/mtext.d.ts

@@ -1,6 +1,6 @@
 import { FontManager } from '../font';
 import { StyleManager } from './styleManager';
-import { ColorSettings, MTextData, MTextLayout, TextStyle } from './types';
+import { ColorSettings, MTextData, MTextLayout, ShapeData, TextStyle } from './types';
 import * as THREE from 'three';
 /**
  * Represents an AutoCAD MText object in Three.js.
@@ -101,6 +101,12 @@ export declare class MText extends THREE.Object3D {
      * @returns The created Three.js object, or undefined if creation fails
      */
     private loadMText;
+    /**
+     * Builds and places one SHX shape glyph.
+     */
+    loadShape(shapeData: ShapeData, style: TextStyle): THREE.Object3D<THREE.Object3DEventMap> | undefined;
+    private finalizePlacement;
+    private createShapeGroup;
     /**
      * Creates a group of text elements from MText data.
      * @param mtextData - The MText data to process

package/lib/renderer/mtextProcessor.d.ts

@@ -275,6 +275,19 @@ export declare class MTextProcessor {
      * @param group The group to add processed geometries to
      */
     private startNewParagraph;
+    /**
+     * Renders one SHX shape glyph for AutoCAD SHAPE entities.
+     *
+     * The glyph is resolved by {@link shapeName} first, then by {@link shapeNumber}.
+     */
+    processShapeGlyph(shapeName?: string, shapeNumber?: number): THREE.Object3D | undefined;
+    private resolveShapeGlyph;
+    /**
+     * Builds geometry for one glyph and appends it to the output buffers.
+     *
+     * @returns Horizontal advance width after width factor and oblique skew.
+     */
+    private buildShapeGeometry;
     /**
      * Render the specified texts
      * @param item Input texts to render

package/lib/renderer/shape.d.ts

@@ -0,0 +1,25 @@
+import { FontManager } from '../font';
+import { StyleManager } from './styleManager';
+import { ColorSettings, MTextLayout, ShapeData, TextStyle } from './types';
+import * as THREE from 'three';
+/**
+ * Represents one AutoCAD SHAPE entity in Three.js.
+ */
+export declare class Shape extends THREE.Object3D {
+    private _shapeData;
+    private _style;
+    private _fontsInStyleLoaded;
+    private _styleManager;
+    private _fontManager;
+    private _colorSettings;
+    private _box;
+    constructor(shapeData: ShapeData, style: TextStyle, styleManager: StyleManager, fontManager: FontManager, colorSettings?: ColorSettings);
+    get box(): THREE.Box3;
+    get styleManager(): StyleManager;
+    get textStyle(): TextStyle;
+    createLayoutData(): MTextLayout;
+    asyncDraw(): Promise<void>;
+    syncDraw(): void;
+    private createPlacementData;
+    private getFontName;
+}

package/lib/renderer/types.d.ts

@@ -177,6 +177,25 @@ export interface MTextData {
     /** Whether to collect per-character bounding boxes for picking. Default is true */
     collectCharBoxes?: boolean;
 }
+/**
+ * Describes one AutoCAD SHAPE entity for rendering.
+ */
+export interface ShapeData {
+    /** Shape name within the SHX font (DXF group 2). */
+    name?: string;
+    /** Numeric shape code within the SHX font. */
+    shapeNumber?: number;
+    /** Shape height (DXF group 40). */
+    size: number;
+    /** Insertion point in WCS coordinates. */
+    position: Point3d;
+    /** Rotation relative to the shape OCS X axis, in radians. */
+    rotation?: number;
+    /** Extrusion/normal vector. */
+    directionVector?: Point3d;
+    /** Relative X-scale factor. */
+    widthFactor?: number;
+}
 /**
  * Represents a text style configuration that defines the visual appearance and formatting of text.
  * This interface contains properties that control various aspects of text rendering including font,

package/lib/worker/baseRenderer.d.ts

@@ -1,5 +1,5 @@
 import { StyleManager } from '../renderer/styleManager';
-import { ColorSettings, MTextData, MTextLayout, TextStyle } from '../renderer/types';
+import { ColorSettings, MTextData, MTextLayout, ShapeData, TextStyle } from '../renderer/types';
 import * as THREE from 'three';
 /**
  * Represents a rendered MText object that extends THREE.Object3D with additional MText-specific properties.
@@ -55,6 +55,14 @@ export interface MTextBaseRenderer {
      * @returns A Promise resolving to a populated `MTextObject` ready to add to a scene.
      */
     syncRenderMText(mtextContent: MTextData, textStyle: TextStyle, colorSettings?: ColorSettings): MTextObject;
+    /**
+     * Render one SHX shape glyph synchronously.
+     */
+    syncRenderShape(shapeContent: ShapeData, textStyle: TextStyle, colorSettings?: ColorSettings): MTextObject;
+    /**
+     * Render one SHX shape glyph asynchronously.
+     */
+    asyncRenderShape(shapeContent: ShapeData, textStyle: TextStyle, colorSettings?: ColorSettings): Promise<MTextObject>;
     /**
      * Ensure the specified fonts are available to the renderer.
      *

package/lib/worker/mainThreadRenderer.d.ts

@@ -1,5 +1,5 @@
 import { StyleManager } from '../renderer/styleManager';
-import { ColorSettings, MTextData, TextStyle } from '../renderer/types';
+import { ColorSettings, MTextData, ShapeData, TextStyle } from '../renderer/types';
 import { MTextBaseRenderer, MTextObject } from './baseRenderer';
 /**
  * Main thread renderer for MText objects
@@ -30,6 +30,8 @@ export declare class MainThreadRenderer implements MTextBaseRenderer {
      * that default font is loaded and fonts needed in mtext are loaded.
      */
     syncRenderMText(mtextContent: MTextData, textStyle: TextStyle, colorSettings?: ColorSettings): MTextObject;
+    asyncRenderShape(shapeContent: ShapeData, textStyle: TextStyle, colorSettings?: ColorSettings): Promise<MTextObject>;
+    syncRenderShape(shapeContent: ShapeData, textStyle: TextStyle, colorSettings?: ColorSettings): MTextObject;
     /**
      * Load fonts in the main thread
      */

package/lib/worker/unifiedRenderer.d.ts

@@ -1,6 +1,6 @@
 import { DefaultFontsPreset } from '../font';
 import { StyleManager } from '../renderer';
-import { ColorSettings, MTextData, TextStyle } from '../renderer/types';
+import { ColorSettings, MTextData, ShapeData, TextStyle } from '../renderer/types';
 import { MTextObject } from './baseRenderer';
 import { WebWorkerRendererConfig } from './webWorkerRenderer';
 export type RenderMode = 'main' | 'worker';
@@ -57,6 +57,8 @@ export declare class UnifiedRenderer {
      * @param colorSettings - Optional color context (ByLayer, ByBlock colors).
      */
     syncRenderMText(mtextContent: MTextData, textStyle: TextStyle, colorSettings?: ColorSettings): MTextObject;
+    asyncRenderShape(shapeContent: ShapeData, textStyle: TextStyle, colorSettings?: ColorSettings, _mode?: RenderMode): Promise<MTextObject>;
+    syncRenderShape(shapeContent: ShapeData, textStyle: TextStyle, colorSettings?: ColorSettings): MTextObject;
     /**
      * Sets the default font fallback chain on the active renderer and workers.
      */

package/lib/worker/webWorkerRenderer.d.ts

@@ -1,5 +1,5 @@
 import { StyleManager } from '../renderer/styleManager';
-import { CharBox, ColorSettings, MTextData, TextStyle } from '../renderer/types';
+import { CharBox, ColorSettings, MTextData, ShapeData, TextStyle } from '../renderer/types';
 import { MTextBaseRenderer, MTextObject } from './baseRenderer';
 /**
  * Configuration options for WebWorkerRenderer
@@ -171,6 +171,8 @@ export declare class WebWorkerRenderer implements MTextBaseRenderer {
      * Notes: It isn't supported yet.
      */
     syncRenderMText(_mtextContent: MTextData, _textStyle: TextStyle, _colorSettings?: ColorSettings): MTextObject;
+    asyncRenderShape(_shapeContent: ShapeData, _textStyle: TextStyle, _colorSettings?: ColorSettings): Promise<MTextObject>;
+    syncRenderShape(_shapeContent: ShapeData, _textStyle: TextStyle, _colorSettings?: ColorSettings): MTextObject;
     loadFonts(fonts: readonly string[]): Promise<{
         loaded: string[];
     }>;

package/package.json

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