https://github.com/nmoehrle/mvs-texturing
Algorithm to texture 3D reconstructions from multi-view stereo images
https://github.com/nmoehrle/mvs-texturing
3d-reconstruction mvs texturing
Last synced: about 1 month ago
JSON representation
Algorithm to texture 3D reconstructions from multi-view stereo images
- Host: GitHub
- URL: https://github.com/nmoehrle/mvs-texturing
- Owner: nmoehrle
- License: other
- Created: 2014-12-02T22:08:53.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2025-07-13T14:04:57.000Z (9 months ago)
- Last Synced: 2025-12-21T03:08:55.928Z (4 months ago)
- Topics: 3d-reconstruction, mvs, texturing
- Language: C++
- Size: 391 KB
- Stars: 1,054
- Watchers: 55
- Forks: 362
- Open Issues: 72
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-computer-vision-papers - 2014ECCV
- awesome-mvs - mvs-texturing - Large-Scale Texturing of 3D Reconstructions](http://www.gcc.tu-darmstadt.de/home/proj/texrecon/). M. Waechter, N. Moehrle, M. Goesele. ECCV 2014. (Paper / Mesh Texturing)
README
MVS-Texturing
--------------------------------------------------------------------------------
Welcome to our project that textures 3D reconstructions from images.
This project focuses on 3D reconstructions generated using structure from
motion and multi-view stereo techniques, however, it is not limited to this
setting.
The algorithm was published in Sept. 2014 on the
*European Conference on Computer Vision* in
[Let There Be Color! Large-Scale Texturing of 3D Reconstructions](https://download.mmag.hrz.tu-darmstadt.de/media/FB20/GCC/paper/Waechter-2014-LTB.pdf)
see publication details below.
Dependencies
--------------------------------------------------------------------------------
The code and the build system have the following prerequisites:
- cmake (>= 3.1)
- git
- make
- gcc (>= 5.0.0) or a compatible compiler
- libpng, libjpg, libtiff, libtbb
Furthermore the build system automatically downloads and compiles the following
dependencies (so there is nothing you need to do here):
- rayint
https://github.com/nmoehrle/rayint
- Eigen
https://libeigen.gitlab.io
- Multi-View Environment
https://github.com/simonfuhrmann/mve
- mapMAP
https://github.com/dthuerck/mapmap_cpu
Compilation 
--------------------------------------------------------------------------------
1. `git clone https://github.com/nmoehrle/mvs-texturing.git`
2. `cd mvs-texturing`
3. `mkdir build && cd build && cmake ..`
4. `make` (or `make -j` for parallel compilation)
If something goes wrong during compilation you should check the output of the
cmake step. CMake checks all dependencies and reports if anything is missing.
If you think that there is some problem with the build process on our side
please tell us.
If you are trying to compile this under windows (which should be possible but
we haven't checked it) and you feel like we should make minor fixes to support
this better, you can also tell us.
Execution
--------------------------------------------------------------------------------
As input our algorithm requires a triangulated 3D model and images that are
registered against this model. One way to obtain this is to:
* import images, infer camera parameters, reconstruct depth maps and fuse these depth maps into a combined 3d model
using the applications from the [Multi-View Environment](https://github.com/simonfuhrmann/mve).
By starting the application without any parameters and you will get a
description of the expected file formats and optional parameters.
Troubleshooting
--------------------------------------------------------------------------------
When you encounter errors or unexpected behavior please make sure to switch
the build type to debug e.g. `cmake -DCMAKE_BUILD_TYPE=DEBUG ..`, recompile
and rerun the application. Because of the computational complexity the default
build type is RELWITHDEBINFO which enables optimization but also ignores
assertions. However, these assertions could give valuable insight in failure cases.
License, Patents and Citing
--------------------------------------------------------------------------------
Our software is licensed under the BSD 3-Clause license, for more details see
the LICENSE.txt file.
If you use our texturing code for research purposes, please cite our paper:
```
@inproceedings{Waechter2014Texturing,
title = {Let There Be Color! --- {L}arge-Scale Texturing of {3D} Reconstructions},
author = {Waechter, Michael and Moehrle, Nils and Goesele, Michael},
booktitle= {Proceedings of the European Conference on Computer Vision},
year = {2014},
publisher= {Springer},
}
```
Contact
--------------------------------------------------------------------------------
If you have trouble compiling or using this software, if you found a bug or if
you have an important feature request, please use the issue tracker of the [github repository
](https://github.com/nmoehrle/mvs-texturing).