Project description

Django-deepzoom is a drop-in Django app for the creation and use of Deep Zoom
tiled images. It handily integrates Daniel Gasienica’s and Kapil Thangavelu’s
deepzoom.py image generator, Microsoft’s SeaDragon deep zoom viewer, and
Sean Rice’s JavaScript touch events into a set of model classes and template
tags which programmatically generate tiled images and all JavaScript necessary
for their instantiation into templates.

Let me know what you think of Django-deepzoom. Share your site (or sites) that use it. I’m curious. Cool.

What’s New?

Django-deepzoom has been ported to Python 3 and Django 1.6. Both ports required
introducing backwards-incompatible changes that have been resolved, for now, with
separate Django-deepzoom releases. In the future a unified version will be
attempted.

Porting to Django 1.6 mainly involved converting the test code to handle the new
default database autocommit behavior. Tests designed to force errors and exceptions
had to be wrapped in transaction.atomic() to avoid halting the testrunner.

To accommodate these inflection points, three Django-deepzoom releases are available:

Version 0.3 is compatible with Python 2 and Django pre-1.6.

Version 0.4 is compatible with Python 2 and Django 1.6+.

Version 1.0 is compatible with Python 3 and Django 1.6+.

A summary table is provided in the Quick start section below…

Run tests

After Django-deepzoom has been installed, you may want to sanity check it by running tests, like this:

python manage.py test deepzoom --settings=deepzoom.test.test_settings

Attention!

Some of the negative tests are intended to throw exceptions. The error text will display mixed in with the test results. THAT IS EXPECTED!

If the end result is OK then all tests have passed.

Enjoy.

Quick start

Before you begin, choose the Django-deepzoom version that’s compatible with the versions of Python and Django you’re using:

9.) Start the development server and visit http://127.0.0.1:8000/admin/ to upload an image to the associated model (you’ll need the Admin app enabled). Be sure to check the Generate deep zoom? checkbox for that image before saving it.

10.) Navigate to the page containing the deep zoom image and either click/touch it or click/touch the overlaid controls to zoom into and out of the tiled image: