Adom Symbol

@@ -10,6 +10,74 @@ adom-symbol renders a `.kicad_sym` through the shared `service-kicad` (no local  Every control lives in one floating panel. **Source** switches between auto-grouped (from the datasheet via ds2sf), the manufacturer symbol, or a vendor variant — the symbol re-renders in place. **Layout** flips between a left/right pinout and a square quad. **Groups** clusters pins by function (and splits GPIO by port). **Ref** and **Name** each get a direction pad and an inside/outside toggle, with overlap-aware placement so labels never collide. **3D chip** picks the render style, **Send to** exports, and every choice is sticky between sessions. On a wide screen the panel is a draggable floating toolbar; on a phone it folds into an inline panel. +# What each studio variant produces++Every control re-renders the symbol live through `service-kicad`, with overlap+avoidance re-run each time. Here is exactly what each setting does to the same+part (Nordic **nRF54L15**, 49 pins) so you can see the difference, not just read+about it.++## Layout — Left / Right vs Square++The **Layout** toggle decides which sides the pins land on.++![Left / Right layout: pins on two sides, grouped by function](docs/var-layout-leftright.png)++**Left / Right** is the classic two-column schematic symbol: inputs and bus pins+down the left, power / debug / timing / control down the right. Function groups+(`POWER`, `P2`, `DEBUG`, `TIMING`, `GROUND`, `RF`, `CONTROL`) are labelled and+spaced, and the reference (`U?`) sits centred on top. This is the most readable+form for a tall part and is the default.++![Square layout: pins balanced across all four sides](docs/var-layout-square.png)++**Square** balances the same pins across **all four sides** (top / right / bottom+/ left) to make a compact quad block — ideal for a QFN/BGA you want to drop into a+dense sheet without a tall, skinny outline. The pin-number rails move to whichever+edge each pin now lives on, and the body re-proportions to a square.++## Grouping — Grouped vs Flat++**Grouped** (shown in both layouts above) clusters pins by function with a small+header label per block and a gap between blocks. **Flat** turns that off:++![Flat grouping: every pin in one continuous run, no group headers](docs/var-groups-flat.png)++**Flat** lists every pin in one continuous numeric run with no function headers and+no inter-group gaps — the most compact vertical form, and the right choice when you+want raw pin order rather than a functional read. Toggling it re-flows the whole+symbol and re-checks label spacing.++## 3D chip — shaded iso vs vector outline++Beyond on/off, the **3D chip** overlay has two visual families, both rendered from+the part's real STEP model at the orientation you chose.++![Shaded isometric 3D chip in the symbol body](docs/var-3d-iso.png)++**Iso** is a soft shaded isometric render of the package, sitting behind the pin+text in the body — it reads instantly as "this is the real chip."++![Vector-outline 3D chip (teal), OCCT hidden-line removal](docs/var-3d-outline.png)++The **outline** styles (thin / bold / blueprint / teal / dark) are crisp+black-&-white (or accent) line art produced by **OCCT hidden-line removal** — a+schematic-native look that prints cleanly and never muddies the pin labels. Teal is+shown here; each style is the same geometry, re-inked.++## Chip name — In symbol vs On chip++Where the part number shows is its own control, and it ties into the 3D chip.++![Name on the chip: laser-marked onto the 3D package, schematic label hidden](docs/var-name-onchip.png)++**On chip** laser-marks the part number onto the 3D package's **top face** — real+embossed geometry that travels into the STEP file you send to KiCad — and hides the+schematic label, because the name is now physically on the part. (`In symbol` keeps+the conventional schematic label above the body; `Both` shows each; `None` hides+both.) This is the feature no other symbol tool has: the name you read in the+schematic is the same mark that ends up on the rendered chip.+ ## The signature feature: the chip on the symbol  ![The 3D chip embossed on the symbol body](docs/chip3d.png)

⋯ 1 unchanged line ⋯

⋯ 1 unchanged line ⋯

⋯ 1 unchanged line ⋯

⋯ 1 unchanged line ⋯

⋯ 1 unchanged line ⋯

⋯ 1 unchanged line ⋯