@maruaudio/dsp/voices/clouds translates the Mutable Instruments Clouds granular mode: a stereo 16-bit recording buffer (32,696 frames), up to 32 grains scheduled in 32-frame blocks, freeze, trigger, feedback, blend, spread and reverb, at the fixed 32 kHz core rate behind a host-rate adapter. Other modes and quality settings are unsupported; qualification is pending.
Parameters
setCloudsParam returns false for an unknown index, a non-finite value, or a quality or playback mode other than 0.
| Index | Range as coded | Default |
|---|---|---|
| 0 position, 1 size, 3 density, 4 texture, 6 dry/wet, 7 spread, 8 feedback | 0 to 1 | 0.5 |
| 2 pitch / 5 input gain | −48 to 48 semitones / −18 to 6 dB | 0 / 0 |
| 9 reverb / 10 freeze (≥ 0.5 on) / 13 blend target (rounded 0 to 3) | 0 to 1 | 0 |
| 11 quality / 12 playback mode | Must be 0 (granular) | 0 |
setCloudsCv writes eight CVs, added to their parameters while present; setCloudsInputPresent declares the inputs (an absent right copies the left).
Lifecycle
initCloudsState(rate) allocates every buffer → prepareCloudsState restores defaults in place → set parameters, CVs and input presence → tickClouds(state, left, right) once per host frame returns the stereo out, or processCloudsBlock on blocks at the 32 kHz core rate → resetCloudsState clears the recording, grains and histories.
When to use it
A Clouds granular processor on a stereo input, in a module that admits only this mode.
Limits
- Stereo; rates below 8 kHz fall back to 32 kHz; the adapter adds 16 host plus 48 core frames of latency.
processCloudsBlocktakes at most 128 frames and writes silence for an unsupported mode; grain randomness starts from a fixed seed.