image_forge #

pub package License

Open-source project maintained by the community. Found a bug or want to contribute? PRs and issues are welcome.

Full-featured Rust image processing engine for Flutter — GPU-accelerated filters, face beauty, layer composition, multi-format encoding, mood/swipe presets, LUT support, and GPU preview surface. Runs native Rust on device with SIMD and WGSL compute shaders.

Platform Support #

Quick Start #

import 'package:image_forge/image_forge.dart';

// Resize an image
final thumb = resizeImage(
  bytes: bytes,
  width: 512,
  height: 512,
  algorithm: ResizeAlgorithm.lanczos3,
  format: OutputFormat.jpeg,
  quality: 85,
  fixExif: true,
  backend: ProcessingBackend.auto,
);

// Apply a filter
final filtered = applyFilter(
  bytes: bytes,
  filter: const ImageFilter.brightness(amount: 0.2),
  format: OutputFormat.jpeg,
  quality: 85,
  fixExif: true,
);

// Probe image info without full decode
final info = probeImage(bytes: bytes);
print('${info.width}x${info.height}');

What You Can Do #

• Resize, crop, rotate — Multiple resize algorithms (Lanczos3, Mitchell, CatmullRom, etc.) with batch parallelism.
• Filters & adjustments — Brightness, contrast, saturation, hue, warmth, fade, vignette, highlights, shadows, structure, presets, LUTs.
• Face beauty — Skin smoothing, eye brightening, lip tinting with GPU compute shaders.
• Stickers & drawing — Text, lines, circles, watermark overlays with blend modes (Multiply, Screen, Overlay, Add).
• EXIF handling — Read and fix orientation without re-encoding.
• Multi-format — JPEG, PNG, WebP, AVIF encode/decode.
• Progressive decode — Low-res preview + full-res buffer in one pass.
• GPU compute — wgpu Metal/Vulkan acceleration for resize, blur, sharpen, brightness, contrast, saturation, hue, and beauty passes.
• Buffer pool — Zero-allocation byte vector reuse for render loops.
• Face landmark smoothing — EMA stabilizer for live camera streams.

For the full API, see the Dart API reference.

Pros & Cons #

App Size #

The package bundles native Rust libraries per platform. Size impact by component:

Installation #

flutter pub add image_forge

Prerequisites: A Rust toolchain on your development machine. For Android:

rustup target add aarch64-linux-android armv7-linux-androideabi \
  x86_64-linux-android i686-linux-android

More Examples #

Crop & rotate #

final cropped = cropImage(
  bytes: bytes, x: 100, y: 100, width: 400, height: 300,
  format: OutputFormat.jpeg, quality: 85, fixExif: true,
);

final rotated = rotateImage(
  bytes: bytes, rotation: Rotation.deg90,
  format: OutputFormat.jpeg, quality: 85, fixExif: true,
);

Overlay with blend mode #

final composed = overlayImage(
  baseBytes: photo, overlayBytes: logo,
  x: 40, y: 40, blendMode: BlendMode.multiply,
  format: OutputFormat.png, quality: 100,
);

Progressive decode (low-res preview + full buffer) #

final result = decodeProgressiveImage(bytes, previewMaxEdge: 128, fixExif: true);
// Show result.previewBytes immediately for instant feedback
// Then work with result.fullBuffer for full-resolution editing

GPU detection #

final gpu = gpuComputeInfo();
if (gpu != null) print('GPU: ${gpu.deviceName} (${gpu.backend})');

// Use GPU backend for supported operations
final thumb = resizeImage(
  bytes: bytes, width: 512, height: 512,
  algorithm: ResizeAlgorithm.lanczos3,
  format: OutputFormat.jpeg, quality: 85,
  fixExif: true,
  backend: ProcessingBackend.auto, // auto = GPU if available
);

Contributing #

This package is part of the MediaForge monorepo. Issues and pull requests are welcome on GitHub.

Links #

• GitHub Repository
• Issue Tracker