# orama-interactive/pixelorama architecture

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

- Interactive diagram: https://gitdiagram.com/orama-interactive/pixelorama
- Repository: https://github.com/orama-interactive/pixelorama

## Overview

Pixelorama is a Godot-based pixel-art editor for creating sprites, tiles, and animations. The main workflow is user input through the editor and its tools, editing a layered project, then importing or saving/exporting artwork. The graph preserves documented branches for animation, palettes, effects, tilemaps, 3D layers, extensions, and customization. The supplied source excerpts cover installer-localization utilities, not the runtime; runtime paths and capability links therefore rely on the repository tree and README, and uncertain internal call wiring is omitted.

Main entry points: [`src/UI`](https://github.com/orama-interactive/pixelorama/tree/master/src/UI) (Editor UI), [`src/Tools`](https://github.com/orama-interactive/pixelorama/tree/master/src/Tools) (Drawing Tools), [`src/Autoload/OpenSave.gd`](https://github.com/orama-interactive/pixelorama/blob/master/src/Autoload/OpenSave.gd) (Project Files), [`src/Autoload/Export.gd`](https://github.com/orama-interactive/pixelorama/blob/master/src/Autoload/Export.gd) (Export)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editing["Editing"]
  node_editor["Editor UI"]
  node_tools["Drawing Tools"]
  node_draw_algos["Drawing Algorithms<br/>[DrawingAlgos.gd]"]
end

subgraph group_project["Project Model"]
  node_project["Artwork Project<br/>[Project.gd]"]
  node_layers["Layer Types"]
  node_cels["Cel Types"]
end

subgraph group_io["Import Export"]
  node_import["Import<br/>[Import.gd]"]
  node_open_save["Project Files<br/>[OpenSave.gd]"]
  node_export["Export<br/>[Export.gd]"]
  node_animation_export["Animation Exporters"]
end

subgraph group_capabilities["Creative Features"]
  node_timeline["Animation Timeline"]
  node_tilemap["Tilemap Layers<br/>[CelTileMap.gd]"]
  node_three_d["3D Tools"]
  node_effects["Image Effects<br/>[ImageEffect.gd]"]
  node_palettes["Palette Manager<br/>[Palettes.gd]"]
  node_extensions["Extensions API<br/>[ExtensionsApi.gd]"]
end

subgraph group_customization["Customization"]
  node_preferences["Preferences"]
  node_shortcuts["Shortcut Profiles"]
end

node_artist(("Artist"))
node_external_files["Artwork Files"]

node_artist -->|"uses"| node_editor
node_editor -->|"selects tools"| node_tools
node_tools -->|"uses algorithms"| node_draw_algos
node_tools -->|"edits artwork"| node_project
node_project -->|"organizes layers"| node_layers
node_layers -->|"contains cels"| node_cels
node_editor -->|"edits animation"| node_timeline
node_editor -->|"edits tiles"| node_tilemap
node_editor -->|"uses 3D tools"| node_three_d
node_editor -->|"applies effects"| node_effects
node_editor -->|"manages colors"| node_palettes
node_editor -->|"accesses extensions"| node_extensions
node_editor -->|"initiates import"| node_import
node_import -->|"reads artwork"| node_external_files
node_editor -->|"requests file action"| node_open_save
node_open_save -->|"loads or saves"| node_project
node_open_save -->|"reads or writes"| node_external_files
node_editor -->|"initiates export"| node_export
node_export -->|"exports animation"| node_animation_export
node_export -->|"writes output"| node_external_files
node_editor -->|"customizes UI"| node_preferences
node_editor -->|"configures shortcuts"| node_shortcuts

click node_editor "https://github.com/orama-interactive/pixelorama/tree/master/src/UI"
click node_tools "https://github.com/orama-interactive/pixelorama/tree/master/src/Tools"
click node_draw_algos "https://github.com/orama-interactive/pixelorama/blob/master/src/Autoload/DrawingAlgos.gd"
click node_project "https://github.com/orama-interactive/pixelorama/blob/master/src/Classes/Project.gd"
click node_layers "https://github.com/orama-interactive/pixelorama/tree/master/src/Classes/Layers"
click node_cels "https://github.com/orama-interactive/pixelorama/tree/master/src/Classes/Cels"
click node_timeline "https://github.com/orama-interactive/pixelorama/tree/master/src/UI/Timeline"
click node_tilemap "https://github.com/orama-interactive/pixelorama/blob/master/src/Classes/Cels/CelTileMap.gd"
click node_three_d "https://github.com/orama-interactive/pixelorama/tree/master/src/Tools/3DTools"
click node_effects "https://github.com/orama-interactive/pixelorama/blob/master/src/Classes/ImageEffect.gd"
click node_palettes "https://github.com/orama-interactive/pixelorama/blob/master/src/Autoload/Palettes.gd"
click node_extensions "https://github.com/orama-interactive/pixelorama/blob/master/src/Autoload/ExtensionsApi.gd"
click node_import "https://github.com/orama-interactive/pixelorama/blob/master/src/Autoload/Import.gd"
click node_open_save "https://github.com/orama-interactive/pixelorama/blob/master/src/Autoload/OpenSave.gd"
click node_export "https://github.com/orama-interactive/pixelorama/blob/master/src/Autoload/Export.gd"
click node_animation_export "https://github.com/orama-interactive/pixelorama/tree/master/src/Classes/AnimationExporters"
click node_preferences "https://github.com/orama-interactive/pixelorama/tree/master/src/Preferences"
click node_shortcuts "https://github.com/orama-interactive/pixelorama/tree/master/addons/keychain"

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_editor,node_tools,node_draw_algos toneBlue
class node_project,node_layers,node_cels toneAmber
class node_import,node_open_save,node_export,node_animation_export toneMint
class node_timeline,node_tilemap,node_three_d,node_effects,node_palettes,node_extensions toneRose
class node_preferences,node_shortcuts,node_artist,node_external_files toneIndigo
```

## Components

### Editing

- [Editor UI](https://github.com/orama-interactive/pixelorama/tree/master/src/UI): `src/UI`
- [Drawing Tools](https://github.com/orama-interactive/pixelorama/tree/master/src/Tools): `src/Tools`
- [Drawing Algorithms](https://github.com/orama-interactive/pixelorama/blob/master/src/Autoload/DrawingAlgos.gd): `src/Autoload/DrawingAlgos.gd`

### Project Model

- [Artwork Project](https://github.com/orama-interactive/pixelorama/blob/master/src/Classes/Project.gd): `src/Classes/Project.gd`
- [Layer Types](https://github.com/orama-interactive/pixelorama/tree/master/src/Classes/Layers): `src/Classes/Layers`
- [Cel Types](https://github.com/orama-interactive/pixelorama/tree/master/src/Classes/Cels): `src/Classes/Cels`

### Import Export

- [Import](https://github.com/orama-interactive/pixelorama/blob/master/src/Autoload/Import.gd): `src/Autoload/Import.gd`
- [Project Files](https://github.com/orama-interactive/pixelorama/blob/master/src/Autoload/OpenSave.gd): `src/Autoload/OpenSave.gd`
- [Export](https://github.com/orama-interactive/pixelorama/blob/master/src/Autoload/Export.gd): `src/Autoload/Export.gd`
- [Animation Exporters](https://github.com/orama-interactive/pixelorama/tree/master/src/Classes/AnimationExporters): `src/Classes/AnimationExporters`

### Creative Features

- [Animation Timeline](https://github.com/orama-interactive/pixelorama/tree/master/src/UI/Timeline): `src/UI/Timeline`
- [Tilemap Layers](https://github.com/orama-interactive/pixelorama/blob/master/src/Classes/Cels/CelTileMap.gd): `src/Classes/Cels/CelTileMap.gd`
- [3D Tools](https://github.com/orama-interactive/pixelorama/tree/master/src/Tools/3DTools): `src/Tools/3DTools`
- [Image Effects](https://github.com/orama-interactive/pixelorama/blob/master/src/Classes/ImageEffect.gd): `src/Classes/ImageEffect.gd`
- [Palette Manager](https://github.com/orama-interactive/pixelorama/blob/master/src/Autoload/Palettes.gd): `src/Autoload/Palettes.gd`
- [Extensions API](https://github.com/orama-interactive/pixelorama/blob/master/src/Autoload/ExtensionsApi.gd): `src/Autoload/ExtensionsApi.gd`

### Customization

- [Preferences](https://github.com/orama-interactive/pixelorama/tree/master/src/Preferences): `src/Preferences`
- [Shortcut Profiles](https://github.com/orama-interactive/pixelorama/tree/master/addons/keychain): `addons/keychain`

### Other components

- **Artist**
- **Artwork Files**

## Connections

- Artist → Editor UI: uses
- Editor UI → Drawing Tools: selects tools
- Drawing Tools → Drawing Algorithms: uses algorithms
- Drawing Tools → Artwork Project: edits artwork
- Artwork Project → Layer Types: organizes layers
- Layer Types → Cel Types: contains cels
- Editor UI → Animation Timeline: edits animation
- Editor UI → Tilemap Layers: edits tiles
- Editor UI → 3D Tools: uses 3D tools
- Editor UI → Image Effects: applies effects
- Editor UI → Palette Manager: manages colors
- Editor UI → Extensions API: accesses extensions
- Editor UI → Import: initiates import
- Import → Artwork Files: reads artwork
- Editor UI → Project Files: requests file action
- Project Files → Artwork Project: loads or saves
- Project Files → Artwork Files: reads or writes
- Editor UI → Export: initiates export
- Export → Animation Exporters: exports animation
- Export → Artwork Files: writes output
- Editor UI → Preferences: customizes UI
- Editor UI → Shortcut Profiles: configures shortcuts
