PanoEdit Help Reference

How to Take Source Images

Properly taking source images is crucial to successful panorama stitching.

  • When taking images, rotate camera around some fixed point. A tripod is not required to stitch a good panorama but remember that a heavily moving camera from side to side, especially for indoor scenes, will lead to rendering artifacts or even to no matching source images altogether. Also do not zoom in/out while taking photos.
  • Keep an overlap of at least 20-30% between images. Monotonous scenes like the sea may need more overlapping.
  • Use lens without a lot of distortion. Fish eye lenses are not supported in the current version of PanoEdit.

How to Use PanoEdit

The PanoEdit window is divided into two resizable areas. The top area is for the panorama and the bottom area is for source images.

To create panorama import source images into PanoEdit either by dragging and dropping them into bottom area or using menu (File -> Import, Cmd-I). After that ‘Match’ button should be enabled. Just click it and wait while the matching is working. After a successful matching the top area will display just stitched panorama. In the bottom area images that constitute the panorama will be marked as ‘matched’ group.

PanoEdit Modes

PanoEdit has three modes.

Preview Mode

The first one is the preview mode. It shows how your final panorama will look like after export. Note that it is low resolution, approximate representation of the final image.

Projection Editor

The second mode is the projection editor.

The spherical projection (also known as equirectangular projection) just maps longitude and latitude to image coordinates as is. Select this projection when panorama has a large field of view.

The rectilinear projection (also known as gnomonic projection) can map only part of the full spherical panorama without much distortion. It has a property that a straight line in the real world is a straight in the projected image. Select this projection when the field of view is not very large.

Also, projection editor allows you to easily modify the yaw, pitch and roll parameters of projection. The image of panorama has handles overlaid over it:

Click and drag image near horizontal handle to move horizontally, near vertical to move vertically. Clicking and dragging near or outside of the outer four curved handles will rotate the panorama. These controls are useful when panorama needs recomposition or when default parameters are not satisfactory, for example, the panorama having a curved horizon.


The third mode is the crop tool.

In addition to the usual crop rectangle there are controls for scale, size and crop mode. Scale is specified in percentage of source images scale, i.e. when scale is 100% one pixel in panorama roughly corresponds to one pixel in source images. Size edit boxes allow to specify precisely desired final image width or height and other parameters will be recalculated according to the crop rectangle proportions and current scale.

The crop mode allows to automatically position the crop rectangle and (for inscribed and superscribed modes) properly recalculate it whenever the panorama is changed. The superscribed mode is turned on by default and keeps the crop rectangle precisely cover all panorama. The inscribed mode keeps the crop rectangle inside panorama.


After you have successfully created panorama you can save it to disk using Save button on main panel. You may also adjust panorama horizon and crop parameters at first and then save panoramic image to disk.