# Spectral — Full Documentation & Technical Reference

> Spectral is a high-performance, privacy-first, client-side RAW photo editor and 3D LUT color grading tool that executes entirely within the browser via WebGL and WebAssembly.

---

## 1. Core Architecture & Privacy Principles

### 100% Local Execution
- **Zero Server Uploads**: Image data never crosses the network. All decoding, color science transformations, and rendering happen within the local browser runtime.
- **WebGL Rendering Pipeline**: Uses WebGL fragment shaders with multi-pass framebuffers for real-time 60fps adjustments, histogram computation, and LUT application.
- **Local Storage**: Projects, history snapshots, and custom LUT collections are stored on-device using IndexedDB and the Origin Private File System (OPFS).
- **Offline / PWA**: Functions completely offline once cached by the Service Worker.

---

## 2. Image Processing & Color Science

### Supported File Formats
- **Standard Raster**: JPEG, PNG, WebP, AVIF
- **RAW Camera Formats**: DNG, CR2, NEF, ARW, ORF, RW2 (decoded client-side)
- **Color Profiles**: Adobe RGB, sRGB, Display P3, Rec. 709, Rec. 2020

### Color Adjustments & Tone Controls
1. **Light & Exposure**:
   - Exposure (-5.0 EV to +5.0 EV)
   - Contrast (-100 to +100)
   - Highlights & Shadows (-100 to +100)
   - Whites & Blacks (-100 to +100)
2. **Color & Balance**:
   - Temperature (2000K to 12000K)
   - Tint (-100 to +100)
   - Vibrance & Saturation (-100 to +100)
   - 8-Channel HSL (Hue, Saturation, Luminance per channel)
3. **Tone Curves**:
   - Parametric & point curves for RGB composite and Red, Green, Blue individual channels.
4. **Color Grading & Split Toning**:
   - 3-Way color grading wheels (Shadows, Midtones, Highlights) with hue, saturation, and luminance offset.
5. **3D LUT Engine**:
   - Full support for industry-standard `.cube` files (17x17x17 up to 65x65x65 grids).
   - Real-time trilinear interpolation via 3D textures in WebGL 2.0 (with 2D texture atlas fallback for WebGL 1).
   - Adjustable LUT opacity/intensity (0% to 100%).
6. **Effects & Details**:
   - Procedural Film Grain (Amount, Size, Roughness)
   - Vignette (Amount, Midpoint, Feather, Roundness)
   - Unsharp Mask / Detail Sharpening
   - Dehaze & Clarity algorithms

---

## 3. Keyboard Shortcuts

| Action | Shortcut (Mac) | Shortcut (Windows/Linux) |
|---|---|---|
| Open Image | `Cmd + O` | `Ctrl + O` |
| Export Image | `Cmd + S` / `Cmd + E` | `Ctrl + S` / `Ctrl + E` |
| Undo | `Cmd + Z` | `Ctrl + Z` |
| Redo | `Cmd + Shift + Z` | `Ctrl + Shift + Z` |
| Toggle Before/After | `\` | `\` |
| Fit to Screen | `Cmd + 0` | `Ctrl + 0` |
| Zoom to 100% (1:1) | `Cmd + 1` | `Ctrl + 1` |
| Reset Current Slider | Double-click slider | Double-click slider |
| Reset All Adjustments | `Cmd + Shift + R` | `Ctrl + Shift + R` |
| Crop Tool | `C` | `C` |
| Copy Settings | `Cmd + Shift + C` | `Ctrl + Shift + C` |
| Paste Settings | `Cmd + Shift + V` | `Ctrl + Shift + V` |
| Select All (Library) | `Cmd + A` | `Ctrl + A` |
| Delete Selected (Library) | `⌫` | `Delete` |
| Import Photos (Library) | `Cmd + I` | `Ctrl + I` |
| Open Photo (Library) | `Enter` | `Enter` |
| Toggle Sidebars / Fullscreen | `Tab` / `F` | `Tab` / `F` |

---

## 4. Monetization & Licensing

- **Free Core Version**: Access to complete editing suite, RAW processing, tone controls, curve adjustments, and standard export.
- **Pro Lifetime License**: A single, one-time payment for lifetime access to advanced features (batch processing, unlimited custom LUT libraries, high-resolution EXIF preservations).
- **Zero Subscriptions**: Spectral explicitly rejects monthly or annual subscription models.

---

## 5. Official Web Endpoints

- **Application Root**: https://spectral.platvlak.com/
- **Web Photo Editor**: https://spectral.platvlak.com/editor
- **Community Recipes**: https://spectral.platvlak.com/community
- **Changelog**: https://spectral.platvlak.com/changelog
- **Privacy Policy**: https://spectral.platvlak.com/privacy
- **Terms**: https://spectral.platvlak.com/terms
- **About**: https://spectral.platvlak.com/about
- **Machine Context**: https://spectral.platvlak.com/llms.txt