Get Dasca

Docs

Learn Dasca, from your first project to node graphs.

Node / Animation and Values

Animation and Values

Animate a Node graph with the timeline and keyframes, drive settings with value nodes, react to music, beats and MIDI files, and make seamless loops.

Note

These docs cover Dasca 2.3.

A Node graph moves in two ways: keyframes on the timeline, and value nodes wired into settings. Both follow the same playhead, so the result is the same in the viewer and in export.

The timeline

The timeline dock at the bottom of the graph has Play / Pause, the performance button and Open timeline. Space plays and pauses.

The timeline itself is the same one Effects mode uses (see Keyframes and Timeline):

  • The time readout shows the playhead and the duration. Click the duration (Duration (seconds)) to type a new length, from 0.1 to 600 seconds. A new Node graph is 10 seconds long.
  • Loop on / Loop off sets whether playback starts again at the end. Loop is on by default.
  • Choosing a video or a sound file that is longer than the timeline makes the timeline longer to fit it.

Videos in File In, sound in Audio, notes in MIDI File and every other time-based node follow the playhead, also when you drag it.

Keyframes

Number and color settings have a keyframe diamond at the left of their row:

DiamondClick to
AnimateStart animating the setting with a keyframe at the playhead.
Add keyframeAdd a keyframe at the playhead. The setting already has keyframes elsewhere.
Remove keyframeRemove the keyframe at the playhead. Removing the last one leaves the setting at that value.

Clicking a diamond also opens the timeline. The setting menu (right-click a setting) has Add keyframe and Remove keyframe too.

  • When you change an animated setting at a moment with a keyframe, the keyframe takes the new value. At a moment without one, the change is a preview until you add a keyframe there. With Auto key on in the timeline, every change sets a keyframe.
  • A setting driven by a wire cannot be keyframed; its diamond says Driven by a wire.
  • Menus, switches and text settings cannot be keyframed. To change an option over time, switch between versions with a Switch node, or drive a number instead.
  • Keyframes travel with copied and duplicated nodes. Keyframes inside a custom node belong to the custom node; see What is shared.

Driving settings with values

A value is a single number that can change every frame. Value outputs and the sockets that take them have the Value type.

  • Open a card with Show all settings. Settings that can be driven have a socket at the left of their row.
  • Wire a value output into that socket. The setting now follows the value, and its bar shows the value live.
  • Right-click the setting and choose Disconnect to stop driving it.

The quickest way is Drive with in the setting menu, which adds and wires the nodes for you. See Drive with.

Value nodes show their current value on the card as a meter. Nodes with several value outputs list a few of them, and all of them when you click Show all settings. Show full data shows every value with a short trace of its past (see Show full data).

Value nodes

NodeWhat it gives
WaveA value that rises and falls: Sine, Triangle, Saw or Square, at Rate (Hz), between Low and High.
TimeThe time in seconds times Speed, plus Offset. Loop starts it again after that many seconds.
RandomA value that jumps, or with Glide drifts, between Low and High, Rate (Hz) times per second.
TempoA beat clock at BPM. Pulse flashes on every beat, bar or part of a beat (Every), Count counts them and Phase runs from 0 to 1 between them.
MathA and B combined by Operation: Add, Subtract, Multiply, Divide, Minimum, Maximum, Power or Modulo.
RemapMoves Value from one range (From low to From high) into another (To low to To high), with Clamp and a Curve.
SmoothFollows Value with a delay of Lag (sec), for calmer motion.
AccumulateAdds up Input over time, so a speed becomes an angle or a position. Limit can wrap it around or clamp it between Low and High.
HoldCatches Input when Trigger turns on and keeps it until the next trigger. Mode can also follow the input while the trigger is on, or keep the highest value.
LogicTurns Input into on and off around Threshold. Outputs Gate, a short Pulse, a Count and a Toggle.
MouseX and Y of the pointer over the viewer, and Pressed.
Audio, Audio AnalysisLevel, bands and beats of sound. See Music and beats.
MIDI File, MIDI InPitch, note, velocity and gate of notes. See MIDI files and MIDI In.

Tracking nodes output values too, for example Pinch from Hand Track or Smile from Face Track. See Tracking.

Music and beats

Audio plays a sound file with the timeline and reads it at the same time. File takes a sound or a video file; with a video, its sound is used.

OutputWhat it follows
LevelHow loud the sound is.
Bass, Mid, TrebleHow loud the low (20 to 150 Hz), middle (150 to 2,500 Hz) and high (2,500 to 16,000 Hz) parts are.
BeatJumps to 1 on each beat (the hits in the bass) and falls back over Beat decay (sec).
OnsetJumps on each new sound, such as a hit or a note.
CountHow many beats have passed.
SoundThe sound itself, for scopes and sound nodes.

The values follow the song: they are always the same at the same moment, so a sound-reactive graph exports exactly as you saw it. Release (sec) sets how fast the values fall, and Sensitivity how easily beats and onsets are found. Play sound, Volume (dB), Low cut (Hz) and High cut (Hz) shape the sound you hear.

Audio Analysis gives the same values for any sound wired into it, for example from a Microphone, an NDI In or a sound you make in the graph.

Other nodes for music:

  • Tempo keeps a steady beat when you know the BPM.
  • Switch cuts between pictures by number; wire Count into its Index to cut on every beat.
  • Logic turns any value into triggers, and Hold catches a value on a trigger.
  • Spectrum draws the sound as bars, a ring, a line or a strip, and outputs the bar tips as elements.

MIDI files

MIDI File turns the notes of a .mid file into values along the timeline: Pitch (Hz), Note, Velocity, Gate (1 while a note is held) and Level (shaped by Attack (sec) and Release (sec)). Track and Channel pick the notes to read (0 reads all), and Note priority decides which note counts when several play at once.

Its Notes output plays the notes and chords on an Oscillator or a Path to Sound. See Sound and Oscilloscope.

Time, memory and loops

Some nodes remember earlier frames, for example Feedback, Previous Frame, Time Delay, Trail, Follow, Flow, Smooth, Accumulate, Swarm and the tracking nodes.

  • While playing, they build up over time. When you pause, they stay as they are.
  • When you jump back on the timeline, they start again from the beginning.
  • When the timeline loops during playback, they carry on instead of starting again.

Seamless loops

To make a loop that repeats without a jump, everything that moves must come back to where it started at the end of the timeline:

  • Keyframes: give the first and the last keyframe the same value.
  • Wave, Tempo: pick a rate that fits a whole number of times into the timeline, for example 0.5 Hz in a 10 second timeline.
  • Noise, Random, Jitter, Particles and Swarm have Loop (sec). Set it to the timeline length, or to a length that fits into it a whole number of times, and their motion repeats with that period.
  • Time has Loop, which starts it again after that many seconds.

Nodes that build up over time, such as Feedback, do not start from nothing in a looping export: see Seamless loops.