Get Dasca

Docs

Learn Dasca, from your first project to node graphs.

Node / Building Graphs

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.

Note

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.

PartWhat it does
TitleThe node name. A custom node shows its own name.
Resolution badge1/2, 1/4 or 1/8 when the node is computed at a lower resolution. See Resolution and precision.
SnowflakeThe node is frozen. See Freeze.
TimeHow long the node took in the last frame, in milliseconds. Slow nodes are highlighted.
DotA red dot is an error, a ring is a notice. Hover it to read the message.
Edit insideCustom nodes only. Opens the custom node.
Square iconShow 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 onTurns the node off. A bypassed node passes its input through unchanged; a node without a matching input outputs nothing.
Show all settings / Show lessA 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.

KindHow to change it
NumberDrag 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.
ColorClick the swatch to open the color picker.
SwitchClick to turn it on or off.
MenuClick and choose an option.
TextType, then press Enter or click elsewhere. Longer texts have a text box.
FileClick to choose a file. The bar shows the file name.
PaletteOpens the built-in palettes, your own palettes from Effects mode (Your palettes) and Edit colors, where you paste hex colors.
CurvesClick 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:

CommandWhat it does
ResetReturns the setting to its default.
Copy value / Paste valueCopies the value and pastes it into another setting of the same kind.
Add keyframe / Remove keyframeNumber and color settings. See Keyframes.
DisconnectShown when a wire drives the setting. Removes the wire.
Drive withNumber 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.

ChoiceWhat it adds
WaveA Wave that rises and falls smoothly.
RandomA Random that jumps or drifts.
Audio levelAn 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.
BeatThe same as Audio level, but follows the beat.
MouseA Mouse and a Remap: the setting follows the pointer over the viewer from left to right.
HeadA Webcam, a Face Track and a Remap: the setting follows your head from left to right. Existing Webcam and Face Track nodes are reused.
HandThe 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:

OptionSize the node is computed at
Auto (default)The size of its largest input, or the canvas size when it has no input.
FullThe canvas size.
Half, Quarter, EighthThat 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 Y and 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 Alt and 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+click adds a card to the selection or removes it, and Shift+drag on empty space selects with a box.
  • Ctrl+A selects all nodes, frames and notes.
  • Delete or Backspace removes the selection.
  • Ctrl+C copies and Ctrl+V pastes at the mouse position. Ctrl+D duplicates. Keyframes travel with copied nodes, and a copied frame takes its contents with it.
  • B bypasses the selected nodes or turns them on again. H collapses or expands them.
  • Ctrl+Z undoes and Ctrl+Y (or Ctrl+Shift+Z) redoes. Undo and Redo in the app menu work in Node mode too.
  • F fits 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.

CommandWhat it does
Edit insideCustom nodes. Opens the custom node.
Save to library / Update in libraryCustom nodes. See The library.
Bypass / Turn onTurns the nodes off or on.
Freeze / UnfreezeSee Freeze.
Hide preview / Show previewHides the card preview. A thin strip stays; click it to show the preview again. A hidden preview is not computed.
Collapse / ExpandShrinks the card to its title and sockets. Double-click the title to expand it.
Show full dataOpens a window with the live values and element lists of the node. See Show full data.
DetachTakes the node out of its chain and wires its neighbors together.
DuplicateCopies the nodes next to the originals.
VariationsShows variations of the nodes. See Variations.
Limit to areaNodes with an empty Mask input. See Mix and Limit to area.
CopyCopies the nodes.
Frame selectionPuts the nodes in a frame.
AlignAlign and distribute buttons, shown when two or more items are selected.
Make custom nodePacks the nodes into one custom node. See Custom Nodes.
Replace withSwaps the node for another type. Wires that still fit are kept.
DeleteRemoves 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 Alt while 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 Esc or Ctrl+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:

RowWhat it shows
EngineThe graphics engine, for example Native DX12 or Native Metal.
FrameHow long a whole frame takes.
RateFrames per second while playing, or Paused.
MemoryThe graphics memory the graph's results use, out of its budget.
ComputedHow 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.