Blender-Addon-Photgrammetry-Importer

This documentation describes an addon for Blender that allows to import different reconstruction results of several Structure from Motion and Multi-View Stereo libraries.

Supported libraries (data formats):

Colmap (Model folders (BIN and TXT), workspaces, NVM, PLY) Meshroom (MG, JSON, SfM, PLY) MVE (MVE workspaces) 1 Open3D (JSON, LOG, PLY) 1 OpenSfM (JSON) OpenMVG (JSON, NVM, PLY) 2 Regard3D (OpenMVG JSON) VisualSFM (NVM) 1

In addition, the addon supports some common point cloud data formats:

Polygon files (PLY) 3 Point Cloud Library files (PCD) 3 LASer files (LAS) 3, 4 LASzip files (LAZ) 3, 4, 5 Simple ASCII point files (ASC, PTS, CSV) 3

¹ Requires pillow to read image sizes from disk. ² Requires pillow for point color computation.

³ Requires pyntcloud for parsing. ⁴ Requires laspy for parsing. ⁵ Requires lazrs for parsing.

The latest release of the addon is currently compatible with Blender 3.1.2 onwards. For older Blender versions you might find a suitable release here.

Getting Started

• Blender-Addon-Photgrammetry-Importer
• Installation Instructions
• Troubleshooting
• Customize Import/Export Options
• Examples
• Import Data
• Export Data
• Scale Cameras and Points
• Alignment of Cameras and Point Cloud
• Visualization and Rendering
• Addon Usage with Python
• Extending the Addon
• Contribution
• Documentation
• Recent Features / Changelog
• API Reference

There is a short tutorial video that shows how to

• install the addon

• compute a reconstruction with Meshroom

• import the results into Blender

Example Results (Shipped with Addon)

This repository contains an example Colmap model. The following image shows the imported camera poses, image planes and point cloud in Blender’s 3D view.

The input images of the Colmap model are located here: https://github.com/openMVG/ImageDataset_SceauxCastle.

The addon computes an animated camera with corresponding background images from the reconstructed camera poses.

There is also an import option that allows to interpolate the reconstructed camera poses.

In addition, the addon allows to import meshes contained in the workspaces of specific libraries. Manually imported meshes can also be aligned with the corresponding reconstruction by following the instructions here.

The addon offers an option to draw big point clouds with OpenGL to reduce computational requirements. The addon provides a panel to export these OpenGL point clouds renderings - see Point Cloud Visualization and Rendering.