Struct PersonalThumbnailInstallRequest 

pub struct PersonalThumbnailInstallRequest { /* private fields */ }

Owned personal-cache install request for async or runtime-specific adapters.

Constructing this request does not perform filesystem I/O. Normalization and installation happen only when Self::install_path or Self::install_png_bytes is called. Constructing a ReadablePersonalOriginalIdentity from a local path performs blocking filesystem I/O, so async callers should do that inside their runtime’s blocking adapter too.

use xdg_thumbnail::{
    PersonalCacheRoot, PersonalThumbnailInstallRequest, ReadablePersonalOriginalIdentity, ThumbnailSize,
};

fn spawn_blocking<F, R>(operation: F) -> R
where
    F: FnOnce() -> R + Send + 'static,
    R: Send + 'static,
{
    operation()
}

fn render_thumbnail_png() -> Vec<u8> {
    unimplemented!("return PNG bytes produced by the caller's renderer")
}

fn main() -> xdg_thumbnail::Result<()> {
    let root = PersonalCacheRoot::resolve_from_env()?;
    let rendered_png = render_thumbnail_png();

    let installed = spawn_blocking(move || {
        let original =
            ReadablePersonalOriginalIdentity::from_local_path("/home/alice/Pictures/photo.png")?;
        let request = PersonalThumbnailInstallRequest::new(
            root,
            original,
            ThumbnailSize::Normal,
            rendered_png,
        );
        request.install_png_bytes()
    })?;
    let _path = installed.path();
    Ok(())
}

Implementations

impl PersonalThumbnailInstallRequest

pub fn new( root: PersonalCacheRoot, original: ReadablePersonalOriginalIdentity, size: ThumbnailSize, rendered_png: Vec<u8>, ) -> Self

Creates an owned personal-cache install request.

pub fn install_path(self) -> Result<InstalledThumbnailPath>

Normalizes rendered PNG data, installs a personal-cache thumbnail, and returns its path.

Errors

Returns the same errors as PersonalCacheRoot::install_thumbnail_returning_path.

pub fn install_png_bytes(self) -> Result<InstalledThumbnailPngBytes>

Normalizes rendered PNG data, installs a personal-cache thumbnail, and returns final PNG bytes.

Errors

Returns the same errors as PersonalCacheRoot::install_thumbnail_returning_png_bytes.

pub fn into_parts(self) -> PersonalThumbnailInstallRequestParts

Splits this request into its owned parts.

Trait Implementations

impl Debug for PersonalThumbnailInstallRequest

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

Formats the value using the given formatter.

impl PartialEq for PersonalThumbnailInstallRequest

fn eq(&self, other: &PersonalThumbnailInstallRequest) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for PersonalThumbnailInstallRequest

impl StructuralPartialEq for PersonalThumbnailInstallRequest