You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
To use Meshroom nodal system without any visualization option, you can rely on a minimal set of dependencies.
16
47
17
-
-__Launch the User Interface__
18
-
19
-
```bash
20
-
# Windows
21
-
set PYTHONPATH=%CD% && python meshroom/ui
22
-
# Linux/macOS
23
-
PYTHONPATH=$PWD python meshroom/ui
24
-
```
25
48
26
-
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:
Download a [Release](https://github.com/alicevision/meshroom/releases) or extract files from a recent AliceVision build on [Dockerhub](https://hub.docker.com/r/alicevision/alicevision).
> - On Linux, the .so (here, Rocky9-based) can be directly downloaded [here](https://drive.google.com/uc?export=download&id=1dq7rm_Egc-sQF6j6_E55f60INyxt1ega). It then needs to be placed in `/path/to/pip/install/PySide6/Qt/qml/QtQuick/Scene3D`.
77
76
78
77
79
-
### AliceVision
78
+
### Install dependencies
79
+
80
+
You can install AliceVision to get access to 3D Computer Vision and Machine Learning nodes and pipelines. Additionally, you can install QtAliceVision to get access to Image and 3D data visualization within Meshroom.
80
81
81
-
Meshroom relies on the [AliceVision](https://github.com/alicevision/AliceVision) framework for visualization of images and 3D data.
82
-
AliceVision's binaries must be in the path while running Meshroom.
83
-
To build AliceVision, follow this [guide](https://github.com/alicevision/AliceVision/blob/develop/INSTALL.md) and add the installation in your PATH (and LD_LIBRARY_PATH on Linux/macOS).
82
+
#### AliceVision
83
+
84
+
[AliceVision](https://github.com/alicevision/AliceVision)'s binaries must be in the path while running Meshroom.
85
+
86
+
The easiest way is to download prebuild binaries from the release. You can download a [Release](https://github.com/alicevision/AliceVision/releases) or extract files from a recent AliceVision build on [Dockerhub](https://hub.docker.com/r/alicevision/alicevision).
87
+
88
+
Alternatively, you can build AliceVision manually from the source code by following this [guide](https://github.com/alicevision/AliceVision/blob/develop/INSTALL.md).
89
+
90
+
Then add the `bin` and `lib` folders into your `PATH` (and `LD_LIBRARY_PATH` on Linux/macOS) environment variables.
84
91
85
92
The following environment variable must always be set with the location of AliceVision's install directory:
It can be downloaded [here](https://gitlab.com/alicevision/trainedVocabularyTreeData/raw/master/vlfeat_K80L3.SIFT.tree).
101
-
* Sphere detection model (optional): for the automated sphere detection in stereo photometry.
102
-
It can be downloaded [here](https://gitlab.com/alicevision/SphereDetectionModel/-/raw/main/sphereDetection_Mask-RCNN.onnx).
103
-
* Semantic segmentation model (optional): for the semantic segmentation of objects.
104
-
It can be downloaded [here](https://gitlab.com/alicevision/semanticSegmentationModel/-/raw/main/fcn_resnet50.onnx).
105
-
* Color chart detection models (optional): for the detection of color charts.
106
-
It can be downloaded [here](https://gitlab.com/alicevision/ColorchartDetectionModel).
107
-
108
-
Environment variables need to be set for Meshroom to find those files:
103
+
Meshroom also relies on [specific files provided with AliceVision](https://github.com/alicevision/AliceVision/blob/develop/INSTALL.md#environment-variables-to-set-for-meshroom), set through environment variables.
104
+
If these variables are not set, Meshroom will by default look for them in `{ALICEVISION_ROOT}/share/aliceVision`.
105
+
106
+
> [!NOTE]
107
+
> You may need to checkout the corresponding Meshroom version/tag to avoid versions incompatibilities.
108
+
109
+
110
+
#### QtAliceVision
111
+
112
+
[QtAliceVision](https://github.com/alicevision/QtAliceVision), an additional Qt plugin, can be built to extend Meshroom UI features.
113
+
114
+
Note that it is optional but highly recommended.
115
+
116
+
This plugin uses AliceVision to load and visualize intermediate reconstruction files and OpenImageIO as backend to read images (including RAW/EXR).
117
+
It also adds support for Alembic file loading in Meshroom's 3D viewport, which allows to visualize sparse reconstruction results (point clouds and cameras).
If these variables are not set, Meshroom will by default look for them in `{ALICEVISION_ROOT}/share/aliceVision`.
123
+
124
+
125
+
### Install plugins
117
126
118
127
#### mrSegmentation plugin
119
128
@@ -127,18 +136,32 @@ For mrSegmentation nodes to be correctly detected by Meshroom, the following env
127
136
MESHROOM_PLUGINS_PATH=/path/to/mrSegmentation
128
137
```
129
138
130
-
###QtAliceVision plugin
139
+
#### MeshroomHub
131
140
132
-
[QtAliceVision](https://github.com/alicevision/QtAliceVision), an additional Qt plugin, can be built to extend Meshroom UI features.
141
+
You can find many experimental Machine Learning plugins on [MeshroomHub](https://github.com/meshroomHub).
133
142
134
-
Note that it is optional but highly recommended.
135
143
136
-
This plugin uses AliceVision to load and visualize intermediate reconstruction files and OpenImageIO as backend to read images (including RAW/EXR).
137
-
It also adds support for Alembic file loading in Meshroom's 3D viewport, which allows to visualize sparse reconstruction results (point clouds and cameras).
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:
0 commit comments