mirror of
https://github.com/ajisaacs/OpenNest.git
synced 2026-11-11 03:01:09 -05:00
ajandClaude Opus 5.5
ca693285bb
Holes and radii need sizes on the drawing as well as the overall extents. Select circles or arcs, right-click and choose Add Radius Dimension or Add Diameter Dimension. The value is measured live from the curve, found by its entity ID, so it follows edits; only the leader angle and label offset are saved. A radius on an arc stays on its sweep, and labels are kept clear of the curve and center. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
54 lines
3.3 KiB
Markdown
54 lines
3.3 KiB
Markdown
# Dimensions
|
|
|
|
A drawing can carry dimensions, shown in the CAD Converter:
|
|
|
|
- Overall dimensions: the part's size along X and along Y. In the **Dimensions** panel,
|
|
**Add Overall Dimensions** adds whichever of the two is missing, below and to the right of
|
|
the part. Drag a dimension line to move it, across the part to its other side if wanted.
|
|
- Radius and diameter dimensions on circles and arcs. Select one or more circles or arcs,
|
|
right-click and choose **Add Radius Dimension** or **Add Diameter Dimension**. Each curve
|
|
gets at most one of each. Drag the leader to swing the label around the curve and move it
|
|
in or out; a radius on an arc stays on the arc's sweep.
|
|
|
|
**Remove** in the Dimensions panel deletes the selected dimension.
|
|
|
|
## Contract
|
|
|
|
Dimensions are annotations. They never affect the program, nesting, cut time or posts, and
|
|
they do not appear on plates, in PDFs or in DXF export.
|
|
|
|
- `Drawing.Dimensions` stores only placement, so a value cannot go stale:
|
|
- Overall: the kind and the signed offset from the part's extents. Positive is above
|
|
(horizontal) or right (vertical).
|
|
- Radius and diameter: the kind, the measured curve's entity ID, the leader angle from the
|
|
curve's center (radians) and the signed offset from the curve to the label along the
|
|
leader, positive outside.
|
|
- Zero is never a valid offset.
|
|
- `DimensionBuilder` (`OpenNest.Core/Dimensions`) measures overall dimensions from the
|
|
entities as they will be cut: visible, with roles, breakoffs and tabbed cutouts applied, as
|
|
the Program tab builds them. `FileListItem.Bounds` is not used because it includes hidden
|
|
layers.
|
|
- Marks do not count toward overall dimensions: anything `ScribeLayerRepair.IsMarkLayer`
|
|
matches (scribe, etch and engrave, by layer name) and anything `SpecialLayers.IsMaterial`
|
|
rejects (rapids, break cuts). `IsMaterial` compares layer objects, so it alone would count
|
|
source marks on their own layers. Tabs and a breakoff's scrap count: both are material of
|
|
the part as cut.
|
|
- Radius and diameter find their curve by ID among the visible entities with roles applied,
|
|
before breakoffs and tabbed cutouts, which split a curve into new pieces. A cut or etched
|
|
curve can be dimensioned; an excluded, hidden or display-only one is not shown. Adding one
|
|
to a display-only curve explains that it must be set to Cut or Etch first. An arc that is
|
|
a full circle is measured as a circle.
|
|
- New radius and diameter labels sit outside the curve by half its radius, or a twentieth of
|
|
the part's larger size when that is more. On a circle the radius leader points up and right
|
|
and the diameter leader up and left, so the two do not overlap; on an arc both point
|
|
through the middle of its sweep. Dragging keeps the label a few pixels clear of both the
|
|
curve and the center; a curve too small for that keeps the label outside.
|
|
- A dimension with nothing to measure, a part with no size along its axis, or a curve that
|
|
is gone or no longer cut is listed as not shown and keeps its placement until the geometry
|
|
returns.
|
|
- Values show three decimals with no unit, in the drawing's units; radius labels are drawn
|
|
with an `R` prefix and diameter labels with `Ø`.
|
|
- Split pieces start with no dimensions, like breakoffs and tabbed cutouts.
|
|
|
|
File format: see [drawing dimensions](nest-file-format.md#drawing-dimensions).
|