Prepare

[prezmop]

resolves #187

Preload samples before they are played.
I called it prepare, because it could be used to do other preparations.
(Like this?)

This was annoying me so much that i took it upon myself to write it.

[prezmop]

Currently I have not written any docs for the new functionality.
I have only written bare minimum code to implement the required functionality into superdough and added some code to call it in Cyclist (NeoCyclist remains untouched).

[yaxu]

Hey thanks for working on this, could you give an example for how prepare() is used?

[prezmop]

Hey,
like superdough(), prepare() is called with a value containing all the sound properties. However, it does not need a deadline or duration, since it doesn't actually play the sound.
It can optionally be called before the sound is actually needed, so that it can be downloaded.

The following examples both assume that the "sd" sound has not been loaded yet.

without prepare (this still works):

superdough({s:"sd"},0)
// sound doesn't play

with prepare:

prepare({s:"sd"})

// some time later

superdough({s:"sd"},0)
//sound plays

[prezmop]

Note that it is up to whatever/whoever is using superdough to inform what sounds will be needed

[felixroos]

i like this idea! i cant review the code until in 2 weeks tho.. i think this would already be a good addition even without automatically calling it from a scheduler. is this a promise, so can we await it before playback?

[prezmop]

for a strudel example:

$: n("<0 1 2 3 4 5 6 7>").s("kawai").scale("c:major")

Though this actually seems to work worse at the moment.
Looking at the network requests for the sounds they seem to take really long time.
Maybe the amount of parallel fetches needs to be limited.

[prezmop]

Admittedly, i don't know much about js

[prezmop]

i like this idea! i cant review the code until in 2 weeks tho.. i think this would already be a good addition even without automatically calling it from a scheduler. is this a promise, so can we await it before playback?

Yes, it can be awaited