Difference between revisions of "Unusual remappings"

From PanoTools.org Wiki
Jump to navigation Jump to search
m (changed thumbs to 250px)
m (changed headline hierarchy)
Line 1: Line 1:
== Unusual remappings ==
+
= 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.
 
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 ===
+
== Little planet ==
 
This is a remapping already used by Helmut Dersch as a thumbnail for his virtual Marburg tour on [http://www.path.unimelb.edu.au/~dersch/] (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.
 
This is a remapping already used by Helmut Dersch as a thumbnail for his virtual Marburg tour on [http://www.path.unimelb.edu.au/~dersch/] (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.
  
  
 
[[Image:little_planet.jpg|thumb|250px|Little planet remapping result © Erik Krause]]
 
[[Image:little_planet.jpg|thumb|250px|Little planet remapping result © Erik Krause]]
==== Steps ====
+
=== Steps ===
 
* Open PTGui, choose '''Advanced mode''' and load your equirect image on '''Source Images''' tab page.
 
* Open PTGui, choose '''Advanced mode''' and load your equirect image on '''Source Images''' tab page.
 
* 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 '''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.
Line 19: Line 19:
  
 
[[Image:little_planet_tweaks.jpg|thumb|250px|Pano editor tweaks in PTGui]]
 
[[Image:little_planet_tweaks.jpg|thumb|250px|Pano editor tweaks in PTGui]]
==== Tweaks ====
+
=== 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. {{clr}}
 
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. {{clr}}
  
Line 27: Line 27:
 
[[Image:pano-editor-settings-360.jpg|thumb|250px|Pano editor and lens settings for 360� in PTGui]]
 
[[Image:pano-editor-settings-360.jpg|thumb|250px|Pano editor and lens settings for 360� in PTGui]]
 
[[Image:orientation-plate-360.jpg|thumb|250px|Arc formed 360� panorama © Erik Krause]]
 
[[Image:orientation-plate-360.jpg|thumb|250px|Arc formed 360� panorama © Erik Krause]]
=== Orientation plate (arc) ===
+
== 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.
 
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 ====
+
=== Steps ===
 
<ul>
 
<ul>
 
<li>Open PTGui, choose '''Advanced mode''' and load your cylindrical image on '''Source Images''' tab page. Note down the pixel sizes. In our example these are 4254x400 pixels.</li>
 
<li>Open PTGui, choose '''Advanced mode''' and load your cylindrical image on '''Source Images''' tab page. Note down the pixel sizes. In our example these are 4254x400 pixels.</li>
Line 43: Line 43:
 
You might want to crop the result image in your image editor in order to get rid of the black space.
 
You might want to crop the result image in your image editor in order to get rid of the black space.
  
==== Tweaks ====
+
=== 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.
 
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.
  

Revision as of 23:28, 13 December 2005

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.


Little planet remapping result © Erik Krause

Steps

  • Open PTGui, choose Advanced mode and load your equirect image on Source Images tab page.
  • 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.


Arc formed panorama © Erik Krause
Pano editor and pano settings in PTGui
Pano editor and lens settings for 360� in PTGui
Arc formed 360� panorama © Erik Krause

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

  • Open PTGui, choose Advanced mode and load your cylindrical image on Source Images tab page. Note down the pixel sizes. In our example these are 4254x400 pixels.
  • 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.
  • On Create Panorama tab page check the output size and click Create panorama.

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.

--Erik Krause 16:09, 13 Dec 2005 (EST)