hdmake
hdmake is a Windows command line tool that takes a single large image and produces a tiled image set suitable for streaming
over the web to HD View. It also optionally produces the xml manifest file that describes the tile set to HD View. The tool
is available from the Microsoft Research download page
here.
The command line options for the tool are described here:
-?
Display usage information
Top of page
-src image.{tif|png|jpg|wdp|bmp}
(this argument is required)
source image that you wish to tile
Top of page
-dst path quality(0-1)
(this argument is optional)
'folder' specifies the destination folder for the tile set.
'quality' 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 values are 'tiles' for folder and 0.8 for quality.
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 an 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 fov
(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. fov 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 fov
(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
-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
-xmldeepzoom filename.xml
(this argument is optional)
Generate a Deep Zoom tile site and (if requested) html file instead of HD View tile set.
Top of page
-html filename.htm
(this argument is optional)
specifies to generate a simple web page that embeds HD View and loads the generated tile set.
Top of page
The command line options for the tool are described here:
-?
Display usage information
Top of page
-src image.{tif|png|jpg|wdp|bmp}
(this argument is required)
source image that you wish to tile
Top of page
-dst path quality(0-1)
(this argument is optional)
'folder' specifies the destination folder for the tile set.
'quality' 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 values are 'tiles' for folder and 0.8 for quality.
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 an 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 fov
(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. fov 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 fov
(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
-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
-xmldeepzoom filename.xml
(this argument is optional)
Generate a Deep Zoom tile site and (if requested) html file instead of HD View tile set.
Top of page
-html filename.htm
(this argument is optional)
specifies to generate a simple web page that embeds HD View and loads the generated tile set.
Top of page
