hdmake 

hdmake is a Windows command line tool that takes one or more large image and produces a tiled image set suitable for streaming over the web to Deep Zoom or HD View. It also produces the necessary xml manifest files and an example web page that embeds Deep Zoom and/or HD View. The tool is available from the Microsoft Research download page here (32 bit) or here (64 bit).   A forum for hdmake community based support is available here.

The command line options for the tool are described here:

-?
Display usage information
Top of page

-src image.{tif|png|jpg|wdp|bmp}
(one src argument is required)
source image that you wish to tile
Top of page

-srcgrid grid_width grid_height images[1->width][1].{tif|jpg|png|wdp|bmp} ... images[1->width][height]
(one src argument is required)
grid of w by h source images that you wish to tile
Top of page

-srcgridfile grid_width grid_height filename
(one src argument is required)
text file containing grid of w by h source images that you wish to tile
Top of page

-quality(0-1)
(this argument is optional)
specifies the compression quality for the output tiles. Note the quality of '1' means lossless compression. This will result in large tile sizes and is not suitable for web content. All of the imagery in the HD View web site uses a quality of 0.75. Default is 0.8.
Top of page

-xmlflat filename.xml
(this argument is optional)
specifies to generate an xml manifest for a 'flat' file. Use this when you want the viewer to not do any compensation for cylindrical or spherical distortions.
Top of page

-xmlsphere filename.xml panmin panmax tiltmin tiltmax
(this argument is optional)
specifies to generate an xml manifest for a 'spherical' file. Use this when providing an image that has undergone spherical (also called equirectangular) distortions and you want HD View to undo the distortion.
panmin is the angle(degrees) for the left column of the image
panmax is the angle(degrees) for the right column of the image
tiltmin is the angle(degrees) for the top row of the image
tiltmax is the angle(degrees) for the bottom row of the image

Example: for a 180 wide by 90 degree tall pano
-xmlsphere mysphere.xml 90 270 45 135

Note that as in the example you should specify this such that the center of the pan range is 180. tiltmin and tiltmax should be set consistent with the north pole being 0 and the south-pole being 180 degrees. In this case the sphere is centered at the equator thus the 45 – 135 range.
Top of page

-xmlcntrsphere filename.xml hfov
(this argument is optional)
specifies to generate an xml manifest for a 'spherical' file. This is similar to the previous case, except that it specifies that the center row of the image is at the equator. hfov indicates the horizontal field of view (degrees), given this hdmake can automatically compute tiltmin and tiltmax
Top of page

-xmlcyl filename.xml panmin panmax tiltmin tiltmax
(this argument is optional)
specifies to generate an xml manifest for a 'cylindrical' file. The arguments have the same description as xmlsphere. The difference is that the viewer will interpret the file as coming from a cylindrical source.
Top of page

-xmlcntrcyl filename.xml hfov
(this argument is optional)
specifies to generate an xml manifest for a 'cylindrical' file. The arguments have the same description as xmlscntrphere. The difference is that the viewer will interpret the file as coming from a cylindrical source.
Top of page

-xmlspheretrans filename.xml tiltmin tiltmax panmin panmax
(this argument is optional)
specifies to generate an xml manifest for a 'spherical transverse' file. Like -xmlsphere but vertically not horizontally oriented.
tiltmin is the angle(degrees) for the top row of the image
tiltmax is the angle(degrees) for the bottom row of the image
panmin is the angle(degrees) for the left column of the image
panmax is the angle(degrees) for the right column of the image

Example: for a 180 degree tall by 90 wide pano
-xmlspheretrans myspheretrans.xml 90 270 45 135

Note that as in the example you should specify this such that the center of the tilt range is 180. panmin and panmax should be set consistent with the 'west pole' being 0 and the 'east pole' being 180 degrees. In this case the sphere is centered at 0 thus the 45 – 135 range.
Top of page

-xmlcntrspheretrans filename.xml vfov
(this argument is optional)
specifies to generate an xml manifest for a 'spherical transverse' file. This is similar to the previous case, except that it specifies that the center column of the image is at 0. vfov indicates the vertical field of view (degrees), given this hdmake can automatically compute panmin and panmax
Top of page

-xmlcyltrans filename.xml tiltmin tiltmax panmin panmax
(this argument is optional)
specifies to generate an xml manifest for a 'cylindrical transverse' file. Like -xmlcyl but vertically not horizontally oriented.
Top of page

-xmlcntrcyltrans filename.xml fov
(this argument is optional)
specifies to generate an xml manifest for a 'cylindrical transverse' file. Like -xmlcntrcyl but verticall not horizontally oriented.
Top of page

-xmlwlpg filename.xml
(this argument is optional)
The Windows Live Photo Gallery (WLPG) has a panoramic stitching feature.  If you use WLPG stitching, the resultant files have embedded metadata that describe the image projection.  This argument specifies to read that metadata and use that to generate the xml file.  More details on the metadata are available here.
Top of page

-xmlautopano filename.xml
(this argument is optional)
Autopano (by Kolor) is a panoramic stitcher.  If you use Autopano stitching, the resultant files have embedded metadata that describe the image projection.  This argument specifies to read that metadata and use that to generate the xml file.  More details are available here.
Top of page

-viewer {0 = hdview, 1 = deepzoom, 2 = automatic}
(this argument is optional)
specifies the viewer for the web page: HD View or Deep Zoom. 'Automatic' (the default) means use HD View if the platform supports it and Deep Zoom otherwise.
Top of page

-html
(this argument is optional)
specifies to generate a simple web page that embeds HD View and loads the generated tile set.
Top of page

-extension {jpg|png|wdp}
(this argument is optional)
specifies image type for the generated tile set. Default is 'wdp' for HD View viewer or 'jpg' otherwise.
Top of page

-tileformat {0 = flat, 1 = hierarachy, 2 = Seadragon}
(this argument is optional)
can specify folder-per-column hierarchy rather than the Seadragon default of folder-per-level to reduce the number of files per directory. Must be Seadragon for Deep Zoom.
Top of page

-notiles
(this argument is optional)
generate .xml and .html only; no image tiles. Useful to regenerate .xml descriptions with existing tile sets.
Top of page

-nozip
(this argument is optional)
by default the tiles are written into one or more zip files, use this option to instead write the tiles directly to file-system folders.
Top of page

-zipsize size(MB)
(this argument is optional)
if zip output is selected then this option can be used to split into multiple zips that have each a maximum size specified by this parameter.
Top of page