Struct Image 

pub struct Image { /* private fields */ }

Represents a loaded image.

Implementations

impl Image

pub async fn new(mime: Mime, data: Vec<u8>) -> Image

Creates a new Image from raw image data.

It will decode the image on a background thread, preventing UI blocking.

Panics

Panics if the MIME type is not supported or if the image data cannot be decoded.

pub async fn process<F>(&mut self, func: F)

where F: FnOnce(Arc<DynamicImage>) -> DynamicImage + Send + 'static,

Process the image with a closure on a background thread

pub async fn encode(&self, mime: Mime) -> Vec<u8>

Encodes the image to the specified MIME type.

Panics

Panics if the MIME type is not supported or if encoding fails.

pub async fn encode_png(&self) -> Vec<u8>

Encodes the image as PNG.

pub async fn encode_jpeg(&self, _quality: u8) -> Vec<u8>

Encodes the image as JPEG with the specified quality (currently unused).

pub async fn rotate(&mut self, angle: u32)

Rotates the image by the specified angle in degrees (0, 90, 180, or 270).

Panics

Panics if the angle is not a multiple of 90 degrees or is outside the range 0-359.

pub fn width(&self) -> u32

Get the width of the image in pixels

pub fn height(&self) -> u32

Get the height of the image in pixels

pub fn dimensions(&self) -> (u32, u32)

Get the dimensions (width, height) of the image

pub async fn resize(&mut self, width: u32, height: u32)

Resize the image to the specified dimensions Uses Lanczos3 filter for high quality

pub async fn resize_to_fit(&mut self, max_width: u32, max_height: u32)

Resize the image to fit within the specified dimensions while maintaining aspect ratio

pub async fn resize_to_fill(&mut self, width: u32, height: u32)

Resize the image to fill the specified dimensions while maintaining aspect ratio

pub async fn resize_exact(&mut self, width: u32, height: u32)

Resize the image exactly to the specified dimensions (may distort aspect ratio)

pub async fn flip_horizontal(&mut self)

Flip the image horizontally

pub async fn flip_vertical(&mut self)

Flip the image vertically

pub async fn crop(&mut self, x: u32, y: u32, width: u32, height: u32) -> bool

Crop the image to the specified rectangle Returns true if successful, false if the rectangle is out of bounds

pub async fn blur(&mut self, sigma: f32)

Blur the image with the specified sigma value

pub async fn brighten(&mut self, value: i32)

Adjust the brightness of the image value: -100 to 100 (negative for darker, positive for brighter)

pub async fn adjust_contrast(&mut self, contrast: f32)

Adjust the contrast of the image contrast: floating point value (1.0 = no change, < 1.0 = less contrast, > 1.0 = more contrast)

pub async fn grayscale(&mut self)

Convert the image to grayscale

pub async fn invert(&mut self)

Invert the colors of the image

pub async fn unsharpen(&mut self, sigma: f32, threshold: i32)

Apply an unsharpen mask to the image

pub fn get_pixel(&self, x: u32, y: u32) -> Option<WithOpacity<Srgb>>

Get the color of a specific pixel Returns None if the coordinates are out of bounds

pub async fn thumbnail(&mut self, max_size: u32)

Create a thumbnail of the image with the specified maximum dimension

pub async fn rotate_90(&mut self)

Rotate the image 90 degrees clockwise

pub async fn rotate_180(&mut self)

Rotate the image 180 degrees

pub async fn rotate_270(&mut self)

Rotate the image 270 degrees clockwise (90 degrees counter-clockwise)

pub async fn gaussian_blur(&mut self, sigma: f32)

Apply a Gaussian blur with the specified sigma

pub async fn huerotate(&mut self, degrees: i32)

Hue rotate the image by the specified degrees

pub const fn mime(&self) -> &Mime

Get the MIME type of the image

pub async fn write( &self, format: Mime, path: impl AsRef<Path>, ) -> Result<(), Error>

Write the image to a file with the specified format

Errors

Returns an error if the file cannot be written.

pub async fn url(&self) -> String

Generate a base64-encoded data URL for the image encoded as PNG

For large images (>10KB), encoding is done on a background thread to prevent UI blocking.

Trait Implementations

impl Clone for Image

fn clone(&self) -> Image

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Image

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

Formats the value using the given formatter.