# aicon-hub/cam architecture

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

- Interactive diagram: https://gitdiagram.com/aicon-hub/cam
- Repository: https://github.com/aicon-hub/cam

## Overview

CaM is an on-device Android camera app. A creator uses its single camera screen to configure framing and camera controls, capture photos or video, and save media locally. The main activity owns the camera workflow and also contains capture processing, settings, and recording behavior; separate views and a GL processor provide overlays and filtering. The README documents additional camera controls and storage destinations, but their detailed implementation paths are not separately visible in the excerpts.

Main entry points: [`app/src/main/java/app/aicon/cam/MainActivity.java`](https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/MainActivity.java) (Camera screen), [`app/src/main/java/app/aicon/cam/FilterEffect.java`](https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/FilterEffect.java) (Filter renderer), [`app/src/main/java/app/aicon/cam/AspectGuideView.java`](https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/AspectGuideView.java) (Framing guide), [`app/src/main/java/app/aicon/cam/HistogramView.java`](https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/HistogramView.java) (Histogram overlay)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_camera["Camera workflow"]
  node_activity["Camera screen<br/>[MainActivity.java]"]
  node_controls["Camera controls<br/>[MainActivity.java]"]
end

subgraph group_render["Preview and overlays"]
  node_filter["Filter renderer<br/>[FilterEffect.java]"]
  node_guide["Framing guide"]
  node_histogram["Histogram overlay<br/>[HistogramView.java]"]
  node_style["UI styling<br/>[UiStyle.java]"]
end

subgraph group_media["Media output"]
  node_photo["Photo capture<br/>[MainActivity.java]"]
  node_recording["Video recording<br/>[MainActivity.java]"]
  node_localmedia[("Device media")]
end

node_creator(("Creator"))

node_creator -->|"operates"| node_activity
node_activity -->|"configures"| node_controls
node_activity -->|"updates"| node_guide
node_activity -->|"supplies bins"| node_histogram
node_activity -->|"sets filter"| node_filter
node_activity -->|"uses styles"| node_style
node_activity -->|"captures and processes"| node_photo
node_photo -->|"writes photos"| node_localmedia
node_activity -->|"starts or stops"| node_recording
node_recording -->|"saves videos"| node_localmedia

click node_activity "https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/MainActivity.java"
click node_controls "https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/MainActivity.java"
click node_photo "https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/MainActivity.java"
click node_recording "https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/MainActivity.java"
click node_filter "https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/FilterEffect.java"
click node_guide "https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/AspectGuideView.java"
click node_histogram "https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/HistogramView.java"
click node_style "https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/UiStyle.java"

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_activity,node_controls toneBlue
class node_filter,node_guide,node_histogram,node_style toneAmber
class node_photo,node_recording,node_localmedia toneMint
class node_creator toneIndigo
```

## Components

### Camera workflow

- [Camera screen](https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/MainActivity.java): `app/src/main/java/app/aicon/cam/MainActivity.java`
- [Camera controls](https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/MainActivity.java): `app/src/main/java/app/aicon/cam/MainActivity.java`

### Preview and overlays

- [Filter renderer](https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/FilterEffect.java): `app/src/main/java/app/aicon/cam/FilterEffect.java`
- [Framing guide](https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/AspectGuideView.java): `app/src/main/java/app/aicon/cam/AspectGuideView.java`
- [Histogram overlay](https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/HistogramView.java): `app/src/main/java/app/aicon/cam/HistogramView.java`
- [UI styling](https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/UiStyle.java): `app/src/main/java/app/aicon/cam/UiStyle.java`

### Media output

- [Photo capture](https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/MainActivity.java): `app/src/main/java/app/aicon/cam/MainActivity.java`
- [Video recording](https://github.com/aicon-hub/cam/blob/main/app/src/main/java/app/aicon/cam/MainActivity.java): `app/src/main/java/app/aicon/cam/MainActivity.java`
- **Device media**

### Other components

- **Creator**

## Connections

- Creator → Camera screen: operates (evidence: `README.md`)
- Camera screen → Camera controls: configures (evidence: `app/src/main/java/app/aicon/cam/MainActivity.java`)
- Camera screen → Framing guide: updates (evidence: `app/src/main/java/app/aicon/cam/MainActivity.java`)
- Camera screen → Histogram overlay: supplies bins (evidence: `app/src/main/java/app/aicon/cam/MainActivity.java`)
- Camera screen → Filter renderer: sets filter (evidence: `app/src/main/java/app/aicon/cam/MainActivity.java`)
- Camera screen → UI styling: uses styles (evidence: `app/src/main/java/app/aicon/cam/MainActivity.java`)
- Camera screen → Photo capture: captures and processes (evidence: `app/src/main/java/app/aicon/cam/MainActivity.java`)
- Photo capture → Device media: writes photos (evidence: `app/src/main/java/app/aicon/cam/MainActivity.java`)
- Camera screen → Video recording: starts or stops (evidence: `app/src/main/java/app/aicon/cam/MainActivity.java`)
- Video recording → Device media: saves videos (evidence: `README.md`)
