Skip to content

Commit 68e6d8c

Browse files
authored
Update turntable documentation
Merge pull request #47 from alicevision/turntable-update
2 parents 2dac1a7 + 644e4f5 commit 68e6d8c

File tree

1 file changed

+8
-33
lines changed

1 file changed

+8
-33
lines changed
Lines changed: 8 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,13 @@
11
Turntable
22
=========
33

4-
It is possible to use a turntable. To improve the results it might be
5-
useful to mask the images.
4+
To use a turntable, you should:
5+
- On the FeatureMatching node, set the "Minimal 2D Motion" to a value of 2 pixels to avoid matching feature points that are exactly at the same location between 2 images.
6+
- Add an ImageMasking node to make a color keying of the background.
7+
The Input from the ImageMasking connects to CameraInit. The output of the ImageMasking node can be connected to the FeatureExtraction Masking Input and to the PrepareDenseScene Masking Input (applies the undistort to the mask and combines it with the RGB into an RGBA image, so the dense geometry will be computed only on the selected pixels).
8+
If your background is not a uniform color, you can experiment with the ImageSegmentation node to segment the background, but it will less reliable that a color keying.
69

7-
Currently, Meshroom does not support masking but you can see
8-
`#188 <https://github.com/alicevision/meshroom/issues/188>`__ for a
9-
decent workaround.
10+
More details on the ImageMasking node: https://github.com/alicevision/Meshroom/wiki/New-Features-in-Meshroom-2023.1#1-image-masking
1011

11-
Essentially, the software is detecting features on both the foreground
12-
and background. On a turntable, the subject is moving but the background
13-
is not. This confuses it.
14-
15-
So you have 2 choices: make the background completely white and same
16-
lighting so that no features can be extracted from this region, or mask
17-
your images - that is basically covering the background artificially to
18-
stop the region being used in the pipeline, or both.
19-
20-
*Another approach entirely would be to just keep the scene the same but
21-
you move the camera instead, which is usually the best way to go about
22-
things anyway, this what I would most recommend.*
23-
24-
- without masking, the object on the turntable will become blurry/only
25-
partially reconstructed and the background will be reconstructed fine
26-
27-
- we use a blank background to easily mask it
28-
29-
Simply using your white wallpaper will not work as it has too many
30-
recognizable features you should use a clean and smooth background that
31-
will not allow any feature detection use the "Scale for Small-Object
32-
Photogrammetry" by Samantha Porter
33-
34-
http://www.stporter.com/resources/
35-
36-
https://conservancy.umn.edu/handle/11299/172480?show=full
37-
38-
or create your own.
12+
You can put markers in the scene to automatically scale the scene to real world coordinates:
13+
See https://github.com/alicevision/Meshroom/wiki/CCTAG-scaling

0 commit comments

Comments
 (0)