# thetechgeekko/spektrafilm-android architecture

> Architecture diagram of the GitHub repository thetechgeekko/spektrafilm-android, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/thetechgeekko/spektrafilm-android
- Repository: https://github.com/thetechgeekko/spektrafilm-android

## Overview

Spektrafilm for Android is a photo editor that applies a physically based negative-to-scan film simulation, with RAW/photo import, creative and local adjustments, and export. The main workflow is source selection and decoding, image preparation, profile and parameter selection, rendering, then editing and file or LUT export; saved sidecar edits are restored when reopening. The README documents the analog stages and major editing/export capabilities. Source excerpts are partial, so links for unsampled subsystems rely on README statements and are kept at subsystem level.

Main entry points: [`app/src/main/java/com/spectrafilm/app/MainActivity.kt`](https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/MainActivity.kt) (Editor UI), [`engine/spektra-core/src/main/cpp/spektra.cpp`](https://github.com/thetechgeekko/spektrafilm-android/blob/main/engine/spektra-core/src/main/cpp/spektra.cpp) (Native render engine), [`engine/spektra-core/src/main/kotlin/com/spectrafilm/engine/SpektraEngine.kt`](https://github.com/thetechgeekko/spektrafilm-android/blob/main/engine/spektra-core/src/main/kotlin/com/spectrafilm/engine/SpektraEngine.kt) (Engine facade), [`app/src/main/java/com/spectrafilm/app/ImagePipeline.kt`](https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/ImagePipeline.kt) (Image export pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Import and editing"]
  node_editor["Editor UI<br/>[MainActivity.kt]"]
  node_source["Source selection<br/>[SourceAccess.kt]"]
  node_raw["RAW decoding<br/>[RawDecoder.kt]"]
  node_imageprep["Image preparation<br/>[EngineHelpers.kt]"]
end

subgraph group_film["Film simulation"]
  node_profiles["Film and paper profiles<br/>[StockCatalog.kt]"]
  node_looks["Presets and recipes<br/>[Presets.kt]"]
  node_params["Render parameters<br/>[SpektraParams.kt]"]
  node_holder["Engine owner<br/>[EngineHolder.kt]"]
  node_facade["Engine facade<br/>[SpektraEngine.kt]"]
  node_native["Native render engine<br/>[spektra.cpp]"]
  node_negative["Negative filming<br/>[filming.cpp]"]
  node_enlarger["Enlarger printing<br/>[printing.cpp]"]
  node_scan["Scanner output<br/>[scanning.cpp]"]
end

subgraph group_adjust["Creative adjustments"]
  node_preview["Interactive preview<br/>[Viewer.kt]"]
  node_grade["Tone and color edits<br/>[ColorGrade.kt]"]
  node_masks["Local masks<br/>[MaskCompositor.kt]"]
  node_whitebalance["White balance<br/>[ColorManagement.kt]"]
end

subgraph group_outputs["Persistence and export"]
  node_recipes[("Saved sidecar edits<br/>[Recipes.kt]")]
  node_export["Export coordinator"]
  node_pipeline["Image export pipeline<br/>[ImagePipeline.kt]"]
  node_png["PNG writer<br/>[PngWriter.kt]"]
  node_tiff["TIFF writer<br/>[TiffWriter.kt]"]
  node_lut["3D LUT export<br/>[ClfWriter.kt]"]
end

node_person(("Photographer"))
node_files["Photo files"]

node_person -->|"edits in"| node_editor
node_person -->|"chooses photo"| node_source
node_source -->|"decodes RAW"| node_raw
node_source -.->|"provides image"| node_imageprep
node_raw -->|"provides decoded data"| node_imageprep
node_editor -->|"selects stock"| node_profiles
node_editor -->|"chooses look"| node_looks
node_profiles -->|"configures simulation"| node_params
node_looks -.->|"sets parameters"| node_params
node_imageprep -->|"supplies image"| node_facade
node_holder -->|"creates and shares"| node_facade
node_facade -->|"invokes native engine"| node_native
node_params -->|"configures render"| node_native
node_native -->|"runs filming"| node_negative
node_native -->|"runs printing"| node_enlarger
node_native -->|"runs scanning"| node_scan
node_facade -.->|"returns render"| node_preview
node_preview -.->|"displays for editing"| node_grade
node_editor -->|"sets creative edits"| node_grade
node_editor -->|"sets local edits"| node_masks
node_editor -->|"sets balance"| node_whitebalance
node_grade -->|"combines with local edits"| node_masks
node_editor -->|"saves edits"| node_recipes
node_recipes -->|"restores edits"| node_editor
node_editor -.->|"starts export"| node_export
node_export -->|"requests render"| node_facade
node_export -.->|"publishes output"| node_pipeline
node_pipeline -->|"writes PNG"| node_png
node_pipeline -->|"writes TIFF"| node_tiff
node_editor -->|"bakes engine look"| node_lut
node_pipeline -->|"writes image files"| node_files
node_lut -->|"writes LUT"| node_files

click node_editor "https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/MainActivity.kt"
click node_source "https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/SourceAccess.kt"
click node_raw "https://github.com/thetechgeekko/spektrafilm-android/blob/main/lib/libraw/src/main/kotlin/com/spectrafilm/libraw/RawDecoder.kt"
click node_imageprep "https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/EngineHelpers.kt"
click node_profiles "https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/StockCatalog.kt"
click node_looks "https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/Presets.kt"
click node_params "https://github.com/thetechgeekko/spektrafilm-android/blob/main/engine/spektra-core/src/main/kotlin/com/spectrafilm/engine/SpektraParams.kt"
click node_holder "https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/EngineHolder.kt"
click node_facade "https://github.com/thetechgeekko/spektrafilm-android/blob/main/engine/spektra-core/src/main/kotlin/com/spectrafilm/engine/SpektraEngine.kt"
click node_native "https://github.com/thetechgeekko/spektrafilm-android/blob/main/engine/spektra-core/src/main/cpp/spektra.cpp"
click node_negative "https://github.com/thetechgeekko/spektrafilm-android/blob/main/engine/spektra-core/src/main/cpp/runtime/stages/filming.cpp"
click node_enlarger "https://github.com/thetechgeekko/spektrafilm-android/blob/main/engine/spektra-core/src/main/cpp/runtime/stages/printing.cpp"
click node_scan "https://github.com/thetechgeekko/spektrafilm-android/blob/main/engine/spektra-core/src/main/cpp/runtime/stages/scanning.cpp"
click node_preview "https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/Viewer.kt"
click node_grade "https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/ColorGrade.kt"
click node_masks "https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/masks/MaskCompositor.kt"
click node_whitebalance "https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/ColorManagement.kt"
click node_recipes "https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/Recipes.kt"
click node_export "https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/ExportWorkRuntime.kt"
click node_pipeline "https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/ImagePipeline.kt"
click node_png "https://github.com/thetechgeekko/spektrafilm-android/blob/main/lib/pngwriter/src/main/kotlin/com/spectrafilm/pngwriter/PngWriter.kt"
click node_tiff "https://github.com/thetechgeekko/spektrafilm-android/blob/main/lib/tiffwriter/src/main/kotlin/com/spectrafilm/tiffwriter/TiffWriter.kt"
click node_lut "https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/ClfWriter.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_editor,node_source,node_raw,node_imageprep toneBlue
class node_profiles,node_looks,node_params,node_holder,node_facade,node_native,node_negative,node_enlarger,node_scan toneAmber
class node_preview,node_grade,node_masks,node_whitebalance toneMint
class node_recipes,node_export,node_pipeline,node_png,node_tiff,node_lut toneRose
class node_person,node_files toneIndigo
```

## Components

### Import and editing

- [Editor UI](https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/MainActivity.kt): `app/src/main/java/com/spectrafilm/app/MainActivity.kt`
- [Source selection](https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/SourceAccess.kt): `app/src/main/java/com/spectrafilm/app/SourceAccess.kt`
- [RAW decoding](https://github.com/thetechgeekko/spektrafilm-android/blob/main/lib/libraw/src/main/kotlin/com/spectrafilm/libraw/RawDecoder.kt): `lib/libraw/src/main/kotlin/com/spectrafilm/libraw/RawDecoder.kt`
- [Image preparation](https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/EngineHelpers.kt): `app/src/main/java/com/spectrafilm/app/EngineHelpers.kt`

### Film simulation

- [Film and paper profiles](https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/StockCatalog.kt): `app/src/main/java/com/spectrafilm/app/StockCatalog.kt`
- [Presets and recipes](https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/Presets.kt): `app/src/main/java/com/spectrafilm/app/Presets.kt`
- [Render parameters](https://github.com/thetechgeekko/spektrafilm-android/blob/main/engine/spektra-core/src/main/kotlin/com/spectrafilm/engine/SpektraParams.kt): `engine/spektra-core/src/main/kotlin/com/spectrafilm/engine/SpektraParams.kt`
- [Engine owner](https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/EngineHolder.kt): `app/src/main/java/com/spectrafilm/app/EngineHolder.kt`
- [Engine facade](https://github.com/thetechgeekko/spektrafilm-android/blob/main/engine/spektra-core/src/main/kotlin/com/spectrafilm/engine/SpektraEngine.kt): `engine/spektra-core/src/main/kotlin/com/spectrafilm/engine/SpektraEngine.kt`
- [Native render engine](https://github.com/thetechgeekko/spektrafilm-android/blob/main/engine/spektra-core/src/main/cpp/spektra.cpp): `engine/spektra-core/src/main/cpp/spektra.cpp`
- [Negative filming](https://github.com/thetechgeekko/spektrafilm-android/blob/main/engine/spektra-core/src/main/cpp/runtime/stages/filming.cpp): `engine/spektra-core/src/main/cpp/runtime/stages/filming.cpp`
- [Enlarger printing](https://github.com/thetechgeekko/spektrafilm-android/blob/main/engine/spektra-core/src/main/cpp/runtime/stages/printing.cpp): `engine/spektra-core/src/main/cpp/runtime/stages/printing.cpp`
- [Scanner output](https://github.com/thetechgeekko/spektrafilm-android/blob/main/engine/spektra-core/src/main/cpp/runtime/stages/scanning.cpp): `engine/spektra-core/src/main/cpp/runtime/stages/scanning.cpp`

### Creative adjustments

- [Interactive preview](https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/Viewer.kt): `app/src/main/java/com/spectrafilm/app/Viewer.kt`
- [Tone and color edits](https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/ColorGrade.kt): `app/src/main/java/com/spectrafilm/app/ColorGrade.kt`
- [Local masks](https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/masks/MaskCompositor.kt): `app/src/main/java/com/spectrafilm/app/masks/MaskCompositor.kt`
- [White balance](https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/ColorManagement.kt): `app/src/main/java/com/spectrafilm/app/ColorManagement.kt`

### Persistence and export

- [Saved sidecar edits](https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/Recipes.kt): `app/src/main/java/com/spectrafilm/app/Recipes.kt`
- [Export coordinator](https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/ExportWorkRuntime.kt): `app/src/main/java/com/spectrafilm/app/ExportWorkRuntime.kt`
- [Image export pipeline](https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/ImagePipeline.kt): `app/src/main/java/com/spectrafilm/app/ImagePipeline.kt`
- [PNG writer](https://github.com/thetechgeekko/spektrafilm-android/blob/main/lib/pngwriter/src/main/kotlin/com/spectrafilm/pngwriter/PngWriter.kt): `lib/pngwriter/src/main/kotlin/com/spectrafilm/pngwriter/PngWriter.kt`
- [TIFF writer](https://github.com/thetechgeekko/spektrafilm-android/blob/main/lib/tiffwriter/src/main/kotlin/com/spectrafilm/tiffwriter/TiffWriter.kt): `lib/tiffwriter/src/main/kotlin/com/spectrafilm/tiffwriter/TiffWriter.kt`
- [3D LUT export](https://github.com/thetechgeekko/spektrafilm-android/blob/main/app/src/main/java/com/spectrafilm/app/ClfWriter.kt): `app/src/main/java/com/spectrafilm/app/ClfWriter.kt`

### Other components

- **Photographer**
- **Photo files**

## Connections

- Photographer → Editor UI: edits in (evidence: `README.md`)
- Photographer → Source selection: chooses photo (evidence: `README.md`)
- Source selection → RAW decoding: decodes RAW (evidence: `README.md`)
- Source selection → Image preparation: provides image
- RAW decoding → Image preparation: provides decoded data (evidence: `app/src/main/java/com/spectrafilm/app/EngineHelpers.kt`)
- Editor UI → Film and paper profiles: selects stock (evidence: `README.md`)
- Editor UI → Presets and recipes: chooses look (evidence: `README.md`)
- Film and paper profiles → Render parameters: configures simulation (evidence: `README.md`)
- Presets and recipes → Render parameters: sets parameters
- Image preparation → Engine facade: supplies image (evidence: `engine/spektra-core/src/main/kotlin/com/spectrafilm/engine/SpektraEngine.kt`)
- Engine owner → Engine facade: creates and shares (evidence: `app/src/main/java/com/spectrafilm/app/EngineHolder.kt`)
- Engine facade → Native render engine: invokes native engine (evidence: `engine/spektra-core/src/main/kotlin/com/spectrafilm/engine/SpektraEngine.kt`)
- Render parameters → Native render engine: configures render (evidence: `engine/spektra-core/src/main/kotlin/com/spectrafilm/engine/SpektraParams.kt`)
- Native render engine → Negative filming: runs filming (evidence: `README.md`)
- Native render engine → Enlarger printing: runs printing (evidence: `README.md`)
- Native render engine → Scanner output: runs scanning (evidence: `README.md`)
- Engine facade → Interactive preview: returns render
- Interactive preview → Tone and color edits: displays for editing
- Editor UI → Tone and color edits: sets creative edits (evidence: `README.md`)
- Editor UI → Local masks: sets local edits (evidence: `README.md`)
- Editor UI → White balance: sets balance (evidence: `README.md`)
- Tone and color edits → Local masks: combines with local edits (evidence: `README.md`)
- Editor UI → Saved sidecar edits: saves edits (evidence: `README.md`)
- Saved sidecar edits → Editor UI: restores edits (evidence: `README.md`)
- Editor UI → Export coordinator: starts export
- Export coordinator → Engine facade: requests render (evidence: `app/src/main/java/com/spectrafilm/app/ExportWorkRuntime.kt`)
- Export coordinator → Image export pipeline: publishes output
- Image export pipeline → PNG writer: writes PNG (evidence: `app/src/main/java/com/spectrafilm/app/ImagePipeline.kt`)
- Image export pipeline → TIFF writer: writes TIFF (evidence: `app/src/main/java/com/spectrafilm/app/ImagePipeline.kt`)
- Editor UI → 3D LUT export: bakes engine look (evidence: `README.md`)
- Image export pipeline → Photo files: writes image files (evidence: `README.md`)
- 3D LUT export → Photo files: writes LUT (evidence: `README.md`)
