Switch branches/tags
Nothing to show
Pull request Compare This branch is 1 commit ahead of meso-unimpressed:master.


Ruby Deep Zoom Tools

Convert images into the Microsoft Deep Zoom Image (DZI) file format.

DZI files can be rendered using any of the following software:

* Microsoft Silverlight Deep Zoom
* Microsoft Seadragon Ajax
* Microsoft Seadragon Mobile
* Microsoft Live Labs Pivot
* OpenZoom


rmagick gem (tested with version 2.9.0)


require "deepzoom"
image_creator =
image_creator.create("path/to/your/image.jpg", "path/to/your/image.dzi")

Or define custom settings:

require "deepzoom"
image_creator =

# Custom settings
image_creator.tile_size = 508
image_creator.tile_overlap = 2
image_creator.tile_format = "png"
image_creator.image_quality = 0.5
image_creator.copy_metadata = true

# convert
image_creator.create("path/to/your/image.jpg", "path/to/your/image.dzi")

Additional Information

Copyright © 2009, MESO Web Scapes, Sascha Hanssen ( All rights reserved.


  • Sascha Hanssen <>

  • Daniel Gasienica <>

Software distributed under the License is distributed on an “AS IS” basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License.

Deep Zoom and Seadragon are trademarks or registered trademarks of Microsoft, Inc.