Skip to main content
Help us improve Python packaging – donate today!

Django application for displaying very high resolution images

Project Description


Franck Barbenoire <>

Software version

Version 0.1.1, November 4th, 2012.


This software is released under GPL v3 license :


Django-openzoom is a django application for displaying an image you can zoom in. It is based on the flash panorama viewer `OpenZoom <>`_ from Daniel Gasienica.
All the necessary flash files are embedded whithin the application as static files.

Before you can use the application, you must fill a directory tree with images respecting the `DeepZoom <>`_ format .
In the open source world, you can use `Python Deep Zoom Tools <>`_ for that task. It converts an image file into lots of image tiles.

Installing the application

The OpenZoom application does not require any other application to be installed.

* insert the saladoplayer application in the INSTALLED_APPS tuple in your project


* insert the openzoom.contextprocessor.settings in the TEMPLATE_CONTEXT_PROCESSORS tuple in your project


* modify the following symbols in

* OPENZOOM_FLASH_SECURE.This is a boolean value. It controls whether to use "alway" or "sameDomain" for the AllowScriptAccess parameter (see `Control access to scripts \| Host web page <>`_ page from Adobe for some more explanations about this). When the value is True, "sameDomain" is used.
* OPENZOOM_STATIC_URL. This is a string value. Its value is the panorama url root.

Using the templates

You can use the following templates tags for including them in your own templates :

* before using the templates, insert this in your html page::

{% load openzoom %}

* **openzoomscript**. This template tag must inserted in the header part of the html page. Its arguments are as follows :

* **directory**. This is a string argument. This is the tour id of the tour to be displayed.
* **Height**. This is an integer argument. This is the height of the
SaladoPlayer window.
* **Width**. This is an integer argument. This is the width of the SaladoPlayer window::

{% openzoomscript directory height width %}

This is how the path is organized : OPENZOOM_STATIC_URL/<directory>/<name>.xml

* **openzoomdiv** : There is no argument. This template tag must inserted in the body part of the html page where you want the image to appear. It inserts a div html tag which id is "OpenZoom"::

{% openzoomdiv %}



Here are some tips and common mistakes.

When working with a remote host :

* Don't forget to collect static files. Then upload these files in a directory so that they can be served by a dedicated server. Read the official documentation about static files ;

* If you have installed the packages as eggs directories, don't forget to add ``django.template.loaders.eggs.Loader`` to your ``TEMPLATE_LOADERS`` tuple in your settings ;

Release history Release notifications

This version
History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django-openzoom-0.1.1.tgz (79.0 kB) Copy SHA256 hash SHA256 Source None Nov 4, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page