Building Graphs
Add nodes, read and edit node cards, drive settings, wire nodes together, organize the graph with frames and notes, and keep it fast in DASCA's Node mode.
These docs cover Dasca 2.3.
This page covers the everyday work on the graph: adding nodes, reading a card, changing settings, wiring, editing and organizing, and keeping a big graph fast. For a first walkthrough, see Your first graph.
Adding nodes
Open the add menu in any of these ways:
- Press
Tab. The menu opens at the mouse position. - Double-click empty space on the graph.
- Right-click empty space and choose Add node.
- Drag from a socket and release on empty space. The node you pick is wired to that socket. This works from outputs and from inputs.
Type in Search nodes to filter. Enter adds the highlighted node, which is the first match while you type, and Esc closes the menu. The line at the bottom of the menu describes the highlighted node. Without a search, the menu lists:
- Ready-made: finished looks, see Ready-made looks.
- The node categories: Source, Tracking, Color, Filter, Composite, Dither, Elements, GPU Particles, 3D, Behavior, Draw, Value, Sound, Code and Output. See the Node Reference.
- Custom: the custom nodes of this project.
- Library: the custom nodes you saved for all projects.
Search also finds nodes by their old or related names, so media finds File In and filter finds Keep Range.
Where a new node goes
- One node selected: the new node is placed right after it and wired in. Nodes further down the chain move to the right to make room, and the wires that left the selected node now leave the new one. With the Output selected, the new node goes at the end of the chain, just before the Output.
- Nothing selected: the node is placed where you opened the menu. If nothing is wired into the Output yet, the new node is wired to it so you see it right away.
A graph has one Output, so the menu does not offer a second one.
Node cards
Every node is a card. Inputs are on the left edge, outputs on the right. Hover a socket to see its name.
| Part | What it does |
|---|---|
| Title | The node name. A custom node shows its own name. |
| Resolution badge | 1/2, 1/4 or 1/8 when the node is computed at a lower resolution. See Resolution and precision. |
| Snowflake | The node is frozen. See Freeze. |
| Time | How long the node took in the last frame, in milliseconds. Slow nodes are highlighted. |
| Dot | A red dot is an error, a ring is a notice. Hover it to read the message. |
| Edit inside | Custom nodes only. Opens the custom node. |
| Square icon | Show in the viewer. A filled square means the viewer shows this node; click it again to go back to the Output. A number next to it means the node is in a viewer slot. See The Node Viewer. |
| Bypass / Turn on | Turns the node off. A bypassed node passes its input through unchanged; a node without a matching input outputs nothing. |
| Show all settings / Show less | A card shows only its one or two main settings until you open it. Double-clicking the title does the same. |
Below the header, nodes that make or change a picture, elements, particles or a 3D scene show a live preview. Value nodes show a meter or a short list of their current values. The Oscillator, the sound effect nodes, Light, Environment and Camera show a small live drawing of what they do, and Audio shows the waveform of its file.
When a card shows all its settings, secondary inputs (for example the Mask of a filter) also appear as labeled rows. A row says Connected when something is wired in. Right-click a connected row and choose Disconnect to remove its wire.
Settings
Settings work the same way on every card.
| Kind | How to change it |
|---|---|
| Number | Drag across the bar. Hold Shift while dragging for fine steps. Double-click the bar, or press Enter when it has focus, to type a value; the arrow keys step it, and Shift with an arrow takes bigger steps. Some settings accept typed values beyond the bar's range. |
| Color | Click the swatch to open the color picker. |
| Switch | Click to turn it on or off. |
| Menu | Click and choose an option. |
| Text | Type, then press Enter or click elsewhere. Longer texts have a text box. |
| File | Click to choose a file. The bar shows the file name. |
| Palette | Opens the built-in palettes, your own palettes from Effects mode (Your palettes) and Edit colors, where you paste hex colors. |
| Curves | Click to add a point, drag to move it, double-click to remove it. The tabs switch between All, R, G and B. |
Some settings appear only when another setting needs them, for example Key color of Blob Track appears when Track is Color.
A number bar that is driven by a wire shows the incoming value as it changes and cannot be dragged.
The setting menu
Right-click a setting for these commands:
| Command | What it does |
|---|---|
| Reset | Returns the setting to its default. |
| Copy value / Paste value | Copies the value and pastes it into another setting of the same kind. |
| Add keyframe / Remove keyframe | Number and color settings. See Keyframes. |
| Disconnect | Shown when a wire drives the setting. Removes the wire. |
| Drive with | Number settings that can take a wire. Adds the nodes that move the setting, see below. |
Drive with
Drive with wires a moving value into a number setting in one step. The setting then moves between its current value and a quarter of its range above it, or below it when the value is already at the top. You can change the range on the nodes that were added.
| Choice | What it adds |
|---|---|
| Wave | A Wave that rises and falls smoothly. |
| Random | A Random that jumps or drifts. |
| Audio level | An Audio node and a Remap. Choose a sound file on the Audio card. If the graph already has an Audio node with a file, that one is used. |
| Beat | The same as Audio level, but follows the beat. |
| Mouse | A Mouse and a Remap: the setting follows the pointer over the viewer from left to right. |
| Head | A Webcam, a Face Track and a Remap: the setting follows your head from left to right. Existing Webcam and Face Track nodes are reused. |
| Hand | The same with a Hand Track: the setting follows your hand from left to right. |
Editing several nodes at once
Select several nodes of the same type, then hold Alt while you change a setting on one of them. The change applies to all selected nodes of that type, except where that setting is driven by a wire or has keyframes.
Mix and Limit to area
Many image nodes have a Mix setting and a Mask input:
- Mix blends the node's result with its input. At 0 the node has no effect.
- A mask wired into Mask limits the node to the white parts of the mask.
Right-click such a node and choose Limit to area to add a soft white circle (Shape) wired into its Mask. The Shape is selected, so you can move and size the area with its handles in the viewer. Limit to area is available while the Mask input is empty.
Resolution and precision
When a card shows all its settings, image nodes have a Resolution setting at the bottom:
| Option | Size the node is computed at |
|---|---|
| Auto (default) | The size of its largest input, or the canvas size when it has no input. |
| Full | The canvas size. |
| Half, Quarter, Eighth | That part of the canvas size. Faster, and the card shows a badge. |
Many image nodes also have Precision: Auto, 8-bit, 16-bit float or 32-bit float (the last one when your graphics card supports it). Auto keeps the precision of the input. Higher precision helps smooth gradients and color math, at the cost of memory.
Wires
- Drag from an output to an input to connect them. An output can feed many inputs. An input takes one wire, and a new wire replaces the old one.
- Wires connect only sockets whose types fit (see Nodes, wires and types). Wires cannot form a loop; to feed a result back, use Feedback or Previous Frame.
- To move a wire, drag its end to another socket. Drop the end on empty space to remove the wire.
- Click a wire to select it, then press
Delete. - Hold
Yand drag across wires to cut every wire the line crosses. - Double-click a wire to add a reroute dot. Drag the dot to route the wire around other cards. A dot takes the type of the wire through it.
- Drag a node that has no wires onto a wire and release it there to insert it into that wire. The wire highlights when the node fits.
- Hold
Altand drag a wired node to pull it out of its chain. The nodes before and after it are wired together. Right-click and Detach does the same without moving it.
Previous Frame reads the node chosen in its Source setting instead of a wired input. The graph shows that link as a dashed wire.
Selecting and editing
- Click a card to select it.
Ctrl+clickadds a card to the selection or removes it, andShift+drag on empty space selects with a box. Ctrl+Aselects all nodes, frames and notes.DeleteorBackspaceremoves the selection.Ctrl+Ccopies andCtrl+Vpastes at the mouse position.Ctrl+Dduplicates. Keyframes travel with copied nodes, and a copied frame takes its contents with it.Bbypasses the selected nodes or turns them on again.Hcollapses or expands them.Ctrl+Zundoes andCtrl+Y(orCtrl+Shift+Z) redoes. Undo and Redo in the app menu work in Node mode too.Ffits the selection in view, or the whole graph when nothing is selected.
The node menu
Right-click a node for these commands. Most of them act on all selected nodes.
| Command | What it does |
|---|---|
| Edit inside | Custom nodes. Opens the custom node. |
| Save to library / Update in library | Custom nodes. See The library. |
| Bypass / Turn on | Turns the nodes off or on. |
| Freeze / Unfreeze | See Freeze. |
| Hide preview / Show preview | Hides the card preview. A thin strip stays; click it to show the preview again. A hidden preview is not computed. |
| Collapse / Expand | Shrinks the card to its title and sockets. Double-click the title to expand it. |
| Show full data | Opens a window with the live values and element lists of the node. See Show full data. |
| Detach | Takes the node out of its chain and wires its neighbors together. |
| Duplicate | Copies the nodes next to the originals. |
| Variations | Shows variations of the nodes. See Variations. |
| Limit to area | Nodes with an empty Mask input. See Mix and Limit to area. |
| Copy | Copies the nodes. |
| Frame selection | Puts the nodes in a frame. |
| Align | Align and distribute buttons, shown when two or more items are selected. |
| Make custom node | Packs the nodes into one custom node. See Custom Nodes. |
| Replace with | Swaps the node for another type. Wires that still fit are kept. |
| Delete | Removes the nodes. |
Right-click empty space for Add node, Paste, Add frame, Add note and Learn Nodes.
Frames and notes
Frames and notes keep a big graph readable. Both are saved with the graph, also inside custom nodes.
Frames group cards under a title:
- Select cards and press
Ctrl+J(or right-click and choose Frame selection) to put them in a frame. Or right-click empty space and choose Add frame. - Drag a frame by its title bar to move it with everything inside. Hold
Altwhile you start the drag to move the frame alone. - Drag the frame's edges to resize it. A card belongs to a frame when its center is inside.
- Double-click the title to rename it. Right-click the frame for Rename and Color.
- Deleting a frame keeps the cards that were inside it.
Notes are short texts on the graph:
- Right-click empty space and choose Add note, then type. Click elsewhere, or press
EscorCtrl+Enter, to finish. An empty note is not kept. - Double-click a note to edit it. Drag its right edge to change its width. Right-click it for Edit and Color.
Frames and notes come in Gray, Red, Orange, Yellow, Green, Teal, Blue and Purple.
Align and distribute
Select two or more cards, frames or notes and right-click one of them. The Align row has Align left, Align center, Align right, Align top, Align middle and Align bottom. With three or more items, Distribute horizontally and Distribute vertically space them evenly. A frame moves together with its contents.
Find
Press Ctrl+F to find nodes, frames and notes by name, in the whole project, including inside custom nodes. Use the arrow keys and Enter, or click a result, to jump to it. The graph opens the right custom node, selects the result and brings it into view. Esc closes the search.
Performance
The performance view
Click the gauge button in the timeline dock, or press Shift+P, to measure the graph. A Performance panel appears on the graph:
| Row | What it shows |
|---|---|
| Engine | The graphics engine, for example Native DX12 or Native Metal. |
| Frame | How long a whole frame takes. |
| Rate | Frames per second while playing, or Paused. |
| Memory | The graphics memory the graph's results use, out of its budget. |
| Computed | How many nodes are computed per frame. |
The panel says whether it measures GPU time or CPU time. Each card then also shows its own time and a bar with its share of the frame; the bar turns warmer for nodes that take a large share. Press play or change a setting to start measuring.
Ways to keep a graph fast
- Lower Resolution on heavy nodes whose detail you do not need (see Resolution and precision).
- Lower the Editing resolution while you work. Export always uses full resolution. See Canvas size.
- Set Card previews while playing to Every 4th (the default) or Off. See Canvas size.
- Hide the previews of cards you do not need to watch, or collapse them.
- Freeze nodes that do not need to change.
Freeze
Freezing keeps a node's result as it is at the current moment, so the node and everything before it stop being computed for it. Select nodes and press Ctrl+Shift+F, or right-click and choose Freeze.
- A frozen card shows a snowflake, and its settings are locked. Its tooltip shows the time it was frozen at.
- Unfreeze it the same way to make changes.
- Freezing is for working live only. Export computes frozen nodes normally, and the export dialog says how many there are.
- The frozen state is saved with the project, and the result is computed again when you open it.
Show full data
Right-click a node and choose Show full data to open a floating window with everything the node outputs, live:
- Values: each value output with its number and a short trace of its recent past.
- Element outputs: the number of elements and a list of the named ones, such as tracked points, with their positions. Hover a row to highlight that element in the viewer.
- Outputs: the other outputs of the node.
Drag the window's corner to resize it.