Filmr

FilmeR / Film Rust

Filmr is a high-fidelity, physics-based film simulation engine written in Rust. Unlike simple LUT-based filters, Filmr simulates the physical properties of photographic film—from spectral sensitivity and grain structure to chemical development curves—to produce authentic, organic results.

📖 Table of Contents

• Core Features
• Quick Start
• Installation
• Supported Film Stocks
• Project Structure
• License

🚀 Core Features

Filmr implements a comprehensive imaging pipeline that models the physical behavior of analog film:

• 🔬 Spectral Simulation: Accurate modeling of film spectral sensitivity (Panchromatic, Orthochromatic, Infrared) using physical wavelength data.
• 🌾 Physics-Based Grain: Spatially correlated grain synthesis based on RMS granularity and blur radius, simulating the organic texture of silver halide crystals.
• 📈 H-D Curves: Segmented characteristic curves (D-min, D-max, Gamma) for realistic tonal response and density formation.
• ✨ Halation & Bloom: Physical light scattering simulation (Gaussian diffusion) to recreate the signature "glow" of bright highlights on film.
• ⏱️ Reciprocity Failure: Simulation of film speed loss during long exposures (Schwarzschild effect).
• 🎨 30+ Film Presets: Built-in profiles for legendary stocks like Kodak Portra, Tri-X, Fujifilm Velvia, and Kodachrome.
• 📊 Diagnostic Tools: Integrated quality verification and visualization tools for analyzing color science and signal metrics.
• ⚡ High Performance: Parallelized image processing using rayon for fast rendering.

⚡ Quick Start

1. Run the GUI Demo

The interactive GUI allows you to drag-and-drop images and tweak simulation parameters in real-time.

cargo run --example gui_demo --release

2. Generate Diagnostic Charts

Visualize the color response, grain structure, and spectral characteristics of all supported films.

cargo run --example chart_diagnosis --release

Output will be saved to diagnosis_output/contact_sheet.jpg.

📦 Installation

Prerequisites

• Rust Toolchain (1.70 or later)

Steps

1. Clone the repository

   git clone https://github.com/w-mai/filmr.git
   cd filmr
   

2. Build the project

   cargo build --release
   

3. Run tests

   cargo test
   

🎞️ Supported Film Stocks

Filmr includes over 30 calibrated film presets, categorized by type:

📄 License

This project is open source and available under the MIT License.