@mlightcad/graphic-interface 3.12.0 → 3.12.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 mlightcad
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 mlightcad
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,214 +1,214 @@
-# @mlightcad/graphic-interface
-
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![npm version](https://img.shields.io/npm/v/@mlightcad/graphic-interface.svg)](https://www.npmjs.com/package/@mlightcad/graphic-interface)
-
-The graphic-interface package provides the graphics interface for controlling how AutoCAD entities are displayed on screen. This package offers a simplified API compared to AutoCAD ObjectARX's AcGi classes, making it more developer-friendly while maintaining the core functionality needed for rendering CAD entities.
-
-## Overview
-
-This package provides the graphics interface layer that bridges the gap between the data model and the rendering system. It handles the conversion of AutoCAD entities into drawable objects and provides customization options for how objects are displayed, including colors, layers, visibility, and various rendering styles.
-
-## Key Features
-
-- **Entity Rendering**: Convert AutoCAD entities to drawable objects
-- **Style Customization**: Control colors, line styles, text styles, and point styles
-- **View Management**: Handle different views and viewports
-- **Arrow and Hatch Support**: Custom arrow types and hatch pattern rendering
-- **Image Rendering**: Support for raster image display
-- **Flexible Rendering**: Extensible rendering system for different output formats
-
-## Installation
-
-```bash
-npm install @mlightcad/graphic-interface
-```
-
-## Key Classes
-
-### Core Rendering Classes
-- **AcGiRenderer**: Main interface for rendering entities to drawable objects
-- **AcGiEntity**: Base class for drawable objects that can be rendered
-- **AcGiView**: Represents a view with camera and projection settings
-- **AcGiViewport**: Manages viewport settings and clipping
-
-### Style Classes
-- **AcGiArrowType**: Defines different arrow types for dimensions and leaders
-- **AcGiHatchStyle**: Controls hatch pattern rendering and appearance
-- **AcGiImageStyle**: Manages raster image display properties
-- **AcGiLineStyle**: Defines line styles including dash patterns and widths
-- **AcGiPointStyle**: Controls point entity display appearance
-- **AcGiTextStyle**: Manages text rendering properties and formatting
-
-## Usage Examples
-
-### Basic Entity Rendering
-```typescript
-import { AcGiRenderer, AcGiEntity } from '@mlightcad/graphic-interface';
-import { AcDbLine, AcGePoint3d } from '@mlightcad/data-model';
-
-// Create a renderer
-const renderer = new AcGiRenderer();
-
-// Create an entity
-const startPoint = new AcGePoint3d(0, 0, 0);
-const endPoint = new AcGePoint3d(10, 10, 0);
-const line = new AcDbLine(startPoint, endPoint);
-
-// Render the entity
-const drawableEntity = renderer.renderEntity(line);
-```
-
-### Style Configuration
-```typescript
-import { 
-  AcGiLineStyle, 
-  AcGiTextStyle, 
-  AcGiPointStyle,
-  AcGiArrowType 
-} from '@mlightcad/graphic-interface';
-
-// Configure line style
-const lineStyle = new AcGiLineStyle();
-lineStyle.setColor(1); // Red
-lineStyle.setWidth(2.0);
-lineStyle.setDashPattern([10, 5, 5, 5]); // Dashed line
-
-// Configure text style
-const textStyle = new AcGiTextStyle();
-textStyle.setFont('Arial');
-textStyle.setHeight(12);
-textStyle.setColor(2); // Yellow
-textStyle.setBold(true);
-
-// Configure point style
-const pointStyle = new AcGiPointStyle();
-pointStyle.setSize(5);
-pointStyle.setShape('Circle');
-pointStyle.setColor(3); // Green
-
-// Configure arrow style
-const arrowStyle = new AcGiArrowType();
-arrowStyle.setType('ClosedFilled');
-arrowStyle.setSize(3);
-arrowStyle.setColor(1); // Red
-```
-
-### View and Viewport Management
-```typescript
-import { AcGiView, AcGiViewport, AcGePoint3d } from '@mlightcad/graphic-interface';
-
-// Create a view
-const view = new AcGiView();
-view.setEyePoint(new AcGePoint3d(0, 0, 100));
-view.setTargetPoint(new AcGePoint3d(0, 0, 0));
-view.setUpVector(new AcGeVector3d(0, 1, 0));
-
-// Create a viewport
-const viewport = new AcGiViewport();
-viewport.setView(view);
-viewport.setWidth(800);
-viewport.setHeight(600);
-viewport.setZoom(1.0);
-
-// Set viewport properties
-viewport.setClippingEnabled(true);
-viewport.setClippingBounds(0, 0, 100, 100);
-```
-
-### Hatch Pattern Rendering
-```typescript
-import { AcGiHatchStyle } from '@mlightcad/graphic-interface';
-
-// Configure hatch style
-const hatchStyle = new AcGiHatchStyle();
-hatchStyle.setPattern('ANSI31'); // Standard AutoCAD pattern
-hatchStyle.setScale(1.0);
-hatchStyle.setAngle(0);
-hatchStyle.setColor(4); // Cyan
-hatchStyle.setTransparency(0.5);
-
-// Apply hatch to an entity
-const hatchedEntity = renderer.renderEntityWithHatch(entity, hatchStyle);
-```
-
-### Image Rendering
-```typescript
-import { AcGiImageStyle } from '@mlightcad/graphic-interface';
-
-// Configure image style
-const imageStyle = new AcGiImageStyle();
-imageStyle.setBrightness(1.0);
-imageStyle.setContrast(1.0);
-imageStyle.setFade(0.0);
-imageStyle.setTransparency(0.0);
-imageStyle.setClippingEnabled(false);
-
-// Render image with style
-const imageEntity = renderer.renderImage(imagePath, imageStyle);
-```
-
-### Custom Rendering Pipeline
-```typescript
-import { AcGiRenderer, AcGiEntity } from '@mlightcad/graphic-interface';
-
-// Create a custom renderer
-class CustomRenderer extends AcGiRenderer {
-  renderEntity(entity: AcDbEntity): AcGiEntity {
-    // Custom rendering logic
-    const drawable = super.renderEntity(entity);
-    
-    // Apply custom styling
-    if (entity.getLayer() === 'HIGHLIGHT') {
-      drawable.setHighlighted(true);
-    }
-    
-    return drawable;
-  }
-  
-  renderToCanvas(canvas: HTMLCanvasElement, entities: AcGiEntity[]) {
-    const ctx = canvas.getContext('2d');
-    
-    entities.forEach(entity => {
-      // Custom canvas rendering
-      this.renderEntityToCanvas(ctx, entity);
-    });
-  }
-}
-
-// Use custom renderer
-const customRenderer = new CustomRenderer();
-const drawableEntities = entities.map(entity => customRenderer.renderEntity(entity));
-customRenderer.renderToCanvas(canvas, drawableEntities);
-```
-
-### Batch Rendering
-```typescript
-import { AcGiRenderer } from '@mlightcad/graphic-interface';
-
-// Batch render multiple entities
-const renderer = new AcGiRenderer();
-const entities = [line1, circle1, polyline1, text1];
-
-// Render all entities with consistent styling
-const drawableEntities = renderer.renderEntities(entities, {
-  defaultColor: 7, // White
-  defaultLayer: '0',
-  defaultLinetype: 'CONTINUOUS'
-});
-
-// Apply viewport transformations
-viewport.applyTransformations(drawableEntities);
-```
-
-## Dependencies
-
-- **@mlightcad/geometry-engine**: For geometric operations (peer dependency)
-
-## API Documentation
-
-For detailed API documentation, visit the [RealDWG-Web documentation](https://mlight-lee.github.io/realdwg-web/).
-
-## Contributing
-
+# @mlightcad/graphic-interface
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![npm version](https://img.shields.io/npm/v/@mlightcad/graphic-interface.svg)](https://www.npmjs.com/package/@mlightcad/graphic-interface)
+
+The graphic-interface package provides the graphics interface for controlling how AutoCAD entities are displayed on screen. This package offers a simplified API compared to AutoCAD ObjectARX's AcGi classes, making it more developer-friendly while maintaining the core functionality needed for rendering CAD entities.
+
+## Overview
+
+This package provides the graphics interface layer that bridges the gap between the data model and the rendering system. It handles the conversion of AutoCAD entities into drawable objects and provides customization options for how objects are displayed, including colors, layers, visibility, and various rendering styles.
+
+## Key Features
+
+- **Entity Rendering**: Convert AutoCAD entities to drawable objects
+- **Style Customization**: Control colors, line styles, text styles, and point styles
+- **View Management**: Handle different views and viewports
+- **Arrow and Hatch Support**: Custom arrow types and hatch pattern rendering
+- **Image Rendering**: Support for raster image display
+- **Flexible Rendering**: Extensible rendering system for different output formats
+
+## Installation
+
+```bash
+npm install @mlightcad/graphic-interface
+```
+
+## Key Classes
+
+### Core Rendering Classes
+- **AcGiRenderer**: Main interface for rendering entities to drawable objects
+- **AcGiEntity**: Base class for drawable objects that can be rendered
+- **AcGiView**: Represents a view with camera and projection settings
+- **AcGiViewport**: Manages viewport settings and clipping
+
+### Style Classes
+- **AcGiArrowType**: Defines different arrow types for dimensions and leaders
+- **AcGiHatchStyle**: Controls hatch pattern rendering and appearance
+- **AcGiImageStyle**: Manages raster image display properties
+- **AcGiLineStyle**: Defines line styles including dash patterns and widths
+- **AcGiPointStyle**: Controls point entity display appearance
+- **AcGiTextStyle**: Manages text rendering properties and formatting
+
+## Usage Examples
+
+### Basic Entity Rendering
+```typescript
+import { AcGiRenderer, AcGiEntity } from '@mlightcad/graphic-interface';
+import { AcDbLine, AcGePoint3d } from '@mlightcad/data-model';
+
+// Create a renderer
+const renderer = new AcGiRenderer();
+
+// Create an entity
+const startPoint = new AcGePoint3d(0, 0, 0);
+const endPoint = new AcGePoint3d(10, 10, 0);
+const line = new AcDbLine(startPoint, endPoint);
+
+// Render the entity
+const drawableEntity = renderer.renderEntity(line);
+```
+
+### Style Configuration
+```typescript
+import { 
+  AcGiLineStyle, 
+  AcGiTextStyle, 
+  AcGiPointStyle,
+  AcGiArrowType 
+} from '@mlightcad/graphic-interface';
+
+// Configure line style
+const lineStyle = new AcGiLineStyle();
+lineStyle.setColor(1); // Red
+lineStyle.setWidth(2.0);
+lineStyle.setDashPattern([10, 5, 5, 5]); // Dashed line
+
+// Configure text style
+const textStyle = new AcGiTextStyle();
+textStyle.setFont('Arial');
+textStyle.setHeight(12);
+textStyle.setColor(2); // Yellow
+textStyle.setBold(true);
+
+// Configure point style
+const pointStyle = new AcGiPointStyle();
+pointStyle.setSize(5);
+pointStyle.setShape('Circle');
+pointStyle.setColor(3); // Green
+
+// Configure arrow style
+const arrowStyle = new AcGiArrowType();
+arrowStyle.setType('ClosedFilled');
+arrowStyle.setSize(3);
+arrowStyle.setColor(1); // Red
+```
+
+### View and Viewport Management
+```typescript
+import { AcGiView, AcGiViewport, AcGePoint3d } from '@mlightcad/graphic-interface';
+
+// Create a view
+const view = new AcGiView();
+view.setEyePoint(new AcGePoint3d(0, 0, 100));
+view.setTargetPoint(new AcGePoint3d(0, 0, 0));
+view.setUpVector(new AcGeVector3d(0, 1, 0));
+
+// Create a viewport
+const viewport = new AcGiViewport();
+viewport.setView(view);
+viewport.setWidth(800);
+viewport.setHeight(600);
+viewport.setZoom(1.0);
+
+// Set viewport properties
+viewport.setClippingEnabled(true);
+viewport.setClippingBounds(0, 0, 100, 100);
+```
+
+### Hatch Pattern Rendering
+```typescript
+import { AcGiHatchStyle } from '@mlightcad/graphic-interface';
+
+// Configure hatch style
+const hatchStyle = new AcGiHatchStyle();
+hatchStyle.setPattern('ANSI31'); // Standard AutoCAD pattern
+hatchStyle.setScale(1.0);
+hatchStyle.setAngle(0);
+hatchStyle.setColor(4); // Cyan
+hatchStyle.setTransparency(0.5);
+
+// Apply hatch to an entity
+const hatchedEntity = renderer.renderEntityWithHatch(entity, hatchStyle);
+```
+
+### Image Rendering
+```typescript
+import { AcGiImageStyle } from '@mlightcad/graphic-interface';
+
+// Configure image style
+const imageStyle = new AcGiImageStyle();
+imageStyle.setBrightness(1.0);
+imageStyle.setContrast(1.0);
+imageStyle.setFade(0.0);
+imageStyle.setTransparency(0.0);
+imageStyle.setClippingEnabled(false);
+
+// Render image with style
+const imageEntity = renderer.renderImage(imagePath, imageStyle);
+```
+
+### Custom Rendering Pipeline
+```typescript
+import { AcGiRenderer, AcGiEntity } from '@mlightcad/graphic-interface';
+
+// Create a custom renderer
+class CustomRenderer extends AcGiRenderer {
+  renderEntity(entity: AcDbEntity): AcGiEntity {
+    // Custom rendering logic
+    const drawable = super.renderEntity(entity);
+    
+    // Apply custom styling
+    if (entity.getLayer() === 'HIGHLIGHT') {
+      drawable.setHighlighted(true);
+    }
+    
+    return drawable;
+  }
+  
+  renderToCanvas(canvas: HTMLCanvasElement, entities: AcGiEntity[]) {
+    const ctx = canvas.getContext('2d');
+    
+    entities.forEach(entity => {
+      // Custom canvas rendering
+      this.renderEntityToCanvas(ctx, entity);
+    });
+  }
+}
+
+// Use custom renderer
+const customRenderer = new CustomRenderer();
+const drawableEntities = entities.map(entity => customRenderer.renderEntity(entity));
+customRenderer.renderToCanvas(canvas, drawableEntities);
+```
+
+### Batch Rendering
+```typescript
+import { AcGiRenderer } from '@mlightcad/graphic-interface';
+
+// Batch render multiple entities
+const renderer = new AcGiRenderer();
+const entities = [line1, circle1, polyline1, text1];
+
+// Render all entities with consistent styling
+const drawableEntities = renderer.renderEntities(entities, {
+  defaultColor: 7, // White
+  defaultLayer: '0',
+  defaultLinetype: 'CONTINUOUS'
+});
+
+// Apply viewport transformations
+viewport.applyTransformations(drawableEntities);
+```
+
+## Dependencies
+
+- **@mlightcad/geometry-engine**: For geometric operations (peer dependency)
+
+## API Documentation
+
+For detailed API documentation, visit the [RealDWG-Web documentation](https://mlight-lee.github.io/realdwg-web/).
+
+## Contributing
+
 This package is part of the RealDWG-Web monorepo. Please refer to the main project README for contribution guidelines. 

package/lib/AcGiEntity.d.ts

@@ -57,5 +57,26 @@ export interface AcGiEntity {
      * @returns Return a clone of this object and optionally all descendants.
      */
     fastDeepClone(): AcGiEntity;
+    /**
+     * Optionally merges same-material drawable leaves so later
+     * {@link fastDeepClone} copies far fewer geometries.
+     *
+     * Used by block-reference template caching. Must be called before the INSERT
+     * transform is applied while the entity is still at identity. Implementations
+     * that do not support compaction may omit this method.
+     *
+     * @returns Nothing.
+     */
+    compactForInstancing?(): void;
+    /**
+     * Optionally releases GPU/CPU resources owned by this entity.
+     *
+     * Used when clearing the block rendering cache. Implementations that do not
+     * own disposable resources may omit this method. Shared materials from a
+     * style cache should not be disposed here unless the implementation owns them.
+     *
+     * @returns Nothing.
+     */
+    dispose?(): void;
 }
 //# sourceMappingURL=AcGiEntity.d.ts.map

package/lib/AcGiEntity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcGiEntity.d.ts","sourceRoot":"","sources":["../src/AcGiEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAEzD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,IAAI,QAAQ,IAAI,MAAM,CAAA;IACtB,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAC;IAE3B;;;OAGG;IACH,IAAI,OAAO,IAAI,MAAM,CAAA;IACrB,IAAI,OAAO,CAAC,KAAK,EAAE,MAAM,EAAC;IAE1B;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAAA;IACvB,IAAI,SAAS,CAAC,KAAK,EAAE,MAAM,EAAC;IAE5B;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAAA;IACtB,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAAC;IAE3B;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAAA;IACtB,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAC;IAE3B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IAEjC;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IAEvC;;OAEG;IACH,SAAS,IAAI,IAAI,CAAA;IAEjB;;OAEG;IACH,WAAW,IAAI,IAAI,CAAA;IAEnB;;;;;;;OAOG;IACH,aAAa,IAAI,UAAU,CAAA;CAC5B"}
+{"version":3,"file":"AcGiEntity.d.ts","sourceRoot":"","sources":["../src/AcGiEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAEzD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,IAAI,QAAQ,IAAI,MAAM,CAAA;IACtB,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAC;IAE3B;;;OAGG;IACH,IAAI,OAAO,IAAI,MAAM,CAAA;IACrB,IAAI,OAAO,CAAC,KAAK,EAAE,MAAM,EAAC;IAE1B;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAAA;IACvB,IAAI,SAAS,CAAC,KAAK,EAAE,MAAM,EAAC;IAE5B;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAAA;IACtB,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAAC;IAE3B;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAAA;IACtB,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAC;IAE3B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IAEjC;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IAEvC;;OAEG;IACH,SAAS,IAAI,IAAI,CAAA;IAEjB;;OAEG;IACH,WAAW,IAAI,IAAI,CAAA;IAEnB;;;;;;;OAOG;IACH,aAAa,IAAI,UAAU,CAAA;IAE3B;;;;;;;;;OASG;IACH,oBAAoB,CAAC,IAAI,IAAI,CAAA;IAE7B;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,IAAI,CAAA;CACjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mlightcad/graphic-interface",
-  "version": "3.12.0",
+  "version": "3.12.2",
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -33,8 +33,8 @@
     "require": "./dist/graphic-interface.umd.cjs"
   },
   "peerDependencies": {
-    "@mlightcad/common": "1.12.0",
-    "@mlightcad/geometry-engine": "3.12.0"
+    "@mlightcad/common": "1.12.2",
+    "@mlightcad/geometry-engine": "3.12.2"
   },
   "scripts": {
     "clean": "rimraf dist lib tsconfig.tsbuildinfo",