Repository navigation
Footprint Editor
The Footprint Editor edits .snxfpt files — Signex's native
footprint format.
Two ways to build a footprint:
- Pads mode — place and edit pads directly. Fast, familiar, what you want for a one-off part.
- Sketch Mode — draw a parametric 2D sketch driven by a constraint solver, then bake it into pads / silk / courtyard. What you want when a family of parts shares one drawing.
Both live in the same tab and edit the same file. You can move between them freely.
A .snxfpt opens as a document tab from the project tree or the file
dialog. One file holds many footprints — the format is a
multi-footprint container, matching the Altium PCB Library model.
A three-segment strip floating over the canvas switches the editor mode. The segments read Sketch · Pads · 3D:
| Button | Mode |
|---|---|
| Sketch | Parametric sketch — see Sketch Mode |
| Pads | Direct pad-list editing |
| 3D | 3D body preview |
A TOML manifest header plus one [[footprints]] entry per footprint.
Each footprint's bulk pad list is embedded as a TSV literal block
(pads_tsv = '''…''') — line-diffable in git, and editable in any
spreadsheet if you really want to.
format = "snxfpt/1"
file_uuid = "…"
display_name = "Connectors"
[[footprints]]
name = "SOIC-8"
pads_tsv = '''
number kind shape size_x …
1 Smd RoundRect 1.5 …
'''Everything that is variant-shaped or sparse — silk / fab / courtyard graphics, the 3D body, the sketch, pours, keepouts, cutouts, v-scores, mask openings and excludes, paste apertures — stays as inline TOML rather than being forced into the TSV grid.
The format key is a schema sentinel. Current builds write and accept
"snxfpt/1"; any other token is rejected with an explicit error rather
than being silently misparsed.
The Pads-mode active bar carries the placement tools. Click a tool to arm it; right-click cancels back to Select.
| Tool | Gesture |
|---|---|
| Select | Default. Click to select, drag to move. |
| Place Pad | Click empty canvas to drop pads |
| Place Via | Click empty canvas to drop a through-hole via |
| Place String | Click empty canvas to drop silk-layer text |
There is no Delete button on the bar — the Delete key removes the
selection.
More placement tools reach the canvas through the shared active-bar dropdowns below (Text, Shapes, 3D Body).
| Kind | Meaning |
|---|---|
Smd |
Surface-mount pad |
Tht |
Plated through-hole |
NptHole |
Non-plated mounting hole |
ConnectorPad |
Connector pad |
Fiducial |
Vision-alignment marker — single side, no paste, no drill |
Castellated |
Plated half-hole on the board edge, halved by the parent PCB outline router |
| Shape | Notes |
|---|---|
| Round | Default |
| Rect | |
| RoundRect | Corner-radius ratio, 0.0 = sharp rect … 0.5 = full pill |
| Oval | |
| Chamfered | Chamfer ratio + per-corner enable flags (top-left / top-right / bottom-right / bottom-left) |
| Custom | Arbitrary polygon outline — either an explicit point list, or traced from a sketch profile |
Pads sit on Top, Bottom, or All. Through-hole and non-plated pads
require All.
Drills carry a diameter, an optional slot length (None = round drill,
set = oval slot), and a plated flag — clear it for a non-plated
mounting hole.
The Pad Stack section has three tabs, matching Altium's:
| Tab | Shows |
|---|---|
| Simple | One row per stack family — COPPER / HOLE / PASTE / SOLDER |
| Top-Middle-Bottom | COPPER splits into Top / Middle / Bottom rows |
| Full Stack | Enumerates the pad's layer list verbatim |
Per-side overrides live on the pad itself: mask margin and paste margin
each have a global fallback plus _top / _bottom overrides, per-side
paste-stencil enable, and per-side tented flags (tenting skips the
mask opening entirely).
Pads also carry an electrical type (Load / Source / Terminator), a mechanical pad feature (None / Counterbore / Countersink), thermal-relief style, and test-point participation flags.
These buttons sit on the editor's active bar in both modes.
Ten footprint-kind toggle pills — 3D Bodies, Keepouts, Tracks, Arcs,
Pads, Vias, Regions, Fills, Texts, Other — plus an All - On /
All - Off toggle. Filter presets can be saved (+ Save Preset).
Snap layers: All Layers / Current Layer / Off.
Snap targets: Grids, Guides, Axes.
Objects for snapping: Track Vertices, Track Lines, Arc Centers, Intersections, Pad Centers, Pad Vertices, Pad Edges, Via Centers, Texts, Regions, Footprint Origins, 3D Body Snap Points.
In a footprint there is no separate move tool — dragging a pad is the move gesture. Move and Drag therefore both drop you into the select-and-drag behaviour.
Move Selection by X, Y… opens a modal where you type an exact
(dx, dy) offset in mm instead of nudging by the grid step. It feeds
the same dispatcher the one-step nudge uses, so history, sketch mirror,
and primitive re-sync all behave identically.
Stubs: Break Track and Drag Track End are present in the menu but not yet implemented.
Selection-mode picker: Lasso Select, Inside Area, Outside Area, Touching Rectangle, Touching Line, All on Layer, All, Off Grid Pads, Toggle Selection, plus Select overlapped / Select next for stacked objects.
| Horizontal | Vertical |
|---|---|
| Align Left | Align Top |
| Align Right | Align Bottom |
| Align Left (maintain spacing) | Align Top (maintain spacing) |
| Align Right (maintain spacing) | Align Bottom (maintain spacing) |
| Align Horizontal Centers | Align Vertical Centers |
| Distribute Horizontally | Distribute Vertically |
| Increase Horizontal Spacing | Increase Vertical Spacing |
| Decrease Horizontal Spacing | Decrease Vertical Spacing |
Plus Align To Grid and Move All Components Origin To Grid.
Stub: the generic Align… dialog launcher (per-axis radio + reference picker) is not yet implemented. The concrete operations above cover the day-to-day flow.
- String — click to place silk-layer text.
- Text Frame — press-drag-release on empty canvas. Press sets the anchor, the drag previews a ghost rectangle, release commits a framed silk string sized to the box.
Framed text is aligned and clipped inside its frame at render time. There is no auto-wrap or reflow — text that doesn't fit is clipped, not rewrapped.
Sketch-mode geometry (Line, Arc, Full Circle, Rectangle), plus Fill and Solid Region — two names for the same primitive, a closed-loop filled polygon. Picking either flips the editor back to Pads mode and arms the region gesture.
The menu lists Arc (Center), Arc (Edge), and Arc (Any Angle) separately, but all three currently arm the same centre → start → end arc tool.
3D Body and Extruded 3D Body.
Verified in the footprint canvas:
| Key | Action |
|---|---|
Ctrl+X / Ctrl+C / Ctrl+V
|
Cut / copy / paste pad — works in both Pads and Sketch mode |
Space |
Rotate the selected pad 90° |
X |
Flip the selected pad's layer |
Space and X only fire when there's a pad to act on, so the canvas
doesn't swallow them from sketch tools.
These canvas keys are fixed, not rebindable. What is rebindable is
the mode switching — "Switch footprint editor to Pads / Sketch / 3D
View mode" are keymap commands — along with the general Delete
binding. See Keyboard Shortcuts.
A sketch array expands to multiple baked primitives at bake time. Each replica inherits its attributes from the source entity; the bake applies per-instance position and pad number.
| Kind | Parameters |
|---|---|
| Linear | source, count, dx, dy |
| Grid | source, nx, ny, dx, dy, optional depopulation |
| Polar | source, centre, count, sweep angle, optional depopulation |
Depopulation suppresses individual instances without breaking the
parametric chain — a predicate evaluated per (i, j) index (i, j,
nx, ny are in scope; true keeps the instance), plus an explicit
list of indices to skip.
Numbering schemes:
| Scheme | Result |
|---|---|
| LinearIncrement (default) | Sequential integers from start by step
|
| BgaRowCol | Row letter + column number (A1, H17). IPC-7351 skips I/O/Q/S/X/Z when skip_letters is on |
| Explicit | An explicit name list — for named-pin connectors |
Bake is how sketch geometry becomes real footprint primitives. The sketch is the source; the baked pads / silk / courtyard are the output.
The flow:
- Solve the sketch. The constraint solver resolves entity positions — see Sketch Mode.
-
Resolve parameters. The sketch's parameter table is topologically
sorted and evaluated, so
body_w = "= pad_pitch * (pin_count - 1) + 2mm"works and cycles are rejected. -
Walk each attributed entity. Entities carry optional bake
attributes. An entity with a
padattribute bakes to a pad; one with asilkattribute bakes to silkscreen, and so on. - Evaluate the expression strings on each attribute against the resolved parameters.
- Emit the baked primitives.
| Attribute | Bakes to |
|---|---|
pad |
A pad |
silk |
Silkscreen |
courtyard |
Courtyard outline |
mask_opening / mask_exclude
|
Solder-mask geometry |
paste_aperture |
Paste-stencil aperture |
pour |
Copper pour |
keepout |
Keepout |
board_cutout |
Board cutout |
v_score |
V-score hint |
Attributes that need an outline (silk, courtyard, mask, pour, keepout, cutout, 3D extrude) run the closed-profile walker: from a starting Line, it traverses connected edges through shared endpoint Points and emits the boundary as a polygon.
- Lines and Arcs both participate. Each arc is tessellated into a
fixed number of straight segments from its solved
(centre, start, end, sweep_ccw). - Construction and centerline entities are skipped silently — they're solver scaffolding and never reach the baked geometry.
- A Circle is rejected by the walker. A circle is already closed and has no start/end endpoints to walk, so the bake module handles it directly instead.
- Branching topology — a vertex with 3 or more incident edges — is ambiguous. The trace fails and the bake skips with a warning.
- Other trace failures: the start isn't an edge, an endpoint can't be resolved, the walk ran off an open chain, or it exceeded its iteration cap on broken topology.
Baked layer names come from the same Altium-style label set the rest of the Signex PCB taxonomy uses — "Top Layer", "Top Solder", "Top Paste", and so on.
Honest list, read out of the code:
-
Paste aperture patterns —
GridandCustompatterns warn and fall back to a single aperture. -
Custom pads from a sketch profile bake to a Custom polygon via the
profile walker. If the trace fails, the pad falls back to
Rectwith a warning rather than failing the bake.
Bake warnings from the most recent solve surface in the sketch inspector's Solve warnings section — you don't have to go hunting in a log.
The repo ships an example that builds a small stock library — SOIC-8,
QFN-16, R0805, MountingHole-3.2mm, Fiducial-1mm — as a
reference for the format.
- Sketch Mode — the parametric sketcher and its solver
- Active Bar
- Selection and Filter
- Keyboard Shortcuts
Signex v0.14.0 · Apache-2.0 · Issues · Discussions · Website