Exports
The Downloads button in the project header provides access to all export features. Click it to see the available options.
Export Image
Export the current canvas view as an image file.
- Format – PNG or SVG
- Resolution – configurable DPI for print-quality output
- Scope – exports exactly what is visible on the canvas, including active layers, component overlays, and rendering mode
Use this to generate assembly prints, board images for documentation, or quote visuals.
The MCP tool render_board_images renders the bare board images (<name>_PCB-Image-TOP.svg and -BOT.svg, realistic look in the PCB tab's colours, no components) on the server from the saved project and keeps a copy with the project.
Export Assembly Layout
Export the flat "base image" of each board side for assembly drawings, in place of a Gerbv rendering. The page is white, every selected layer is drawn in its own solid colour, and the bottom side is mirrored so it shows the board as seen from below. Unlike Export Image, it does not depend on the canvas view.
- Format – PNG, PDF or SVG. PNG uses the same resolution setting as Export Image and records its DPI, so it lands at board size in LibreOffice Draw. PDF and SVG are vector.
- Page (PDF) – A4 (default) or A3: the drawing is scaled to fit the sheet with a 10 mm margin and centred, in landscape or portrait to match the board, at the same scale on every page. Board size (1:1) makes each page the size of the framed drawing at 1:1 plus its 1 mm margin: the board and whatever crosses its edge with the Board outline frame, or everything on the selected layers with All selected layers. Small boards then look small on screen.
- Side – Top, Bottom, or Top + Bottom (ZIP). PDF also offers All, one two-page PDF (TOP, BOT), and Top + Bottom + All, a ZIP of all three PDFs.
- Layers – every layer of the project for the chosen side, each with a checkbox and a colour. Ticked by default: the board outline, solder mask, paste, silkscreen, drill files, and designator or assembly layers for that side (for example an Altium
Top_Designatormechanical layer). Copper, inner layers and other mechanical layers can be added. Reset restores the defaults for the side. - Frame – Board outline (default) or All selected layers. Board outline keeps everything that crosses the board edge, such as connector and LED outlines, and leaves out drawings that stand apart from the board, such as an Altium "Top Overlay" layer-name label. All selected layers shows everything on the chosen layers. Both add a 1 mm margin.
Layers are drawn bottom to top in a fixed order: copper, inner layers, solder mask, paste, silkscreen, drill, outline, then designator and other layers.
Default colours follow the Gerbv images used for assembly drawings:
| Layer | Colour |
|---|---|
| Solder mask openings | green #4E9E61 |
| Paste | blue #183ACF (top), magenta #C930B6 (bottom) |
| Silkscreen, outline | near-black #4E4E4E |
| Drill | white (holes) |
| Designator and other layers | orange #FFC34E |
| Copper, inner layers | light grey |
Layer choices, colours, the frame and the PDF page are saved with the project and shared with the team. Viewers can export, but their changes are not saved.
Gerbtrace finds designator layers and their side from the file's Gerber X2 FileFunction header, then from the file name. A layer whose side is unknown is listed on both sides, unticked.
Areas a layer knocks out of itself (clear polarity) show the layers beneath in every format, as in Gerbv. For example, KiCad's "subtract soldermask from silkscreen" leaves the pads under the silkscreen visible.
Export Assembly Drawing
Generate the finished assembly drawings for production: one A4 landscape PDF per ERP step (S SMT, ST THT, SO, TO), named and titled as the ERP files the drawing of that step's Assembly Specification: <item>-<site>-<step>_Assembly-Drawing.pdf, for example ITM-0017B-01B-DE-S_Assembly-Drawing.pdf and ITM-0017B-01B-DE-ST_Assembly-Drawing.pdf. The item is the step item code from the title block. Each PDF is downloaded and also saved to the project's documents as a Drawings document, replacing an earlier export of the same name. Drawings of earlier versions, which had one PDF for all steps (…-DE_Assembly-Drawing.pdf), stay in the documents until you remove them.
After the approval. An approved project, or a shown variant whose approval still covers its drawing, keeps exporting and storing its assembly drawings. Export them once the approval stands: the stored PDFs then carry the approver's initials, the approval date and the revision in the title block. Team editors and admins can store them, even while the Files page is locked. Only the …_Assembly-Drawing.pdf documents are stored this way; every other file and setting of an approved project stays frozen. To change the drawing itself, reopen the project for revision (below).
Each step's PDF stands on its own: it has the 3D views, the PCB and panel and the fiducials, plus that step's own pages (SMD for S, THT for ST). The label page before assembly is in the first step's PDF, the label page of final inspection in the last step's. The sections, in production order:
- Label before assembly – when a board label is applied before assembly (the usual traceability label), its own page comes first: the bare board side drawn as its PCB image (solder mask, surface finish and legend in the colours of the PCB data, as PCB images draws them, with the traces showing through the mask) with each label as a red outline at its size and position, see-through so the board under it stays visible, a short text inside (
BCunless you set another) and its item above it; a table of the labels (name, where, side, X/Y, size); and one info box per label with the same red box, the label's item, name and size (for exampleESO-L00311 / Standard7x7 / 7x7mm) and its instruction. In the PDF each info box is a link to the label's record in the ERP (https://erp.newmatik.com/app/traceability-label/<item>). - 3D views – the TOP, BOTTOM and isometric renders of the 3D model made from the uploaded STEP file. The page is left out while there is no render; a view that is still missing shows a placeholder asking for the STEP upload.
- PCB and panel – the single board and the panel with automatic dimensions (board and panel size, first board, frame). The panel is shown whenever the project is panelized, also when it holds one board in a frame, and each board is drawn with its real outline and cut-outs, turned as in the panel editor (a rectangle when the outline has no closed contour). The page also has the pick-and-place origin and a parameter table (size, boards per panel, separation, frame, layers, thickness, material, copper, finish, solder mask, silkscreen, component counts, and last the full DNP list in natural order, wrapped over as many lines as it needs). General instruction notes (notes for no particular step) appear here.
- Fiducials – every fiducial on each side with names and a table of their coordinates and sizes; left out when the board has none.
- SMD assembly TOP / BOTTOM – polarized parts framed in translucent magenta with the whole pin 1 (pad and lead) filled magenta, DNP parts filled blue. On a side without silkscreen the polarized and DNP parts also get their designators as labels; where the silkscreen already prints them, the labels are left out so they don't cover dense areas. Export › Assembly Drawing Designators changes this for the project: Auto (default), Always or Never. Instruction notes for the SMT step appear next to the legend; the parts they name are outlined.
- THT assembly – the board seen from the side the THT parts are fitted from, THT parts grouped by item, each group with a number and a colour (parts fitted from the other side are drawn pale with a dotted outline), and beside it a compact
Group | Qty | Item | Description | Designatorstable above the isometric render, when there is one (four groups per page; more groups continue on the next THT page). Each THT page marks pin 1, draws callouts and lists notes only for the parts in its own table, and its notes' pictures follow it on their own page. - Label at final inspection – labels applied after assembly come last: the board side as its PCB image with the fitted parts and the red label boxes, plus labels that do not go on the board (for example a label for the delivery note or the packaging), each with its info box, link and instruction. Every THT part's tag starts with its group number, so the page also reads correctly in greyscale or for colour-blind readers.
The 2D views draw the board and every part in light greyscale (pads, silkscreen and holes, no traces) so only the markings carry colour; the 3D renders and the label pages keep the board's real colours. Each colour has one meaning: DNP is blue, polarity is magenta, notes and fiducials are orange, and red marks only the traceability labels on the label pages (a red outline with no fill, drawn on a thin white halo, so the box also shows on a red board). The four THT group colours (yellow, green, violet, brown) use no blue or cyan, which would read as DNP, and no red, which is kept for warnings; they stay distinct for colour-blind readers and in brightness, and each THT part is drawn as a light tint of its group colour with a border in the full colour, the colour the table prints. The THT page draws no library footprint for its own parts, so under the tint you see the board's own pads and holes, where the part is inserted. Designator tags are at least 1.8 mm tall and move below or beside a part when another tag or a pin-1 mark already sits above it, so no tag covers a polarity mark. THT parts are always tagged, because the tag carries the group number.
Pages have no header and keep the top 20 mm free for binder punching: the page title appears only in the title block, in bold black, and sections are not numbered (only the sheet n/N of the step's PDF). Every page carries a compact legend in the bottom-left corner and the Newmatik title block (content, sheet n/N, side / operation, assembly, product, the revision stamp, created / date / approved / date, the Gerbtrace project and variant, and a one-line confidentiality notice). Every page of a step's PDF carries that step's item code (…-S or …-ST); pages that apply to every operation (labels, 3D views, PCB and panel, fiducials) say All operations.
The revision stamp ties the drawing to the exact ERP BOM it was made from, since the ERP BOM has no revision of its own: the ERP BOM name of the step, when that BOM was last changed, and a short hash of its lines (designator, item code and quantity, 12 characters), plus the Document field, the ERP Documents record of the step's drawing with its revision (for example DOC-01982-3). The BOM fields come from the last pull of the step's item from the ERP (BOM › Pull from ERP, or the variant's ERP BOMs); a step whose item was not pulled prints dashes. A BOM pulled before the stamp existed prints its name without a hash until you pull it again. The ERP can recompute the hash from the BOM's items and flag the drawing as outdated when the BOM changes; the algorithm is in ADR-016. The side / operation field comes from the project's assembly processes (paste printing, hand or wave soldering) and can be set per page with operations in the assembly documentation, e.g. BOT · Jetprint, J1 von Hand setzen, Reflow. Parts listed under Arrows in the settings dialog (none by default) get a bold magenta arrow on their SMD or THT page: it shows which side of the part faces the board edge, for example a connector's mating side. Without a set direction the arrow points to the nearest edge of the real board outline, so a part under the notch of an L-shaped board points to the notch, not to the bounding box. A part without a library package is drawn as a box around its own pads on the board (the paste pads, else the copper pads, under its placement that no other part covers; the group nearest to the placement plus the groups that mirror it, such as an IC's opposite row); without pads near the placement it keeps a small placeholder box. Polarity is the whole pin 1 filled solid magenta (the board pad under it plus the footprint lead; a THT annulus keeps its hole open), always on top of the part's translucent magenta frame or THT colour tint. On the THT page the SMD parts are drawn translucent without polarity marks; the label page before assembly and the fiducial page show no components. The 2D views draw the board edge as a thin dark line; silkscreen clear-polarity features (logo counters) are cut out as in the Gerber. The customer is never printed on the drawing. Instruction notes and the label notice sit on a pale background. A note can carry a callout: a numbered disc on the board at the spot it is about, with the same disc in front of the note text. The disc and the outline of the note's parts are orange; pick green or black (a near-black) for a note in the settings dialog so neighbouring notes stand apart. Black replaced purple, which looked like THT group 3 (violet); notes saved as purple print in black. The disc is drawn only on a view of the side it was placed on. A note can also be a text box: its text printed in a white box with a border in the note's colour, right on the board view where you place it (also beside the board), turned 0°, 90° (reads upward), 180° or 270° (reads downward), with no number, disc or arrow and no entry in the notes box. Notes are numbered in list order, text boxes not counted: in the settings dialog the arrows move a note up or down, and Sort by page puts the notes in the order of the drawing's pages (PCB page, SMD TOP, SMD BOT, THT), so the numbers count up through the document. All fixed text is printed in the document's language — German, English or Romanian (language in the assembly documentation); custom text such as notes and descriptions is printed as entered.
Polarity, DNP and THT/SMD come from the pick-and-place settings (parts from a THT pick-and-place file are THT); fiducials are recognised by designator, value or package. Item codes come from the BOM line's itemCode extra field (the Newmatik ERP item), falling back to the BOM description. Part outlines use the package library, so set up packages before exporting.
Preview before export
Export › Preview Assembly Drawing renders the same PDFs and shows them in a dialog, one button per step, without downloading or saving anything. Use it while you are still correcting packages, polarity, labels or notes:
- Refresh renders the drawing again from the current project data.
- Settings… opens Assembly Drawing Settings; Save and preview there saves and comes straight back to the preview.
- Export downloads exactly the PDFs you see and saves them to the Drawings documents, like Export Assembly Drawing.
The Docs tab shows whether a saved drawing still matches the preview and marks it out of date when the drawing data changed since its export. If the Files page is locked, the export stops with an error instead of saving.
Assembly Drawing Settings
Export › Assembly Drawing Settings… edits what the drawing prints beyond the design data, in five tabs:
- Labels – up to ten labels. Each has an item code, an optional name, a size (7 × 7 mm and 30 × 10 mm presets), a stage (before assembly or at final inspection), a target (board, delivery note or packaging) and an optional instruction. For a board label, pick the side and click Place on board, then click the spot on the board preview: the label's centre lands there, in pick-and-place coordinates. For teams connected to the Newmatik ERP, typing two or more characters in Label item searches the ERP's Traceability Labels by item code and name (for example
StandardlistsESO-L00311 · Standard7x7 · 7x7mm); picking one fills the item, name and size. Changing a label's Side turns the board preview to that side. On the Labels tab the preview shows the bare board as its PCB image (copper, pads and legend, no parts), the way the label page prints it; the other tabs show the assembly layout. Text in the red box is the short marking printed inside the label's box on the label page, up to six characters (BCfor a barcode label by default; for exampleSNorQR). - Notes – special instructions. Each note goes on the PCB page (general), the SMD pages or the THT pages, can name designators (outlined on the page) and can get a callout: click Add callout and then the spot on the board. A THT note whose named parts all belong to one THT group takes that group's number and colour for its callout, its disc in the notes box and its part outlines, so it matches the group's row in the THT table; a THT note naming parts of several groups, or none, keeps its own number and colour. Set a note's style to Text box to print its text on the board instead of in the notes box: pick its rotation, click Place text box and then the spot for the box's centre (the preview shows the turned box under the pointer; a box near the edge of the sheet is moved in so it stays on the page). While you place a text box, the preview grows to the whole board view of the note's page (dashed frame), so you can put the box beside a wide or narrow board where the drawing prints it. A text box has no pictures and is drawn on the view of the side it was placed on; the PCB page shows the top side, so place a general text box on TOP. An SMD or THT note needs that step under Title block › Steps. Click Add picture to attach up to four photos or screenshots (PNG or JPEG) to a note, for example how a cable is routed or where tape goes. A note with pictures needs no text; a note with neither text nor pictures is dropped when you save. The drawing prints them on a Pictures for the notes page right after the note's page (on THT pages, a note goes on every page that lists one of the parts it names, and on the first THT page when it names none of them): each picture carries the note's number and text, and the note itself says which pictures belong to it ("→ Picture 1, 2"). Pictures are numbered in page order: each step's drawing starts at Picture 1 and the numbers rise from one pictures page to the next, whatever order the notes were added in. Big photos are scaled down to 1600 pixels on the longest edge when you add them; a document holds up to 24 pictures. Pictures are stored with team projects and copied with Copy as new PCB revision; local projects can't have them.
- Arrows – the parts that get an edge arrow. Type the designators or click Pick parts on the board and click the parts; each arrow points to the nearest board edge (Auto) or in a set direction (left, right, up, down as seen from the top). The preview shows the arrows as they will print.
- Parts – the fitted parts without a library package, each with how it is drawn (outline from its pads, or the small placeholder when no pads were found; dashed blue in the preview), and pin 1 picked on the board. For a part whose package has no pin 1 or the wrong one, add it (the polarized parts without pin 1 are listed for one click), click Pick and click its pin-1 pad: the sheets then fill the pad under that point magenta and frame the part as polarized. A picked pin 1 replaces the library's.
- Title block – assembly code, site, product, steps, language, created by / on, checked by / on, and the document number (ERP Documents record with revision) of each step's drawing. In a team project, checked by / on are not typed: the Approve action in the workflow menu fills them with the approver's initials (set on the profile page) and the approval date, and they stay empty until then. With a variant active they come from the variant's approval, and the document numbers are the variant's own and are saved with the variant. Local projects have no approval, so you type checked by / on there.
The dialog saves only while the project is a draft or in progress and you may edit it. Exporting an approved drawing again needs no reopen (see After the approval above). To change the drawing of an approved project, the approver or a team admin chooses Reopen for revision… in the workflow menu and gives a reason (posted in the conversation): the project goes back to In Progress, its drawing becomes the next revision, and after the changes it is sent for approval again. The next approval files that new revision. With a variant active it edits and saves the base project's settings; the base project needs a complete title block first.
The title-block data, steps, document numbers (documentNumbers), language, labels, notes, edge arrows (edgeArrows), picked pin-1 points (pin1) and the designator choice (designatorTags: auto, on or off) are stored with the project (assemblyDocumentation). The dialog and the MCP tool update_assembly_documentation both write them; without them the drawing uses the project name, German and the steps S (and ST when there are THT parts). Older projects with a single label keep printing it as a board label before assembly.
The MCP tool generate_assembly_documentation renders the same PDFs on the server from the saved project and stores them as Drawings documents (step renders one step's PDF). Without the browser or the server, pnpm run docs:assembly-drawings -- --config <project.json> renders them from a local mirror of the project (see scripts/assembly-drawings.ts).
Export Panel Image
Export the panelized board layout as an image. This requires a panel configuration in the Panel tab.
- Format – PNG or SVG
- Resolution – configurable DPI
- Content – the full panel layout including frame, fiducials, tooling holes, and routing channels
Export Panel Gerber
Download the panel as fabrication data ({name}_PCB-Data-Panel.zip), for example to order panels from the PCB manufacturer. The file name carries the project name only (no tool or supplier name), so name the project with the item code. This requires a panel configuration in the Panel tab and a board outline layer.
The ZIP holds every board layer repeated at each board position of the panel (count X, count Y, gaps and rotation as on the Panel tab), under the original file names. Gerber layers are written as RS-274X and drill files as Excellon, in millimetres with the origin at the bottom-left corner of the panel. Additional fiducials placed in Gerbtrace are included in the copper and solder mask layers of every board, as in Download Gerber.
The panel elements are merged into the board layers they belong to, as a PCB manufacturer expects them:
- the frame fiducials into the top and bottom copper (pad diameter) and solder mask (mask opening) layers;
- the panel label into the top silkscreen;
- on a V-cut-only panel a board outline that is a plain rectangle is left out, because the panel profile is the only contour that is routed. An outline with cut-outs, slots or a shaped contour stays in, repeated on every board, so those contours are still milled, and the export warns you to check it against the V-cuts.
The other elements are files of their own:
| File | Content |
|---|---|
Panel-Outline.gbr | Panel profile: outer contour with the frame's corner radius, as a 0.1 mm line |
Panel-V-Cut.gbr | V-cuts, as 0.1 mm lines (V-cut panels) |
Panel-Millings.gbr | Routing channels and added millings, as lines of the routing tool diameter, interrupted at the tabs (routed panels) |
Panel-Tabs.gbr | Tab contours, as 0.1 mm lines (routed panels) |
Panel-NPTH.drl | Tooling holes and the mouse-bite holes of the tabs, as non-plated Excellon |
When the board has no layer for a panel element (for example no bottom solder mask, or no top silkscreen for the label), that element is written as its own file instead (Panel-Fiducials-BOT-Mask.gbr, Panel-Silkscreen-TOP.gbr, …) and the export warns that it adds a layer to the order. A side without any copper (a single-sided board) gets no frame fiducials. Drill files keep their format: Excellon stays Excellon, and a Gerber-format drill file (such as KiCad's *-NPTH-drl.gbr) stays Gerber with its plated/non-plated file function. Unclassified files are repeated too; one without Gerber or drill content is left out and named in a warning.
The export also warns when the panel label prints differently from the text you typed (capitals only; characters the font lacks are left blank), when it would print over a fiducial opening or a tooling hole, and when a panel set up with the AA-EN-034 preset has grown wider than the preset's maximum (for example because the board outline measures slightly larger than the size the preset was applied for).
The other edge markings the Panel tab draws (reference labels and dimensions) are not exported. With Fill special contours on, the Panel tab mills a ring around each board instead of the straight channels; that ring follows the board outline file and is not repeated in Panel-Millings.gbr, which then holds only the added millings.
Export Panel Image for PCB Specification
Download {name}_Panel-Image-TOP.png, the top view of the panel for the ERP PCB Specification: the boards and the frame in the PCB data colours (solder mask, surface finish, legend), drilled holes dark, frame fiducials and tooling holes, the panel label, V-cuts as red lines, and a thin dark border (3 px, rgb 60,60,60) so the panel edge shows on white paper. It is drawn at 12 px/mm (at most 6000 px on the longest side) from the same data as Export Panel Gerber.
Download Gerber
Download the imported Gerber and drill files as a ZIP package. This re-packages the original files for handover or archival.
Export ERP PCB Specification
Download the board parameters from the PCB tab and the layout from the Panel tab as a JSON file whose field names match the ERP PCB Specification record. The file ends with a validation block listing any fields the ERP side still needs.
Export ERP Assembly Specification
Download the process declaration from the Assembly tab together with the component counts from the Summary tab as a JSON file whose field names match the ERP Assembly Specification record:
- Process checkboxes (wave soldering, hand soldering, coating, X-ray, AOI, test, ...) as the effective values shown in the viewer
- Paste printing technology (stencil or jet print) from the Assembly tab, only while paste printing is on
- Assembly type and SMT / THT assembly sides derived from the component counts, including any count overrides made on the Summary tab
- Coated sides (TOP, BOT or TOP+BOT) while coating is on
- Depanelization and assembly notes
With a variant shown, the file carries that variant's processes and coating (Assembly variants). A gerbtrace block carries the raw declaration so an importer can tell a manual decision from a detected one, the coating material and sides, and for a variant the settings it sets itself; a validation block lists missing fields.
Export PnP
Export Pick and Place data for production.
- Convention – Mycronic, IPC-7351, or IEC 61188-7 rotation convention
- Format – TSV or CSV
- Side – combined, top only, bottom only, or separate files
- Components – SMD, THT, or both
- Fields – select which columns to include
Exported data applies all overrides (rotation corrections, DNP flags, package mappings, assembly types) and converts to the selected convention.
Export DXF
Export Gerber layers as DXF files for import into mechanical CAD tools or EDA software.
- Output – Combined DXF (all selected layers in a single file) or ZIP per layer (one DXF per selected layer in a ZIP archive)
- DXF variant – POLYLINE (R12) is the recommended default for maximum CAD interoperability, while LWPOLYLINE (R2000+) is available for smaller files in newer toolchains
- Layers – select which Gerber layers to include using the checklist, with Select All / None buttons
The summary line at the bottom shows the number of selected layers, the output mode, and the DXF variant. The exporter converts Gerber primitives (arcs, lines, regions, flashes) into DXF entities with layer names matching the source file names.
Export JPSys
Export a JPSys JSON program file for Mycronic jet printers. This requires paste layer data. The export is also accessible from the Jetprint tab.
- Ejector Type – AG04 (Standard) or AR02 (Fine-Pitch)
- Volume % – 90%, 100%, or 130% paste volume
- Program Name – auto-generated from the project name and settings, or enter a custom name
- Machine Type – target machine identifier (default: MY500_S3)
- Stencil Height – virtual stencil height in micrometers (50–300, default: 127)
- Deposit Shrink Factor – ratio to account for paste spread after deposition (0.80–1.00, default: 0.96)
The info box shows the number of paste pads detected and the ejector media type. The exported JSON file follows the JPSys format documented in the Jet Printing reference.