Contents

Unusual remappings

The possibilities of panotools go far beyond mere panorama stitching. Due to it's flexibility and modular design there are some remappings possible that (may be) where not intended originally. It should be possible to perform these remappings using the Panorama Tools Plugins but I prefer to use one of the GUI front-ends, since they allow for a more convenient control. I've used PTGui here but it should be possible with hugin, PTAssembler or PTMac in a similar way.

Little planet

This is a remapping already used by Helmut Dersch as a thumbnail for his virtual Marburg tour on [1] (scroll down on the page). It remaps an equirectangular full spherical panorama to a virtual 360� fishey image. Unfortunately neither PTGui nor hugin support this remapping directly, hence we have to modify the PTStitcher script.

Steps

On Lens Settings tab page choose Equirectangular from the Lens type list, set Hor. Field of View to 360 degrees and click Restore defaults in the Advanced frame in order to set all lens correction parameters to 0.0.

On Panorama Settings tab page choose Projection: Equirectangular and set Field of View to 180 x 180 degrees. This is for convenience only. The values will be changed later.

On Image parameters tab page click the Pitch field for your image and set it to 90 in order to view straight down.

On Create Panorama tab page set the width and file format you want for your output image. One single image is created hence any single image format is good. Don't forget the image name. Choose Stitch using: Panorama Tools (PTStitcher) from the Advanced frame and check Show script.

Click Create panorama. The script will be shown.

In the line beginning with the letter p change f2 to f3 and v180 to v360. Click Ok.

The resulting image is supposed to be a "Full Frame Fisheye", hence you need to crop it to a circular frame in your image editor.

Pano editor tweaks in PTGui

Tweaks

If you don't like the rotation of the result image you use Numerical transform from the PTGui panorama editor (Ctrl+E). Enter a step value for Roll (f.e. -10) and press Apply button repeatedly until you like the roation. The display in pano editor will be in equirect, not in "little planet" of course.

Orientation plate (arc)

On some places with wide panoramic vistas you can find orientation plates. Arc formed prints of the panorama. Panotools can make this remapping from a cylindrical panorama to an arc formed one, too. No need to edit scripts here but a pocked calculator might be of some use and you should know the approximate horizontal Field of View (here abbreviated as hfov) of your panorama. This works even for 360� panoramas.

Steps

On Lens Settings tab page choose Cylindrical from the Lens type list, set Hor. Field of View to the field of view of your panorama (120 degrees in our example). Click Restore defaults in the Advanced frame in order to set all lens correction parameters to 0.0. Get your calculator. Use the following formula (provided by Rik Littlefield - many thanks):

r = (image_width_in_pixels*360)/(hfov*2*pi)

In the example case this is

r = (4254*360)/(120*2*3.14) = 2031

Enter the result as a negative value in the vert.(e) Image shift field (-2031 in the example case).

On Panorama Settings tab page choose Projection: Rectilinear and set Field of View to 120 x 120 degrees. This will probably be changed later.

On Image parameters tab page click the Pitch field for your image and set it to 90 in order to view straight down.

On Create Panorama tab page set the width and file format you want for your output image. One single image is created hence any single image format is good. Don't forget the image name. Choose Stitch using: Panorama Tools (PTStitcher) from the Advanced frame and uncheck Use fast transform.

Open panorama editor (Ctrl+E) and adjust panorama width and height using the sliders such that it contains the whole arc. Ocassionaly PTGui fails to display the arc correctly in pano editor. In this case you need to calculate the appropriate values. See below for details.

You might want to crop the result image in your image editor in order to get rid of the black space.

Tweaks

Since the source panorama is arched, the pixels have to be compressed at the inner side and stretched at the outer side. There is a line in the middle where there is no stretching or compression. In most cases it is desireable that this line is the horizon which is assumed to be half way between upper and lower edge of the panorama. If you want this line to be somewhere else simply use a different image shift (e) value. For example -2231 will shift 200 pixels further down (nearer to the center of the result image) than -2031 and create a smaller and narrower arc.

The above calculation

r = (image_width_in_pixels*360)/(hfov*2*pi)

actually calculates the virtual radius (half of the diameter of the cylinder it is projected on) of the cylindrical source image in pixels. We will need this value r for the following calculation.

Result images might get very large large since they have to be symmetrical to the center point of the arcs circle, which requires a lot of black space especially if the source panorama HFoV is low. Occasionaly PTGui pano editor doesn't show the correct result image (although PTStitcher will create the arc correctly) making it impossible to adjust the panorama size manually.

In both cases it might be interesting to create the minimum possible size that covers the whole arc. Since Fit Panorama (in PTGui pano editor) fails in this case we need to calculate the values ourselves.

The minimal vertical FoV value that will cover the whole arc can be calculated by

rvFoV = 2*arctan(r/(e-(image_height/2)))

where e is the positive Image shift you entered in the vert.(e) Image shift field as a negative value and r is the radius from two paragraphs above. In our example:

rvFoV = 2*arctan(2031/(2031-(400/2))) = 95.93 degrees

rvFoV (for result vertical Field of View).

If your source FoV is lower than 180� like in our example the resulting horizontal Field of View (rhFoV) can be lower than the vertical FoV (rvFoV). This can be calculated by

rhFoV = 2*arctan(sin(source_hfov/2) * tan(rvFoV/2))

In our example

2*arctan(sin(120/2)*tan(96/2)) = 87.77 degrees

It is advisable to choose sligtly larger values for both horizontal and vertical result FoV in order not to loose any pixels.