Skip to content

Commit

Permalink
[doc] Update the MVS exporter documentation to use sfm_data.bin file …
Browse files Browse the repository at this point in the history
…by default
  • Loading branch information
pmoulon committed Jan 3, 2018
1 parent 8539c8f commit 08bae45
Show file tree
Hide file tree
Showing 4 changed files with 11 additions and 14 deletions.
2 changes: 1 addition & 1 deletion docs/sphinx/rst/software/MVS/CMPMVS.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,4 @@ OpenMVG exports [CMPMVS]_ ready to use project (images, projection matrices and

.. code-block:: c++

$ openMVG_main_openMVG2CMPMVS -i Dataset/outReconstruction/sfm_data.json -o Dataset/outReconstruction
$ openMVG_main_openMVG2CMPMVS -i Dataset/outReconstruction/sfm_data.bin -o Dataset/outReconstruction
12 changes: 5 additions & 7 deletions docs/sphinx/rst/software/MVS/MVE.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,31 +2,29 @@
MVE (Multi-View Environment)
***************************************

`MVE <http://www.gris.informatik.tu-darmstadt.de/projects/multiview-environment>`_ can import a converted openMVG SfM scene and use it to create dense depth map and complete dense 3D models.
`MVE <https://github.com/simonfuhrmann/mve>`_ can import a converted openMVG SfM scene and use it to create dense depth map and complete dense 3D models.

.. code-block:: c++

# Convert the openMVG SfM scene to the MVE format
$ openMVG_main_openMVG2MVE -i Dataset/outReconstruction/sfm_data.json -o Dataset/outReconstruction
$ openMVG_main_openMVG2MVE -i Dataset/outReconstruction/sfm_data.bin -o Dataset/outReconstruction

#--
# shell script example
#--

directory=Dataset/outReconstruction/MVE
resolution=2

# MVE
dmrecon -s$resolution $directory
scene2pset -ddepth-L$resolution -iundist-L$resolution -n -s -c $directory $directory/OUTPUT.ply
fssrecon $directory/OUTPUT.ply $directory/OUTPUT_MESH.ply
meshclean $directory/OUTPUT_MESH.ply $directory/OUTPUT_MESH_CLEAN.ply

Call any tool without arguments to see the help.

You will need to compile MVE tools and `FSSR <http://www.gris.informatik.tu-darmstadt.de/projects/floating-scale-surface-recon/>`_.

Export to MVS Texturing
=======================

If you don't want to use the full MVE pipeline but only `MVS Texturing <http://www.gris.tu-darmstadt.de/projects/mvs-texturing/>`_ [Waechter2014]_ to project a set of oriented images on a mesh, one solution is to use the openMVG_main_openMVG2MVSTEXTURING binary. This binary converts your SfM_Data file into one format used by MVS Texturing. In addition, you may need to undistort your images with openMVG_main_ExportUndistortedImages as it's not handled by the openMVG_main_openMVG2MVSTEXTURING tool.
If you don't want to use the full MVE pipeline but only `MVS Texturing <https://github.com/nmoehrle/mvs-texturing>`_ [Waechter2014]_ to project a set of oriented images on a mesh, one solution is to use the openMVG_main_openMVG2MVSTEXTURING binary. This binary converts your SfM_Data file into one format used by MVS Texturing. In addition, you may need to undistort your images with openMVG_main_ExportUndistortedImages as it's not handled by the openMVG_main_openMVG2MVSTEXTURING tool.
4 changes: 2 additions & 2 deletions docs/sphinx/rst/software/MVS/OpenMVS.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,8 @@ To use OpenMVG scene in OpenMVS you can:
.. code-block:: c++

# Export the OpenMVG scene to the OpenMVS data format
$ openMVG_main_openMVG2openMVS -i PATH/sfm_data.(json/xml/bin) -d OUTPUT_PATH -o OUTPUT_PATH/Scene
$ openMVG_main_openMVG2openMVS -i PATH/sfm_data.bin -d OUTPUT_PATH -o OUTPUT_PATH/Scene

# Or you can Import the OpenMVG scene to the OpenMVS data format using the OpenMVS binary
$ InterfaceOpenMVG -i PATH/sfm_data.json -o scene.mvs

Expand Down
7 changes: 3 additions & 4 deletions docs/sphinx/rst/software/MVS/PMVS.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,11 @@ Export to PMVS/CMVS

OpenMVG exports [PMVS]_ ready to use project (images, projection matrices and pmvs_options.txt files).

Once a 3D calibration have been computed you can convert the SfM_Ouput files to a PMVS project.
Once a 3D calibration has been computed you can convert the SfM_Ouput files to a PMVS project.

.. code-block:: c++

$ openMVG_main_openMVG2PMVS -i Dataset/outReconstruction/sfm_data.json -o Dataset/outReconstruction
$ openMVG_main_openMVG2PMVS -i Dataset/outReconstruction/sfm_data.bin -o Dataset/outReconstruction
$ pmvs Dataset/outReconstruction/PMVS/ pmvs_options.txt

.. figure:: PMVS_result.png
Expand All @@ -20,9 +20,8 @@ In order to use CMVS for large scene openMVG2PMVS exports also the scene in the

.. code-block:: c++

$ openMVG_main_openMVG2PMVS -i Dataset/outReconstruction/sfm_data.json -o Dataset/outReconstruction
$ openMVG_main_openMVG2PMVS -i Dataset/outReconstruction/sfm_data.bin -o Dataset/outReconstruction
$ cmvs Dataset/outReconstruction/PMVS/ [MaxImageCountByCluster=100]
$ cmvs Dataset/outReconstruction/PMVS/ 30
$ genOption Dataset/outReconstruction/PMVS/
$ sh Dataset/outReconstruction/PMVS/pmvs.sh

0 comments on commit 08bae45

Please sign in to comment.