<b> Important!</b> For all transformations that use non-overlapping images like assembling cube faces to an [[equirectangular]] image the 'Fast transform' option should be disabled. As a default 'Fast transform' is disabled for the [[Panorama Tools Plugins]] and for [[PTEditor]]. However, it is enabled by default for some of the GUIs ([[PTGui]] f.e.)

+

<b>Important!</b> For all transformations that use non-overlapping images like assembling cube faces to an [[equirectangular]] image the 'Fast transform' option should be disabled. As a default 'Fast transform' is disabled for the [[Panorama Tools Plugins]] and for [[PTEditor]]. However, it is enabled by default for some of the GUIs ([[PTGui]] f.e.)

Fast Transform can cause the loss of some pixels in the corners of an [[Rectilinear Projection|rectilinear]] image which will be visible as small triangular black holes in the result image. More on 'Fast Transform' on [http://www.fsoft.it/panorama/pano12.htm Fulvio Senore's page].

Fast Transform can cause the loss of some pixels in the corners of an [[Rectilinear Projection|rectilinear]] image which will be visible as small triangular black holes in the result image. More on 'Fast Transform' on [http://www.fsoft.it/panorama/pano12.htm Fulvio Senore's page].

−

== Possibilities ==

+

PTGui 5 has a new internal stitcher which causes a similar effect even if Fast Transform is switched off. <b>Don't use PTGui 5 internal stitcher to assemble cubefaces!</b> Choose "Panotools Stitcher" (PTStitcher) instead.

−

There are basically three possibilities to extract partial [[Rectilinear Projection|rectilinear]] views:

+

+

== Possibilities with panotools ==

+

There are basically three possibilities to extract partial [[Rectilinear Projection|rectilinear]] views with panorama tools:

* [[PTEditor]]

* [[PTEditor]]

* [[Panorama Tools Plugins]]

* [[Panorama Tools Plugins]]

Line 16:

Line 18:

=== PTEditor ===

=== PTEditor ===

−

[[PTEditor]] is a [[Java]] application provided with the standard [[Panorama Tools]] distribution. It should run on any OS where Java and the panotools runtime (the [[pano12]] library) is installed. There is a nice tutorial on [[How to use PTEditor]]. This is the most convenient way to extract and insert any arbitrary [[Rectilinear Projection|rectilinear]] view. The disadvantage is that it doesn't save 16 bit images.

+

[[PTEditor]] is a [[Java]] application provided with the standard [[Panorama Tools]] distribution. It should run on any OS where Java and the panotools runtime (the [[pano12]] library) are installed. There is a nice tutorial on [[How to use PTEditor]]. This is the most convenient way to extract and insert any arbitrary [[Rectilinear Projection|rectilinear]] view. The disadvantage is that it doesn't save 16 bit images.

=== Panotools plugins ===

=== Panotools plugins ===

−

The [[Photoshop]] and [[Gimp]] compatible [[Panorama Tools Plugins]] are part of the standard Panotools distribution as well. There is an upgraded version available from [http://epaperpress.com/ptplugins/index.html Thomas Niemann] that corrects some bugs and works for 16 bit.

+

The [[Photoshop]] and [[Gimp]] compatible [[Panorama Tools Plugins]] are part of the standard Panotools distribution as well. The most recent version that corrects some bugs and works for 16 bit is available as part of the panotools download from [http://sourceforge.net/projects/panotools/ panotools sourceforge page].

The plugins contain the [[Panorama Tools Plugins#Adjust|Adjust]] filter, which is capable of extracting and inserting any view in almost any projection. Any data (pan/tilt angle, size of view etc.) has to be inserted manually. Yaw, roll and pitch value have to be calculated or estimated which makes the usage a bit inconvenient.

The plugins contain the [[Panorama Tools Plugins#Adjust|Adjust]] filter, which is capable of extracting and inserting any view in almost any projection. Any data (pan/tilt angle, size of view etc.) has to be inserted manually. Yaw, roll and pitch value have to be calculated or estimated which makes the usage a bit inconvenient.

−

However, extracting and inserting [[Zenith]] or [[Nadir]] is straightforward and relatively easy. [[Helmut Dersch]] has outlined the basic workflow in [http://www.path.unimelb.edu.au/~dersch/panorectilinear/panorectilinear.html Extracting Rectilinear Images from Panoramas]. You need to do the following:

+

However, extracting and inserting [[Zenith]] or [[Nadir]] is straightforward and relatively easy. [[Helmut Dersch]] has outlined the basic workflow in [http://www.panotools.org/dersch/panorectilinear/panorectilinear.html Extracting Rectilinear Images from Panoramas]. You need to do the following:

==== Extracting ====

==== Extracting ====

Line 71:

Line 73:

* Press 'Ok' to perform the transformation

* Press 'Ok' to perform the transformation

−

The image is loaded as a document containing an alpha channel with the mask. In photoshop you can move this into a masked layer:

+

The image is loaded as a document containing an [[alpha channel]] with the mask. In photoshop you can move this into a masked layer:

* In the layers palette double click the layer thumbnail in order to create a layer from background.

* In the layers palette double click the layer thumbnail in order to create a layer from background.

* Choose 'Load Selection' from the 'Select' menu.

* Choose 'Load Selection' from the 'Select' menu.

−

* Choose 'Channel: Alpha 1' as new selection and pess 'Ok'

+

* Choose 'Channel: Alpha 1' as new selection and press 'Ok'

* Click the 'Add vector mask' button in the bottom line of the layers palette.

* Click the 'Add vector mask' button in the bottom line of the layers palette.

* Shift-Drag (pres and hold the shift key after started dragging) the layer from the layers palette to your original panorama.

* Shift-Drag (pres and hold the shift key after started dragging) the layer from the layers palette to your original panorama.

Line 90:

Line 92:

==== PanoCube Plus ====

==== PanoCube Plus ====

−

[[PanoCube]] Plus can extract six cube faces (single, batch modes) for editing and then convert it directly into [[QuickTime]] cubic movie(s). Both 8/16 bits per channel are supported - depending on the [[pano12]] library used the cube faces are the same bit depth as the source images.

+

[[PanoCube]] Plus can extract six cube faces (single, batch modes) for editing and then convert it directly into [[QTVR]] cubic movie(s). Both 8/16 bits per channel are supported - depending on the [[pano12]] library used the cube faces are the same bit depth as the source images.

To activate "equirectangular to 6 cube faces" mode copy the file <code>Script.txt</code> to the folder where your source image is and set "1" as first character in this line using a text editor (notepad!):

To activate "equirectangular to 6 cube faces" mode copy the file <code>Script.txt</code> to the folder where your source image is and set "1" as first character in this line using a text editor (notepad!):

Line 98:

Line 100:

in the file <code>Script.txt</code> and put it into pano's folder. Next drag and drop your single pano or folder with panos onto the program icon. The source file name and path should contain no spaces. The source image must be exactly in 2:1 format (f.e. 2000x1000 or 6000x3000 pixels). [[PanoCube]] calls [[PTStitcher]] 6 times and creates 6 files in the order front, right, back, left, top, bottom and replaces the last two characters of the name with 11, 22, 33, 44, 55, 66. All files ended with 55 are represent zenith view, ended with 66 - nadir view.

in the file <code>Script.txt</code> and put it into pano's folder. Next drag and drop your single pano or folder with panos onto the program icon. The source file name and path should contain no spaces. The source image must be exactly in 2:1 format (f.e. 2000x1000 or 6000x3000 pixels). [[PanoCube]] calls [[PTStitcher]] 6 times and creates 6 files in the order front, right, back, left, top, bottom and replaces the last two characters of the name with 11, 22, 33, 44, 55, 66. All files ended with 55 are represent zenith view, ended with 66 - nadir view.

−

After editing drag again any one (not all!) tile or folder with tiles to get [[QuickTime]] cubic movie(s). In batch mode important to have first six letters differ in filenames, otherwice PanoCube can skips "similar" files.

+

After editing drag again any one (not all!) tile or folder with tiles to get [[QTVR]] cubic movie(s). In batch mode important to have first six letters differ in filenames, otherwice PanoCube can skips "similar" files.

This technique is good if the final product is a [[QTVR]] movie. If you need an equirectangular for PTViewer you can of course drag the .mov file on panocube plus to get it converted, but image quality suffers because of intermediate [[JPEG]] compression and decompression and another [[interpolation]] step.

This technique is good if the final product is a [[QTVR]] movie. If you need an equirectangular for PTViewer you can of course drag the .mov file on panocube plus to get it converted, but image quality suffers because of intermediate [[JPEG]] compression and decompression and another [[interpolation]] step.

All of the [[GUI front-ends]] should be capable of extracting an arbitrary [[Rectilinear Projection|rectilinear]] view from a spherical pano. Use the equirect image as input (don't forget to set the correct FoV) and specify a rectilinear image with 90� as output "panorama". Set all lens correction parameters to 0.0. Then change yaw and pitch of the input image until you get the desired view. Note that the values work the other way round than when inserting an image.

+

All of the [[GUI front-ends]] should be capable of extracting an arbitrary [[Rectilinear Projection|rectilinear]] view from a spherical pano. Use the equirect image as input (don't forget to set the correct FoV) and specify a rectilinear image with 90° as output "panorama". Set all lens correction parameters to 0.0. Then change yaw and pitch of the input image until you get the desired view. Note that the values work the other way round than when inserting an image.

==== PTGui ====

==== PTGui ====

Line 137:

Line 139:

On the 'Panorama Settings' tab don't forget to uncheck 'Use fast transform' (for details see [[#Warning|Warning]] at top of page).

On the 'Panorama Settings' tab don't forget to uncheck 'Use fast transform' (for details see [[#Warning|Warning]] at top of page).

−

To pan along the horizon f.e. in 20� steps insert 20 into the 'Yaw' field and press 'Apply' repeatedly until you get the desired view. Positive values pan right, negatives left.

+

To pan along the horizon f.e. in 20° steps insert 20 into the 'Yaw' field and press 'Apply' repeatedly until you get the desired view. Positive values pan right, negatives left.

Do the corresponding for 'Pitch' and 'Roll' if needed. This way you can extract any partial view. Once your are done create the "Panorama" (which is the desired partial view) using output format [[TIFF]]. Note down or save the exact values for Yaw, Roll and Pitch as shown on 'Image Parameters" tab page.

Do the corresponding for 'Pitch' and 'Roll' if needed. This way you can extract any partial view. Once your are done create the "Panorama" (which is the desired partial view) using output format [[TIFF]]. Note down or save the exact values for Yaw, Roll and Pitch as shown on 'Image Parameters" tab page.

−

Now edit the partial view to your need. Then add it to the project with your original panorama and on 'Panorama settings' tab change to equirectangular and 360�x180�. Choose individual lens parameters for the new image on 'Lens settings' tab and set 'Rectilinear' and 90� on 'Image parameters' tab. The image should fit now perfectly in the original panorama.

+

Now edit the partial view to your need. Then add it to the project with your original panorama and on 'Panorama settings' tab change to equirectangular and 360°x180°. Choose individual lens parameters for the new image on 'Lens settings' tab and set 'Rectilinear' and 90° on 'Image parameters' tab. The image should fit now perfectly in the original panorama.

In order to move the panorama back to it's original position go to panorama editor again and choose 'Numerical transform'. Now Enter the exact values for Yaw, Roll and Pitch you previously saved or noted down. The panorama should move back to it's original position now.

In order to move the panorama back to it's original position go to panorama editor again and choose 'Numerical transform'. Now Enter the exact values for Yaw, Roll and Pitch you previously saved or noted down. The panorama should move back to it's original position now.

Line 147:

Line 149:

You can create either the complete panorama or the partial view only. Choose the size of the original panorama for output.

You can create either the complete panorama or the partial view only. Choose the size of the original panorama for output.

−

--[[User:Erik Krause|Erik Krause]] 18:30, 20 Mar 2005 (EST)

+

There are two templates available for conveniently extract and insert the floor cube face using this technique from [http://erik-krause.de/ttt#Bodenbild_extrahieren http://erik-krause.de/ttt]

+

+

== Other possibilities ==

+

* The free [http://www.superrune.com/technical/software_supercubic.php Super Cubic plugin] for photoshop extracts and inserts both [[zenith]] and [[nadir]].

+

* A video tutorial using Photoshop actions and PTGui templates can be found here: [http://www.youtube.com/watch?v=owq7kaXMTTk Nadir patching in Photoshop with actions and PTGui templates]

+

* A two parts [http://panospace.wordpress.com/2008/03/18/edit-the-nadir/ tutorial] with [[Hugin]]

Intro

One of the most problematic points when shooting spherical panoramas is the view straight down also called the nadir view. Either the tripod is visible or there may be alignment or color mismatches if shooting handheld.

Unfortunately neither the nadir nor the zenith (straight above) area can be edited directly in the equirectangular image since it is very distorted. For this task we need to extract a partial view - best in Rectilinear Projection.

Warning

Important! For all transformations that use non-overlapping images like assembling cube faces to an equirectangular image the 'Fast transform' option should be disabled. As a default 'Fast transform' is disabled for the Panorama Tools Plugins and for PTEditor. However, it is enabled by default for some of the GUIs (PTGui f.e.)

Fast Transform can cause the loss of some pixels in the corners of an rectilinear image which will be visible as small triangular black holes in the result image. More on 'Fast Transform' on Fulvio Senore's page.

PTGui 5 has a new internal stitcher which causes a similar effect even if Fast Transform is switched off. Don't use PTGui 5 internal stitcher to assemble cubefaces! Choose "Panotools Stitcher" (PTStitcher) instead.

Possibilities with panotools

There are basically three possibilities to extract partial rectilinear views with panorama tools:

PTEditor

PTEditor is a Java application provided with the standard Panorama Tools distribution. It should run on any OS where Java and the panotools runtime (the pano12 library) are installed. There is a nice tutorial on How to use PTEditor. This is the most convenient way to extract and insert any arbitrary rectilinear view. The disadvantage is that it doesn't save 16 bit images.

The plugins contain the Adjust filter, which is capable of extracting and inserting any view in almost any projection. Any data (pan/tilt angle, size of view etc.) has to be inserted manually. Yaw, roll and pitch value have to be calculated or estimated which makes the usage a bit inconvenient.

PanoCube Plus

PanoCube Plus can extract six cube faces (single, batch modes) for editing and then convert it directly into QTVR cubic movie(s). Both 8/16 bits per channel are supported - depending on the pano12 library used the cube faces are the same bit depth as the source images.

To activate "equirectangular to 6 cube faces" mode copy the file Script.txt to the folder where your source image is and set "1" as first character in this line using a text editor (notepad!):

1 # create tiles for editing ( 0 = NO, 1 = YES). Default NO.

in the file Script.txt and put it into pano's folder. Next drag and drop your single pano or folder with panos onto the program icon. The source file name and path should contain no spaces. The source image must be exactly in 2:1 format (f.e. 2000x1000 or 6000x3000 pixels). PanoCube calls PTStitcher 6 times and creates 6 files in the order front, right, back, left, top, bottom and replaces the last two characters of the name with 11, 22, 33, 44, 55, 66. All files ended with 55 are represent zenith view, ended with 66 - nadir view.

After editing drag again any one (not all!) tile or folder with tiles to get QTVR cubic movie(s). In batch mode important to have first six letters differ in filenames, otherwice PanoCube can skips "similar" files.

This technique is good if the final product is a QTVR movie. If you need an equirectangular for PTViewer you can of course drag the .mov file on panocube plus to get it converted, but image quality suffers because of intermediate JPEG compression and decompression and another interpolation step.

possibility to patch nadir in a relative early stage of editing thus leaving open any possibility of correcting over all colors etc.

preserving as much as possible of the original image data

To re-insert the patched cubeface into the original document implies that you have worked on a cube face with enough resolution, preferable the pixel width of the original pano divided by 3.

You can use the batch file or PTGui template mentioned above. You simply have to set output size equal to your original panorama size and create single image TIFFs as output. Any of those TIFF files can be added to the original panorama as a masked layer using the "Tiff to masked layers" action from http://www.erik-krause.de/ttt

GUI

All of the GUI front-ends should be capable of extracting an arbitrary rectilinear view from a spherical pano. Use the equirect image as input (don't forget to set the correct FoV) and specify a rectilinear image with 90° as output "panorama". Set all lens correction parameters to 0.0. Then change yaw and pitch of the input image until you get the desired view. Note that the values work the other way round than when inserting an image.

PTGui

PTGui offers an additional advantage: The panorama editor and numerical transform. To use it load your image as described above, open panorama editor and choose 'Numerical Transform' from the edit menu.

On the 'Panorama Settings' tab don't forget to uncheck 'Use fast transform' (for details see Warning at top of page).

To pan along the horizon f.e. in 20° steps insert 20 into the 'Yaw' field and press 'Apply' repeatedly until you get the desired view. Positive values pan right, negatives left.

Do the corresponding for 'Pitch' and 'Roll' if needed. This way you can extract any partial view. Once your are done create the "Panorama" (which is the desired partial view) using output format TIFF. Note down or save the exact values for Yaw, Roll and Pitch as shown on 'Image Parameters" tab page.

Now edit the partial view to your need. Then add it to the project with your original panorama and on 'Panorama settings' tab change to equirectangular and 360°x180°. Choose individual lens parameters for the new image on 'Lens settings' tab and set 'Rectilinear' and 90° on 'Image parameters' tab. The image should fit now perfectly in the original panorama.

In order to move the panorama back to it's original position go to panorama editor again and choose 'Numerical transform'. Now Enter the exact values for Yaw, Roll and Pitch you previously saved or noted down. The panorama should move back to it's original position now.

You can create either the complete panorama or the partial view only. Choose the size of the original panorama for output.

There are two templates available for conveniently extract and insert the floor cube face using this technique from http://erik-krause.de/ttt