Struct Env 

pub struct Env { /* private fields */ }

Everything widgets need to know about how to draw and label themselves.

Implementations

impl Env

pub fn builtin() -> Self

Built-in files only, the monochrome theme, Unicode glyphs, English and 24-bit colour. Deterministic, which makes it the environment for tests.

pub fn load(dirs: &AssetDirs) -> Result<Self>

Loads the application’s files over the built-ins and detects colour depth, glyphs and language from the process environment.

Errors

Returns an I/O error when a configured directory or file cannot be read and no text was given for that kind of file; with text given, an unreadable path is a diagnostic and the text stands in for it. Problems inside files are never errors; they are collected in Env::diagnostics.

pub fn theme(&self) -> &Theme

The active theme.

pub fn themes(&self) -> Vec<(String, String)>

(id, name) of every theme.

pub fn icon_sets(&self) -> Vec<(String, String)>

(id, name) of every icon set, the way Env::themes lists the themes. A theme names the set it draws with, so this tells which sets a theme may name.

pub fn icons(&self) -> &Icons

The icons in the active glyph mode.

pub fn icon_mode(&self) -> IconMode

The chosen icon mode.

pub fn glyph_mode(&self) -> GlyphMode

The glyph column actually drawn.

pub fn i18n(&self) -> &I18n

The translator.

pub fn keymap(&self) -> &Keymap

The keymap.

pub fn keymap_mut(&mut self) -> &mut Keymap

The keymap, to bind actions in code, e.g. before handing the environment to a Harness.

pub fn depth(&self) -> ColorDepth

The terminal’s colour depth.

pub fn reduced_motion(&self) -> bool

Whether animations are reduced: layers appear at once, nothing breathes or spins.

The QUVYTA_REDUCED_MOTION environment variable, read by Env::load, decides when it is set: 0 keeps motion, any other non-empty value reduces it. It wins over a saved reduced-motion setting and over Command::set_reduced_motion, because a choice made in the user’s shell is the stronger signal, the way accessibility overrides work. Unset or empty, the saved setting and the application decide.

pub fn reduced_motion_forced(&self) -> bool

Whether the QUVYTA_REDUCED_MOTION environment variable decides reduced motion, so neither a saved setting nor Command::set_reduced_motion can change it. A settings screen uses it to show its reduced-motion switch as decided by the environment instead of letting the switch snap back when pressed.

pub fn pillar_style(&self) -> Option<PillarStyle>

The pillar the user chose over the theme’s, if any.

pub fn slide(&self) -> bool

Whether list structures (lists, menus, trees, tables, tab strips and rails, dropdown options) slide the leading text of hovered and selected rows one cell; buttons and fields never do. The user’s choice when made, otherwise the theme’s motion.slide.

pub fn diagnostics(&self) -> &[Diagnostic]

Problems found in theme, icon, locale and keymap files, including theme switches that fell back to the default.

Trait Implementations

impl Clone for Env

fn clone(&self) -> Env

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Env

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

Formats the value using the given formatter.