README.md

Blender-Addon-Photogrammetry-Importer

This repository contains a Blender addon to import reconstruction results of several libraries.

Supported libraries / data formats:

• Colmap reconstructions (https://github.com/colmap/colmap)
  • Colmap model folders (binary and txt format), Colmap workspaces, NVM, PLY
• Meshroom reconstructions (https://alicevision.github.io/)
  • MG, JSON, SfM, PLY
• Open3D reconstructions (http://www.open3d.org/)
  • JSON, LOG, PLY
• OpenSfM reconstructions (https://github.com/mapillary/OpenSfM)
  • JSON
• OpenMVG reconstructions (https://github.com/openMVG/openMVG)
  • JSON, NVM, PLY
• Polygon Files (http://paulbourke.net/dataformats/ply/)
  • PLY
• Regard3D reconstructions (https://www.regard3d.org/)
  • (OpenMVG) JSON
• VisualSFM reconstructions (http://ccwu.me/vsfm/)
  • NVM

Tested for Blender 2.81. There is an older version of the addon available for Blender 2.79 that allows to import NVM files - see the 2.79 branch.

Getting Started

• Documentation
• Tutorial Video
• Installation Instructions
• Troubleshooting
• Customize Import/Export Options
• Examples
• Import Data
• Export Data
• Adjust Results (Scale Cameras and Points)
• Ensure Camera and Point Alignment
• Point Cloud Visualization and Rendering
• Addon Usage with Python
• Contribution
• Recent features / Changelog

Example

This repository contains an example NVM file. The imported result looks as follows. The input images of the NVM file are located here: https://github.com/openMVG/ImageDataset_SceauxCastle.

There is an import option that interpolates the reconstructed camera poses to compute a camera animation.

You can also overlay the (sparse) point cloud with the corresponding mesh - see Import Data.

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.