Skip to navigation

ZofzPCB 3D Gerber Viewer ZofzPCB:
Frequently Asked Questions

  1. How to export IPC-356 File?
    1. Warning: Component Reference text length
    2. Eagle
    3. KiCad
    4. Protel99se
    5. Altium
    6. CirCAD
  2. How to load Gerber files set, using Auto files assignment
  3. What are .camset and .zofzproj files?
  4. Missing tracks, transparent PCB volume, missing PCB outline
  5. Why rendering sometimes takes so long?
  6. Why am I not allowing to overwrite component selection, even if the models are there?
  7. Why a non-standard Windows GUI?
  8. How to load the license key

How to export IPC-356 File?

Warning: Component Reference text length

Eagle Warning box

The IPC-356 allows for reference text length up to 6 characters. For example, the reference text "BTN_DOWN" is truncated to "BTN_DN". (Eagle could have been allowing for one more character, btw.) Pay attention that the truncated names are not overlapping after all truncations.

Truncated components' references will not match respective references in the BOM file, making it challenging to auto-detect the BOM columns.

Very oddly, the IPC-356 format is a fixed-width format. Therefore, there is a possibility of a net name aliasing by IPC-356 specification. The original name is renamed to a short alias, used within IPC-356. There is no such option for the component reference, however.
I have found out that some other ecad programs do not bother and export longer designators without warning. That approach is readable, under the condition that the reference name does not contain a minus sign, as the format forces "-" after the reference field. This approach might be problematic to some parsers, however. Another solution would be not allowing for component designator lengths above 6 characters already on the input (schematic) side.
The IPC-356 expects designators to be like "SW1", see Wikipedia
And sticking to the familiar names makes it easier for ZofzPCB to assign more accurate component models.

  1. How to export IPC-356 File from Eagle?

    Drop Down Menu: File / Export / IPC
    See the following Eagle UI screenshot: Eagle Menu
  2. How to export IPC-356 File from Kicad?

    Drop Down Menu: File / Fabrication Outputs / IPC-D-365 Netlist File...
    See the following KiCad UI screenshot: KiCad Menu
  3. How to export IPC-356 File from Protel99se?

    1. Drop Down Menu: Tools / CAM Wizard...
    2. In Output Wizard: Select "Test Points", click "Next"
    3. In Output Wizard: Select "IPC-D-365A", deselect all other, if you do not need it, click "Next"
    See the following Protel99se UI screenshot: Protel Menu
  4. How to export IPC-356 File from CirCAD?

    Original exported IPC-356 file is missing holes/pads having no assigned net-name or pin-name.
    Please use provided command-line tool to extract the IPC-356 file directly from the CirCAD PCB file.


    CirCAD2ipc test.pcb

    The program creates test.ipc file, possibly overwriting any existing file!
    For additional security, please check the downloaded file signature.

    Download CirCAD2ipc.exe

How to load Gerber files set, using Auto files assignment

As I have some feedback about problems reading Eagle Gerbers, I have installed Eagle 9.4.2 free version.
I took an Open Hardware project: hackaday/BoborBuino
There is my walk-through.

  1. I started by exporting the CAM files. The Gerber export results are saved in multiple directories, named: Assembly DrillFiles, GerberFiles.
    This is not standard, and it is not compatible with ZofzPCB Auto-Detection. No problem to move the files to a single directory, though.
  2. Automatic recognition composition of files: "drill_1_16.xln" was not recognized as a drill file. - I have fixed the "CAM_Load_Rules.txt" mask file immediately. (available by next release)
  3. Now press the [Auto Load] button.

    ZofzPCB Auto Recognition dialog-box
  4. Now press the [OK: Read & Render] button.

    ZofzPCB Stackup dialog-box

  5. Board outline:
    The board outline is in a separate file - good.
    ZofzPCB does not read it correctly, missing the PCB milling division of the 2 boards (top/bottom). What is so complicated in the board outline?
    What we need is a clear cut line, as it would guide the tool.
    I have checked the drawing in a 2D Gerber viewer (gerbv). The viewer is just displaying the line drawing instead of attempting to convert it to a "solid" polygon, of course.

    Looks like there is more then a full circle here

    I have removed those overlapping arcs, forming the circles (holes), knowing that they are repeated as drills.
    Obviously, my algorithm could not convert the overlapped arcs to single circles and quit before finishing the whole drawing. (edit: Version 2.0 features a better algorithm.)
    I could smell the problem by seeing the Gerber file size of the outline being 111KB vs e.g. copper-top 40KB. I know it will be difficult for me.
    Indeed, there is much more information in the copper layer than in the board outline, but the file size says the opposite.
    Anyway, I consider it as a zofzpcb bug. (Edit: Fixed)
    Another point - the standard size of a cut-out milling tool is 2.5 mm in diameter. Possibly this can be changed, but not to zero, to accomplish a rectangular cut-out. Inner cut-outs will be quietly adjusted - to having a specific radius "stadium" curve.
    This is not critical, but it will be edited by the cam operator the way he wishes.
  6. I have repeated the above steps. I was lucky - my guess was correct.
  7. Rendering
    The silkscreen renders for hours! It is a ZofzPCB old bug. (edit: Version 2.0 features a better algorithm.)
    Again - the silkscreen_top is 220KB (vs. copper-top 40KB.) I am giving it another try - this time using the Imperial scale. Magically it takes only one second to render. And the size of all imperial Gerbers is about half the size of their metrics versions. Why?

    ZofzPCB rendered PCB and netlist check result

  8. IPC netlist vs. Copper netlist errors:
    as the above error dialog shows, there is one short connection.
    Looking closer using menu Netlist / Errors

    ZofzPCB Netlist Errors dialog-box

    It seems that the ring around the speaker holes was added without an accompanying schematic entry or so. This kind of problem is cosmetic.
  9. I have the components display:

    ZofzPCB PCB View

    There are some differences between what ZofzPCB have shown and what the project's photos show. Some problems are the lack of proper models, some other (adjustable), - wrong detection, primarily because of non-standard reference naming. Right-click model menu lets resolve some of the problems, either by removing the component or selecting a different model, or changing some parameter's value.

    ZofzPCB PCB View - right click menu / model

  10. The final view - do not forget to save the .camset file and/or the rendered board mesh data.

    ZofzPCB PCB Final View

Check out the rendered project on The Project Gallery

What are .camset and .zofzproj files?


Preparing Gerber files set for display in ZofzPCB requires some work. The .camset file contains all the configurations created in the setup process so that you can read the Gerber files quickly for a second time. Example: after applying changes in the ECAD program and regenerating the Gerber files. If you open the saved .camset file, ZofzPCB will also read all the CAM files and render (flatten) the PCB model again.

  1. Stackup and list of all layers. For each layer:
    1. File Name
    2. Type - e.g., copper, silkscreen, core, etc
    3. Thickness, etc
  2. The board outline is a part of the stackup list. The thickness of the board outline is the thickness of the whole PCB
  3. List of drill files. For each drill file:
    1. File Name
    2. Span (thru, or from-to copper numbers)
    3. Platting type, micro-via options
  4. IPC-356 and BOM file names
  5. List of user defined layer types, like glue, gold or carbon
  6. Settings of Gerber and drill file parser, for older on incomplete headers, missing information like polarity
  7. Color settings:
    1. For each layer in the stackup
    2. For each layer type
    3. Netlist color schema
    4. Netlist color exceptions (manual adjustments)
    5. Color mixer settings
  8. Components:
    1. Result of automatic and manual component model selection, model parameters
    2. Body Builder model data
  9. Saved camera positions 0..9


The file contains all internal data structures the program needed to display and browse the PCBA. The file also includes all the information the .camset file contains. Reading the .zofzproj file leads to a direct display of the PCBA model without the flattening and triangulation phase. Gerber and other CAM files are no longer needed.

  1. The file is compressed and encrypted
  2. The "Read Only" option:
    1. The file contains encrypted access flags and may miss specific information
    2. PCBA model is displayed in premium mode by a software/user without the premium license
    3. You need the premium license to create the "Read Only" file

Missing tracks, transparent PCB volume, missing PCB outline

Sometimes PCB renders in a wired way, strange gradient effects appear, PCB volume is transparent, tracks are partially missing.
Those are typical symptoms of the misinterpreted board outline.

The Gerber primary data are often accompanied by text, symbols, frames e.t.c. not representing the PCB structures but carrying descriptions targeting the manufacturer.
These parts of the image must be removed before a 3D model of the board is created. Typically ZofzPCB uses the Board Outline drawing to decide what regions of the image must be preserved and what regions are to be removed. If the detection of the board outline fails, yielding e.g. a small object placed inside (or worst) outside the board, those strange artifacts may be present.

Please check the following:

  • The Board Outline Layer must be present in the stackup if the file is available.
  • ZofzPCB can extract the outline drawing from a copper or silkscreen, if it is distinguishable from other elements, by a track thickness below some threshold. All other track objects must have their thickness value above the threshold. See "Meta Drawing" settings.
  • The board outline drawing must be made out of continuously overlapping tracks segments (straight or arcs).
  • As the description text characters may also form closed-loop track areas, please select a way to identify the outline in "How To Identify" settings.

Why rendering sometimes takes so long?

yes. why it is still not done!?
(Update:) Just working on it...
Version 2.0 have a much faster rendering

Why am I not allowed to overwrite component selection, even if the models are there?

Unlike in other 3D software, the models are created out of footprints. There must be a particular configuration of pads/holes for the generator to fit the model. Pads and footprints must always match. You never had to adjust the 3D model rotation and position or the distance of the el-cap pin, right?

  1. SMD shunt resistor
    A resistor may look the same, but there are 4 pads on the PCB. There are 2 pads for each terminal, avoiding a voltage drop on the high current solder junction. The algorithm searches to fit a 4 pad device in this place. There would have to be some arrangement to tell the program to ignore the specific 2 pads.
  2. Metal Can OSC
    The footprint is constructed to accommodate 2 types of the package: long (like DIP14) and short (like DIP8). This dual function is not visible in the IPC-356 file. The algorithm constructs a strange 6-pin device.
  3. 3-pin SMD diode
    Diode uses only 2 pins; the not-connected pin is not exported in the IPC-356 file. The algorithm fits a 2-pin diode instead. This usually can be corrected by the settings - something like "export all".

A solution for this would be a kind of IPC-356 graphical editor, allowing for removing pads/holes or adding from the drills or copper/solder-mask pads.

Some decisions are permanent in the component selection tree (e.g. this is a 2 pin device), and some are guesses (e.g. this is a resistor).
It is possible to overwrite any guess.

Why a non-standard Windows GUI?

Version 2.0 Suports Windows GUI

I had started the project in ancient times when the Direct3D-capable graphic card was not a piece of standard equipment. Even if the graphic card was compatible with Direct3D 9.0, it was not necessarily powerful. The typical implementation was also not working well when combining 2D and 3D subsystems - windowed mode. The 3D content typically had frame sync problems, leading to jerky animation or a split image.

The program was supposed to be used mainly in a full-screen mode, with the 2D/GDI system switched off. It is just like most of the games are constructed. And, like I just said, the GDI (windows graphic) is not available in this mode. I remember my long hesitation and making this not very popular decision. Now, it would be possible to rewrite, but there is always something more important to do. Bad side: we are missing the drag-and-drop interface and the great windows file explorer functionality. Also, some people are confused with any non-standard-looking GUI - I am sorry for this. But, on the other side, some users, including me, like it.

How to load the license key

  1. ZofzPCB license dialogs

    Program without the component generator license will nag you, but it will not limit any 3D Gerber functionality except the components view and View-Only saving possibility. You can switch off the nagging if you select Components / Model Generator / Extruded (Free)

  2. ZofzPCB license dialogs

    The license changes the "Extruded" components view....

  3. ZofzPCB license dialogs

    ... to the "Parametric" component view.

  4. ZofzPCB license dialogs

    When you have the license key, please start the "License Key" dialog box, via menu: Components / Enter License Key.

  5. ZofzPCB license dialogs

    Please paste the complete license key text into the edit box, by clicking inside the box (cursor should blink there) and pressing the Ctrl-V keys on the keyboard.

  6. ZofzPCB license dialogs

    The text of the License Key should appear in the edit window. The text is blurred on the picture, to keep it secret. But in the real life it is just a normal text, ending with an equal sign. Note that you should preserve the upper and lower case.

  7. ZofzPCB license dialogs

    After pasting the key text (1), please check the validity of the key by pressing the [Load License Key] button (2). The info text (3) should reflect your key type and date of validity.
    Now, you can close the dialog, pressing the (X) in the corner (4).
  8. Note that the key text is written to the registry on the program exit. If, by chance, the program is closed incorrectly, the key might not have been saved, and you may need to repeat the copy-paste procedure.