vips 0.2.0

Rust bindings for libvips: fast, low-memory image processing with a safe, ergonomic API.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

use crate::Result;
use crate::VipsImage;

/// Extension trait for thumbnailing encoded image bytes.
///
/// Prefer this over `from_buffer` + [`VipsImage::thumbnail`]: `vips_thumbnail_buffer`
/// combines decode + resize so libvips can shrink-on-load.
pub trait VipsBuffer {
    /// Decode `self` as an encoded image and produce a `width`×`height` thumbnail.
    ///
    /// The returned image may retain a lazy load pipeline that reads from
    /// `self`; keep the buffer alive until the thumbnail is fully consumed.
    ///
    /// # Errors
    /// Returns an error if the buffer is not a valid image or thumbnail fails.
    fn thumbnail(&self, width: u32, height: u32, size: vips_sys::VipsSize)
    -> Result<VipsImage<'_>>;
}

impl VipsBuffer for [u8] {
    fn thumbnail(
        &self,
        width: u32,
        height: u32,
        size: vips_sys::VipsSize,
    ) -> Result<VipsImage<'_>> {
        VipsImage::thumbnail_buffer(self, width, height, size)
    }
}