edgefirst-image

High-performance image processing for edge AI inference pipelines.

This crate provides hardware-accelerated image loading, format conversion, resizing, rotation, and cropping operations optimized for ML preprocessing workflows.

Features

• Multiple backends - Automatic selection of fastest available: G2D → OpenGL → CPU
• Format conversion - RGBA, RGB, NV12, NV16, YUYV, GREY, planar formats
• Geometric transforms - Resize, rotate (90° increments), flip, crop
• Zero-copy integration - Works with edgefirst-tensor DMA/SHM buffers
• JPEG/PNG support - Load and save with EXIF orientation handling

Quick Start

use edgefirst_image::{TensorImage, ImageProcessor, Rotation, Flip, Crop, RGBA};

// Load an image
let bytes = std::fs::read("input.jpg")?;
let src = TensorImage::load(&bytes, Some(RGBA), None)?;

// Create processor (auto-selects best backend)
let mut processor = ImageProcessor::new()?;

// Create destination with desired size
let mut dst = TensorImage::new(640, 640, RGBA, None)?;

// Convert with resize, rotation, letterboxing
processor.convert(
    &src,
    &mut dst,
    Rotation::None,
    Flip::None,
    Crop::letterbox(),  // Preserve aspect ratio
)?;

// Save result
dst.save_jpeg("output.jpg", 90)?;

Backends

Supported Formats

Feature Flags

• opengl (default) - Enable OpenGL backend on Linux
• decoder (default) - Enable detection box rendering

Environment Variables

• EDGEFIRST_DISABLE_G2D - Disable G2D backend
• EDGEFIRST_DISABLE_GL - Disable OpenGL backend
• EDGEFIRST_DISABLE_CPU - Disable CPU backend

License

Licensed under the Apache License, Version 2.0. See LICENSE for details.