# perarnia/fspy-blender architecture

> Architecture diagram of the GitHub repository perarnia/fspy-blender, 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/perarnia/fspy-blender
- Repository: https://github.com/perarnia/fspy-blender

## Overview

This is the fSpy importer add-on for Blender. A user chooses an .fspy project from Blender’s Import menu; the add-on parses the project’s camera parameters and embedded image, then configures a Blender camera and can use the image as its background. Import options control whether an existing matching camera is updated and whether the background image is imported. The excerpts show parsing and scene-setup behavior, but omit parts of the import operator, so the graph avoids inferring unshown calls such as render-resolution setup.

Main entry points: [`fspy_blender/addon.py`](https://github.com/perarnia/fspy-blender/blob/master/fspy_blender/addon.py) (Import operator), [`fspy_blender/__init__.py`](https://github.com/perarnia/fspy-blender/blob/master/fspy_blender/__init__.py) (Import menu), [`fspy_blender/fspy.py`](https://github.com/perarnia/fspy-blender/blob/master/fspy_blender/fspy.py) (Project parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_registration["Blender integration"]
  node_menu["Import menu<br/>[__init__.py]"]
end

subgraph group_project["Project parsing"]
  node_project_parser["Project parser<br/>[fspy.py]"]
  node_camera_parameters["Camera parameters<br/>[fspy.py]"]
end

subgraph group_scene["Scene setup"]
  node_operator["Import operator<br/>[addon.py]"]
end

node_user(("Blender user"))
node_blender_scene["Blender scene"]

node_user -->|"chooses import"| node_menu
node_menu -->|"registers"| node_operator
node_operator -->|"parses project"| node_project_parser
node_project_parser -->|"extracts"| node_camera_parameters
node_operator -->|"configures camera"| node_blender_scene
node_operator -->|"sets background image"| node_blender_scene

click node_menu "https://github.com/perarnia/fspy-blender/blob/master/fspy_blender/__init__.py"
click node_operator "https://github.com/perarnia/fspy-blender/blob/master/fspy_blender/addon.py"
click node_project_parser "https://github.com/perarnia/fspy-blender/blob/master/fspy_blender/fspy.py"
click node_camera_parameters "https://github.com/perarnia/fspy-blender/blob/master/fspy_blender/fspy.py"

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_menu,node_user toneBlue
class node_project_parser,node_camera_parameters toneAmber
class node_operator toneMint
class node_blender_scene toneIndigo
```

## Components

### Blender integration

- [Import menu](https://github.com/perarnia/fspy-blender/blob/master/fspy_blender/__init__.py): `fspy_blender/__init__.py`

### Project parsing

- [Project parser](https://github.com/perarnia/fspy-blender/blob/master/fspy_blender/fspy.py): `fspy_blender/fspy.py`
- [Camera parameters](https://github.com/perarnia/fspy-blender/blob/master/fspy_blender/fspy.py): `fspy_blender/fspy.py`

### Scene setup

- [Import operator](https://github.com/perarnia/fspy-blender/blob/master/fspy_blender/addon.py): `fspy_blender/addon.py`

### Other components

- **Blender user**
- **Blender scene**

## Connections

- Blender user → Import menu: chooses import (evidence: `README.md`)
- Import menu → Import operator: registers (evidence: `fspy_blender/__init__.py`)
- Import operator → Project parser: parses project (evidence: `fspy_blender/addon.py`)
- Project parser → Camera parameters: extracts (evidence: `fspy_blender/fspy.py`)
- Import operator → Blender scene: configures camera (evidence: `fspy_blender/addon.py`)
- Import operator → Blender scene: sets background image (evidence: `fspy_blender/addon.py`)
