# hamid101101/depth-player-app architecture

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

- Interactive diagram: https://gitdiagram.com/hamid101101/depth-player-app
- Repository: https://github.com/hamid101101/depth-player-app

## Overview

Depth Player is a desktop viewer for synchronized RGB frames and per-method stereo disparity/depth results. The user selects a sequence and method data, then scrubs or plays frames while adjusting visualization settings; the controller loads and processes the data, and the UI presents the results. Major capabilities also include depth conversion, method management, synchronized display ranges, and zoom/pan/fullscreen viewing. The source excerpts show the main UI/controller boundary and configuration handling; some feature links rely on README documentation.

Main entry points: [`application/controller.py`](https://github.com/hamid101101/depth-player-app/blob/main/application/controller.py) (Sequence loading), [`application/manager_ui.py`](https://github.com/hamid101101/depth-player-app/blob/main/application/manager_ui.py) (Main viewer UI), [`application/assets/compared_methods.json`](https://github.com/hamid101101/depth-player-app/blob/main/application/assets/compared_methods.json) (Method configuration), [`application/assets/parameters.json`](https://github.com/hamid101101/depth-player-app/blob/main/application/assets/parameters.json) (Display parameters)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Desktop interaction"]
  node_entry["App entry<br/>[main.py]"]
  node_ui["Main viewer UI<br/>[manager_ui.py]"]
  node_method_dialog["Method manager<br/>[manager_ui.py]"]
  node_playback["Frame playback<br/>[controller.py]"]
  node_canvases["Image canvases<br/>[manager_ui.py]"]
  node_view_controls["View controls<br/>[manager_ui.py]"]
end

subgraph group_processing["Visualization processing"]
  node_loader["Sequence loading<br/>[controller.py]"]
  node_disparity["Disparity processing<br/>[controller.py]"]
  node_depth["Depth conversion<br/>[controller.py]"]
  node_color_mapping["Color mapping<br/>[controller.py]"]
end

subgraph group_data["Sequence data"]
  node_rgb_frames[("RGB image sequence")]
  node_method_data[("Method disparity files")]
end

subgraph group_settings["Configuration"]
  node_method_config["Method configuration"]
  node_parameters["Display parameters<br/>[parameters.json]"]
  node_dataset_structure["Dataset structure"]
end

node_user(("User"))

node_user -->|"operates"| node_ui
node_entry -->|"creates"| node_ui
node_ui -->|"requests uploads"| node_loader
node_ui -->|"controls frames"| node_playback
node_ui -->|"opens manager"| node_method_dialog
node_ui -->|"sets view"| node_view_controls
node_playback -->|"loads current frame"| node_loader
node_loader -->|"loads images"| node_rgb_frames
node_loader -->|"loads disparity files"| node_method_data
node_loader -->|"reads method paths"| node_method_config
node_loader -->|"reads settings"| node_parameters
node_loader -->|"processes arrays"| node_disparity
node_disparity -.->|"colors disparity"| node_color_mapping
node_depth -.->|"colors depth"| node_color_mapping
node_ui -->|"selects depth mode"| node_depth
node_depth -->|"converts disparity"| node_disparity
node_loader -->|"requests depth mode"| node_depth
node_color_mapping -.->|"renders results"| node_canvases
node_view_controls -->|"zooms and pans"| node_canvases
node_method_dialog -->|"updates methods"| node_method_config
node_ui -->|"saves parameters"| node_parameters
node_loader -.->|"uses dataset layout"| node_dataset_structure

click node_entry "https://github.com/hamid101101/depth-player-app/blob/main/application/main.py"
click node_ui "https://github.com/hamid101101/depth-player-app/blob/main/application/manager_ui.py"
click node_method_dialog "https://github.com/hamid101101/depth-player-app/blob/main/application/manager_ui.py"
click node_playback "https://github.com/hamid101101/depth-player-app/blob/main/application/controller.py"
click node_canvases "https://github.com/hamid101101/depth-player-app/blob/main/application/manager_ui.py"
click node_view_controls "https://github.com/hamid101101/depth-player-app/blob/main/application/manager_ui.py"
click node_loader "https://github.com/hamid101101/depth-player-app/blob/main/application/controller.py"
click node_disparity "https://github.com/hamid101101/depth-player-app/blob/main/application/controller.py"
click node_depth "https://github.com/hamid101101/depth-player-app/blob/main/application/controller.py"
click node_color_mapping "https://github.com/hamid101101/depth-player-app/blob/main/application/controller.py"
click node_method_config "https://github.com/hamid101101/depth-player-app/blob/main/application/assets/compared_methods.json"
click node_parameters "https://github.com/hamid101101/depth-player-app/blob/main/application/assets/parameters.json"
click node_dataset_structure "https://github.com/hamid101101/depth-player-app/blob/main/application/assets/dataset_structure.json"

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_entry,node_ui,node_method_dialog,node_playback,node_canvases,node_view_controls,node_user toneBlue
class node_loader,node_disparity,node_depth,node_color_mapping toneAmber
class node_rgb_frames,node_method_data toneMint
class node_method_config,node_parameters,node_dataset_structure toneRose
```

## Components

### Desktop interaction

- [App entry](https://github.com/hamid101101/depth-player-app/blob/main/application/main.py): `application/main.py`
- [Main viewer UI](https://github.com/hamid101101/depth-player-app/blob/main/application/manager_ui.py): `application/manager_ui.py`
- [Method manager](https://github.com/hamid101101/depth-player-app/blob/main/application/manager_ui.py): `application/manager_ui.py`
- [Frame playback](https://github.com/hamid101101/depth-player-app/blob/main/application/controller.py): `application/controller.py`
- [Image canvases](https://github.com/hamid101101/depth-player-app/blob/main/application/manager_ui.py): `application/manager_ui.py`
- [View controls](https://github.com/hamid101101/depth-player-app/blob/main/application/manager_ui.py): `application/manager_ui.py`

### Visualization processing

- [Sequence loading](https://github.com/hamid101101/depth-player-app/blob/main/application/controller.py): `application/controller.py`
- [Disparity processing](https://github.com/hamid101101/depth-player-app/blob/main/application/controller.py): `application/controller.py`
- [Depth conversion](https://github.com/hamid101101/depth-player-app/blob/main/application/controller.py): `application/controller.py`
- [Color mapping](https://github.com/hamid101101/depth-player-app/blob/main/application/controller.py): `application/controller.py`

### Sequence data

- **RGB image sequence**
- **Method disparity files**

### Configuration

- [Method configuration](https://github.com/hamid101101/depth-player-app/blob/main/application/assets/compared_methods.json): `application/assets/compared_methods.json`
- [Display parameters](https://github.com/hamid101101/depth-player-app/blob/main/application/assets/parameters.json): `application/assets/parameters.json`
- [Dataset structure](https://github.com/hamid101101/depth-player-app/blob/main/application/assets/dataset_structure.json): `application/assets/dataset_structure.json`

### Other components

- **User**

## Connections

- User → Main viewer UI: operates (evidence: `README.md`)
- App entry → Main viewer UI: creates (evidence: `application/main.py`)
- Main viewer UI → Sequence loading: requests uploads (evidence: `application/manager_ui.py`)
- Main viewer UI → Frame playback: controls frames (evidence: `README.md`)
- Main viewer UI → Method manager: opens manager (evidence: `README.md`)
- Main viewer UI → View controls: sets view (evidence: `README.md`)
- Frame playback → Sequence loading: loads current frame (evidence: `application/controller.py`)
- Sequence loading → RGB image sequence: loads images (evidence: `README.md`)
- Sequence loading → Method disparity files: loads disparity files (evidence: `application/controller.py`)
- Sequence loading → Method configuration: reads method paths (evidence: `application/controller.py`)
- Sequence loading → Display parameters: reads settings (evidence: `application/controller.py`)
- Sequence loading → Disparity processing: processes arrays (evidence: `application/controller.py`)
- Disparity processing → Color mapping: colors disparity (evidence: `README.md`)
- Depth conversion → Color mapping: colors depth (evidence: `README.md`)
- Main viewer UI → Depth conversion: selects depth mode (evidence: `application/manager_ui.py`)
- Depth conversion → Disparity processing: converts disparity (evidence: `application/controller.py`)
- Sequence loading → Depth conversion: requests depth mode (evidence: `application/controller.py`)
- Color mapping → Image canvases: renders results (evidence: `README.md`)
- View controls → Image canvases: zooms and pans (evidence: `README.md`)
- Method manager → Method configuration: updates methods (evidence: `README.md`)
- Main viewer UI → Display parameters: saves parameters
- Sequence loading → Dataset structure: uses dataset layout
