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.