Skip to content

Footprint Editor

alpCaner edited this page Jul 16, 2026 · 1 revision

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.

Opening a footprint

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.

Modes

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

The .snxfpt format

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.

Pads mode

Placing

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).

Pad kinds

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

Pad shapes

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

Pad side and drill

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

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.

Shared tooling

These buttons sit on the editor's active bar in both modes.

Selection Filter

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 Options

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.

Place / Move

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.

Select

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.

Align / Distribute

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.

Text

  • 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.

Shapes

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

3D Body and Extruded 3D Body.

Keyboard

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.

Arrays

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

The bake pipeline

Bake is how sketch geometry becomes real footprint primitives. The sketch is the source; the baked pads / silk / courtyard are the output.

The flow:

  1. Solve the sketch. The constraint solver resolves entity positions — see Sketch Mode.
  2. 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.
  3. Walk each attributed entity. Entities carry optional bake attributes. An entity with a pad attribute bakes to a pad; one with a silk attribute bakes to silkscreen, and so on.
  4. Evaluate the expression strings on each attribute against the resolved parameters.
  5. Emit the baked primitives.

Bake attributes

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

Closed-profile tracing

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.

Layer naming

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.

Known bake limitations

Honest list, read out of the code:

  • Paste aperture patterns — Grid and Custom patterns 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 Rect with 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.

Stock footprints

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.

See also

Clone this wiki locally