@mlightcad/cad-pdf-plugin 1.8.0-preview.2 → 1.8.0-preview.4

package/lib/recognition/pdfDimensionPattern.d.ts

@@ -0,0 +1,173 @@
+/**
+ * Recognizes exploded dimensions (arrowheads or ticks, dimension line,
+ * extension lines and text) in imported PDF geometry.
+ *
+ * Pure geometry: callers describe lines, closed polylines, circles and texts
+ * with plain data, so the recognizer is unit-testable without the data model.
+ */
+import { type PdfRecPoint } from './pdfRecGeometry';
+/** A straight segment (line, or 2-vertex polyline). */
+export interface PdfDimSegment<Id = unknown> {
+    id: Id;
+    p0: PdfRecPoint;
+    p1: PdfRecPoint;
+}
+/** A closed polyline that may be an arrowhead. */
+export interface PdfDimPolygon<Id = unknown> {
+    id: Id;
+    /** Vertices without the repeated closing point. */
+    vertices: PdfRecPoint[];
+}
+/** A circle or arc a radial dimension may point at. */
+export interface PdfDimCurve {
+    center: PdfRecPoint;
+    radius: number;
+}
+/** An arc that may be the dimension arc of an angular dimension. */
+export interface PdfDimArc<Id = unknown> {
+    id: Id;
+    center: PdfRecPoint;
+    radius: number;
+    /** Start angle in radians; the arc runs counterclockwise to `endAngle`. */
+    startAngle: number;
+    endAngle: number;
+}
+/** A text that may be a dimension value. */
+export interface PdfDimText<Id = unknown> {
+    id: Id;
+    text: string;
+    /** Center of the text box. */
+    center: PdfRecPoint;
+    height: number;
+    /**
+     * Extra entity ids that form exploded stroke text beyond {@link id}
+     * (each stroke is its own line/polyline).
+     */
+    extraIds?: Id[];
+}
+/**
+ * Exploded stroke text whose characters are not yet known. Linear recognition
+ * may still claim it and use the measured length as the value.
+ */
+export interface PdfDimUnreadText<Id = unknown> {
+    id: Id;
+    extraIds: Id[];
+    center: PdfRecPoint;
+    height: number;
+}
+/** Shapes to search, in model-space coordinates. */
+export interface PdfDimInput<Id = unknown> {
+    segments: PdfDimSegment<Id>[];
+    polygons: PdfDimPolygon<Id>[];
+    curves: PdfDimCurve[];
+    texts: PdfDimText<Id>[];
+    /** Arcs that may carry angular dimensions. Optional. */
+    arcs?: PdfDimArc<Id>[];
+    /**
+     * Stroke clusters that look like dimension text but have no readable
+     * value yet. Used only as a linear-dimension fallback.
+     */
+    unreadTexts?: PdfDimUnreadText<Id>[];
+}
+/** A recognized linear (rotated) dimension. */
+export interface PdfLinearDimension<Id = unknown> {
+    kind: 'linear';
+    /** First extension line origin (object side). */
+    xLine1: PdfRecPoint;
+    /** Second extension line origin (object side). */
+    xLine2: PdfRecPoint;
+    /** A point on the dimension line. */
+    dimLinePoint: PdfRecPoint;
+    /** Dimension line direction in radians, in `[0, π)`. */
+    rotation: number;
+    /** Distance between the terminators. */
+    measured: number;
+    text: PdfDimText<Id>;
+    /** Arrow length (or tick half-length); 0 without terminators. */
+    arrowSize: number;
+    /** How far extension lines run past the dimension line. */
+    extensionBeyond: number;
+    /** True when the terminators are architectural ticks. */
+    ticks: boolean;
+    /**
+     * True when the arrowheads sit outside the extension lines (tips point
+     * toward each other). False for the usual inside arrows (pointing apart).
+     */
+    arrowsOut: boolean;
+    /** Source shapes the dimension replaces. */
+    consumed: Id[];
+}
+/** A recognized radius or diameter dimension. */
+export interface PdfRadialDimension<Id = unknown> {
+    kind: 'radius' | 'diameter';
+    center: PdfRecPoint;
+    /** Point on the curve the arrow touches. */
+    chordPoint: PdfRecPoint;
+    radius: number;
+    /** Distance from the chord point to the text. */
+    leaderLength: number;
+    /** Radius or diameter, matching `kind`. */
+    measured: number;
+    text: PdfDimText<Id>;
+    arrowSize: number;
+    consumed: Id[];
+}
+/** A recognized angular dimension (three-point form). */
+export interface PdfAngularDimension<Id = unknown> {
+    kind: 'angular';
+    center: PdfRecPoint;
+    /** A point on the first leg (object side). */
+    xLine1: PdfRecPoint;
+    /** A point on the second leg (object side). */
+    xLine2: PdfRecPoint;
+    /** Midpoint of the dimension arc. */
+    arcPoint: PdfRecPoint;
+    /** Measured angle in degrees. */
+    measured: number;
+    text: PdfDimText<Id>;
+    arrowSize: number;
+    consumed: Id[];
+}
+export type PdfDimensionCandidate<Id = unknown> = PdfLinearDimension<Id> | PdfRadialDimension<Id> | PdfAngularDimension<Id>;
+/** Tuning for {@link recognizePdfDimensions}. */
+export interface PdfDimensionOptions {
+    /** Geometric tolerance. Default: 2 % of the median arrow size. */
+    tolerance?: number;
+    /** Angular tolerance in radians. Default 3°. */
+    angleTolerance?: number;
+}
+/**
+ * Reads an arrowhead from a closed triangle: the sharpest corner is the tip,
+ * the others form the base. Rejects shapes that are not slender triangles.
+ */
+export declare function pdfArrowFromPolygon(vertices: PdfRecPoint[]): {
+    tip: PdfRecPoint;
+    direction: PdfRecPoint;
+    size: number;
+} | undefined;
+/** First number in a dimension text, e.g. `Ø25` → 25, `1,200` → 1200. */
+export declare function parsePdfDimensionValue(text: string): number | undefined;
+/**
+ * Finds linear, radius and diameter dimensions.
+ *
+ * Linear: two terminators whose tips share their axis (arrows pointing
+ * apart, or together for small dimensions), a value text beside them, and
+ * optional extension lines through each tip. Pairs are taken shortest
+ * first so chained dimensions sharing extension lines stay separate.
+ *
+ * Radial: an arrow whose tip lies on a circle and points along its radius,
+ * with an `R…` or `Ø…` text nearby.
+ *
+ * @param input - Candidate shapes.
+ * @param options - Tolerances.
+ */
+export declare function recognizePdfDimensions<Id>(input: PdfDimInput<Id>, options?: PdfDimensionOptions): PdfDimensionCandidate<Id>[];
+/** Entity ids that a dimension value text replaces. */
+export declare function pdfDimTextIds<Id>(text: PdfDimText<Id>): Id[];
+/**
+ * Most common text-value / measured-length ratio, i.e. the drawing scale the
+ * PDF was printed at. Uses linear dimensions when there are any. Returns `undefined` when
+ * no dimension has a numeric text.
+ */
+export declare function suggestPdfDimensionScale(dimensions: PdfDimensionCandidate[]): number | undefined;
+//# sourceMappingURL=pdfDimensionPattern.d.ts.map

package/lib/recognition/pdfDimensionPattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdfDimensionPattern.d.ts","sourceRoot":"","sources":["../../src/recognition/pdfDimensionPattern.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAoB,KAAK,WAAW,EAAO,MAAM,kBAAkB,CAAA;AAE1E,uDAAuD;AACvD,MAAM,WAAW,aAAa,CAAC,EAAE,GAAG,OAAO;IACzC,EAAE,EAAE,EAAE,CAAA;IACN,EAAE,EAAE,WAAW,CAAA;IACf,EAAE,EAAE,WAAW,CAAA;CAChB;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa,CAAC,EAAE,GAAG,OAAO;IACzC,EAAE,EAAE,EAAE,CAAA;IACN,mDAAmD;IACnD,QAAQ,EAAE,WAAW,EAAE,CAAA;CACxB;AAED,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,oEAAoE;AACpE,MAAM,WAAW,SAAS,CAAC,EAAE,GAAG,OAAO;IACrC,EAAE,EAAE,EAAE,CAAA;IACN,MAAM,EAAE,WAAW,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,4CAA4C;AAC5C,MAAM,WAAW,UAAU,CAAC,EAAE,GAAG,OAAO;IACtC,EAAE,EAAE,EAAE,CAAA;IACN,IAAI,EAAE,MAAM,CAAA;IACZ,8BAA8B;IAC9B,MAAM,EAAE,WAAW,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,EAAE,GAAG,OAAO;IAC5C,EAAE,EAAE,EAAE,CAAA;IACN,QAAQ,EAAE,EAAE,EAAE,CAAA;IACd,MAAM,EAAE,WAAW,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,oDAAoD;AACpD,MAAM,WAAW,WAAW,CAAC,EAAE,GAAG,OAAO;IACvC,QAAQ,EAAE,aAAa,CAAC,EAAE,CAAC,EAAE,CAAA;IAC7B,QAAQ,EAAE,aAAa,CAAC,EAAE,CAAC,EAAE,CAAA;IAC7B,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,CAAA;IACvB,wDAAwD;IACxD,IAAI,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,EAAE,CAAA;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC,EAAE,CAAC,EAAE,CAAA;CACrC;AAED,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB,CAAC,EAAE,GAAG,OAAO;IAC9C,IAAI,EAAE,QAAQ,CAAA;IACd,iDAAiD;IACjD,MAAM,EAAE,WAAW,CAAA;IACnB,kDAAkD;IAClD,MAAM,EAAE,WAAW,CAAA;IACnB,qCAAqC;IACrC,YAAY,EAAE,WAAW,CAAA;IACzB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAA;IAChB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,CAAA;IACpB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAA;IACjB,2DAA2D;IAC3D,eAAe,EAAE,MAAM,CAAA;IACvB,yDAAyD;IACzD,KAAK,EAAE,OAAO,CAAA;IACd;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB,4CAA4C;IAC5C,QAAQ,EAAE,EAAE,EAAE,CAAA;CACf;AAED,iDAAiD;AACjD,MAAM,WAAW,kBAAkB,CAAC,EAAE,GAAG,OAAO;IAC9C,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAA;IAC3B,MAAM,EAAE,WAAW,CAAA;IACnB,4CAA4C;IAC5C,UAAU,EAAE,WAAW,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAA;IACpB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,EAAE,EAAE,CAAA;CACf;AAED,yDAAyD;AACzD,MAAM,WAAW,mBAAmB,CAAC,EAAE,GAAG,OAAO;IAC/C,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,WAAW,CAAA;IACnB,8CAA8C;IAC9C,MAAM,EAAE,WAAW,CAAA;IACnB,+CAA+C;IAC/C,MAAM,EAAE,WAAW,CAAA;IACnB,qCAAqC;IACrC,QAAQ,EAAE,WAAW,CAAA;IACrB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,EAAE,EAAE,CAAA;CACf;AAED,MAAM,MAAM,qBAAqB,CAAC,EAAE,GAAG,OAAO,IAC1C,kBAAkB,CAAC,EAAE,CAAC,GACtB,kBAAkB,CAAC,EAAE,CAAC,GACtB,mBAAmB,CAAC,EAAE,CAAC,CAAA;AAE3B,iDAAiD;AACjD,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AA0BD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,WAAW,EAAE,GACtB;IAAE,GAAG,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAkBxE;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQvE;AAUD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EACvC,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,EACtB,OAAO,GAAE,mBAAwB,GAChC,qBAAqB,CAAC,EAAE,CAAC,EAAE,CAwY7B;AA0LD,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAI5D;AAkDD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,qBAAqB,EAAE,GAClC,MAAM,GAAG,SAAS,CAsBpB"}