PanoTwist is a free, open source editor for fully spherical (360° x 180°) equirectangular panoramas. It can perform the following editing functions:
- Setting the initial viewpoint
- Rescaling the panorama
- Patching nadir and zenith:
- With an image
- With the average color under the patch
- With a specific color
Panoramas can be manipulated one by one or as a batch.
Rescaling panoramas is sometimes needed as there can be hard limits on the maximum size; for example, in order to upload a panorama file to Facebook, it must be 6000 x 3000 px or smaller.
PanoTwist is a non-destructive editor in the sense that it leaves the original images unchanged so that it's always possible to go back. The edited files are saved separately in a subfolder.
64-bit windows installer is available from the author's website.
This code is structured as a Visual Studio 2013 project. It has three dependencies which are not included into the distribution and need to be downloaded/compiled separately:
- Qt5 - user interface (uses Core, Gui, Widgets)
- OpenCV - image manipulation
- Exiv2 - EXIF and XMP data editing
Exiv2, in turn, depends on Expat, XMP SDK and zlib, but those dependencies are usually packaged with Exiv2 itself.
Therefore the steps needed to get this project up and running on your local machine with Visual Studio are as follows:
- Clone this project:
git clone https://github.com/dizzylogicc/PanoTwist
- Download Qt5, if you don't have it already. Downloading Qt5 binaries is much simpler than downloading the sources and compiling them. The binaries must match your Visual Studio version and the runtime library (multi-threaded, multi-threaded DLL, etc.).
- Download OpenCV and Exiv2. Here too, downloading the binary files is simpler than downloading and compiling the sources.
- Open the
PanoTwist.slnfile with Visual Studio 2013 (or later) with the Qt plugin installed.
- Point the project to where Qt5 is located on your system (
Qt5 menu -> Qt Optionsand
Qt5 menu -> Qt Project Settings).
- Specify the include directories for Qt5, OpenCV and Exiv2 (
Project menu -> Properties -> Configuration Properties -> VC++ Directores -> Include directories).
- Add the following libraries for OpenCV and Exiv2 support to the project (
Project -> Add existing item): libexiv2.lib, libexpat.lib, opencv_world310.lib, xmpsdk.lib, zlib1.lib. Note that library names may differ somewhat on your system. If these libraries are already among the project files, remove them from the project first.
- Build the project!
This project is licensed under GNU General Public License v.3 (GNU GPL v.3) or later version.
This project uses some neat code from demottea's CvImageWidget. Hat tip for making it publicly available!