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.

✨ Search Document