1. Skip to navigation
  2. Skip to content
  3. Skip to sidebar


Welcome to the GigaPan Forum!

This is the place for Gigapan.com members to offer peer-to-peer support for exchanging tips, ideas, comments, etc.

Those who need direct technical assistance with their GigaPan EPIC Series imagers, stitching software or gigapan.com membership account should contact us.

Forums » Upload » Image pyramid on local disk?

Image pyramid on local disk?
Marc Buma Marc Buma
Total Posts: 3

Is there any way to use the uploader (or another tool) to create a local image pyramid in gigapan format? I have a panorama made with an external stitcher (it failed to stitch in the gigapan stitcher) that I want to burn to DVD for offline viewing…

Jason Buchheim Jason Buchheim
Total Posts: 86

Hello Marc,

A few years ago I created a tool to upload Gigapans to my own local server. It was a series of php scripts run on apache that mimicked the gigapan server and allowed me to use the gigapan upload program to dice up my image and save it locally in Gigapan format.

I posted the code in the old gigapan forum here http://forum.gigapan.org/viewtopic.php?p=2646 , it should still work.

An alternative would be to buy a license for the excellent Krpano viewer http://Krpano.com and use the included dicing tool and the Krpano viewer, (which can display 360 degre panoramas as well as flat panoramas by setting the field of view to 1 degree. I use the Krpano viewer to deliver the Gigapans in 360 degrees at http://www.3d-360.com/34725

Good luck


Marc Buma Marc Buma
Total Posts: 3

Hi Jason,

Thanks, that is some nifty code there! I tested yesterday on centos / apache, but the uploader finished the first batch of images and then got stuck trying to resend (data transmission error, retrying). I tried with the new (2.0) and old (0.4) versions of the uploader, with the same result: looks like the uploader is not getting the return codes it expects… I will give it a try on windows apache tonight.

I am using krpano/krtools viewer as well, but with the gigapan tiling scheme: I’d prefer to have a single storage format for all gigapans…

btw: cool panorama!

Jason Buchheim Jason Buchheim
Total Posts: 86

Concerning uploading Gigapan to your local server so that you can have an image pyramid locally in Gigapan format, below is the code for this.

The file ‘putTile.php’ noted in my previous post was for receiving the tiles using uploader protocol version 1, the new version 2 protocol uploads up to 50 image tiles at a time per post as part of multipart data, and the server does a sum checksum on each tile to verify that it recieved all the data without errors. It is much faster than the original uploader.

I just updated the ‘putTile.php’ code to function with protocol version 2 (although I have not implemented the checksum test of the data as I am not sure what the algorithm is to generate the checksum value from the image tile data, so I am just echoing the given correct value back to the uploader to keep it happy. Anyone out there know the checksum algorithm?)

As this forum does not have any means for posting code, I have the code uploaded as text files to my server, please rename the php and html files by dropping the trailing .txt

Caveat, this is NOT production environment ready code, it works great for your personal use on a local serve, but if you were to put it into production web environment, you would want proper session management, username management, and to implement the image checksum calculations – there is currently nothing in the putTile.php that verifies authority to put the tile there, it is open for attack if it was on a live public access server.

The great WAMP server will get you set up on Windows http://www.wampserver.com/en/

The files for setting up a local upload receiving server for Gigapans are here:
rpc.php http://www.3d-360.com/upload/rpc.php.txt
putTile.php http://www.3d-360.com/upload/putTile.php.txt
gigapan_number.txt http://www.3d-360.com/upload/gigapan_number.txt
gigapan_index.html http://www.3d-360.com/upload/gigapan_index.html…

If you installed WAMP at c:/WAMP, put these files at c:/wamp/www and create the folder c:/wamp/www/gigapans

use the current Gigapan Uploader and when asked for your username, use USERNAME@localhost and password is PASSWORD (unless you change these in rpc.php)

Happy local Gigapanning


Marc Buma Marc Buma
Total Posts: 3

Hi Jason,

Works like a charm: Thanks a lot for the assistance!

Groeten, Marc

PS. This is one of my projects with local storage: The city hall of Utrecht, the Netherlands through the ages… http://www.bumos.nl/3dc/.

kore24 kore24
Total Posts: 1


I tried to open gigapan_index.html but the resources were not found. Is there another way of generating a stack of local (Gigapan) images? Thanks for your support, I’m pretty stuck!

Forums» Upload » Image pyramid on local disk?