1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
// src/components/setting_command.rs
use alloc::string::String;
use crate::components::InputKey;
use crate::ecs::asset_id::AssetId;
/// What a "setting:*" action does to its value: cycle one step (for a stepper
/// row), jump to an absolute option index (for a dropdown pick), set an absolute
/// position in [0, 1] (for a slider row's drag), or bind a key (for a key-rebind
/// row).
///
/// Eq is intentionally not derived: SetFraction carries an f32.
#[derive(Debug, Clone, Copy, PartialEq, Default)]
pub enum SettingOp {
/// Step the value one option forward.
#[default]
Next,
/// Step the value one option back.
Prev,
/// Jump straight to this option index (clamped to the option count). Sent
/// once when the user picks an entry from an open dropdown list.
SetIndex(usize),
/// Set the value to this fraction of its range, 0.0..=1.0. Sent each frame
/// while a slider is dragged.
SetFraction(f32),
/// Bind the named action (the command's setting) to this key. Sent once when
/// the user presses a key while a rebind row is capturing.
Rebind(InputKey),
/// Bind the named gamepad action (the command's `pad_*` setting) to this
/// button. Sent once when the user presses a button while a gamepad rebind
/// row is capturing.
RebindButton(crate::components::GamepadButton),
}
/// Runtime-only event sent by UiInputSystem when a "setting:*" action fires.
/// GraphicsSystem reads these each step: it applies the change to the named
/// setting (cycling it or setting it from a fraction), updates the value_label
/// text, and (when persist is set) writes the new value to the settings store.
/// World authors never declare this type directly.
#[derive(Debug, Clone)]
pub struct SettingCommand {
/// Engine setting key (e.g. "vsync").
pub setting: String,
/// How to change the value.
pub op: SettingOp,
/// The value TextLabel to update with the new value, when known.
pub value_label: Option<AssetId>,
/// Whether to write the new value to the settings store. A cycle is one
/// discrete change and always persists; a slider drag persists only on
/// release (the in-progress frames apply live but skip the disk write).
pub persist: bool,
}
impl Default for SettingCommand {
fn default() -> Self {
Self {
setting: String::new(),
op: SettingOp::Next,
value_label: None,
persist: true,
}
}
}
#[cfg(test)]
mod tests {
use super::*;
// A command with nothing stated names no setting and writes through to the
// store: a cycle is one discrete change, and only a slider drag opts out.
#[test]
fn a_default_command_persists_and_advances() {
let command = SettingCommand::default();
assert!(command.setting.is_empty());
assert!(matches!(command.op, SettingOp::Next));
assert_eq!(command.value_label, None);
assert!(command.persist);
}
}