# Graphics and Annotations

Use schematic graphics and text to explain circuit intent, group related sections, and record design constraints. They support documentation but do not create an electrical connection unless the selected tool is explicitly electrical.

## Choose the correct tool

| Tool | Use it for |
|---|---|
| **Draw Line** (++shift+l++), **Draw Rectangle** (++r++), **Draw Circle** (++e++), **Draw Arc** (++a++), **Draw Polygon** (++o++) | Visual grouping or explanatory shapes |
| **Place Text** (++t++) | Notes, limits, test points, and design intent |
| **Net Harness** (++h++) | A drawn line that marks a bundle of signals; it does not connect nets |
| **Junction** (++j++) | Explicit electrical meeting point of wires |
| **Import Image** | A PNG, JPG, or BMP picture (a logo, a block diagram) placed at the centre of the view |

Do not use a graphic line as a wire. If two pins must be electrically connected, use the Wire tool and verify the result with net highlighting or ERC.

## Create and edit an annotation

1. Select the graphic or text tool.
2. Place its points or bounds on the sheet.
3. Press ++esc++ when the shape is complete.
4. Select it and use **Properties → Graphic Object** to set **Content** (text), **Size**, **Color**, or **Thickness**.
5. Save and inspect the PDF result if the annotation is part of release documentation.

### Short video — Add a circuit note and grouping box

<video controls muted playsinline preload="metadata" src="../assets/wf/docs/schematic/graphics-and-annotations/add-a-circuit-note-and-grouping-box.mp4" title="Place a text note under the 32.768 kHz crystal Y1 and draw a grouping rectangle around it"></video>
The KLP4e datalogger is a good model: every functional block on its main sheet — *Real time clock*, *MCU*, *EEPROM*, *Connectors*, *Mounting* — sits inside a rectangle with a title in large text. Imported from KiCad, those rectangles and titles come in as WireFrame graphics, drawn exactly where the author put them.

## Annotation guidelines

- State measurable constraints, not vague comments.
- Keep notes outside symbol pins and wires.
- Use consistent font size and restrained color.
- Include voltage, current, tolerance, or test conditions when relevant.
- Avoid duplicating information that is already controlled by a component property.
- Confirm that release-critical notes remain readable in exported PDF.

## Dimensions

The schematic editor has no dimension tool. Record required distances as text, and place real dimensions on the PCB with the **Measure** tool (++m++).

### Image — Documented schematic block

![The KLP4e real-time clock block as its author drew it: a grouping rectangle titled Real time clock around U1, its crystal and pull-ups](../assets/wf/docs/schematic/graphics-and-annotations/documented-schematic-block.png)
## Related guidelines

- [Wiring and Nets](wiring-and-nets.md)
- [Properties and Attributes](properties-and-attributes.md)
- [Templates and Title Block](templates.md)
