https://github.com/krupkat/xpano
Automated photo stiching tool. Lets you import a directory of images and then export the autodetected panoramas.
https://github.com/krupkat/xpano
cpp imgui imgui-sdl opencv panorama panorama-stitching sdl
Last synced: 3 months ago
JSON representation
Automated photo stiching tool. Lets you import a directory of images and then export the autodetected panoramas.
- Host: GitHub
- URL: https://github.com/krupkat/xpano
- Owner: krupkat
- License: gpl-3.0
- Created: 2022-07-20T15:57:19.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-07-28T15:30:52.000Z (over 1 year ago)
- Last Synced: 2024-08-31T10:01:57.685Z (about 1 year ago)
- Topics: cpp, imgui, imgui-sdl, opencv, panorama, panorama-stitching, sdl
- Language: C++
- Homepage: https://krupkat.github.io/xpano/
- Size: 6.18 MB
- Stars: 217
- Watchers: 9
- Forks: 15
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/krupkat/xpano/actions/workflows/test.yml)
[](https://github.com/krupkat/xpano/actions/workflows/clang-format-check.yml)
[](https://github.com/krupkat/xpano/actions/workflows/clang-tidy-check.yml)
# xpano
Xpano is a tool for panorama stitching with focus on simplicity and ease of use, major features include:
- Auto detection of groups of images that can be stitched into panoramas
- Preview + zoom + pan of the computed panoramas
- Crop mode, boundary auto fill, selectable projection types
- Projection adjustments: pitch, yaw and roll
- Export of full resolution panoramas including exif metadata
## Built with
The app uses the excellent [OpenCV](https://opencv.org/) library for image manipulation and its [stitching](https://docs.opencv.org/4.x/d1/d46/group__stitching.html) module for computing the panoramas.
Other dependencies include [imgui](https://github.com/ocornut/imgui), [SDL](https://github.com/libsdl-org/SDL), [spdlog](https://github.com/gabime/spdlog/), [Catch2](https://github.com/catchorg/Catch2), [nativefiledialog-extended](https://github.com/btzy/nativefiledialog-extended), [alpaca](https://github.com/p-ranav/alpaca), [thread-pool](https://github.com/bshoshany/thread-pool), [expected](https://github.com/TartanLlama/expected), [Exiv2](https://github.com/Exiv2/exiv2), [multiblend](https://horman.net/multiblend/), [SIMDe](https://github.com/simd-everywhere/simde) and the [Google Noto](https://fonts.google.com/noto) fonts.
## Demo
Check out the demo on [YouTube](https://youtu.be/MyiTC3i1hK0).
## Installation
Install directly from Flathub or the Microsoft Store:
Get additional packages:
- Windows and MacOS executables from [GitHub](https://github.com/krupkat/xpano/releases)
- Ubuntu packages from my [Launchpad PPA](https://launchpad.net/~krupkat/+archive/ubuntu/code)
- Nix packages from [nixpkgs](https://search.nixos.org/packages?channel=unstable&show=xpano)
- Archlinux AUR: [xpano-git](https://aur.archlinux.org/packages/xpano-git)
## Command line
Xpano has basic CLI support, you can either run it fully automatic in the command line, or launch to gui with the `--gui` flag.
```
Xpano [] [--output=] [--gui] [--help] [--version]
```
## Development
The project can be built by running a single script from the `misc/build` directory. You will need at least CMake 3.21, git and a compiler with C++20 support.
### NixOS
Run the build script from the root of the repository:
```
nix-shell misc/build/nix/default.nix
./misc/build/build-nixos.sh
```
Possible issues when running - [troubleshooting](https://gist.github.com/krupkat/cd0adbd584e2bfe154accdb393076fc3).
### MacOS
Library prerequisites: SDL2, spdlog, catch2
Install with brew: `brew install sdl2 spdlog catch2`
Install with macports: `sudo port install libsdl2 spdlog catch2` (for details: [#96](https://github.com/krupkat/xpano/pull/96#issuecomment-1575589249))
Run the build script from the root of the repository:
```
./misc/build/build-macos.sh
```
### Ubuntu 24.04
Library prerequisites:
```
sudo apt install libgtk-3-dev libopencv-dev libsdl2-dev libspdlog-dev catch2
```
Run the build script from the root of the repository:
```
./misc/build/build-ubuntu-24.sh
```
### Ubuntu 22.04
Library prerequisites:
```
sudo apt install libgtk-3-dev libopencv-dev libsdl2-dev libspdlog-dev
```
Run the build script from the root of the repository:
```
./misc/build/build-ubuntu-22.sh
```
### Windows
Open the "Developer PowerShell for VS 2022" profile in Windows Terminal and run the build script from the root of the repository:
```
./misc/build/build-windows-latest.ps1
```
## Contributions
Contributions are more than welcome, there is a couple of ideas for enhancements in [open issues](https://github.com/krupkat/xpano/issues) which you could take on - if you start working on one of them, please add a comment there.
Please check the [contribution guidelines](https://github.com/krupkat/xpano/blob/main/CONTRIBUTING.md) for further details regarding formatting and coding style.
## License
Distributed under the *GPL-3.0-or-later* license. See the full [license text](https://github.com/krupkat/xpano/blob/main/LICENSE) for more information.
## Contact
Tomas Krupka - [krupkat.cz](https://krupkat.cz)