Skip to main content

ResolutionContext

Struct ResolutionContext 

Source
pub struct ResolutionContext {
    pub font_dpi: f32,
    pub button_order: DialogButtonOrder,
    pub icon_theme: Option<Cow<'static, str>>,
}
Expand description

Resolution-time inputs captured once per theme-build.

Replaces the font_dpi: Option<f32> parameter on ThemeMode::into_resolved and the corresponding internal OverlaySource field.

Accessibility preferences live on SystemTheme, NOT here — accessibility is a render-time concern, not a resolve-time concern (docs/archive/v0.5.7_gaps.md §G7).

§Examples

use native_theme::resolve::ResolutionContext;

// Production: auto-detect from OS.
let ctx = ResolutionContext::from_system();
assert!(ctx.font_dpi > 0.0);

// Tests: deterministic values.
let ctx = ResolutionContext::for_tests();
assert_eq!(ctx.font_dpi, 96.0);
assert!(ctx.icon_theme.is_none());

Fields§

§font_dpi: f32

Font DPI for pt-to-px conversion. It must be finite and positive: resolution rejects any other value as one Error::ResolutionInvalid on the path context.font_dpi, before any point size is converted.

from_system detects it: 72.0 on macOS, 96.0 on Windows, 96.0 on a GNOME or Budgie desktop (with the portal feature; GNOME’s text-scaling factor is carried in AccessibilityPreferences, not in the DPI; an unrecognised desktop counts as the one SystemTheme::from_system reads, its portal backend’s once a system read has asked it), and on other Linux desktops KDE’s kcmfonts forceFontDPI on an X11 session (with the kde feature), then Xft.dpi, then xrandr’s physical DPI (with kde or portal), then 96.0; 96.0 elsewhere. The detected DPI is cached until invalidate_caches(). When the OS theme is read (SystemTheme::from_system), the reader’s own DPI replaces it: KDE’s this same cached chain; GNOME’s 96.0, macOS’s 72.0 and Windows’ 96.0.

§button_order: DialogButtonOrder

Dialog button ordering (PrimaryLeft on KDE and Windows, PrimaryRight elsewhere).

§icon_theme: Option<Cow<'static, str>>

Runtime-detected icon theme name, used when the preset and per-variant icon_theme fields are both None. Three-tier precedence in the pipeline: per-variant → Theme-level shared → this runtime detection.

from_system puts the detected system icon theme here, or None where detection failed; system_icon_theme() gives the reason.

Implementations§

Source§

impl ResolutionContext

Source

pub fn from_system() -> Self

Build the context by auto-detecting from the current OS.

Calls:

  • crate::detect::system_font_dpi for font_dpi (private)
  • crate::resolve::inheritance::platform_button_order for button_order
  • crate::detect::system_icon_theme for icon_theme, which is None where detection fails
Source

pub fn for_tests() -> Self

Deterministic values for tests: 96 DPI, PrimaryRight button order, no detected icon_theme.

Tests that need a specific DPI (e.g. 72.0 for Apple point→pixel) can construct the struct via a literal: ResolutionContext { font_dpi: 72.0, ..ResolutionContext::for_tests() }.

Trait Implementations§

Source§

impl Clone for ResolutionContext

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for ResolutionContext

Source§

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

Formats the value using the given formatter. Read more

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
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

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

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

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> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

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

Source§

type Error = !

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

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

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

Source§

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.
Source§

impl<T> WithSubscriber for T

Source§

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
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

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