@mlightcad/data-model 1.2.21 → 1.2.23

package/lib/entity/AcDbFace.js

@@ -0,0 +1,224 @@
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+import { AcGeBox3d, AcGePoint3d } from '@mlightcad/geometry-engine';
+import { AcDbEntity } from './AcDbEntity';
+/**
+ * Represents a three-dimensional surface patch — specifically, a flat polygon that
+ * can have three or four vertices (triangular or quadrilateral). It’s one of the
+ * simplest types of 3D geometry in AutoCAD — used mainly for visual representation
+ * of 3D models, not for solid modeling.
+ */
+var AcDbFace = /** @class */ (function (_super) {
+    __extends(AcDbFace, _super);
+    /**
+     * Creates a new face entity.
+     *
+     * This constructor initializes a face with default values.
+     * All vertices are set to the origin.
+     */
+    function AcDbFace() {
+        var _this = _super.call(this) || this;
+        _this._vertices = [new AcGePoint3d(), new AcGePoint3d(), new AcGePoint3d()];
+        _this._edgeInvisibilities = 0;
+        return _this;
+    }
+    /**
+     * Gets the point at the specified index in this face.
+     *
+     * The index can be 0, 1, 2, or 3, representing the four vertices of the face.
+     * If the index is out of range, it returns the first or last vertex accordingly.
+     *
+     * @param index - The index (0-3) of the vertex to get
+     * @returns The point at the specified index in WCS coordinates
+     *
+     * @example
+     * ```typescript
+     * const point0 = face.getVertexAt(0);
+     * const point1 = face.getVertexAt(1);
+     * console.log(`Vertex 0: ${point0.x}, ${point0.y}, ${point0.z}`);
+     * ```
+     */
+    AcDbFace.prototype.getVertexAt = function (index) {
+        if (index < 0)
+            return this._vertices[0];
+        if (index > this._vertices.length) {
+            return this._vertices[this._vertices.length - 1];
+        }
+        return this._vertices[index];
+    };
+    /**
+     * Sets the point at the specified index in this face.
+     *
+     * The index must be 0, 1, 2, or 3, representing the four vertices of the face.
+     * If the index is out of range, it sets the first or last vertex accordingly.
+     *
+     * @param index - The index (0-3) of the vertex to set
+     * @param point - The new point in WCS coordinates
+     *
+     * @example
+     * ```typescript
+     * face.setVertexAt(0, new AcGePoint3d(0, 0, 0));
+     * face.setVertexAt(1, new AcGePoint3d(10, 0, 0));
+     * face.setVertexAt(2, new AcGePoint3d(10, 5, 0));
+     * face.setVertexAt(3, new AcGePoint3d(0, 5, 0));
+     * ```
+     */
+    AcDbFace.prototype.setVertexAt = function (index, point) {
+        if (index < 0)
+            this._vertices[0].copy(point);
+        if (index >= 3) {
+            if (this._vertices.length === 3) {
+                this._vertices.push(new AcGePoint3d());
+            }
+            return this._vertices[3].copy(point);
+        }
+        this._vertices[index].copy(point);
+    };
+    /**
+     * Sets the invisibilities of the edges of the face.
+     *
+     * The invisibilities are represented as a bitmask, where each bit corresponds to an edge.
+     * If the bit is set, the edge is invisible, otherwise it is visible.
+     *
+     * @param invisibilities - The bitmask representing the invisibilities of the edges
+     *
+     * @example
+     * ```typescript
+     * face.setEdgeInvisibilities(0b1111); // All edges are visible
+     * face.setEdgeInvisibilities(0b0000); // All edges are invisible
+     * face.setEdgeInvisibilities(0b1010); // Edge 0 and 2 are visible, edge 1 and 3 are invisible
+     * ```
+     */
+    AcDbFace.prototype.setEdgeInvisibilities = function (invisibilities) {
+        this._edgeInvisibilities = invisibilities;
+    };
+    /**
+     * Checks if the edge at the specified index is visible.
+     *
+     * The index must be 0, 1, 2, or 3, representing the four edges of the face.
+     * If the index is out of range, it throws an error.
+     *
+     * @param index - The index (0-3) of the edge to check
+     * @returns True if the edge is visible, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const isVisible = face.isEdgeVisibleAt(0);
+     * console.log(`Edge 0 is visible: ${isVisible}`);
+     * ```
+     */
+    AcDbFace.prototype.isEdgeVisibleAt = function (index) {
+        if (index < 0 || index > 3) {
+            throw new Error('Index out of range');
+        }
+        return (this._edgeInvisibilities & (1 << index)) === 0;
+    };
+    /**
+     * Makes the edge at the specified index invisible.
+     *
+     * The index must be 0, 1, 2, or 3, representing the four edges of the face.
+     * If the index is out of range, it throws an error.
+     *
+     * @param index - The index (0-3) of the edge to make invisible
+     *
+     * @example
+     * ```typescript
+     * face.makeEdgeInvisibleAt(0);
+     * face.makeEdgeInvisibleAt(1);
+     * face.makeEdgeInvisibleAt(2);
+     * face.makeEdgeInvisibleAt(3);
+     * ```
+     */
+    AcDbFace.prototype.makeEdgeInvisibleAt = function (index) {
+        if (index < 0 || index > 3) {
+            throw new Error('Index out of range');
+        }
+        this._edgeInvisibilities = this._edgeInvisibilities | (1 << index);
+    };
+    Object.defineProperty(AcDbFace.prototype, "geometricExtents", {
+        /**
+         * Gets the geometric extents (bounding box) of this face.
+         *
+         * @returns The bounding box that encompasses the entire face
+         *
+         * @example
+         * ```typescript
+         * const extents = face.geometricExtents;
+         * console.log(`Trace bounds: ${extents.minPoint} to ${extents.maxPoint}`);
+         * ```
+         */
+        get: function () {
+            return new AcGeBox3d().setFromPoints(this._vertices);
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Gets the grip points for this face.
+     *
+     * Grip points are control points that can be used to modify the face.
+     * For a face, the grip points are all four vertices.
+     *
+     * @returns Array of grip points (all four vertices)
+     *
+     * @example
+     * ```typescript
+     * const gripPoints = face.subGetGripPoints();
+     * // gripPoints contains all four vertices of the face
+     * ```
+     */
+    AcDbFace.prototype.subGetGripPoints = function () {
+        var gripPoints = new Array();
+        for (var index = 0; index < this._vertices.length; ++index) {
+            gripPoints.push(this.getVertexAt(index));
+        }
+        return gripPoints;
+    };
+    /**
+     * Draws this face using the specified renderer.
+     *
+     * This method renders the face as a filled area using the face's
+     * current style properties.
+     *
+     * @param renderer - The renderer to use for drawing
+     * @returns The rendered face entity, or undefined if drawing failed
+     *
+     * @example
+     * ```typescript
+     * const renderedFace = face.draw(renderer);
+     * ```
+     */
+    AcDbFace.prototype.draw = function (renderer) {
+        var num = this._vertices.length;
+        var buffer = new Float32Array(num * 3);
+        var indices = new Uint16Array(num * 2);
+        for (var i = 0; i < num; i++) {
+            buffer[i * 3] = this._vertices[i].x;
+            buffer[i * 3 + 1] = this._vertices[i].y;
+            buffer[i * 3 + 2] = this._vertices[i].z;
+            if (this.isEdgeVisibleAt(i)) {
+                indices[i * 2] = i;
+                indices[i * 2 + 1] = (i + 1) % 4;
+            }
+        }
+        return renderer.lineSegments(buffer, 3, indices, this.lineStyle);
+    };
+    /** The entity type name */
+    AcDbFace.typeName = 'Face';
+    return AcDbFace;
+}(AcDbEntity));
+export { AcDbFace };
+//# sourceMappingURL=AcDbFace.js.map

package/lib/entity/AcDbFace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcDbFace.js","sourceRoot":"","sources":["../../src/entity/AcDbFace.ts"],"names":[],"mappings":"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"}

package/lib/entity/index.d.ts

@@ -1,10 +1,11 @@
+export * from './AcDbArc';
 export * from './AcDbBlockReference';
+export * from './AcDbCircle';
+export * from './AcDbCurve';
 export * from './AcDbEllipse';
 export * from './AcDbEntity';
-export * from './AcDbArc';
-export * from './AcDbCircle';
+export * from './AcDbFace';
 export * from './AcDbHatch';
-export * from './AcDbCurve';
 export * from './AcDbLeader';
 export * from './AcDbLine';
 export * from './AcDbMText';

package/lib/entity/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entity/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entity/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,sBAAsB,CAAA;AACpC,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/lib/entity/index.js

@@ -1,10 +1,11 @@
+export * from './AcDbArc';
 export * from './AcDbBlockReference';
+export * from './AcDbCircle';
+export * from './AcDbCurve';
 export * from './AcDbEllipse';
 export * from './AcDbEntity';
-export * from './AcDbArc';
-export * from './AcDbCircle';
+export * from './AcDbFace';
 export * from './AcDbHatch';
-export * from './AcDbCurve';
 export * from './AcDbLeader';
 export * from './AcDbLine';
 export * from './AcDbMText';

package/lib/entity/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/entity/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/entity/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,sBAAsB,CAAA;AACpC,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mlightcad/data-model",
-  "version": "1.2.21",
+  "version": "1.2.23",
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -36,9 +36,9 @@
     "uid": "^2.0.2"
   },
   "devDependencies": {
-    "@mlightcad/common": "1.2.1",
+    "@mlightcad/geometry-engine": "3.0.2",
     "@mlightcad/graphic-interface": "3.0.3",
-    "@mlightcad/geometry-engine": "3.0.2"
+    "@mlightcad/common": "1.2.1"
   },
   "scripts": {
     "analyze": "pnpm run analyze:lib && pnpm run analyze:worker",