Struct widgetry::Settings

pub struct Settings {
    window_title: String,
    dump_raw_events: bool,
    scale_factor: Option<f64>,
    window_icon: Option<String>,
    loading_tips: Option<Text>,
    read_svg: Box<dyn Fn(&str) -> Vec<u8>>,
}

Customize how widgetry works. These settings can't be changed after starting.

Fields

window_title: String

dump_raw_events: bool

scale_factor: Option<f64>

window_icon: Option<String>

loading_tips: Option<Text>

read_svg: Box<dyn Fn(&str) -> Vec<u8>>

Implementations

impl Settings

pub fn new(window_title: &str) -> Settings

Specify the title of the window to open.

pub fn dump_raw_events(self) -> Self

Log every raw winit event to the DEBUG level.

pub fn scale_factor(self, scale_factor: f64) -> Self

Override the initial HiDPI scale factor from whatever winit initially detects.

pub fn window_icon(self, path: String) -> Self

Sets the window icon. This should be a 32x32 image.

pub fn loading_tips(self, txt: Text) -> Self

Sets the text that'll appear during long ctx.loading_screen calls. You can use this as a way to entertain your users while they're waiting.

pub fn read_svg(self, function: Box<dyn Fn(&str) -> Vec<u8>>) -> Self

When calling Widget::draw_svg, ButtonBuilder::image_path, and similar, use this function to transform the filename given to the raw bytes of that SVG file. By default, this just reads the file normally. You may want to override this to more conveniently locate the file (transforming a short filename to a full path) or to handle reading files in WASM (where regular filesystem IO doesn't work).