Update README with installation guide and full parameter reference
This commit is contained in:
monkeyforever2
@@ -1,8 +1,12 @@
|
||||
# Camera Forensic Realism Engine v2
|
||||
# 📷 Camera Forensic Realism Engine v2
|
||||
|
||||
Makes AI-generated images look like they were shot on an **iPhone 15 Pro** by emulating Apple's ISP color science pipeline.
|
||||
|
||||
## Processing Stages
|
||||
> No more "AI look" — this node applies the same sensor artifacts, tone curves, and color science that real camera hardware produces.
|
||||
|
||||
---
|
||||
|
||||
## ✨ Processing Stages
|
||||
|
||||
| # | Stage | What It Does |
|
||||
|---|-------|-------------|
|
||||
@@ -14,14 +18,171 @@ Makes AI-generated images look like they were shot on an **iPhone 15 Pro** by em
|
||||
| 6 | **ISP Sharpening** | Luminance-only unsharp mask (Apple crispness) |
|
||||
| 7 | **Sensor FX** | Subtle luminance noise + gentle f/1.78 vignette |
|
||||
|
||||
## Installation
|
||||
---
|
||||
|
||||
Copy into `ComfyUI/custom_nodes/ComfyUI-CameraForensicRealism/` and restart ComfyUI.
|
||||
## 🚀 Installation
|
||||
|
||||
Node appears under: **image/forensic** -> **Camera Forensic Realism Engine**
|
||||
### Option 1: Git Clone (Recommended)
|
||||
|
||||
## Quick Start
|
||||
Open a terminal and navigate to your ComfyUI custom nodes folder:
|
||||
|
||||
Place after detailers/post-processing, before SaveImage. Defaults are tuned for iPhone 15 Pro Standard style.
|
||||
```bash
|
||||
cd ComfyUI/custom_nodes
|
||||
```
|
||||
|
||||
**No extra dependencies** - uses only numpy + torch (built into ComfyUI).
|
||||
Clone this repository:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MONKEYFOREVER2/ComfyUI-CameraForensicRealism.git
|
||||
```
|
||||
|
||||
Install dependencies:
|
||||
|
||||
```bash
|
||||
cd ComfyUI-CameraForensicRealism
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
Restart ComfyUI.
|
||||
|
||||
### Option 2: Manual Download
|
||||
|
||||
1. Click the green **Code** button at the top of this page
|
||||
2. Select **Download ZIP**
|
||||
3. Extract the ZIP into your `ComfyUI/custom_nodes/` folder
|
||||
4. Make sure the folder is named `ComfyUI-CameraForensicRealism`
|
||||
5. Install dependencies:
|
||||
```bash
|
||||
cd ComfyUI/custom_nodes/ComfyUI-CameraForensicRealism
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
6. Restart ComfyUI
|
||||
|
||||
### Option 3: ComfyUI Manager
|
||||
|
||||
If you have [ComfyUI Manager](https://github.com/ltdrdata/ComfyUI-Manager) installed:
|
||||
|
||||
1. Open ComfyUI Manager
|
||||
2. Click **Install Custom Nodes**
|
||||
3. Search for `Camera Forensic Realism`
|
||||
4. Click **Install**
|
||||
5. Restart ComfyUI
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Finding the Node
|
||||
|
||||
Once installed, find the node in the ComfyUI menu:
|
||||
|
||||
**Right-click** → **Add Node** → **image/forensic** → **Camera Forensic Realism Engine**
|
||||
|
||||
---
|
||||
|
||||
## ⚡ Quick Start
|
||||
|
||||
1. Build your workflow as normal (generate/upscale/detail your image)
|
||||
2. Place the **Camera Forensic Realism Engine** node **after** your detailers/post-processing and **before** SaveImage
|
||||
3. Connect your image output to the node's input
|
||||
4. That's it — defaults are tuned for **iPhone 15 Pro Standard** style
|
||||
|
||||
### Recommended Workflow Position
|
||||
|
||||
```
|
||||
[Generate] → [Upscale] → [FaceDetailer] → [📷 Camera Forensic Realism] → [SaveImage]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Parameters
|
||||
|
||||
### Master Controls
|
||||
| Parameter | Default | Description |
|
||||
|-----------|---------|-------------|
|
||||
| `master_strength` | `0.7` | Scales all effects globally. **0.6–0.8 recommended** |
|
||||
| `seed` | `0` | Random seed for noise reproducibility |
|
||||
|
||||
### Tone Mapping
|
||||
| Parameter | Default | Description |
|
||||
|-----------|---------|-------------|
|
||||
| `enable_tone_mapping` | `True` | iPhone S-curve: lifts shadows, compresses highlights |
|
||||
| `tone_strength` | `0.6` | Tone curve intensity (0.5–0.7 = natural iPhone) |
|
||||
| `highlight_rolloff` | `0.5` | Smooth highlight compression — prevents blown whites |
|
||||
| `shadow_lift` | `0.4` | Raises black level — iPhone never crushes pure black |
|
||||
| `contrast` | `0.5` | Mid-tone contrast punch |
|
||||
|
||||
### Display P3 Color
|
||||
| Parameter | Default | Description |
|
||||
|-----------|---------|-------------|
|
||||
| `enable_p3_color` | `True` | Wider gamut rendering via CIE XYZ transform |
|
||||
| `color_strength` | `0.5` | P3 color rendering intensity |
|
||||
| `color_saturation` | `0.3` | Gamut saturation boost — keep low for realism |
|
||||
| `color_warmth` | `0.3` | Apple warm color bias |
|
||||
|
||||
### Smart HDR
|
||||
| Parameter | Default | Description |
|
||||
|-----------|---------|-------------|
|
||||
| `enable_local_tone` | `True` | Local contrast like Apple's multi-frame HDR |
|
||||
| `local_tone_strength` | `0.35` | Local contrast / HDR intensity |
|
||||
| `detail_boost` | `0.4` | Micro-detail enhancement — texture pop |
|
||||
|
||||
### Real Tone (Skin)
|
||||
| Parameter | Default | Description |
|
||||
|-----------|---------|-------------|
|
||||
| `enable_skin_rendering` | `True` | Natural warm skin — prevents orange cast |
|
||||
| `skin_strength` | `0.5` | Skin rendering intensity |
|
||||
| `skin_warmth` | `0.4` | Skin warmth / natural glow |
|
||||
|
||||
### Deep Fusion
|
||||
| Parameter | Default | Description |
|
||||
|-----------|---------|-------------|
|
||||
| `enable_deep_fusion` | `True` | High-freq texture crunch (fabric, pores) |
|
||||
| `fusion_strength` | `0.6` | Texture amplification strength |
|
||||
| `fusion_texture_freq` | `0.5` | Which texture thicknesses get enhanced |
|
||||
|
||||
### White Balance
|
||||
| Parameter | Default | Description |
|
||||
|-----------|---------|-------------|
|
||||
| `enable_white_balance` | `True` | iPhone AWB — warm daylight bias |
|
||||
| `wb_strength` | `0.5` | White balance correction strength |
|
||||
| `wb_temperature` | `0.25` | Cool (blue) ← → Warm (orange). iPhone ≈ 0.2–0.3 |
|
||||
| `wb_tint` | `0.0` | Green ← → Magenta. 0 = neutral |
|
||||
|
||||
### Color Grading
|
||||
| Parameter | Default | Description |
|
||||
|-----------|---------|-------------|
|
||||
| `enable_color_grading` | `True` | Blue-tinted blacks + warm golden highlights |
|
||||
| `blue_shadows` | `0.4` | Blue tint in darks — the iPhone blue-black look |
|
||||
| `warm_highlights` | `0.3` | Golden warmth in brights |
|
||||
|
||||
### ISP Sharpening
|
||||
| Parameter | Default | Description |
|
||||
|-----------|---------|-------------|
|
||||
| `enable_sharpening` | `True` | Apple-style luminance sharpening |
|
||||
| `sharpen_strength` | `0.3` | Sharpening intensity |
|
||||
|
||||
### Sensor FX
|
||||
| Parameter | Default | Description |
|
||||
|-----------|---------|-------------|
|
||||
| `enable_sensor` | `True` | Subtle luminance noise + lens vignette |
|
||||
| `sensor_strength` | `0.25` | Overall sensor effect intensity |
|
||||
| `sensor_noise` | `0.3` | Luminance noise — very subtle on iPhone |
|
||||
| `sensor_vignette` | `0.4` | Lens vignette — f/1.78 falloff |
|
||||
|
||||
---
|
||||
|
||||
## 📋 Requirements
|
||||
|
||||
- **ComfyUI** (latest version recommended)
|
||||
- **Python 3.10+**
|
||||
- **numpy** and **torch** (already included with ComfyUI)
|
||||
- Additional dependencies listed in `requirements.txt`
|
||||
|
||||
---
|
||||
|
||||
## 🤝 Contributing
|
||||
|
||||
Pull requests are welcome! If you'd like to add new camera profiles or improve the processing pipeline, feel free to open an issue or PR.
|
||||
|
||||
## 📄 License
|
||||
|
||||
MIT License — free to use, modify, and distribute.
|
||||
|
||||
Reference in New Issue
Block a user