Skip to content

Latest commit

 

History

History
70 lines (56 loc) · 3.09 KB

INSTALL.md

File metadata and controls

70 lines (56 loc) · 3.09 KB
Raw

Development

This guide will help you setup a development environment to launch and contribute to Meshroom.

Requirements

AliceVision

Meshroom relies on the AliceVision framework. AliceVision's binaries must be in the path while running Meshroom. To build AliceVision, follow this guide.

Meshroom also relies on specific files provided with AliceVision.

  • sensor database: a text database of sensor width per camera model. Provided in AliceVision source tree: {ALICEVISION_ROOT}/src/aliceVision/sensorDB/cameraSensors.db
  • voctree (optional): for larger datasets (>200 images), greatly improves image matching performances. It can be downloaded here.

Environment variables must be set for Meshroom to find those files:

ALICEVISION_SENSOR_DB=/path/to/database
ALICEVISION_VOCTREE=/path/to/voctree

Python Environment

  • Windows: Python 3 (>=3.5)
  • Linux: Python 3 (>=3.5) or Python 2 (>= 2.7)

No Python 2.7 support on Windows ?

Official Python 2.7 binary package is built with Visual Studio 2008, while PySide2/Qt is built using Visual Studio 2015/2017. Therefore, in order to avoid mixing MSVC runtime libraries, Qt does not ship PySide2 wheels for Python 2.7 on Windows (as explained here). Note that for using Meshroom in command line mode only (no UI), PySide2 is not required and Python 2.7 would be fine.

To install all the requirements for runtime, development and packaging, simply run:

pip install -r requirements.txt -r dev_requirements.txt

Note: dev_requirements is only related to testing and packaging. It is not mandatory to run Meshroom.

Qt/PySide

  • PySide >= 5.12.2 Warning: On Windows, the plugin AssimpSceneParser is missing from pre-built binaries, so you need to add it manually (from an older version for instance). See https://bugreports.qt.io/browse/QTBUG-74535

Qt Plugins

Additional Qt plugins can be built to extend Meshroom UI features. They can be found on separate repositories, though they might get better integration in the future. Note that they are optional but highly recommended.

QmlAlembic

Adds support for Alembic file loading in Meshroom's 3D viewport. Allows to visualize sparse reconstruction results (point cloud and cameras).

QML2_IMPORT_PATH=/path/to/qmlAlembic/install/qml

QtOIIO

Use OpenImageIO as backend to load images in Qt. Allow to visualize RAW/EXR images in Meshroom. This plugin also provides a QML Qt3D Entity to load depthmaps files stored in EXR format.

QT_PLUGIN_PATH=/path/to/QtOIIO/install
QML2_IMPORT_PATH=/path/to/QtOIIO/install/qml

QtAliceVision

Use AliceVision to load and visualize intermediate reconstruction files.

QML2_IMPORT_PATH=/path/to/qtAliceVision/install/qml