Docs menu · Interface tour

Documentation

Interface tour

The window

Tessera window: top bar, viewport on the left, node graph in the middle, parameters on the right, AI panel at the bottom
Viewport (left), node graph (middle), Parameters (right), AI / Python / Log dock (bottom).

The Tessera window has five areas: the top bar, the viewport, the node graph, the dock with the AI, Python and Log tabs, and the right panel with Parameters, Geometry and Spreadsheet.

Top bar

New / Open / Save
New starts a new, empty project tab. Open opens a bundled example or a .tsr file by path, in its own tab. Save (Ctrl+S) writes the project to its current .tsr file (asking for a name the first time); Save As is Ctrl+Shift+S. A bare name is saved to %USERPROFILE%\Tessera\scenes.
Undo / Redo arrows
Step back and forward through the project’s history. See Undo & redo.
Project tabs
One tab per project. + adds a project, double-click renames, × closes. See Projects & graphs.
Timeline
First frame, previous frame, play / pause, next frame, a frame slider and the current frame, the frame range (start and end) and frames per second. Simulations and time-dependent nodes cook at the current frame.
Unreal
Opens the Unreal link panel; its dot turns on when an editor is connected. See Unreal live link.
Engine dot
Green: engine connected. Pulsing amber: cooking. Red: connection lost.
?
Keyboard shortcut overview (also ?).
☰
Shows or hides the right panel (useful in narrow windows).

Viewport

The 3D view of the current graph’s display node. Its toolbar has Shaded (cycles shaded / wire on shaded / wireframe), Points (P), Grid (G) and Frame (F). The heads-up display in the corner shows the node path, frame, point / primitive / triangle counts, volumes and the cook time. A progress bar appears during long cooks. See Viewport for navigation.

Node graph pane

The header holds the graph tabs (one per graph in the project, plus + and ⊕ Combine), the path of the current graph, and three buttons: + Node (opens the node menu, same as Tab), Layout (L) and Home (H, frame the network). Nodes are coloured by category, show their cook time, a SIM badge for simulations, and the comment under them. See Node graph.

AI, Python and Log dock

AI
The conversation with the AI: its plan, its messages and a chip for every tool call (add nodes, render, check layout…). Below: the prompt box (Enter sends, Shift+Enter for a new line), Send, Stop, New chat, the provider menu and the model menu. See Using the AI.
Python
Runs Python inside the engine with scene, tessera, np, Geometry, ops(), add(), cook() and render() ready. Run or Ctrl+Enter. The value of the last expression (or a variable named result) is shown with anything printed. See Python & HTTP API.
Log
Every graph op, engine event and log message, with filters (ops, events, log) and Clear. A badge on the tab counts new messages.
Parameters
For the selected node: its name (edit to rename), type chip, Display and Bypass flags, Reset sim for simulations, cook time, errors and warnings in red / yellow, the node’s documentation (click to expand), every parameter, and a Comment box whose text appears under the node. See Parameters.
Geometry
A summary of the selected node’s output: counts, bounding box and size, attributes by owner, groups and volumes.
Spreadsheet
Attribute values row by row, for Points, Primitives, Vertices or Detail, paged with the arrows. Groups show as grp:name columns.

Menus and dialogs

  • Node menu: right-click empty graph space, Tab or + Node. Categories, nodes and docs side by side; type to search, arrow keys to move, Enter to add, Esc to close.
  • Unreal panel: detected editors, node and asset name, Send to Unreal, Live link, Refresh, and the result of the last send.
  • Shortcut help: ?. Esc closes it.

Resizing panels

Drag the splitters between viewport and graph, between the upper area and the dock, and in front of the right panel. In narrow windows the right panel becomes a drawer you open with ☰ and close with × or Esc.