Struct OptionSelect 

pub struct OptionSelect {

    pub setting: String,
    pub label: String,
    pub x: f32,
    pub y: f32,
    pub width: f32,
    pub height: f32,
    pub font: String,
    pub font_px: f32,
    pub text_color: [f32; 3],
    pub value_color: [f32; 3],
    pub text_scale: f32,
    pub hover_color: [f32; 3],
    pub hover_scale: f32,
    pub stepper_width: f32,
}

A settings row that cycles through a fixed set of values on click.

OptionSelect is a build-time shorthand for one row of a settings menu: a left-aligned name, a right-aligned current value, and a clickable region that advances the value. It expands into a TextLabel for the name, a TextLabel for the value, and a HitRegion that fires a "setting:<setting>:next" action.

The setting field names an engine setting the runtime knows how to read, cycle, and apply (e.g. "vsync"); its option list lives in the engine, not here. The value label shows a placeholder at build time and is corrected to the live value when the world starts.

Generated names are prefixed with this asset’s name (<name>_label, <name>_value, <name>_btn), so they never clash with hand-authored assets.

OptionSelect {
    setting: "vsync".into(),
    label: "Vsync".into(),
    ..Default::default()
};

Fields

setting: String

Engine setting this row controls (e.g. "vsync"). Must be a setting the runtime recognises; an unknown key renders but does nothing on click.

label: String

Display name shown at the left of the row.

x: f32

Left edge of the row in window pixels.

y: f32

Top edge of the row in window pixels.

width: f32

Row width in window pixels (name sits at the left, value at the right).

height: f32

Row height in window pixels (the clickable region’s height).

font: String

Font for the row text. Empty uses the built-in font.

font_px: f32

Pixel size of the row text when it uses the built-in font (that is, when font is empty). Ignored when font names a Font, which carries its own size.

text_color: [f32; 3]

Linear-space RGB color of the name text.

value_color: [f32; 3]

Linear-space RGB color of the value text.

text_scale: f32

Scale applied to the row text.

hover_color: [f32; 3]

RGB color of the value text while the row is hovered.

hover_scale: f32

Scale of the value text while the row is hovered.

stepper_width: f32

Width in pixels of the < previous-value click region. The > next-value region spans the rest of the row’s right half (the value sits inside it), so a click on the value advances to the next option.

Trait Implementations

impl Authored for OptionSelect

const TYPE: &'static str = "OptionSelect"

The registered asset type, as it appears in a world line’s type.

impl BuildOnlyAsset for OptionSelect

impl Clone for OptionSelect

fn clone(&self) -> OptionSelect

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OptionSelect

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

Formats the value using the given formatter.

impl Default for OptionSelect

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for OptionSelect

where OptionSelect: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for OptionSelect

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

where __S: Serializer,

Serialize this value into the given Serde serializer.