# engineering-drawing

> The engineering-drawing skill makes a dimensioned PDF drawing of a part, with views, hidden lines, hole callouts and a title block projected from the model.

An engineering drawing is the 2D sheet a shop works from: orthographic views of a part, its dimensions, hole callouts, notes and a title block. The `engineering-drawing` skill makes one as a PDF, projecting the views from the part's own geometry and measuring every dimension on that geometry. When the model changes and the script runs again, the drawing follows.

The drawing documents geometry; it does not build it. It is a PDF written by a Python script, not a viewer document, and opens in any PDF reader.

## What it makes

- One PDF, with a page per sheet. Sheet sizes are `A4`, `A3`, `A2`, `A1` and `A0`, landscape.
- Line weights by meaning: heavy visible outlines, dashed hidden lines, thin centre marks and dimensions.
- Dimensions with filled arrowheads and witness lines. Values are true size at any drawing scale.
- A title block with title, part number, material, author, scale, units, projection, revision and sheet count. The general tolerance, when given, is note 1. A revision table appears top-right when the script passes `revisions=`.
- No creation date, so an unchanged drawing rebuilds to an identical file.

## How it works

The part comes from one of two places. For a part with a model, the script calls the model function (for example `enclosure()`) and takes its `.shape`. For a part that exists only as a file, it reads the STEP with `step.read` or an `.xbf` with `xbf.read`.

Your agent writes `<name>_drawing.py` beside the model. Dimension values such as hole pitch, overall size and wall thickness are imported from the model module, so moving a feature moves its dimension. A short drawing script:

```python
from cad.eng_drawing import Sheet, eng_drawing
from enclosure import HOLES, L, H, W, enclosure

@eng_drawing(out="../PDF/enclosure_drawing.pdf")
def enclosure_drawing():
    part = enclosure().shape
    sheet = Sheet("A3", title="ENCLOSURE", part_number="ENC-001", material="ABS",
                  revision="A", general_tolerance="ISO 2768-m",
                  notes=["BREAK SHARP EDGES."])
    top, front, right, iso = sheet.three_views(part, iso=True)
    top.overall()
    top.hole((HOLES[3][0], HOLES[3][1], H / 2), 3, depth=8, count=len(HOLES))
    return sheet

if __name__ == "__main__":
    enclosure_drawing()
```

The `out` path is required, must end in `.pdf`, and is resolved against the script. There is no default location for drawings, so you choose where they belong.

The parts of the sheet API:

- `sheet.three_views(part, iso=True)` returns the top, front and right views in third angle plus an isometric view. A custom layout uses `sheet.view(part, name, at=(x, y))`.
- Dimensions are given in model coordinates: `view.overall()` for overall size, `view.dim` for feature positions, `view.hole` for hole callouts (through, depth, counterbore, countersink, thread) and `view.note` for notes with leaders.
- `text` and `offset` are left unset, so each value is measured and each dimension takes the next free row. `tol=` or `fit=` is added only where you give a tolerance or the design requires one.

The script runs with `cad run`:

```bash
cad run enclosure_drawing.py
```

It prints the PDF it wrote and anything it noticed while drawing, such as a dimension that "measures blank paper" or an "annotation overlaps" warning. Your agent reads those first, then opens the PDF and checks it: no dimension text on a view, hidden lines where features sit behind faces, a centre mark on every hole, no leader crossing the part. It moves `at=` or `offset=` and reruns until the sheet is clean.

A script asked for something it cannot draw correctly raises an error and writes no file. Examples are views that run off the frame (the error names a scale that fits), an unknown sheet size, or a note wider than the sheet. A failed run leaves any earlier PDF unchanged.

## Ask for it

- "Make a dimensioned drawing of the enclosure on an A3 sheet, third angle, with an isometric view."
- "I need a shop drawing of the bracket: overall size, hole positions, and a callout for each hole. Material 6061 aluminium."
- "Draw the vendor STEP file in `vendor/flange.step` on an A4 sheet with a general tolerance of ISO 2768-m."
- "Add a revision table to the drawing, revision A dated today, initial release."

## Limits

- Tolerances come only from `tol=`, `fit=` and `general_tolerance=` written from your requirements. A dimension without one is nominal. Your agent does not invent values, so tell it what you need.
- Views are orthographic projections with hidden lines from the kernel. There are no section views, detail views or auxiliary views yet.
- The sheet keeps callouts clear of the views it knows about and reports annotation that prints over other annotation. It does not check annotation against line work, so the PDF has to be read by eye.
- It is not for DXF cut layouts or flat patterns. For those, see [DXF profiles and flat patterns](https://www.texttocad.dev/docs/cad#dxf-profiles-and-flat-patterns).
- There is no `eng_drawing` command. The Python script is the interface.

## The skill

The skill is [`engineering-drawing`](https://github.com/earthtojake/text-to-cad/blob/main/skills/engineering-drawing/SKILL.md). Its reference:

- [The sheet API](https://github.com/earthtojake/text-to-cad/blob/main/skills/engineering-drawing/references/sheet-api.md): every `Sheet` and `View` argument

Related pages: [cad](https://www.texttocad.dev/docs/cad) for the models a drawing documents, its [manufacturing checks](https://www.texttocad.dev/docs/cad#manufacturing-checks) for checking a part before it goes to a shop, and [sendcutsend](https://www.texttocad.dev/docs/sendcutsend) for pre-upload checks of cut and bent parts.

