0

Meshroom

三维重建软件。（3D Reconstruction Software）

Official Site
Github repo
Main metrics

Github stars Tracking Chart

Meshroom

Meshroom 是基于 AliceVision 摄影测量计算机视觉框架的免费开源三维重建（3D Reconstruction）软件。

在 AliceVision 网站上了解有关管道和基于管道的工具的细节。

在 Sketchfab 上查看管道的结果。

摄影测量法

摄影测量学是一门从照片中进行测量的科学。它从一组无序的照片或视频中推断出场景的几何形状。摄影是将 3D 场景投影到 2D 平面上，失去了深度信息。摄影测量的目的就是要逆转这一过程。

请参阅管道步骤的介绍。

教程

Meshroom软件的总体介绍。

详细教程，重点介绍2019.1发行版的特性。

Meshroom 摄影测量实践的整体介绍。

Meshroom 摄影测量实践的整体介绍，以及如何在 Blender 中进行重新校正的详细介绍。

介绍Meshroom软件，重点是将其用于“比赛移动”。

许可

该项目在 MPLv2 下发布，请参阅 COPYING.md。

获得项目

请参阅 INSTALL.md 来设置项目和先决条件。

获取源代码并安装运行时要求： 

git clone --recursive git://github.com/alicevision/meshroom
cd meshroom
pip install -r requirements.txt

启动网格

您需要在PATH中安装AliceVision（在Linux / macOS上为LD_LIBRARY_PATH）。

  • 启动用户界面
# Windows
set PYTHONPATH=%CD% && python meshroom/ui
# Linux/macOS
PYTHONPATH=$PWD python meshroom/ui

在 Ubuntu 上，本机驱动程序和 mesa 驱动程序之间可能存在冲突。 在这种情况下，您需要通过将本机驱动程序添加到 LD_LIBRARY_PATH 来强制使用本机驱动程序：LD_LIBRARY_PATH=/usr/lib/nvidia-340 PYTHONPATH=$PWD python meshroom/ui 您可能需要调整文件夹 /usr/lib/nvidia-340 为正确的驱动程序版本。

  • 在命令行中启动3D重建
# Windows: set PYTHONPATH=%CD% &&
# Linux/macOS: PYTHONPATH=$PWD
python bin/meshroom_photogrammetry --input INPUT_IMAGES_FOLDER --output OUTPUT_FOLDER

常问问题

有关更多信息，请参见 Meshroom wiki。

联系方式

使用公共邮件列表问问题或请求功能。 这里也是进行非正式讨论的好地方，例如共享结果，有趣的相关技术或出版物：

alicevision@googlegroups.com http://groups.google.com/group/alicevision

您也可以通过以下方式私下联系核心团队：alicevision-team@googlegroups.com。

（The first version translated by vz on 2020.07.11）

Overview

Name With Owneralicevision/Meshroom
Primary LanguagePython
Program languageQML (Language Count: 8)
PlatformLinux, Windows
License:Other
Release Count9
Last Release Namev2023.3.0 (Posted on )
First Release Namev2018.1.0 (Posted on )
Created At2015-04-22 17:33:16
Pushed At2024-05-03 15:14:49
Last Commit At2023-12-11 11:08:53
Stargazers Count10.6k
Watchers Count279
Fork Count1k
Commits Count3.7k
Has Issues Enabled
Issues Count1559
Issue Open Count433
Pull Requests Count621
Pull Requests Open Count48
Pull Requests Close Count56
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private

Meshroom - 3D Reconstruction Software

CII Best Practices

Meshroom is a free, open-source 3D Reconstruction Software based on the AliceVision Photogrammetric Computer Vision framework.

Learn more details about the pipeline on AliceVision website.

See results of the pipeline on sketchfab.

Continuous integration:

  • Windows: Build status
  • Linux: Build Status

Photogrammetry

Photogrammetry is the science of making measurements from photographs.
It infers the geometry of a scene from a set of unordered photographs or videos.
Photography is the projection of a 3D scene onto a 2D plane, losing depth information.
The goal of photogrammetry is to reverse this process.

See the presentation of the pipeline steps.

Tutorials

Overall presentation of the Meshroom software.

Detailed tutorial with a focus on the features of the 2019.1 release.

Overall presentation of the protogrammetry practice with Meshroom.

Overall presentation of the protogrammetry practice with Meshroom and detailed presentation how to do the retolopogy in Blender.

Presentation of the Meshroom software with a focus on using it for Match Moving.

License

The project is released under MPLv2, see COPYING.md.

Get the project

See INSTALL.md to setup the project and pre-requisites.

Get the source code and install runtime requirements:

git clone --recursive git://github.com/alicevision/meshroom
cd meshroom
pip install -r requirements.txt

Start Meshroom

You need to have AliceVision installation in your PATH (and LD_LIBRARY_PATH on Linux/macOS).

  • Launch the User Interface
# Windows
set PYTHONPATH=%CD% && python meshroom/ui
# Linux/macOS
PYTHONPATH=$PWD python meshroom/ui

On Ubuntu, you may have conflicts between native drivers and mesa drivers. In that case, you need to force usage of native drivers by adding them to the LD_LIBRARY_PATH:
LD_LIBRARY_PATH=/usr/lib/nvidia-340 PYTHONPATH=$PWD python meshroom/ui
You may need to adjust the folder /usr/lib/nvidia-340 with the correct driver version.

  • Launch a 3D reconstruction in command line
# Windows: set PYTHONPATH=%CD% &&
# Linux/macOS: PYTHONPATH=$PWD
python bin/meshroom_photogrammetry --input INPUT_IMAGES_FOLDER --output OUTPUT_FOLDER

FAQ

See the Meshroom wiki for more information.

Contact

Use the public mailing-list to ask questions or request features. It is also a good place for informal discussions like sharing results, interesting related technologies or publications:

alicevision@googlegroups.com
http://groups.google.com/group/alicevision

You can also contact the core team privately on: alicevision-team@googlegroups.com.

To the top