How ekinstrop/unspektrawesome-source works
Unspektrawesome is an Android RAW camera app whose main path is camera selection and RAW stream planning, followed by Camera2 frame acquisition, Vulkan preview processing, and Spektra film rendering; still captures are processed and saved. The map also includes camera preferences and Spektra state/undo persistence. Several subsystems are represented by directory-level nodes because their files are in the tree but their implementations were not sampled; those links are omitted where the available evidence does not establish a call.
Main entry points: RawVulkanPreviewController.kt Preview controller · MainActivity.kt App activity · CameraScreen.kt Camera screen · SpektraStateRepository.kt Film state repository
Components 23
Camera input
- Camera catalog
app/src/main/java/com/unspektrawesome/camera/CameraCatalog.java - Camera descriptors
app/src/main/java/com/unspektrawesome/camera/CameraDescriptor.java - Camera preferences
app/src/main/java/com/unspektrawesome/settings/CameraPreferences.kt - RAW stream planning
app/src/main/java/com/unspektrawesome/preview/RawPreviewPlanSelector.kt - Stream policy
app/src/main/java/com/unspektrawesome/camera/RawPreviewPolicy.java - Camera2 session
app/src/main/java/com/unspektrawesome/camera/session/Camera2RawSession.java
Preview and capture
- Preview view
app/src/main/java/com/unspektrawesome/preview/VulkanRawPreviewView.kt - Preview controller
app/src/main/java/com/unspektrawesome/preview/RawVulkanPreviewController.kt - Capture processing
app/src/main/java/com/unspektrawesome/capture - Vulkan bridge
app/src/main/java/com/unspektrawesome/vulkan/VulkanBridge.kt - Vulkan renderer
app/src/main/java/com/unspektrawesome/vulkan/VulkanRenderer.kt
Spektra processing
- Spektra JNI
app/src/main/cpp/spektrafilm_android_jni.cpp - Native Vulkan renderer
app/src/main/cpp/spektrafilm/src/SpektraVulkanRenderer.cpp - Film parameters
app/src/main/java/com/unspektrawesome/spektra/SpektraFilmParams.kt - Film state
app/src/main/java/com/unspektrawesome/spektra/SpektraState.kt - Film state repository
app/src/main/java/com/unspektrawesome/spektra/SpektraStateRepository.kt - Film persistence
app/src/main/java/com/unspektrawesome/spektra/SpektraStatePersistence.kt
App interface
- App activity
app/src/main/java/com/unspektrawesome/MainActivity.kt - Camera screen
app/src/main/java/com/unspektrawesome/ui/camera/CameraScreen.kt - Film controls
app/src/main/java/com/unspektrawesome/ui/camera/SpektraAdjustmentTray.kt
Other components
- Camera user
- Photo library
- Android camera service
Connections 27
- Camera user → App activity: opens app
README.md - App activity → Camera catalog: loads cameras
app/src/main/java/com/unspektrawesome/MainActivity.kt - App activity → Camera preferences: loads settings
app/src/main/java/com/unspektrawesome/MainActivity.kt - App activity → Camera screen: shows screen
app/src/main/java/com/unspektrawesome/MainActivity.kt - App activity → Preview controller: creates controller
app/src/main/java/com/unspektrawesome/MainActivity.kt - App activity → Film state repository: provides state
app/src/main/java/com/unspektrawesome/MainActivity.kt - Camera screen → Camera preferences: reads settings
app/src/main/java/com/unspektrawesome/ui/camera/CameraScreen.kt - Camera screen → Film state repository: edits film state
app/src/main/java/com/unspektrawesome/ui/camera/CameraScreen.kt - Camera screen → Film controls: shows controls
app/src/main/java/com/unspektrawesome/ui/camera/CameraScreen.kt - Camera screen → RAW stream planning: selects preview
- RAW stream planning → Stream policy: chooses stream
app/src/main/java/com/unspektrawesome/preview/RawPreviewPlanSelector.kt - RAW stream planning → Camera preferences: reads selection
app/src/main/java/com/unspektrawesome/preview/RawPreviewPlanSelector.kt - RAW stream planning → Camera descriptors: checks capabilities
app/src/main/java/com/unspektrawesome/preview/RawPreviewPlanSelector.kt - Preview controller → Camera2 session: starts session
app/src/main/java/com/unspektrawesome/preview/RawVulkanPreviewController.kt - Camera2 session → Android camera service: configures capture
- Preview view → Preview controller: attaches surface
app/src/main/java/com/unspektrawesome/preview/VulkanRawPreviewView.kt - Preview controller → Film state repository: captures state
app/src/main/java/com/unspektrawesome/preview/RawVulkanPreviewController.kt - Preview controller → Film parameters: builds render parameters
app/src/main/java/com/unspektrawesome/preview/RawVulkanPreviewController.kt - Preview controller → Capture processing: prepares capture
app/src/main/java/com/unspektrawesome/preview/RawVulkanPreviewController.kt - Preview controller → Vulkan bridge: renders RAW frame
- Capture processing → Photo library: saves photo
- Vulkan bridge → Vulkan renderer: dispatches rendering
- Vulkan bridge → Spektra JNI: calls native code
- Spektra JNI → Native Vulkan renderer: uses renderer
app/src/main/cpp/spektrafilm_android_jni.cpp - Film state repository → Film persistence: loads and saves
app/src/main/java/com/unspektrawesome/spektra/SpektraStateRepository.kt - Film state repository → Film state: publishes state
app/src/main/java/com/unspektrawesome/spektra/SpektraStateRepository.kt - Film state → Film parameters: holds parameters
app/src/main/java/com/unspektrawesome/spektra/SpektraState.kt