0.01
No commit activity in last 3 years
No release in over 3 years
Gamelan is a good-enough soft real-time event scheduler, written in Ruby, especially for music applications.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

Gamelan¶ ↑

Gamelan is a good-enough soft real-time event scheduler especially for music applications. It exposes a simple API for executing Ruby code at a required time. Uses include sending MIDI or OSC messages to external applications or hardware.

Gamelan also makes life easier by supporting logical time. Logical time is reflected in the scheduler’s phase. The unit in logical time is the beat, and the Scheduler’s phase will increment by 1.0 with every beat.

Logical time varies with real time according to the tempo, which is specified in bpm. For example, the Scheduler’s phase will increment by 2.0 for every second that elapses when using the default tempo of 120bpm. Applications are free to alter the tempo at any time, including from within tasks.

Notes¶ ↑

The author admits that Ruby is not at all friendly to realtime applications. No guarantees are made about the scheduler’s performance. It will not drift (it will always stay in sync with the system clock), but jitter is inevitable. This is minimized by using a hybrid spinlock implementation to wait between dispatches, and by using a reasonably efficient priority queue to store Tasks.

The design is an elaboration of Topher Cyll’s Timer implementation from his book, Practical Ruby Projects, and the Priority Queue implementation comes from Brian Amberg.