https://github.com/stuffmatic/fspy-blender

Official fSpy importer for Blender
https://github.com/stuffmatic/fspy-blender

blender blender-addon camera-calibration fspy

Last synced: 6 days ago
JSON representation

Official fSpy importer for Blender

• Host: GitHub
• URL: https://github.com/stuffmatic/fspy-blender
• Owner: stuffmatic
• License: gpl-3.0
• Created: 2018-11-12T15:22:15.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2022-05-04T07:25:15.000Z (over 2 years ago)
• Last Synced: 2024-11-22T01:12:00.594Z (about 1 month ago)
• Topics: blender, blender-addon, camera-calibration, fspy
• Language: Python
• Homepage: https://fspy.io
• Size: 15.8 MB
• Stars: 1,225
• Watchers: 48
• Forks: 123
• Open Issues: 51
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# What is this?

This is the official [fSpy](https://fspy.io) importer add-on for [Blender](https://blender.org). The two images below show an fSpy project (top) and a matching Blender camera created by the importer (bottom).

![An example fSpy project](readme_images/help_fspy.jpg)

![A matching Blender camera](readme_images/help_blender.jpg)

# Getting started

## 1. Download the add-on

[Download the latest version](https://github.com/stuffmatic/fSpy-Blender/releases/latest) (make sure you download the file called `fSpy-Blender-x.y.z.zip`).

### ⚠️ __Important note for mac users__ ⚠️

If you're using Safari, make sure you __download the add-on by right clicking and choosing "Download Linked File"__. This prevents the downloaded file from getting unzipped automatically.

## 2. Install the add-on

Open the preferences window by selecting Preferences from the Edit menu

![Edit -> Preferences](readme_images/help_edit_preferences.png)

Select the _Add-ons_ tab and press the _Install_ button

![Install add-on](readme_images/help_addons_install.png)

Select the downloaded zip-file and press _Install Add-on from file_

![Select the zip file](readme_images/help_select_zip.png)

Locate the fSpy importer in the add-on list and enable it by pressing the checkbox.

![Enable add-on](readme_images/help_enable_addon.png)

## 3. Import an fSpy project file

Once the add-on is installed and activated, fSpy project files can be imported by selecting _fSpy_ from the _Import_ menu. This will create a camera with the same name as the imported project file.

![Import menu](readme_images/help_import_menu.png)

### Import settings

At the bottom left in the importer's file browser, there is a panel with import settings.

![Import settings](readme_images/help_import_settings.png)

__Update existing import (if any)__ - If checked, any previously created camera with a name matching the project filename will be updated. If unchecked, a new camera will be created on each import. 

__Import background image__ - If checked, the image from the fSpy project file will be used as the background image for the Blender camera.

# Support for Blender versions older than 2.80

Starting with version 1.0.3, the addon is only compatible with Blender 2.80 and up. If you are using an older Blender version, please [download version 1.0.2](https://github.com/stuffmatic/fSpy-Blender/releases/tag/v1.0.2) of the add-on.