Fundamentals
Polyphony and Voice Control
Export Targets
VST/AudioUnit
Max External Target
Raspberry Pi Target
The Web Export Target
The C++ Source Code Target
Code Export
Working with JavaScript
Working with C++
Patcher UI
Special Topics
Sample Accurate Patching
Scala and Custom Tuning
RNBO Raspberry Pi OSCQuery Runner
Raspberry Pi GPIO
Events related to Musical Time
Much like for Message and MIDI Events, you can call scheduleEvent to address your RNBO Device's transport and do things like change the tempo or time signature.
@rnbo/js exposes the TempoEvent, TransportEvent, TimeSignatureEvent, and BeatTimeEvent classes for scheduling events related to musical time and the transport that is active in your RNBO device. Like Message events or MIDI events, you call the scheduleEvent function to schedule these various events.
The following example demonstrates how you could schedule these different types of event:
- A
TempoEventthat sets the tempo to 60 bpm, - A
TimeSignatureEventthat sets the device's time signature to simple triple (3/4) time, - A
TransportEventthat sets the transport to be running (as opposed to stopped), and - A
BeatTimeEventthat moves the transport to a new time, specified in a number of quarter notes from the transport's start. This start time, or time 0, would correspond to 1.1.1 in Ableton Live's transport, for example.
const { TempoEvent, BeatTimeEvent, TimeNow, createDevice, TimeSignatureEvent, TransportEvent } = require("@rnbo/js");
let context = new AudioContext();
// Somehow initialize your patcher
const response = await fetch("export/patch.export.json");
const patcher = await response.json();
const device = await createDevice({
patcher: patcher,
context: context
});
// will schedule an event that immediately changes the tempo to 60 bpm, assuming we've initialized our device
let tempoEvent = new TempoEvent(TimeNow, 60);
device.scheduleEvent(tempoEvent);
// will schedule an event that immediately sets the time signature to simple triple time (3/4)
let timeSignatureEvent = new TimeSignatureEvent(TimeNow, 3, 4);
device.scheduleEvent(timeSignatureEvent);
// will schedule an event that immediately sets the Transport to be running
let transportEvent = new TransportEvent(TimeNow, 1);
device.scheduleEvent(transportEvent);
// will immediately move the Transport to a new time, measured in quarter notes — 4 quarter notes from time 0.
let beatTimeEvent = new BeatTimeEvent(TimeNow, 4);
device.scheduleEvent(beatTimeEvent);