# 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:**
```bash
brew install libraw
```

### Building

```bash
# 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

```bash
./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:**
```bash
./target/release/photo_editor \
  --input sample.raw \
  --output output.jpg
```

**Dramatic enhancement with multiple adjustments:**
```bash
./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:**
```bash
./target/release/photo_editor \
  --input sample.raw \
  --output refined.jpg \
  --highlights -15 \
  --shadows 10 \
  --whites 5 \
  --blacks -5
```

**Advanced configuration with negative exposure:**
```bash
./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