Files
OpenNest/OpenNest.Reporting/NestReportSnapshot.cs
T
ajandClaude Opus 5.5 f4fb6e1f3d feat(reporting): show clamps and sheet rulers on the plate layout view
Operators reading a printed nest report could not see where the machine
clamps sit or which ones must be pulled before cutting, and had no way to
measure positions off the layout. Plate diagrams now draw active clamps as
hatched rectangles (labels keep clear of them) and removed rail clamps as
dashed, crossed-out rectangles over the parts, with a legend line only on
plates that have clamps. A horizontal ruler below and a vertical ruler left
of the drawing read the sheet's plate coordinates in job units; the
diagram is fitted in two passes so the ruler bands match their numbers,
and part labels never enter them. Rulers draw as their own content stream
so the diagram stream holds only the sheet and what is on it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-10 08:02:24 -05:00

76 lines
3.4 KiB
C#

using System.Collections.Immutable;
namespace OpenNest.Reporting;
public sealed record ReportPoint(double X, double Y);
public sealed record ReportBounds(double Left, double Bottom, double Right, double Top)
{
public double Length => Right - Left;
public double Width => Top - Bottom;
}
/// <summary>Native line or arc; angles are radians and a null center denotes a line.</summary>
public sealed record ReportSegment(ReportPoint Start, ReportPoint End, ReportPoint? Center,
double Radius, double StartAngle, double SweepAngle);
public sealed record ReportContour(ImmutableArray<ReportSegment> Segments, bool Closed);
public sealed record ReportGeometry(ImmutableArray<ReportContour> Contours, ReportBounds Bounds)
{
public bool StrokeOnly => Contours.Any(contour => !contour.Closed);
}
public sealed record ReportDrawing(string Id, string Name, long Required, long Nested,
long Shortage, long Extra, ImmutableArray<int> Plates, ReportGeometry Geometry)
{
/// <summary>
/// Net weight of one part in <see cref="NestReportSnapshot.WeightUnits"/>; null when the nest
/// has no thickness or the material has no density.
/// </summary>
public double? Weight { get; init; }
}
public sealed record ReportPlacement(string ReportId, ReportGeometry Geometry);
/// <summary>
/// A machine clamp footprint in the parts' placement frame. <paramref name="Removed"/> marks a
/// rail clamp taken off this sheet (by Auto Nest or by hand), which the operator pulls before cutting.
/// </summary>
public sealed record ReportClamp(string Id, ReportBounds Bounds, bool Removed);
public sealed record ReportPlate(int Number, ReportBounds Bounds, int Copies, double PartSpacing,
double Utilization, ImmutableArray<ReportPlacement> Parts, ImmutableArray<ReportGeometry> Cutoffs)
{
/// <summary>Estimated time to cut one copy of this plate; null when no estimate was requested.</summary>
public TimeSpan? CutTime { get; init; }
/// <summary>
/// Weight of one full sheet (outline area x nest thickness x the nest material's density) in
/// <see cref="NestReportSnapshot.WeightUnits"/>; null when the thickness or density is unknown.
/// </summary>
public double? Weight { get; init; }
/// <summary>Clamps on this sheet, active and removed; display only, never material.</summary>
public ImmutableArray<ReportClamp> Clamps { get; init; } = ImmutableArray<ReportClamp>.Empty;
}
/// <summary>A detached value snapshot. No domain objects or mutable geometry are retained.</summary>
public sealed record NestReportSnapshot(string Name, string Customer, string Notes, string Material,
string Grade, double Thickness, string Units, DateTimeOffset GeneratedAt,
ImmutableArray<ReportDrawing> Drawings, ImmutableArray<ReportPlate> Plates)
{
public long TotalSheets => Plates.Aggregate(0L, (total, plate) => checked(total + plate.Copies));
/// <summary>"lb" for inch jobs, "kg" for millimeter jobs.</summary>
public string WeightUnits => Units == "mm" ? "kg" : "lb";
/// <summary>True when the report carries estimated cut times.</summary>
public bool HasCutTimes { get; init; }
/// <summary>Every plate's estimate times its copies; null when the report has no estimates.</summary>
public TimeSpan? TotalCutTime => !HasCutTimes
? null
: Plates.Aggregate(TimeSpan.Zero, (total, plate) => total + (plate.CutTime ?? TimeSpan.Zero) * plate.Copies);
}