Skip to main content

Crate clairlune_platform

Crate clairlune_platform 

Source
Expand description

Platform layer: finding the monitors and setting the desktop wallpaper.

The OS wallpaper APIs only set static images (PLAN.md section 2). A WallpaperHost wraps one OS’s API: list the monitors with stable ids and physical sizes, read and set each monitor’s wallpaper. detect picks the host for the running system. StillStore writes each still under a new file name, because some systems don’t reload an unchanged path.

Windows is implemented (IDesktopWallpaper, per monitor); other systems return PlatformError::Unsupported until their hosts land.

Structs§

Capabilities
What a host can do.
Monitor
One monitor, in physical pixels.
Snapshot
The wallpaper as it was before Clairlune first set one, so it can be put back: each monitor’s image (or none) and the system’s fit mode.
StillStore

Enums§

PlatformError

Traits§

WallpaperHost
One system’s wallpaper API.

Functions§

app_config_dir
Clairlune’s configuration directory: <config>/clairlune.
app_data_dir
Clairlune’s data directory (stills, archive, logs): <local data>/clairlune.
config_dir
The per-user configuration directory: Roaming AppData on Windows, ~/Library/Application Support on macOS, $XDG_CONFIG_HOME (or ~/.config) elsewhere.
detect
The host for the running system.
init_dpi_awareness
Makes the process aware of each monitor’s DPI so sizes come back in physical pixels. Call once, before any window or monitor query. A no-op where it does not apply.
local_data_dir
The per-user local data directory: Local AppData on Windows, ~/Library/Application Support on macOS, $XDG_DATA_HOME (or ~/.local/share) elsewhere.
pictures_dir
The user’s Pictures folder (exports go to Pictures/Clairlune).
set_start_at_login
Registers or removes exe as a login item (per user, no admin rights).
start_at_login
Whether exe is registered to start at login; None where this build can’t manage login items yet.
system_prefers_dark
Whether the system asks apps for a dark appearance, when that is known.