Troubleshooting

What to do when a surface isn't patterned, a file won't open, or the result looks wrong.

First step. Choose Show diagnostic log in the file menu. The engine logs every top-surface block it rewrote or kept, and why.

A surface isn’t patterned

  • You left it as sliced. Click it on the model in the Pattern step, or click Pattern all under Surfaces.
  • It’s above the height limit. Check Only up to height under Surfaces.
  • It’s too small. Areas under the smallest area to pattern (20 mm²) are left as sliced. Lower it in Print settings.
  • It’s very steep or narrow (thin ribs). These fall back to the sliced lines or get only a few.
  • The engine kept it on purpose. If anything looks wrong in a block (a layer change inside it, a failed coverage check), TessaFab keeps the original and logs why. The log names the block.
  • The free edition patterns one chosen piece. Choose it in Assemble, or start the trial.

The pattern is flat or hard to see

  • Ironing is on. Turn it off in the slicer and slice again: ironing flattens the pattern.
  • Line directions are too similar. Under Adjust, turn the tile groups’ dials further apart (90° shows best).
  • Tiles are too small. Tiles narrower than about 1 mm after grout get few or no lines. Raise the tile size, or scale the pattern up under Placement.
  • Try depth or colours. A deeper pattern or raised tiles (Pro), or tile groups in different filaments.

Seams show between pieces

The walls of two pieces still show as a line at each seam: that’s the pieces’ own edges, not the pattern. The pattern itself carries on across; check it in Preview’s Assembled view.

A file won’t open

  • TessaFab opens sliced files: .gcode.3mf (Bambu Studio, OrcaSlicer), .gcode and .bgcode (PrusaSlicer, OrcaSlicer). A plain .3mf or .stl isn’t sliced yet: slice it and export the sliced file (how).
  • The command line takes one plate’s .gcode or .bgcode, not a .3mf.

A piece is in the wrong place after re-slicing

Pieces are found again by their shape. Identical pieces that all moved can’t be told apart: the pieces list marks them Needs attention. Place them again by hand. See Projects and re-slicing.

A turned piece doesn’t fit its layout outline

Layout import lines up a piece’s long outer edges with the outline’s. A piece with no clear edges (a disc with a small notch, say) printed turned may need turning by hand in Assemble.

Lines near walls

Lines that run parallel to a wall can leave a gap of up to one line width next to it. The rim hides most of this; add a loop to Rim along edges if you see it.

Travel marks

Travel moves between lines don’t avoid crossing walls. Long ones retract and Z-hop; raise Z-hop in Print settings if they mark the surface.

The slicer’s preview doesn’t show the pattern

With the slicer hook, the slicer shows its toolpaths from before the hook runs. The file it writes has the pattern. Check it in the app’s Preview, or open the exported file in the slicer.

Still stuck?

Email [email protected] with the diagnostic log, or open an issue on GitHub.