How thetechgeekko/spektrafilm-android works
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: MainActivity.kt Editor UI · spektra.cpp Native render engine · SpektraEngine.kt Engine facade · ImagePipeline.kt Image export pipeline
Components 25
Import and editing
- Editor UI
app/src/main/java/com/spectrafilm/app/MainActivity.kt - Source selection
app/src/main/java/com/spectrafilm/app/SourceAccess.kt - RAW decoding
lib/libraw/src/main/kotlin/com/spectrafilm/libraw/RawDecoder.kt - Image preparation
app/src/main/java/com/spectrafilm/app/EngineHelpers.kt
Film simulation
- Film and paper profiles
app/src/main/java/com/spectrafilm/app/StockCatalog.kt - Presets and recipes
app/src/main/java/com/spectrafilm/app/Presets.kt - Render parameters
engine/spektra-core/src/main/kotlin/com/spectrafilm/engine/SpektraParams.kt - Engine owner
app/src/main/java/com/spectrafilm/app/EngineHolder.kt - Engine facade
engine/spektra-core/src/main/kotlin/com/spectrafilm/engine/SpektraEngine.kt - Native render engine
engine/spektra-core/src/main/cpp/spektra.cpp - Negative filming
engine/spektra-core/src/main/cpp/runtime/stages/filming.cpp - Enlarger printing
engine/spektra-core/src/main/cpp/runtime/stages/printing.cpp - Scanner output
engine/spektra-core/src/main/cpp/runtime/stages/scanning.cpp
Creative adjustments
- Interactive preview
app/src/main/java/com/spectrafilm/app/Viewer.kt - Tone and color edits
app/src/main/java/com/spectrafilm/app/ColorGrade.kt - Local masks
app/src/main/java/com/spectrafilm/app/masks/MaskCompositor.kt - White balance
app/src/main/java/com/spectrafilm/app/ColorManagement.kt
Persistence and export
- Saved sidecar edits
app/src/main/java/com/spectrafilm/app/Recipes.kt - Export coordinator
app/src/main/java/com/spectrafilm/app/ExportWorkRuntime.kt - Image export pipeline
app/src/main/java/com/spectrafilm/app/ImagePipeline.kt - PNG writer
lib/pngwriter/src/main/kotlin/com/spectrafilm/pngwriter/PngWriter.kt - TIFF writer
lib/tiffwriter/src/main/kotlin/com/spectrafilm/tiffwriter/TiffWriter.kt - 3D LUT export
app/src/main/java/com/spectrafilm/app/ClfWriter.kt
Other components
- Photographer
- Photo files
Connections 32
- Photographer → Editor UI: edits in
README.md - Photographer → Source selection: chooses photo
README.md - Source selection → RAW decoding: decodes RAW
README.md - Source selection → Image preparation: provides image
- RAW decoding → Image preparation: provides decoded data
app/src/main/java/com/spectrafilm/app/EngineHelpers.kt - Editor UI → Film and paper profiles: selects stock
README.md - Editor UI → Presets and recipes: chooses look
README.md - Film and paper profiles → Render parameters: configures simulation
README.md - Presets and recipes → Render parameters: sets parameters
- Image preparation → Engine facade: supplies image
engine/spektra-core/src/main/kotlin/com/spectrafilm/engine/SpektraEngine.kt - Engine owner → Engine facade: creates and shares
app/src/main/java/com/spectrafilm/app/EngineHolder.kt - Engine facade → Native render engine: invokes native engine
engine/spektra-core/src/main/kotlin/com/spectrafilm/engine/SpektraEngine.kt - Render parameters → Native render engine: configures render
engine/spektra-core/src/main/kotlin/com/spectrafilm/engine/SpektraParams.kt - Native render engine → Negative filming: runs filming
README.md - Native render engine → Enlarger printing: runs printing
README.md - Native render engine → Scanner output: runs scanning
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
README.md - Editor UI → Local masks: sets local edits
README.md - Editor UI → White balance: sets balance
README.md - Tone and color edits → Local masks: combines with local edits
README.md - Editor UI → Saved sidecar edits: saves edits
README.md - Saved sidecar edits → Editor UI: restores edits
README.md - Editor UI → Export coordinator: starts export
- Export coordinator → Engine facade: requests render
app/src/main/java/com/spectrafilm/app/ExportWorkRuntime.kt - Export coordinator → Image export pipeline: publishes output
- Image export pipeline → PNG writer: writes PNG
app/src/main/java/com/spectrafilm/app/ImagePipeline.kt - Image export pipeline → TIFF writer: writes TIFF
app/src/main/java/com/spectrafilm/app/ImagePipeline.kt - Editor UI → 3D LUT export: bakes engine look
README.md - Image export pipeline → Photo files: writes image files
README.md - 3D LUT export → Photo files: writes LUT
README.md