Struct Settings 

pub struct Settings {
    pub visuals: VisualsSettings,
    pub engine: EngineSettings,
    pub playback: PlaybackSettings,
    pub audio: AudioSettings,
    pub window: WindowSettings,
    pub presets: PresetsSettings,
    pub keymap: KeymapSettings,
}

User-facing knobs persisted between launches.

Every field is pub so the Options UI can edit them in place. We intentionally don’t validate ranges here — the renderer setters (set_mesh_size, etc.) clamp at apply time.

Fields

visuals: VisualsSettings

Visuals tab.

engine: EngineSettings

Engine tab.

playback: PlaybackSettings

Playback tab.

audio: AudioSettings

Audio tab.

window: WindowSettings

Window tab.

presets: PresetsSettings

Preset library behaviour: selection mode, transition feel, history depth. Persisted ratings live separately under data_path so the user-facing config stays human-curated.

keymap: KeymapSettings

Keymap overrides. Empty by default — the GUI’s built-in MD2-style table applies until the user rebinds something.

Implementations

impl Settings

pub fn config_path() -> Option<PathBuf>

Resolve ${XDG_CONFIG_HOME:-~/.config}/onedrop/settings.toml. Returns None if the OS doesn’t expose a config dir (rare — only happens in stripped-down sandboxes).

pub fn load() -> Self

Load from disk. Missing file → defaults, no error (first launch always lands here). Parse errors are logged and also fall back to defaults so a corrupted file doesn’t brick the GUI.

pub fn save(&self)

Best-effort serialize back to disk. Creates the parent dir if missing. Failures are logged but never propagate — a write failure shouldn’t crash the visualiser mid-show.

Trait Implementations

impl Clone for Settings

fn clone(&self) -> Settings

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Settings

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Settings

fn default() -> Settings

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Settings

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Settings

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.