Graphical User Interface¶
The graphical user interface of COLMAP provides access to most of its
functionality and visualizes the reconstruction process in “real-time”. To start
the GUI, please run the pre-built binaries (Windows: COLMAP.bat, Mac:
COLMAP.app) or execute
./src/exe/colmap. The GUI application requires an
attached display with OpenGL 3.2 support. Registered images are visualized in
red and points in their average point color extracted from the images.
Model Viewer Controls¶
- Rotate model: Left-click and drag.
- Shift model: Right-click or <CTRL>-click (<CMD>-click) and drag.
- Zoom model: Scroll.
- Change point size: <CTRL>-scroll (<CMD>-scroll).
- Change camera size: <ALT>-scroll.
- Adjust clipping plane: <SHIFT>-scroll.
- Select point: Double-left-click point (change point size if too small). The green lines visualize the projections into the images that see the point. The opening window shows the projected locations of the point in all images.
- Select camera: Double-left-click camera (change camera size if too small). The purple lines visualize images that see at least one common point with the selected image. The opening window shows a few statistics of the image.
- Reset view: To reset all viewing settings, choose
Render > Reset view.
The model viewer allows you to render the model with different settings,
projections, colormaps, etc. Please, choose
Render > Render options.
To create screenshots of the current viewpoint (without coordinate axes), choose
Extras > Grab image and save the image in the format of your choice.
To create a video screen capture of the reconstructed model, choose
Grab movie. This dialog allows you to set individual control viewpoints by
Add. COLMAP generates a fixed number of frames per second between
each control viewpoint by smoothly interpolating the linear trajectory, and to
interpolate the configured point and the camera sizes at the time of clicking
Add. To change the number of frames between two viewpoints or to reorder
individual viewpoints, modify the time of the viewpoint by double-clicking the
respective cell in the table. Note that the video capture requires to set the
perspective projection model in the render options. You can review the
trajectory in the viewer, which is rendered in light blue. Choose
movie, if you are done creating the trajectory. The output directory then
contains the individual frames of the video capture, which can be assembled to a
movie using FFMPEG with the following command:
ffmpeg -i frame%06d.png -r 30 -vf scale=1680:1050 movie.mp4