Files
OpenNest/docs/breakoffs.md
T
ajandClaude Opus 5.5 e6d438629f feat(cutting): slice slugs the support grid can't hold level
On an enclosed machine a cutout slug that tips once cut free can stand up
above the sheet and catch the enclosure door when the pallet changes. The
head already keeps off cut cutouts, so this is about clearing the door, not
the head.

Cutting Settings > Cutouts > "Slice slugs the support grid can't hold
level" (CuttingParameters.SliceTippingSlugs, off by default, saved per
machine thickness and written only when on) makes Plan Cutting cut each
such slug along the bed's contact lines (grid rows and columns, slat center
lines) before the cutout, so no piece keeps a contact and the pieces drop
between the supports. Each slice stops a kerf short of the cutout, so the
pieces stay attached until the cutout's own kerf frees them together. A
slug the bed holds level, or one on no contact, is left whole; a cutout
holding another part or another of its part's cuts is never sliced.

Slices are break cuts emitted right after the drawing's own break cuts,
pierced on themselves and led straight back to their start. The
released-contour proof now leaves out straight break cuts lying wholly
inside one of the part's closed holes, since the grid cells they free are
scrap; break cuts in material still take part. The plan fingerprint only
changes when the setting is on.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-12 17:04:27 -05:00

68 lines
3.9 KiB
Markdown

# Breakoffs
A breakoff is scrap drawn on a part, such as a forming backgauge tab, that must stay
attached through cutting and forming and is snapped off afterwards. In the CAD
Converter's **Breakoffs** panel, **Add Breakoff**, then click the line that joins the
part and the scrap. Lines or arcs that end partway along another visible line or arc
first split it there (the first piece keeps its entity ID), so a joining line can end
exactly where it meets the outline. The clicked entity then grows into the chain that
continues as a single path. Its ends must touch, within 0.001, one closed outline
drawn around both part and scrap, and the chain must run inside it: either a separate
line drawn across the outline, or a section of the part outline with the scrap's
outside edges drawn separately.
The smaller side is the scrap; **Flip** (or "Larger side is scrap" in the dialog)
swaps it. The dialog sets the tab count (both end tabs included, at least 2) and tab
width; tabs start evenly spaced and can be dragged along the joining line. Edit
re-spaces the tabs only when the count or width changes. The view shades the scrap,
draws the cuts and marks where each cut is pierced.
## Geometry contract
`BreakoffBuilder` (`OpenNest.Core/Breakoffs`) resolves each `Drawing.Breakoffs` entry
against the entities being cut:
- The two sides are the outline from one end of the joining line to the other, closed
back along the joining line. They must add up to the outline within 1%. Tab
positions are measured from the joining line's end with the smaller X (then Y).
- The outline is kept, with every joint snapped exact (lines move their endpoint; a
short connecting line is added between arcs), because the planner closes contours within
1e-6 and the program is re-chained from any entity.
- The joining line between consecutive tabs becomes open cuts on the `Break` layer
(`LayerType.Break`, `SpecialLayers.Break`), each traveling with the scrap on its
left. The joining line itself is not cut at the tabs; end tabs keep cuts off the
outline.
## Cutting break cuts
Break cuts cut like `Cut` motions but are not material: `SpecialLayers.IsMaterial`,
material capture, overlap checks, nesting and area ignore them. `ShapeProfile` and
`ConvertGeometry` pass them through in order without re-chaining or re-winding.
Both Plan Cutting (`PreparedContours`, emitted after scribes and before contours in
every full or prefix emission, never in single-contour probes) and the manual lead-in tool
(`ContourCuttingStrategy.Apply`/`ApplySingle`) emit them through
`ContourCuttingStrategy.EmitBreakCuts`:
- Each cut is entered from its scrap side with the internal lead-in; `NoLeadIn`
pierces on the line. There is no lead-out, since the cut ends at a tab.
- It is entered at whichever end has more scrap before the part's contours along the
scrap direction (`BreakCutEntry`), because the scrap narrows to a wedge near the
outline. Entering at the far end cuts it in reverse.
Plan Cutting also cuts [slug slices](support-tabs.md#slug-slices) on the `Break` layer: open
cuts inside a cutout's slug, pierced on themselves with a straight lead-in along the cut.
Checks treat them as intentional open cuts retained by tabs: `ReleasedContourState`
never makes them rapid obstacles or "open fragment" warnings, but reports a missing
lead-in like any contour. `LeadPathValidator` lets a lead into a break cut run
through its own part's material, and still refuses one that touches any of the part's
boundaries or another part. The posts cut them: Gravograph IS maps `Break` to its cut
settings; CI Fiber and Cincinnati treat any non-lead, non-scribe layer as cut.
Breakoffs that do not resolve (hidden or missing joining line, overlapping tabs) are
listed with the reason and not applied, but stay on the drawing.
`CadImporter.BuildDrawing` applies breakoffs and copies them to the drawing;
`SourceEntities` keep the original geometry so a reopened drawing can be edited. Split
pieces get no breakoffs.