Panojector is a modular panorama image converter.
| explanation | input | output | options / argument | ||
|---|---|---|---|---|---|
| box | Develop a box | equirectangular | plain image | -b x,y,z | aspect ratio of the box |
| -e x,y,z | eye position | ||||
| cone | Develop a cone | equirectangular | plain image | -r 0.3 | radius of the base |
| -e 0.2 | eye height to cone height | ||||
| cylindrical_to_equirectangular | Cylindrical to equirectangular | Side of a circular cylinder | equirectangular | -s 6 | Number of sides |
| equirectangular | Mercator to equirect | Mercator | equirectangular | No option | |
| exponential | exponential | complex (plain image) | complex (plain image) | No option | |
| invert | invert | complex (plain image) | complex (plain image) | No option | |
| log | log | complex (plain image) | complex (plain image) | No option | |
| mercator | Equirect to Mercator | equirectangular | Mercator | No option | |
| power | power | complex (plain image) | complex (plain image) | -n 2 | Power of n |
| prism | Develop a prism | equirectangular | plain image | -e 0.5 | Eye height. |
| -h 0.5 | Height of the prism. | ||||
| -s 6 | Number of sides. | ||||
| -z 2 | Specify where to attach the zenith cap. | ||||
| -n 2 | Specify where to attach the nadir cap. | ||||
| ribbon | Convert a long image to a ribbon | plain image | plain image | -a 0.5 or -a 200/500 | Aspect ratio of the input image. |
| rotate | Rotate an image | plain image | plain image | -a 0 | Specify angle in degree. |
| scale | Scale an image | plain image | plain image | -x 1 | Specify amounts |
| -y 1 | |||||
| -xy 1 | |||||
| -p | |||||
| slide | Slide an image | plain image | plain image | -x 0 | Specify amounts (in image coordinate) |
| -y 0 | |||||
| stereographic | Equirect to stereographic | equirectangular | plain image | -a 90 | Field of view. |
| swap | Swap xyz axes | equirectangular | equirectangular | -n 1 | Swap xyz axes multiple times. |
| tile | Slanted tiling of a long image. (incommensurate) | plain image | plain image (Mercator) | -a 0.5 or -a 200/500 | Aspect ratio of the input image. |
| -s 8 | Number of stories | ||||
| tile2 | Slanted tiling of a long image. (commensurate) | plain image | plain image (Mercator) | -a 0.5 or -a 200/500 | Aspect ratio of the input image. |
| tilt | Tilt an equirectangular image around the x axis. | equirectangular | equirectangular | -a 0 | Specify angle in degree. |
| tumblerfan | Create your own tumbler | Mercator | plain image | -s wtop,wbot,height | Size of the fan. Wtop and wbot specifies the top and bottom width of the developed fan, and height specifies the fan height. |
| load | Load an image file | file | plain image | file name | |
| interpolate | Load an image file | file | plain image | file name | |
Panojector command accepts a few options.
panojector [-s size][-o outfile][list of plugins.....] load filename
-s n Set image size to n x n.
-o file Specify the output file name.
Plugin describes how to project the (-1..+1)x(-1..+1) plane onto another (-1..+1)x(-1..+1) plane. You can apply these projection plugins to the original image by giving plugin(s) as an argument(s) of the panojector command.
For example,
./panojector -s 400 mercator load original.jpg
converts the equirectangular image into mercator projection and output as a 400x400 image.
./panojector -s 600 box equirectangular load original.jpg
converts an Mercator panorama into equirectangular panorama and then develops as a box.
When multiple plugins are given, they work as a pipeline. Each plugin accepts options as its argument. Note that x coordinate points to the right, while y coordinate directs downwards. For complex coordinate, real points to the right, and imaginary directs downwards.
This converts the sample rectangular image to a swirl:
./panojector -s 600 stereographic equirectangular tile2 -a 706/881 load sample.jpg
The first plugin “tile2” tiles the original image, second plugin “equirectangular” regards the image as a Mercator (conformal) panorama and convert it into equirectangular panorama image, and the last plugin “stereographic” converts the equirectangular panorama into stereographic (conformal) image.
This converts the inverted little planet image back to equirectangular panorama:
./panojector -s 1000 slide -x 1.25 equirectangular rotate -a 90 slide -x -0.25 exponential load sample2.jpg
(The sample image is provided by Pedro Moura Pinheiro at http://www.flickr.com/photos/pedromourapinheiro/4929306871 under Creative Commons (CC BY-NC-SA 2.0) License.)
This converts a long train image to 6-story ribbon:
./panojector -s 1000 ribbon -a 826/29999 -s 6 load sample3.jpg
This converts the same image into a swirl:
./panojector -s 1000 stereographic equirectangular tile -a 826/29999 -s 8 load sample3.jpg
and a tilted swirl:
./panojector -s 1000 rotate -a 45 stereographic -a 300 tilt -a 30 equirectangular tile -a 826/29999 -s 8 load sample3.jpg
For now, we provide only one rotation plugin, “tilt”, to give a rotation angle around the X axis to an equirectangular image. In order to rotate the equirectangular image with YAW, PITCH, and ROLL angles in PTgui and Hugin way, use the following parameters: (YAW, PITCH, and ROLL should be replaced by the values.)
./panojector -s 1000 swap tilt -a -YAW swap tilt -a PITCH swap tilt -a ROLL load sample4.jpg
You can even “Create Your Own Starbucks Tumbler.”
./panojector -s 1000 tumblerfan -s 214,173,163 tile -a 826/29999 -s 8 load sample3.jpg
A small utility boxsize.py calculates the proper dimension of the box for your equirectangular panorama image. Here is an example image of a Japanese room. (The sample image is provided in a courtesy of Simon Sherwin. Original photo is available at Flickr. Please download the original image by yourself and rename it as sample.jpg.)
-
Measure the dimensions of the images: picture width, positions of four corners, and ceiling and floor positions at the first corner.
-
Put them as arguments of the boxsize.py program and run it. The program estimates the eye position in the box.
./boxsize.py 4000 538 1432 2541 3445 772 1247 -
You get the optimal parameters to convert the image into a box development. Modify as you like, and run it.
./panojector -s 4000 box -b 1,1.1724609375,0.609415798286 -e 0.5064453125,0.504081292687,0.521980455925 slide -x 0.269 interpolate sample.jpg