Struct ImageProcessor 

pub struct ImageProcessor { /* private fields */ }

Image processing utilities

Provides methods for common image operations like resizing, thumbnail generation, and EXIF stripping.

Implementations

impl ImageProcessor

pub const fn new() -> Self

Creates a new image processor with default settings

Uses FilterType::Lanczos3 for high-quality resizing.

Examples

use acton_htmx::storage::processing::ImageProcessor;

let processor = ImageProcessor::new();

pub const fn with_filter(filter: FilterType) -> Self

Creates a processor with a specific resize filter

Examples

use acton_htmx::storage::processing::ImageProcessor;
use image::imageops::FilterType;

let processor = ImageProcessor::with_filter(FilterType::Nearest);

pub fn generate_thumbnail( &self, file: &UploadedFile, max_width: u32, max_height: u32, ) -> StorageResult<UploadedFile>

Generates a thumbnail from an uploaded image

Creates a thumbnail that fits within the specified dimensions while maintaining aspect ratio.

Arguments

• file - The uploaded image file
• max_width - Maximum width in pixels
• max_height - Maximum height in pixels

Errors

Returns error if the file is not a valid image or processing fails

Examples

use acton_htmx::storage::{UploadedFile, processing::ImageProcessor};

let file = UploadedFile::new("photo.jpg", "image/jpeg", vec![/* ... */]);
let processor = ImageProcessor::new();

// Generate 200x200 thumbnail
let thumbnail = processor.generate_thumbnail(&file, 200, 200)?;

pub fn resize( &self, file: &UploadedFile, width: u32, height: u32, ) -> StorageResult<UploadedFile>

Resizes an image to exact dimensions

Resizes the image to the specified width and height. This may change the aspect ratio if the new dimensions don’t match the original.

Arguments

• file - The uploaded image file
• width - Target width in pixels
• height - Target height in pixels

Errors

Returns error if the file is not a valid image or processing fails

Examples

use acton_htmx::storage::{UploadedFile, processing::ImageProcessor};

let file = UploadedFile::new("photo.jpg", "image/jpeg", vec![/* ... */]);
let processor = ImageProcessor::new();

// Resize to exactly 800x600
let resized = processor.resize(&file, 800, 600)?;

pub fn convert_format( &self, file: &UploadedFile, target_format: &str, ) -> StorageResult<UploadedFile>

Converts an image to a different format

Arguments

• file - The uploaded image file
• target_format - The desired output format (e.g., “image/png”)

Errors

Returns error if the file is not a valid image or format is unsupported

Examples

use acton_htmx::storage::{UploadedFile, processing::ImageProcessor};

let file = UploadedFile::new("photo.jpg", "image/jpeg", vec![/* ... */]);
let processor = ImageProcessor::new();

// Convert JPEG to PNG
let png = processor.convert_format(&file, "image/png")?;

pub fn strip_exif(&self, file: &UploadedFile) -> StorageResult<UploadedFile>

Strips EXIF metadata from an image for privacy

Removes all EXIF metadata (location, camera info, etc.) from an image. This is important for user privacy as EXIF data can contain sensitive information like GPS coordinates.

Errors

Returns error if the file is not a valid image or processing fails

Examples

use acton_htmx::storage::{UploadedFile, processing::ImageProcessor};

let file = UploadedFile::new("photo.jpg", "image/jpeg", vec![/* ... */]);
let processor = ImageProcessor::new();

// Remove all EXIF metadata
let stripped = processor.strip_exif(&file)?;

pub fn get_dimensions(&self, file: &UploadedFile) -> StorageResult<(u32, u32)>

Gets image dimensions without fully decoding

This is faster than loading the full image when you only need dimensions.

Errors

Returns error if the file is not a valid image

Examples

use acton_htmx::storage::{UploadedFile, processing::ImageProcessor};

let file = UploadedFile::new("photo.jpg", "image/jpeg", vec![/* ... */]);
let processor = ImageProcessor::new();

let (width, height) = processor.get_dimensions(&file)?;
println!("Image is {width}x{height}");

Trait Implementations

impl Clone for ImageProcessor

fn clone(&self) -> ImageProcessor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ImageProcessor

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

Formats the value using the given formatter.

impl Default for ImageProcessor

fn default() -> Self

Returns the “default value” for a type.