Struct widgetry::runner::Settings

source ·
pub struct Settings {
    pub(crate) window_title: String,
    pub(crate) assets_base_url: Option<String>,
    pub(crate) assets_are_gzipped: bool,
    dump_raw_events: bool,
    pub(crate) scale_factor: Option<f64>,
    require_minimum_width: Option<f64>,
    window_icon: Option<String>,
    loading_tips: Option<Text>,
    load_default_textures: bool,
    pub(crate) read_svg: Box<dyn Fn(&str) -> Vec<u8>>,
    pub(crate) canvas_settings: CanvasSettings,
}
Expand description

Customize how widgetry works. Most of these settings can’t be changed after starting.

Fields§

§window_title: String§assets_base_url: Option<String>§assets_are_gzipped: bool§dump_raw_events: bool§scale_factor: Option<f64>§require_minimum_width: Option<f64>§window_icon: Option<String>§loading_tips: Option<Text>§load_default_textures: bool§read_svg: Box<dyn Fn(&str) -> Vec<u8>>§canvas_settings: CanvasSettings

Implementations§

source§

impl Settings

source

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

Specify the title of the window to open.

source

pub fn dump_raw_events(self) -> Self

Log every raw winit event to the DEBUG level.

source

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

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

source

pub fn require_minimum_width(self, width: f64) -> Self

If the screen width using the monitor’s detected scale factor is below this value (in units of logical pixels, not physical), then force the scale factor to be 1. If scale_factor() has been called, always use that override. This is helpful for users with HiDPI displays at low resolutions, for applications designed for screens with some minimum width. Scaling down UI elements isn’t ideal (since it doesn’t respect the user’s device settings), but having panels overlap is worse.

source

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

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

source

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.

source

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).

source

pub fn assets_base_url(self, value: String) -> Self

source

pub fn assets_are_gzipped(self, value: bool) -> Self

source

pub fn canvas_settings(self, settings: CanvasSettings) -> Self

source

pub fn load_default_textures(self, load_default_textures: bool) -> Self

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<T> Downcast for T
where T: Any,

§

fn into_any(self: Box<T>) -> Box<dyn Any>

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.
§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
§

fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

impl<G1, G2> Within<G2> for G1
where G2: Contains<G1>,

§

fn is_within(&self, b: &G2) -> bool