Appearance
Moving nodes
The layout places every node automatically. Arrange lets you move nodes to other cells of the layout grid. A moved node keeps its new cell, and its edges route to it.
Arrange is available in the editor while you hold the write lock, and only while no subprocess is expanded in the preview. It is not available in the trial workspace or on a preview link. Arrange works the same in a left-to-right and a top-to-bottom graph.
Switch to arranging
The mode toggle in the top-right corner of the preview has two icons: a pointer on top for selecting, and a move icon below it for arranging. The active mode is highlighted. Point at either icon to see what its mode does. The preview starts in select mode: a drag pans the view and a click selects one node, highlights the nodes linked to it and opens its discussion. A drag never opens the discussion. Right-click a node to open its discussion or the stylesheet. Choose the move icon to start arranging. Choosing the pointer, or the move icon again, returns to select mode and keeps only the last selected node selected.
Select nodes
While arranging:
- Click a node to select it alone and open its discussion.
- Ctrl+click (Cmd+click on macOS) a node to add it to the selection or remove it.
- Drag across empty canvas, a lane or a pool to draw a selection square. Every node the square touches is selected. Hold Ctrl or Cmd to add them to the current selection.
- Click empty canvas, or press Escape, to clear the selection.
Hold Space and drag, or drag with the middle mouse button, to pan the view. The mouse wheel and trackpad gestures pan and zoom as before.
Move nodes
Drag a selected node to move the whole selection. Dragging an unselected node selects it alone and moves it. A see-through copy of each moving node follows the pointer and snaps to the grid cells. Moments later the preview shows the whole graph as it will look after the drop, with the moving nodes highlighted. With nodes selected, the arrow keys move the selection one cell in the arrow's direction.
- A column is a step along the flow and a row a step across it inside a lane. In a left-to-right graph columns run left to right and rows top to bottom. In a top-to-bottom graph columns run top to bottom and rows left to right.
- Every node moves by the same number of columns and the same number of rows within its own lane.
- A node stays in its lane. A move that would take any node out of its lane outlines the copies in red, and dropping it changes nothing.
- A node can move one row past the last row of its lane, which grows the lane, and any number of columns past the last column along the flow, which grows the grid. An empty column keeps the size of the widest column.
- A node standing on a target cell moves in the direction of the flow, right in a left-to-right graph and down in a top-to-bottom graph, to the first free cell in its row. A see-through copy of it shows that cell before you drop.
The view keeps its zoom and position after a move. People editing the same project see the move as soon as the new layout is rendered. Placements apply in the editor, the preview link, the project thumbnail and every export, and they stay with a node when you switch the flow direction.
Edge ends
An edge leaves one node and enters another on one side of each: top, right, bottom or left. The layout picks the sides. While arranging, you can pin either end of an edge to a side. Only the side changes. The edge stays connected to the same two nodes and routes from the side you chose.
Every selected node shows a handle on each edge end attached to it. A filled handle is a pinned end and a hollow handle an automatic end. An end at a pool port has no handle. Point at a handle to see what it does.
- Drag a handle around its node; it snaps to the nearest side. Moments later the preview shows the whole graph as it will look after the drop: the edge on that side, the other ends of the node moved off it, every edge rerouted.
- Drop the handle to pin the end to that side. Dropping on the side the end already uses changes nothing. Press Escape to cancel the drag.
- Alt+click (Option+click on macOS) a filled handle to return the end to the automatic side.
- With a handle focused, the arrow keys pin the end to that side and Delete returns it to automatic.
- A click on a handle changes nothing.
A pinned side holds as many ends as are pinned to it. The automatic ends of the node move to its other sides. Pins apply in the editor, the preview link, the project thumbnail and every export. A pin stays when a node it belongs to is renamed in the code. A pin for an edge removed from the code stays stored and has no effect. Pins are not available while a subprocess is expanded.
When the code changes
A moved node keeps its cell when you edit the code.
- The position is a stored column and lane row. Adding, removing or reordering other nodes leaves a moved node in that cell while the cell is free. Nodes without a stored position follow the automatic layout.
- Renaming a moved node keeps its position when that edit renames only that one node.
- A moved node removed from the code keeps its stored position, which applies again when the node returns.
- A moved node whose lane changes in the code, or whose cell another node takes, shows at its automatic cell. Its stored position applies again once the lane matches and the cell is free.
- Reset selected node positions, Return to original position and Reset delete stored positions and pinned edge ends.
Undo and redo
Your editor keeps one history for every change: typing, assistant edits, node moves, pins, resets, node colors and stylesheet panel edits.
- Press Ctrl+Z (Cmd+Z on macOS) to undo the latest change, in the code editor or in the preview. Press Ctrl+Shift+Z (Cmd+Shift+Z), or Ctrl+Y, to redo it.
- The toolbar's Undo and Redo buttons act on the same history.
- Undo works while the process pad is closed.
- The history belongs to your editor tab. It starts empty when you open another project, and it empties when you lose the write lock.
Reset positions
The Node positions section of the toolbar's Layout options menu holds the resets:
- Reset selected node positions returns the selected nodes to their automatic cells and the pinned ends at the selected nodes to their automatic sides. It is enabled while a selected node has a stored position or a pinned end.
- Reset returns every node in the project to its automatic cell and every pinned end to its automatic side, after a confirmation.
While arranging, right-click a node and choose Return to original position to return that node to its automatic cell. Right-clicking a selected node acts on the whole selection.