Project files

The .tessafab.json format the app saves and the command line applies.

A project is a JSON file, <name>.tessafab.json, saved by the app. You rarely need to edit one by hand, but the format is open, so scripts and other tools can read and write projects. This is schema version 3; older projects are read and upgraded.

Paths inside a project are relative to the project file’s folder.

{
  "schemaVersion": 3,
  "source": {
    "kind": "sliced",
    "inputs": [{ "path": "tiles.gcode.3mf" }],
    "surfaces": { "faces": ["top"], "maxZ": null, "excluded": [] }
  },
  "assembly": {
    "placements": [
      { "input": 0, "plate": 1, "piece": 1,
        "outline": [[0, 0], [60, 0], [60, 60], [0, 60]],
        "rotation": 90, "position": [30, 30] }
    ],
    "layoutSvg": null,
    "assign": {}
  },
  "pattern": { "id": "honeycomb", "values": { "side": 6.0, "grout": 0.6 } },
  "preset": "default",
  "patternPlacement": { "origin": null, "rotation": null, "scale": 1.0 },
  "grout": null,
  "tileDirections": {},
  "patternSettings": {},
  "targets": {
    "gcode": {
      "colour": { "mode": "single", "depth": 2, "bottomDepth": 1, "filaments": {} },
      "settings": {},
      "relief": { "groutDepth": 1, "raise": {} }
    }
  }
}

source

Where the pieces come from. Today only sliced G-code ("kind": "sliced").

Key Meaning
inputs The sliced files, [{ "path": … }], in order. Placements refer to them by index.
surfaces.faces ["top"], ["bottom"] or ["top", "bottom"].
surfaces.maxZ Leave surfaces above this height (mm) as sliced. null: no limit.
surfaces.excluded Surfaces left as sliced, by id.

assembly

Key Meaning
placements One per placed piece: input (file index), plate, piece (its number on the plate), its outline in mm, and where it goes: rotation (degrees) and position (mm). Pieces are never mirrored.
layoutSvg Older projects: a layout SVG the pieces are slid onto, instead of placements.
assign Which identical piece goes to which place, when it was chosen by hand.

pattern and placement

Key Meaning
pattern A provided or user pattern, { "id", "values" }; a pattern drawing, { "file": "path.svg" }; or an image, { "image": "path.png", "values": {…} } (Pro).
preset Which preset the values came from (for the app only).
patternPlacement.origin Shift, [x, y] mm. null: centred, or at the line-up point.
patternPlacement.rotation Turn in degrees. null: the pattern’s own.
patternPlacement.scale Scale, 1.0 = as drawn.
patternPlacement.mode Optional: "each" (the pattern on each piece) or "vary" (varied), with a seed. Absent: across the assembly.
patternPlacement.repeat, align "repeat": false places one copy, lined up at align: "center", "top-left", "top", … "bottom-right".
grout A grout width (mm) for this project instead of the pattern’s. null: the pattern’s.
tileDirections Line direction per tile group (keyed by the group’s colour): degrees, or "rings".
patternSettings How a pattern drawing is read: svgDefaultAngle, svgPaths, svgSkipUnmatched.

targets.gcode

The G-code target’s own settings.

Key Meaning
colour.mode "single", "ams" or "manual" (swap by hand).
colour.depth Layers from the top printed in the tile groups’ filaments.
colour.bottomDepth The same for the bottom, counting up from the plate.
colour.filaments Filament number per tile group, e.g. { "#d8b07a": 1, "#9c6a3c": 2 }.
relief.groutDepth The app’s Pattern depth: layers the pattern goes into, counting the surface (1: the surface only). Under the top with its grout; over a patterned bottom without. Pro.
relief.raise Layers each tile group is raised above the top, e.g. { "#9c6a3c": 2 }. Pro.
settings Print settings: edgeRim, holeRim, minArea, flow, printSpeed, travelSpeed, retract, retractSpeed, retractThreshold, zhop, and a few more for special cases (border, close, wallOverlap, minCoverage, lineWidth, layerHeight, noMerge). Absent keys use the slicer’s value or the default.

A layered SVG export keeps its settings under targets.svg (lineSpacing, split). Targets a version of TessaFab doesn’t know are kept as they are, so a project from a newer TessaFab keeps them when saved.

The full reference is at the top of crates/engine/src/project.rs.