# f0enix/motioncam architecture

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

- Interactive diagram: https://gitdiagram.com/f0enix/motioncam
- Repository: https://github.com/f0enix/motioncam

## Overview

Motion Cam is an Android computational-camera application: users capture RAW bursts or an underexposed frame, then preview and post-process the resulting images. The documented image path combines RAW frames for noise reduction, demosaics and color-corrects, tone-maps, and sharpens; capture also supports zero-shutter-lag and night modes. Android camera controls bridge to native capture and image-processing code, while DNG/JPEG output is saved to Android media storage. The graph combines README-documented capabilities with relationships visible in excerpts and the SOURCE INDEX; unsampled implementation details are not inferred.

Main entry points: [`MotionCam-Android/MotionCam/src/main/java/com/motioncam/processor/ProcessorService.java`](https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/processor/ProcessorService.java) (Processor service), [`libMotionCam/libMotionCam/source/ImageProcessor.cpp`](https://github.com/f0enix/motioncam/blob/main/libMotionCam/libMotionCam/source/ImageProcessor.cpp) (Image processor), [`MotionCam-Android/MotionCam/src/main/java/com/motioncam/ui/PostProcessFragment.java`](https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/ui/PostProcessFragment.java) (Post-process screen), [`MotionCam-Android/MotionCam/src/main/java/com/motioncam/camera/NativeCameraSessionBridge.java`](https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/camera/NativeCameraSessionBridge.java) (Native camera bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture"]
  node_camera_bridge["Native camera bridge"]
  node_capture_sessions["Capture sessions"]
  node_camera_state["Camera state"]
  node_raw_buffers[("RAW buffer manager")]
  node_raw_metadata["RAW metadata<br/>[RawImageMetadata.h]"]
end

subgraph group_processing["Image processing"]
  node_processor_service["Processor service"]
  node_processor_receiver["Progress receiver"]
  node_native_processor["Native processor"]
  node_image_processor["Image processor<br/>[ImageProcessor.cpp]"]
  node_postprocess_generator["Denoise and render"]
  node_preview_pipeline["RAW preview<br/>[CameraPreview.cpp]"]
end

subgraph group_app["Android experience"]
  node_camera_ui["Camera screen"]
  node_camera_controls["Manual controls"]
  node_sensor_orientation["Sensor orientation"]
  node_postprocess_ui["Post-process screen"]
  node_settings["Processing settings"]
end

subgraph group_output["Image output"]
  node_dng_writer["DNG writer<br/>[dng_image_writer.h]"]
  node_media_storage[("Android media storage")]
end

node_user(("Photographer"))
node_camera_device(("Android camera"))

node_user -->|"operates"| node_camera_ui
node_camera_ui -.->|"controls capture"| node_camera_bridge
node_camera_controls -->|"sets exposure"| node_camera_ui
node_sensor_orientation -.->|"provides orientation"| node_camera_bridge
node_camera_bridge -.->|"dispatches capture"| node_capture_sessions
node_camera_device -->|"provides RAW frames"| node_capture_sessions
node_capture_sessions -.->|"queues frames"| node_raw_buffers
node_raw_buffers -->|"stores metadata"| node_raw_metadata
node_raw_buffers -.->|"supplies captured images"| node_processor_service
node_user -->|"selects images"| node_postprocess_ui
node_postprocess_ui -->|"edits parameters"| node_settings
node_postprocess_ui -->|"requests processing"| node_processor_service
node_processor_service -->|"invokes processing"| node_native_processor
node_processor_service -->|"reports progress"| node_processor_receiver
node_native_processor -.->|"processes RAW"| node_image_processor
node_image_processor -.->|"runs algorithms"| node_postprocess_generator
node_postprocess_ui -->|"requests RAW preview"| node_preview_pipeline
node_preview_pipeline -->|"returns preview"| node_camera_bridge
node_processor_service -->|"saves JPEG and DNG"| node_media_storage
node_image_processor -.->|"writes DNG"| node_dng_writer
node_image_processor -.->|"produces image output"| node_media_storage

click node_camera_ui "https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/CameraActivity.java"
click node_camera_controls "https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/camera/CameraManualControl.java"
click node_sensor_orientation "https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/SensorEventManager.java"
click node_camera_bridge "https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/camera/NativeCameraSessionBridge.java"
click node_capture_sessions "https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/cpp/camera/CaptureSessionManager.cpp"
click node_camera_state "https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/cpp/camera/CameraStateManager.cpp"
click node_raw_buffers "https://github.com/f0enix/motioncam/blob/main/libMotionCam/libMotionCam/source/RawBufferManager.cpp"
click node_raw_metadata "https://github.com/f0enix/motioncam/blob/main/libMotionCam/libMotionCam/include/motioncam/RawImageMetadata.h"
click node_postprocess_ui "https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/ui/PostProcessFragment.java"
click node_settings "https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/camera/PostProcessSettings.java"
click node_processor_service "https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/processor/ProcessorService.java"
click node_processor_receiver "https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/processor/ProcessorReceiver.java"
click node_native_processor "https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/processor/NativeProcessor.java"
click node_image_processor "https://github.com/f0enix/motioncam/blob/main/libMotionCam/libMotionCam/source/ImageProcessor.cpp"
click node_postprocess_generator "https://github.com/f0enix/motioncam/blob/main/libMotionCam/libMotionCam/generators/PostProcessGenerator.cpp"
click node_preview_pipeline "https://github.com/f0enix/motioncam/blob/main/libMotionCam/libMotionCam/source/CameraPreview.cpp"
click node_dng_writer "https://github.com/f0enix/motioncam/blob/main/libMotionCam/thirdparty/dng_sdk/dng/dng_image_writer.h"

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_camera_bridge,node_capture_sessions,node_camera_state,node_raw_buffers,node_raw_metadata toneBlue
class node_processor_service,node_processor_receiver,node_native_processor,node_image_processor,node_postprocess_generator,node_preview_pipeline toneAmber
class node_camera_ui,node_camera_controls,node_sensor_orientation,node_postprocess_ui,node_settings toneMint
class node_dng_writer,node_media_storage toneRose
class node_user,node_camera_device toneIndigo
```

## Components

### Capture

- [Native camera bridge](https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/camera/NativeCameraSessionBridge.java): `MotionCam-Android/MotionCam/src/main/java/com/motioncam/camera/NativeCameraSessionBridge.java`
- [Capture sessions](https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/cpp/camera/CaptureSessionManager.cpp): `MotionCam-Android/MotionCam/src/main/cpp/camera/CaptureSessionManager.cpp`
- [Camera state](https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/cpp/camera/CameraStateManager.cpp): `MotionCam-Android/MotionCam/src/main/cpp/camera/CameraStateManager.cpp`
- [RAW buffer manager](https://github.com/f0enix/motioncam/blob/main/libMotionCam/libMotionCam/source/RawBufferManager.cpp): `libMotionCam/libMotionCam/source/RawBufferManager.cpp`
- [RAW metadata](https://github.com/f0enix/motioncam/blob/main/libMotionCam/libMotionCam/include/motioncam/RawImageMetadata.h): `libMotionCam/libMotionCam/include/motioncam/RawImageMetadata.h`

### Image processing

- [Processor service](https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/processor/ProcessorService.java): `MotionCam-Android/MotionCam/src/main/java/com/motioncam/processor/ProcessorService.java`
- [Progress receiver](https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/processor/ProcessorReceiver.java): `MotionCam-Android/MotionCam/src/main/java/com/motioncam/processor/ProcessorReceiver.java`
- [Native processor](https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/processor/NativeProcessor.java): `MotionCam-Android/MotionCam/src/main/java/com/motioncam/processor/NativeProcessor.java`
- [Image processor](https://github.com/f0enix/motioncam/blob/main/libMotionCam/libMotionCam/source/ImageProcessor.cpp): `libMotionCam/libMotionCam/source/ImageProcessor.cpp`
- [Denoise and render](https://github.com/f0enix/motioncam/blob/main/libMotionCam/libMotionCam/generators/PostProcessGenerator.cpp): `libMotionCam/libMotionCam/generators/PostProcessGenerator.cpp`
- [RAW preview](https://github.com/f0enix/motioncam/blob/main/libMotionCam/libMotionCam/source/CameraPreview.cpp): `libMotionCam/libMotionCam/source/CameraPreview.cpp`

### Android experience

- [Camera screen](https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/CameraActivity.java): `MotionCam-Android/MotionCam/src/main/java/com/motioncam/CameraActivity.java`
- [Manual controls](https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/camera/CameraManualControl.java): `MotionCam-Android/MotionCam/src/main/java/com/motioncam/camera/CameraManualControl.java`
- [Sensor orientation](https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/SensorEventManager.java): `MotionCam-Android/MotionCam/src/main/java/com/motioncam/SensorEventManager.java`
- [Post-process screen](https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/ui/PostProcessFragment.java): `MotionCam-Android/MotionCam/src/main/java/com/motioncam/ui/PostProcessFragment.java`
- [Processing settings](https://github.com/f0enix/motioncam/blob/main/MotionCam-Android/MotionCam/src/main/java/com/motioncam/camera/PostProcessSettings.java): `MotionCam-Android/MotionCam/src/main/java/com/motioncam/camera/PostProcessSettings.java`

### Image output

- [DNG writer](https://github.com/f0enix/motioncam/blob/main/libMotionCam/thirdparty/dng_sdk/dng/dng_image_writer.h): `libMotionCam/thirdparty/dng_sdk/dng/dng_image_writer.h`
- **Android media storage**

### Other components

- **Photographer**
- **Android camera**

## Connections

- Photographer → Camera screen: operates
- Camera screen → Native camera bridge: controls capture (evidence: `MotionCam-Android/MotionCam/src/main/java/com/motioncam/CameraActivity.java`)
- Manual controls → Camera screen: sets exposure (evidence: `MotionCam-Android/MotionCam/src/main/java/com/motioncam/CameraActivity.java`)
- Sensor orientation → Native camera bridge: provides orientation
- Native camera bridge → Capture sessions: dispatches capture
- Android camera → Capture sessions: provides RAW frames
- Capture sessions → RAW buffer manager: queues frames
- RAW buffer manager → RAW metadata: stores metadata (evidence: `libMotionCam/libMotionCam/source/RawBufferManager.cpp`)
- RAW buffer manager → Processor service: supplies captured images
- Photographer → Post-process screen: selects images
- Post-process screen → Processing settings: edits parameters (evidence: `MotionCam-Android/MotionCam/src/main/java/com/motioncam/ui/PostProcessFragment.java`)
- Post-process screen → Processor service: requests processing (evidence: `MotionCam-Android/MotionCam/src/main/java/com/motioncam/ui/PostProcessFragment.java`)
- Processor service → Native processor: invokes processing (evidence: `MotionCam-Android/MotionCam/src/main/java/com/motioncam/processor/ProcessorService.java`)
- Processor service → Progress receiver: reports progress (evidence: `MotionCam-Android/MotionCam/src/main/java/com/motioncam/processor/ProcessorService.java`)
- Native processor → Image processor: processes RAW
- Image processor → Denoise and render: runs algorithms
- Post-process screen → RAW preview: requests RAW preview (evidence: `MotionCam-Android/MotionCam/src/main/java/com/motioncam/ui/PostProcessFragment.java`)
- RAW preview → Native camera bridge: returns preview (evidence: `libMotionCam/libMotionCam/source/CameraPreview.cpp`)
- Processor service → Android media storage: saves JPEG and DNG (evidence: `MotionCam-Android/MotionCam/src/main/java/com/motioncam/processor/ProcessorService.java`)
- Image processor → DNG writer: writes DNG
- Image processor → Android media storage: produces image output
