Photo Editor with Libraw RAW Processing

A Rust-based photo editor that processes RAW images using the libraw library for professional photography adjustments.

Features

Process RAW image files with 11 adjustment parameters
Full CLI interface with parameter validation
Direct integration with system-installed libraw library
Optimized release build (650KB executable)
Cross-platform compatibility (macOS tested)

Installation

Prerequisites

First install libraw on your system:

macOS:

brew install libraw

Building

# Clone the repository
git clone <repository-url>
cd PhotoEditor/photo_editor

# Build release version
cargo build --release

# Find the executable in:
./target/release/photo_editor

Usage

Basic Usage

./target/release/photo_editor \
  --input input_file.raw \
  --output output_file.jpg \
  --exposure 0.5 \
  --contrast 20 \
  --highlights -10 \
  --shadows 5 \
  --whites 0 \
  --blacks 0 \
  --clarity 10 \
  --vibrance 15 \
  --saturation 5 \
  --temperature 10 \
  --tint 5

CLI Options

Photo Editor v0.1
==================
Input file:  example.raw
Output file: output.jpg
Exposure:    0.0
Contrast:    0
Highlights:  0
Shadows:     0
Whites:      0
Blacks:      0
Clarity:     0
Vibrance:    0
Saturation:  0
Temperature: 0
Tint:        0

Photo Editor - A Rust-based photo editor with RAW image processing capabilities using libraw

Usage: photo_editor [OPTIONS] --input <INPUT> --output <OUTPUT>

Options:
  -i, --input <INPUT>              Input raw image file to process
  -o, --output <OUTPUT>            Output processed image file
      --exposure <EXPOSURE>        Exposure adjustment (-2.0 to 2.0) [default: 0.0]
      --contrast <CONTRAST>        Contrast adjustment (-100 to 100) [default: 0]
      --highlights <HIGHLIGHTS>    Highlights adjustment (-100 to 100) [default: 0]
      --shadows <SHADOWS>          Shadows adjustment (-100 to 100) [default: 0]
      --whites <WHITES>            Whites adjustment (-100 to 100) [default: 0]
      --blacks <BLACKS>            Blacks adjustment (-100 to 100) [default: 0]
      --clarity <CLARITY>          Clarity adjustment (-100 to 100) [default: 0]
      --vibrance <VIBRANCE>        Vibrance adjustment (-100 to 100) [default: 0]
      --saturation <SATURATION>    Saturation adjustment (-100 to 100) [default: 0]
      --temperature <TEMPERATURE>  Temperature adjustment (-100 to 100) [default: 0]
      --tint <TINT>                Tint adjustment (-100 to 100) [default: 0]
  -h, --help                       Print help information
  -V, --version                    Print version information

Example Commands

Basic processing without adjustments:

./target/release/photo_editor \
  --input sample.raw \
  --output output.jpg

Dramatic enhancement with multiple adjustments:

./target/release/photo_editor \
  --input sample.raw \
  --output dramatic_output.jpg \
  --exposure 0.8 \
  --contrast 30 \
  --highlights -20 \
  --shadows 15 \
  --whites 5 \
  --blacks -10 \
  --clarity 25 \
  --vibrance 30 \
  --saturation 20 \
  --temperature 15 \
  --tint 8

Fine-tuning highlights and shadows:

./target/release/photo_editor \
  --input sample.raw \
  --output refined.jpg \
  --highlights -15 \
  --shadows 10 \
  --whites 5 \
  --blacks -5

Advanced configuration with negative exposure:

./target/release/photo_editor \
  --input sample.raw \
  --output processed.jpg \
  --exposure -0.3 \
  --contrast 40 \
  --clarity 15 \
  --vibrance 20

Adjustment Parameters

Parameter	Range	Effect
Exposure	-2.0 to 2.0	Controls overall brightness
Contrast	-100 to 100	Adjusts image contrast
Highlights	-100 to 100	Control highlight recovery
Shadows	-100 to 100	Control shadow detail
Whites	-100 to 100	Control white point
Blacks	-100 to 100	Control black point
Clarity	-100 to 100	Enhances edge definition
Vibrance	-100 to 100	Adjusts color saturation
Saturation	-100 to 100	Controls overall color intensity
Temperature	-100 to 100	Adjusts color temperature
Tint	-100 to 100	Adjusts color tint

Technical Details

Built with Rust for safety and performance
Integrates directly with system-installed libraw C library
Uses Cargo toolchain for dependency management
Optimized for size (650KB executable)
Full error handling and resource cleanup
Cross-platform compatibility with appropriate system dependencies

Requirements

macOS with brew package manager (for libraw installation)
Rust 1.70+ toolchain
libraw C library installed via Homebrew

License

MIT License

4.9 KiB Raw Permalink Blame History