alda.sound — alda/sound-engine-clj 1.3.0

*play-opts* clj

create-sequence! clj

(create-sequence! score & [event-set])

determine-audio-types clj

(determine-audio-types {:keys [instruments] :as score})

earliest-offset clj

(earliest-offset event-set)

export! clj

(export! score output-filename)

Exports an Alda score to a MIDI file.

new-audio-context clj

(new-audio-context)

play! clj

(play! score & args)

Plays an Alda score, optionally from given start/end marks determined by play-opts.

Optionally takes as a second argument a set of events to play (which could be pre-filtered, e.g. for playing only a portion of the score).

In either case, the offsets of the events to be played are shifted back such that the earliest event's offset is 0 -- this is so that playback will start immediately.

Returns a result map containing the following values:

:score The full score being played.

:stop! A function that, when called mid-playback, will stop any further events from playing.

:wait A function that will sleep for the duration of the score. This is useful if you want to playback asynchronously, perform some actions, then wait until playback is complete before proceeding.

set-up! clj

(set-up! score)

(set-up! {:keys [audio-context] :as score} audio-type)

Does any necessary setup for one or more audio types. e.g. for MIDI, create and open a MIDI synth.

set-up-audio-type! clj multimethod

set-up? clj

(set-up? {:keys [audio-context] :as score} audio-type)

shift-events clj

(shift-events events offset cut-off)

start-finish-times clj

(start-finish-times {:keys [from to]} markers)

stop-playback! clj

(stop-playback! {:keys [audio-context] :as score})

(stop-playback! {:keys [audio-context] :as score} audio-type)

Stop playback, but leave the score in a state where playback can be resumed.

stop-playback-for-audio-type! clj multimethod

tear-down! clj

(tear-down! {:keys [audio-context] :as score})

(tear-down! {:keys [audio-context] :as score} audio-type)

Completely clean up after a score.

Playback may not necessarily be resumed after doing this.

tear-down-audio-type! clj multimethod

with-play-opts clj macro

(with-play-opts opts & body)

Apply opts as overrides to play-opts when executing body