Skip to content

soichih/jquery-tileviewer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

96 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TileViewer

Tiled Image Viewer Client & Tile generator.

Tileviewer is a jQuery plugin that allows users to view stupendously large images (like 30k by 30k pixels or more) via HTML5 capable browser without having to download the whole image. User can zoom in & pan using a mouse similar to Google Map, and TileView only downloads parts of the image (tiles) that needs to be downloaded at varying zoom levels.

Tileviewer has a server side script (tile.py) which will split your original large image into many small (usually 256x256 pixels) pyramid-tiles and Tileviewer jQuery plugin will use AJAX to download them as needed.

Installation

In order to display your image via TileViewer, first you need to tile your images using tile.py (get it from the Download page) on your web server.

For png tiles (default)

./bin/tile.py large_image.png -o tiledir

For jpeg tiles (smaller)

You will need to install libjpeg-devel and reinstall pillow / image pip modules

./bin/tile.py large_image.png -t jpg -o tiledir

You can then create use TileViewer plugin to render your image by doing something like following.

<!DOCTYPE html>
<html>
<body>
<h1>TileView Demo</h1>
<div id="demo" class="tileviewer"></div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
<script src="http://soichih.github.io/jquery-tileviewer/jquery.mousewheel.js"></script>
<script src="http://soichih.github.io/jquery-tileviewer/jquery.tileviewer.js"></script>
<script>
   $("#demo").tileviewer({ src: "tiles/my_big_image" }).width("700").height("500"); 
</script>
</body>
</html>

Please note that, due to XSS restriction, you have to host your images on the same domain that you are hosting this page.

Contact me if you have any problem / comments, etc. at [email protected]

About

jQuery TileViewer plugin

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •