Struct WallpaperBundle

pub struct WallpaperBundle { /* private fields */ }

A wallpaper that adapts to landscape vs portrait surfaces.

Holds a single full-resolution landscape image and lazily produces left-cropped portrait variants on demand, caching the most recently requested crop dimensions.

Implementations

impl WallpaperBundle

pub fn from_decoded(landscape: ImageData) -> Self

Wrap an already-decoded landscape image.

pub fn from_bytes(bytes: &[u8]) -> Result<Self, ImageError>

Decode bytes (PNG/JPEG) as the landscape image.

pub fn from_path(path: &Path) -> Result<Self, ImageError>

Load the landscape image from path.

pub fn from_path_or_bytes(path: Option<&Path>, bundled_fallback: &[u8]) -> Self

Try to load the landscape image from path; on failure fall back to decoding bundled_fallback (typically a include_bytes! asset shipped inside the consumer binary). Errors loading the path are reported on stderr.

pub fn from_path_or_solid(path: Option<&Path>, r: u8, g: u8, b: u8) -> Self

Try to load from path; on failure produce a 1×1 solid-colour bundle using (r, g, b) instead of requiring embedded PNG bytes. Reports path load errors on stderr.

pub fn landscape(&self) -> ImageData

The original landscape image. Cheap clone — only bumps the inner Arc.

pub fn for_size(&self, sw: u32, sh: u32) -> ImageData

Return the wallpaper variant appropriate for a surface of (sw, sh).

• Landscape surface (sw >= sh): returns the full landscape image.
• Portrait surface (sw < sh): returns a left-cropped variant whose aspect ratio matches (sw, sh). The crop is computed once per unique (sw, sh) pair and reused on subsequent calls.

(0, 0) is treated as landscape (returns the original image) so that callers can use this before the surface has been sized.