skode/global
Global synthesizer engine settings, master volume (V), clock, and FX buses.
Maps to process-wide state in parts/synth.c, parts/synth-state.h, and parts/seq.c.
Types
pub type EngineSettings {
EngineSettings(
master_volume_db: Float,
tempo_bpm: Float,
subdivision: Float,
master_pattern: option.Option(Int),
delay_buses: List(delay.DelayBus),
)
}
Constructors
-
EngineSettings( master_volume_db: Float, tempo_bpm: Float, subdivision: Float, master_pattern: option.Option(Int), delay_buses: List(delay.DelayBus), )Arguments
- master_volume_db
-
Master output volume in dB (-60.0 .. 12.0, default -6.0 dB). Sets
V <db>. - tempo_bpm
-
Master tempo in BPM (1.0 .. 960.0, default 120.0). Sets
M <bpm> <subdivision>. - subdivision
-
Clock subdivision (default 16.0). Sets second arg of
M. - master_pattern
-
Master downbeat reference pattern (0..127 or None). Sets
yp <id>. - delay_buses
-
Delay lines 1..4
Values
pub fn default() -> EngineSettings
Default engine settings (master volume = -6.0 dB, 120 BPM, 4 default delay lines).
pub fn diff_skode(
old: EngineSettings,
new: EngineSettings,
) -> List(String)
Compute minimal delta Skode commands when global settings change.
Dragging the Master Volume slider produces solely ["V -3.5"].
pub fn master_volume_linear(settings: EngineSettings) -> Float
Master volume linear amplitude factor (0.0 to ~4.0, with 1.0 at 0 dB).
pub fn set_master_volume_db(
settings: EngineSettings,
db: Float,
) -> EngineSettings
Set master volume in dB with clamping.
pub fn set_master_volume_linear(
settings: EngineSettings,
linear: Float,
) -> EngineSettings
Set master volume as a linear multiplier (0.0 .. 1.0+), converted to dB.
pub fn set_tempo(
settings: EngineSettings,
bpm: Float,
subdivision: Float,
) -> EngineSettings
Set master tempo with clamping.
pub fn to_skode(settings: EngineSettings) -> String
Serialize all engine global settings into full canonical Skode script.
pub fn update_delay_bus(
settings: EngineSettings,
bus_id: Int,
updater: fn(delay.DelayBus) -> delay.DelayBus,
) -> EngineSettings
Update a specific delay bus in the engine settings.