当前位置：首页 > news >正文

Windows 10 + VS2019 保姆级教程：搞定OpenMVG 2.0编译与第一个3D重建

news 2026/6/9 7:28:51

Windows 10 + VS2019 保姆级教程：搞定OpenMVG 2.0编译与第一个3D重建

在计算机视觉领域，3D重建技术正变得越来越重要。OpenMVG作为一款开源的Structure from Motion（SFM）库，为开发者提供了强大的工具来实现从2D图像到3D模型的转换。本文将带你从零开始，在Windows 10系统上使用Visual Studio 2019完成OpenMVG 2.0的编译，并运行第一个3D重建项目。

1. 环境准备与源码获取

在开始编译之前，我们需要确保系统环境配置正确。以下是必备的软件和工具：

Windows 10（64位系统）
Visual Studio 2019（社区版即可）
CMake（最新版本，建议3.15以上）
Git（用于获取源码）

1.1 安装必要软件

首先安装Visual Studio 2019时，需要勾选以下工作负载：

使用C++的桌面开发
通用Windows平台开发（可选）

安装完成后，还需要单独安装CMake和Git。可以从官网下载最新版本：

CMake：https://cmake.org/download/
Git：https://git-scm.com/download/win

1.2 获取OpenMVG源码

有两种方式可以获取OpenMVG 2.0的源码：

方法一：通过Git克隆（推荐）

mkdir openmvg cd openmvg git clone --recursive https://github.com/openMVG/openMVG.git cd openMVG git checkout v2.0

方法二：通过网盘下载如果Git下载速度慢，可以从网盘获取源码压缩包，解压到openmvg目录下。

注意：无论哪种方式，最终目录结构应为.../openmvg/openMVG，其中openMVG文件夹包含完整的源码。

2. CMake配置与项目生成

2.1 基础CMake配置

打开命令行，导航到openmvg目录，执行以下命令：

cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX="./openmvg_v20r" -S .\openMVG\src\ -B .\build_r

这个命令会：

设置构建类型为Release
指定安装目录为openmvg_v20r
指定源码路径为openMVG/src
指定构建目录为build_r

2.2 解决常见问题

在Windows上编译OpenMVG可能会遇到以下问题：

路径过长错误：如果出现"超过OS最大路径限制"的错误，可以通过以下方法解决：
- 将项目放在磁盘根目录（如D:\openmvg）
- 修改Windows注册表启用长路径支持
依赖项缺失： OpenMVG依赖一些第三方库，如Eigen、Ceres等。确保：
- 所有子模块已正确更新（git submodule update --init --recursive）
- 网络连接正常，能够下载所需依赖

3. 编译与安装

3.1 执行编译

CMake配置成功后，执行编译命令：

cmake --build .\build_r --config Release --target install

编译过程可能需要较长时间（取决于电脑配置）。建议：

关闭不必要的程序以释放内存
确保有足够的磁盘空间（至少10GB可用空间）

3.2 编译完成后的处理

编译完成后，所有文件会自动安装到openmvg_v20r目录。此时可以：

删除build_r目录以节省空间（约可释放5-10GB）
将必要的DLL文件复制到bin目录下

4. 运行第一个3D重建项目

4.1 准备测试数据

在openmvg目录下创建reconstruction文件夹，下载测试图像集并解压：

mkdir reconstruction cd reconstruction # 下载并解压images.zip到当前目录

4.2 执行重建流程

重建过程分为多个步骤，每个步骤对应一个OpenMVG工具：

步骤	命令	功能描述
1	openMVG_main_SfMInit_ImageListing	初始化图像列表
2	openMVG_main_ComputeFeatures	计算图像特征
3	openMVG_main_PairGenerator	生成图像对
4	openMVG_main_ComputeMatches	特征匹配
5	openMVG_main_GeometricFilter	几何过滤
6	openMVG_main_SfM	SFM重建
7	openMVG_main_ComputeSfM_DataColor	生成彩色点云

完整的重建命令序列：

mkdir reconstruction_work cd reconstruction_work # 替换路径为你的实际路径 $OPENMVG_PATH/bin/openMVG_main_SfMInit_ImageListing.exe -i ../images/ -d $OPENMVG_PATH/share/openMVG/sensor_width_camera_database.txt -o ./matches $OPENMVG_PATH/bin/openMVG_main_ComputeFeatures.exe -i ./matches/sfm_data.json -o ./matches $OPENMVG_PATH/bin/openMVG_main_PairGenerator.exe -i ./matches/sfm_data.json -o ./matches/pairs.bin $OPENMVG_PATH/bin/openMVG_main_ComputeMatches.exe -i ./matches/sfm_data.json -p ./matches/pairs.bin -o ./matches/matches.putative.bin $OPENMVG_PATH/bin/openMVG_main_GeometricFilter.exe -i ./matches/sfm_data.json -m ./matches/matches.putative.bin -g f -o ./matches/matches.f.bin $OPENMVG_PATH/bin/openMVG_main_SfM.exe -s INCREMENTAL -i ./matches/sfm_data.json -M ./matches/matches.f.bin -o ./output $OPENMVG_PATH/bin/openMVG_main_ComputeSfM_DataColor.exe -i ./output/sfm_data.bin -o ./output/sfm_data_colorized.ply