A simple panorama stitcher application written in C++ with a GTK GUI. The app is written mostly from scratch with as little dependencies as possible. The stitching routine is based on the paper Automatic Panoramic Image Stitching using Invariant Features.
- Open the app and drag the images you wish to stitch from your folder into the drag field. Select your images and click on the "Panorama from selection" button.
- You can crop the result by drawing a rectangle with the right mouse button on the preview screen. Note that the preview may look slightly different than the final result and saving large panoramas may take some time.
Tips for Best Results:
- Stay at the same point when taking pictures.
- Avoid taking multiple pictures without moving the camera.
- Use a standard lens camera (to minimize distortion).
- Parameters in the config menu can be tuned, but adjust them only if you are sure about their effects.
All examples can be found in the results folder.
From the PhotoFit gallery.
"Panorama" of a map.
The front door.
Little planet .
You will need the following packages:
Additionally, you need a compiler that supports C++20 and CMake >= 3.1. To compile for Windows, you will also need MXE.
Install all dependencies with:
sudo apt-get install cmake gcc g++ libopencv-dev libeigen3-dev libgtk-3-devClone the repository and build:
git clone https://github.com/shafiiganjeh/SimplePanorama
cd SimplePanorama
mkdir bin
cd bin
cmake ..
make -j$(nproc)You can launch the app from inside the bin directory.
This process is slightly more complex. First, build MXE as described here.
Then, from inside your MXE directory, run:
make eigen -j$(nproc)
make gtk3 -j$(nproc) MXE_TARGETS='x86_64-w64-mingw32.static'
make opencv -j$(nproc) MXE_TARGETS='x86_64-w64-mingw32.static'Assuming you have built MXE in ~/mxe, you can now cross-compile for Windows:
git clone https://github.com/shafiiganjeh/SimplePanorama
cd SimplePanorama
mkdir bin
cd bin
export PATH=~/mxe/usr/bin:$PATH
x86_64-w64-mingw32.static-cmake ..
make -j$(nproc)
x86_64-w64-mingw32.static-strip panorama.exeCreate the following folder structure inside ~/SimplePanorama:
SimplePanorama/
bin/
share/
glib-2.0/
schemas/
Copy all files from ~/mxe/usr/x86_64-w64-mingw32.static/share/glib-2.0/schemas into ~/SimplePanorama/share/glib-2.0/schemas. Then, from the terminal:
cd ~/SimplePanorama/share/glib-2.0/schemas
glib-compile-schemas .After this, you can copy the SimplePanorama folder to your Windows machine and use it from inside the bin directory or via shortcut. There is no need to install anything.
This section covers some technical details about this implementation.
The app follows Automatic Panoramic Image Stitching using Invariant Features with several key changes:
Bundle adjustment is performed differently. In Lowe's paper, the objective is to minimize residuals between real and projected point pairs. In this implementation, the objective is relaxed — residuals between estimated and projected point pairs are minimized instead. This change makes the algorithm more robust to outliers and results in fewer errors, but it is also slower than the original algorithm. You can still choose to use the original algorithm If you find the improved one too slow.
SIFT has been replaced by rootSIFT. Image matching is more elaborate and also includes keypoints in the overlap region of the images, instead of the entire image region.
Image seams are found via Graphcut instead of just using distance transform. This results in higher quality seams, but can be very slow, so it is disabled by default. You can enable this in the config menu.
- Added new Projection methods (Cylindrical,Stereographic).
- Added method for fixing missing centers-parts in Stereographic projections If possible.
- Added a new method for fixing exposure disparity.
- Added the option to use the original bundle adjustment Algorithm from "Automatic Panoramic Image Stitching using Invariant Features".
- Added the option whether to autoimatically straighten the panorama.
- Fixed some visual issues.