Oscilla Documentation

This documentation describes the cue system, animation model, authoring workflow, and internal architecture of Oscilla.
All behaviour is authored directly in SVG and executed at runtime in the browser.

INSTALL

• Installation
• Quickstart

Authoring Workflow

• Workflow — SVG authoring and browser execution
• Cheatsheet — compact syntax reference

Cue Reference

Cues are the primary execution units in Oscilla. They control timing, navigation, media playback, interaction, and external communication.

Timing & Navigation

• stop() — halt playback
• pause() — pause playback
• speed() — speed control
• nav() — navigation and mode control
• page() — page-based navigation
• stopwatch() — time display and control
• repeat() — repeat and loop structures

Interaction & Structure

• button() — interactive UI buttons
• propagate() — propagate cue state
• reuse() — reuse cue definitions

Animation

Oscilla supports continuous and discrete animation tied directly to score timing.

• scale() — uniform and non-uniform scaling
• rotate() — continuous and stepped rotation
• o2p() — object-to-path traversal
• traverse() — object traversal across points or paths
• color() — color animation (documentation forthcoming)
• fade() — fade visual or UI elements
• text() — timed and sequenced text

A/V & Synthesis

• audio() — audio file playback
• video() — video playback
• synth() — in-browser synthesis

OSC & External Control

• osc() — OSC message output
• oscCtrl() — OSC routing and control

Further Reading

The design and rationale of Oscilla are described in:

R. Canning, OscillaScore: A Modular Platform for Graphic Notation in Networked Music Performance,
Proceedings of the International Conference on Technologies for Music Notation and Representation (TENOR), Beijing, 2025.