Struct Device 

pub struct Device {
    pub mobile_device: bool,
    pub mobile_forced: bool,
    pub orientation: Orientation,
    pub orientation_forced: Option<Orientation>,
    pub screen_size: Vec2,
}

Tracks device characteristics (mobile detection, orientation and screen size) used to drive responsive layout decisions.

Fields

mobile_device: bool

true when the running platform is detected as a mobile device.

mobile_forced: bool

User/debug override forcing mobile behaviour regardless of detection.

orientation: Orientation

Orientation derived from the most recently observed screen size.

orientation_forced: Option<Orientation>

Override that pins the reported orientation when set.

screen_size: Vec2

Most recently observed screen size, in points.

Implementations

impl Device

pub fn set_screen_size(&mut self, rect: &Rect)

Record the current screen size from rect and re-derive the orientation, classifying narrow or sub-540px-wide areas as portrait.

pub fn orientation(&self) -> Orientation

Returns the effective orientation, preferring a forced override when set and otherwise the orientation derived from the screen size.

pub fn is_mobile(&self) -> bool

Returns true if the device is detected as mobile or has been forced into mobile mode.

pub fn toggle_portrait(&mut self)

Toggle a forced portrait orientation: enables it when no override is set, otherwise clears the override and reverts to auto-detection.

pub fn toggle_mobile(&mut self)

Toggle the forced-mobile override on or off.

pub fn is_single_pane(&self) -> bool

Returns true when the UI should collapse to a single pane, such as on mobile (real or forced), in portrait orientation, or inside a Chrome extension popup.

pub fn is_desktop(&self) -> bool

Returns true when the device should use a multi-pane desktop layout (i.e. the inverse of Device::is_single_pane).

pub fn force_orientation(&mut self, orientation: Option<Orientation>)

Force the reported orientation to a specific value, or pass None to resume using the orientation derived from the screen size.

Trait Implementations

impl Clone for Device

fn clone(&self) -> Device

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Device

fn default() -> Device

Returns the “default value” for a type.