Node
Build live visuals in DASCA's Node mode by wiring nodes on a graph. Start here, learn the workspace and build your first graph.
These docs cover Dasca 2.3.
Node mode is a graph editor for live visuals. Every node is a card with a live preview and its main settings. You wire nodes together, and the viewer shows the result at full size while you work. You can start from a photo or a video, from a live camera, or from nothing at all.
Node is under active development. The bug button next to the mode tabs opens Report a Bug (see Report a bug).
On macOS, use Cmd where these pages say Ctrl and Option where they say Alt (see Shortcuts and Navigation).
What you can build
| You want to | Start with | See |
|---|---|---|
| Restyle a photo or video | File In, then color, filter, dither and composite nodes | Building Graphs |
| Make a picture from nothing | Noise, Gradient, Pattern, Shape, Text or Shader | Node Reference |
| Turn a picture into dots, lines or letters | Points, Grid or Contours, then a Draw node | Elements |
| Simulate a million particles | Swarm and Draw Swarm | GPU particles |
| Build and light a 3D scene | Shape 3D or Model 3D, then Render 3D | 3D Scenes |
| Move things with time, music or MIDI | Wave, Audio, Tempo, MIDI File | Animation and Values |
| Draw with sound on an oscilloscope | Oscillator, Path to Sound, Oscilloscope | Sound and Oscilloscope |
| React to a camera, your hands or a live feed | Webcam, Hand Track, Microphone, MIDI In, NDI In | Live Input and Output |
| Write your own node | Shader or Surface Shader | Code Nodes |
| Reuse part of a graph | A custom node, or a ready-made look | Custom Nodes and Ready-made Looks |
Before you start
- Click Node in the mode tabs at the top left of the canvas. To open DASCA in Node mode every time, set Start Mode to Node in Preferences > General.
- Node draws with its own graphics engine on your graphics card: DirectX 12 on Windows and Metal on macOS. If the engine cannot start, Node shows Node is not available on this computer instead of the graph. Updating the graphics drivers usually fixes this. Effects, Kinetic and Code work as usual either way.
- Your graph is saved inside your project file. See Saving and projects.
Learn Nodes
Learn Nodes is a set of short, hands-on lessons inside the app. Open it with the question mark button next to the mode tabs, or right-click empty space on the graph and choose Learn Nodes. It also opens by itself the first time you use Node mode.
The lessons are grouped by level:
| Level | Lessons |
|---|---|
| Start here | Tour: what every button on the viewer does. |
| Easy | Build your first graph, Ready-made looks, Handles, Color and tone, Mix two pictures, Make it move, Export |
| Medium | From nothing, Feedback, Elements, Keep it tidy, Move to music, Live input |
| Advanced | First 3D scene, 3D from a picture, Oscilloscope, GPU particles, MIDI, Code, NDI |
Each lesson points at the part of the screen it talks about and waits until you have done the step, then moves on by itself. Finished lessons get a check mark. Every lesson except the Tour starts on an empty graph; Ctrl+Z brings your own graph back.
Your first graph
This takes about two minutes and shows the basic way of working.
- Open Node mode. A new project has one node, the Output. Whatever reaches the Output is what the viewer shows and what export saves.
- Press
Tab(or double-click empty space), typefileand pressEnterto add File In. Because nothing is wired into the Output yet, the new node is wired to it right away. - Click the File bar on the card and choose a photo. The card and the viewer show it.
- Keep File In selected, press
Tab, typeditherand pressEnter. The Dither node is placed after the selected node, between File In and the Output, and the wires are moved for you. - On the Dither card, drag Pixel size left and right, and open Palette to choose colors.
- Right-click the Pixel size bar and choose Drive with > Wave. A Wave node is added and wired into the setting.
- Press
Spaceto play. The pixels now grow and shrink. - Press
Ctrl+Eto export a video, orCtrl+Shift+Eto save the current frame as a PNG.
From here, see Building Graphs for everything you can do with cards and wires.
The workspace
| Area | What it does |
|---|---|
| Graph | The board with your nodes, wires, frames and notes. Drag empty space to pan and scroll to zoom. F fits the selected nodes, or everything when nothing is selected. |
| Viewer | Shows one node at full size, the Output unless you choose another. See The Node Viewer. |
| Timeline dock | At the bottom of the graph: Play / Pause, the performance button and Open timeline. See Animation and Values. |
| Top bar | Next to the mode tabs: the bug button, Learn Nodes and, inside a custom node, the path back to the project (see Custom Nodes). |
| Info panel | Press I to show how many Nodes and Connections the graph has. |
Viewer layout
Three buttons choose where the viewer goes:
- Show viewer beside the graph: the viewer is a pane on the right with its own toolbar. Drag the divider to resize it.
- Show viewer behind the graph: the result fills the area behind the graph, so you see it large while you edit.
Shift+Bswitches to this layout and back. - Hide viewer: only the graph. The cards keep their previews.
In the side layout these buttons are in the viewer toolbar. In the other two layouts they are in the top right corner of the graph, next to the canvas size button. The viewer toolbar, its tools and its handles are available only in the side layout.
Nodes, wires and types
A node has inputs on the left of its card and outputs on the right. A wire carries the result of an output into an input. Every socket has a type, and a wire connects only sockets that fit:
| Type | What it carries |
|---|---|
| Image | A picture. Image and mask sockets connect to each other. |
| Mask | A gray picture that says where something applies: white is on, black is off. |
| Elements | A set of points, cells or letters, each with its own ID, position, size, color and value. See Elements. |
| Value | A single number that can change over time, for driving settings. See Animation and Values. |
| Audio | Sound, for scopes, sound effects and analysis. See Sound and Oscilloscope. |
| Swarm | GPU particles from a Swarm. |
| Scene, Material, Camera | The parts of a 3D scene. See 3D Scenes. |
| Notes | Notes and chords from MIDI File and MIDI In. |
Each type has its own color on sockets and wires. While you drag a wire, the sockets it can connect to stand out.
Saving and projects
- The graph, its custom nodes, keyframes, snapshots, the canvas size and the viewer setup are saved in the project file, together with the media the graph uses. See Project Files.
- Custom nodes you save to the library are kept outside projects, so they are available in every project. See The library.
- Node graphs made with DASCA 2.2 and earlier belong to the previous Node workspace and do not open in this version. The rest of such a project opens as usual, and saving it again leaves the old graph out.
Export
Click Export in the title bar or press Ctrl+E to open Export Settings. Node exports frame by frame, so every frame is complete even when the live preview is slow, and video files include the sound of the graph. See Node export.
Ctrl+Shift+E saves the current frame as a PNG at the canvas size, in your default save folder (or your Pictures folder when none is set).
All Node pages
- Building Graphs: adding nodes, cards, settings, wires, frames, notes and performance.
- Custom Nodes and Ready-made Looks: packing nodes into your own nodes and keeping them in the library.
- The Node Viewer: what is shown, slots, compare, snapshots, variations, handles and canvas size.
- Animation and Values: the timeline, keyframes, value nodes, music and loops.
- Elements: points, cells and letters, groups and GPU particles.
- 3D Scenes: shapes, models, materials, lights, cameras and rendering.
- Sound and Oscilloscope: making, playing and drawing sound.
- Live Input and Output: webcam, tracking, microphone, MIDI and NDI.
- Code Nodes: writing WGSL in the Shader and Surface Shader nodes.
- Node Reference: every node with its inputs, outputs and settings.