Photo Cinematic Editor

Professional photo processing and cinematic color grading powered by Pillow + NumPy. Use when a user asks to: (1) Edit, enhance, or retouch photos, (2) Apply cinematic/film color grading, (3) Remove haze or improve clarity, (4) Adjust saturation, vibrance, or exposure, (5) Add light effects, vignette, or film grain. Triggers on keywords like: 调色/修图/照片处理/电影感/通透/去雾/饱和度/自然饱和度/色阶。

Cinematic photo processing toolkit with Pillow + NumPy. Supports HEIC/JPEG/PNG input.

Quick Start

bash

# All-in-one cinematic processing (dehaze → grade → light → sharpen)
python3 scripts/photo_editor.py input.jpg output.jpg

# Custom pipeline
python3 scripts/photo_editor.py input.jpg output.jpg dehaze grade saturation=1.3 light sharpen

Effects Reference

Effect	Params	Description
dehaze	strength=1.0	Local contrast dehazing + clarity
grade	strength=1.0	Cinematic S-curve + teal/orange split tone + glow + vignette
saturation	saturation=1.0	Simple saturation multiplier
vibrance	vibrance=1.0	Smart saturation (boosts muted colors more)
levels	shadows=0 midtones=1.0 highlights=255	Photoshop-style levels adjustment
light	strength=1.0	Warm light streaks + highlight boost
sharpen	strength=1.0	Unsharp mask sharpening
blur	strength=1.0	Gaussian blur (radius in pixels)

All params accept strength=N to control intensity.

Usage Examples

bash

# Dehaze only
python3 scripts/photo_editor.py photo.jpg out.jpg dehaze

# Cinematic from scratch
python3 scripts/photo_editor.py photo.jpg out.jpg grade

# Vibrant cinematic
python3 scripts/photo_editor.py photo.jpg out.jpg dehaze grade saturation=1.2 light sharpen

# Soft natural look
python3 scripts/photo_editor.py photo.jpg out.jpg dehaze grade vibrance=0.85 light=0.6 sharpen

# Manual levels adjustment
python3 scripts/photo_editor.py photo.jpg out.jpg levels shadows=15 midtones=1.1 highlights=240 sharpen

Requirements

bash

pip3 install Pillow numpy pillow-heif --break-system-packages

Scripts

• scripts/photo_editor.py — Main editor with pipeline processing
• scripts/cinematic_grade.py — V1 classic cinematic grading
• scripts/cinematic_v2.py — V2 with dehaze + light texture

References

See references/photo-editing-guide.md for technique explanations and advanced workflows.