Struct egui::Options

pub struct Options {
    pub(crate) style: Arc<Style>,
    pub zoom_factor: f32,
    pub zoom_with_keyboard: bool,
    pub tessellation_options: TessellationOptions,
    pub repaint_on_widget_change: bool,
    pub screen_reader: bool,
    pub preload_font_glyphs: bool,
    pub warn_on_id_clash: bool,
    pub line_scroll_speed: f32,
    pub scroll_zoom_speed: f32,
    pub reduce_texture_memory: bool,
}

Some global options that you can read and write.

See also crate::style::DebugOptions.

Fields

style: Arc<Style>

The default style for new Ui:s.

zoom_factor: f32

Global zoom factor of the UI.

This is used to calculate the pixels_per_point for the UI as pixels_per_point = zoom_fator * native_pixels_per_point.

The default is 1.0. Make larger to make everything larger.

Please call crate::Context::set_zoom_factor instead of modifying this directly!

zoom_with_keyboard: bool

If true, egui will change the scale of the ui (crate::Context::zoom_factor) when the user presses Cmd+Plus, Cmd+Minus or Cmd+0, just like in a browser.

This is true by default.

On the web-backend of eframe this is set to false by default, so that the zoom shortcuts are handled exclusively by the browser, which will change the native_pixels_per_point (devicePixelRatio). You can still zoom egui independently by calling crate::Context::set_zoom_factor, which will be applied on top of the browsers global zoom.

tessellation_options: TessellationOptions

Controls the tessellator.

repaint_on_widget_change: bool

If any widget moves or changes id, repaint everything.

It is recommended you keep this OFF, because it is know to cause endless repaints, for unknown reasons (https://github.com/rerun-io/rerun/issues/5018).

screen_reader: bool

This is a signal to any backend that we want the crate::PlatformOutput::events read out loud.

The only change to egui is that labels can be focused by pressing tab.

Screen readers is an experimental feature of egui, and not supported on all platforms.

eframe supports it only on web, but you should consider using AccessKit instead, which eframe supports.

preload_font_glyphs: bool

If true, the most common glyphs (ASCII) are pre-rendered to the texture atlas.

Only the fonts in Style::text_styles will be pre-cached.

This can lead to fewer texture operations, but may use up the texture atlas quicker if you are changing Style::text_styles, of have a lot of text styles.

warn_on_id_clash: bool

Check reusing of Ids, and show a visual warning on screen when one is found.

By default this is true in debug builds.

line_scroll_speed: f32

Multiplier for the scroll speed when reported in crate::MouseWheelUnit::Lines.

scroll_zoom_speed: f32

Controls the speed at which we zoom in when doing ctrl/cmd + scroll.

reduce_texture_memory: bool

If true, egui will discard the loaded image data after the texture is loaded onto the GPU to reduce memory usage.

In modern GPU rendering, the texture data is not required after the texture is loaded.

This is beneficial when using a large number or resolution of images and there is no need to retain the image data, potentially saving a significant amount of memory.

The drawback is that it becomes impossible to serialize the loaded images or render in non-GPU systems.

Default is false.

Implementations

impl Options

pub fn ui(&mut self, ui: &mut Ui)

Show the options in the ui.

Trait Implementations

impl Clone for Options

fn clone(&self) -> Options

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Options

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

Formats the value using the given formatter.

impl Default for Options

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for Options

fn eq(&self, other: &Options) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Options