https://github.com/ac000/deepzoom_tiler

This is a program to create tiles from a given image suitable for viewing in a DeepZoom viewer such as OpenSeadragon.
https://github.com/ac000/deepzoom_tiler

Last synced: 7 days ago
JSON representation

This is a program to create tiles from a given image suitable for viewing in a DeepZoom viewer such as OpenSeadragon.

• Host: GitHub
• URL: https://github.com/ac000/deepzoom_tiler
• Owner: ac000
• License: gpl-3.0
• Created: 2011-08-14T18:01:09.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2014-06-14T16:59:48.000Z (over 10 years ago)
• Last Synced: 2023-04-14T01:30:45.798Z (over 1 year ago)
• Language: C
• Homepage:
• Size: 154 KB
• Stars: 2
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README
  • License: COPYING

Awesome Lists containing this project

README

        
Overview

========

This is a program to create image tiles from a given image that is suitable

for use in a DeepZoom[1] viewer such as OpenSeadragon[2].

Basically it builds up a pyramid of tiles with each level being half the size

of its predecessor. Each level shows the same image, just at a different size.

See [3] and [4] for details on this, having read Microsoft's documentation[5]

those proved to be indispensable.

NOTE: If you want to create pyramids of large files (where large uses up

most/all your memory and takes minutes to complete if at all) then you

should look at VIPS[7] and this example[8] of how to use it to create

DeepZoom images.

Requirements

============

The only thing other than a C compiler is GraphicsMagick[6].

Usage

=====

$ deepzoom_tiler [-t tile size] [-o overlap] [-h] 

-t tile size is the size of the tiles to create. If you don't specify it it

defaults to 256.

-o overlap is the number of pixels to overlap the tiles by, it defaults to 0

(no overlap)

-h prints the usage text.

image is the name of the image to tile.

For a quick start, do the following.

Create a directory, say deepzoom.

Download and untar OpenSeadragon in the above directory. Create a symlink

for openseadragon -> openseadragon-bin-x.x.x

Put an image in the above directory.

Run '/path/to/deepzoom_tiler image.jpg' from the above directory.

That will create a directory called image_files and a file called image.dzi

Create an html file in the above directory, say openseadragon.html with the

following contents;



	var viewer = OpenSeadragon({

		id: "container",

		prefixUrl: "openseadragon/images/",

		tileSources: "image.dzi"

	});

Then open that html file in a browser and you should get a window showing your

image that you can pan and zoom. You can use the button controls or your

mouse wheel to zoom in and out.

[1] - http://en.wikipedia.org/wiki/Deep_Zoom

[2] - http://openseadragon.github.io/

[3] - http://gasi.ch/blog/inside-deep-zoom-1/

[4] - http://gasi.ch/blog/inside-deep-zoom-2/

[5] - http://msdn.microsoft.com/en-us/library/cc645077%28v=VS.95%29.aspx

[6] - http://www.graphicsmagick.org/

[7] - http://www.vips.ecs.soton.ac.uk/index.php?title=VIPS

[8] - http://libvips.blogspot.co.uk/2013/03/making-deepzoom-zoomify-and-google-maps.html