HSLayers.Printer
================
`HSLayers.Printer
<http://www.bnhelp.cz/wwwlibs/hslayers/3.0/doc/symbols/HSLayers.Printer.html>`_
is another Ext.Panel with special functionality. When the panel is
*activated*, it will draw paper on the map. You can set several options and
let the map be printed.

.. literalinclude:: ../../../../branches/hslayers-3.0/examples/Printer.html
    :language: javascript
    :linenos:
    :lines: 14-16,22-29,54,57

.. note :: Two attributes have been set: `OpenLayers.ProxyHosty` which
    points OpenLayers (and HSLayers) to server-side ajax proxy script, and 
    `HSLayers.Printer.printerScript`, which should point the printing
    client to :file:`hslayers/source/scripts/mapCreator.py` server printing
    script.

We also created two `Ext.Buttons` which do activate and deactivate the
panel functionality.

.. literalinclude:: ../../../../branches/hslayers-3.0/examples/Printer.html
    :language: javascript
    :linenos:
    :lines: 30-39

mapCreator.py
-------------
This script, located in `hslayers/source/scripts/mapCreator.py` is
server-side printing script. It accepts JSON object describing the content
of the map, and makes PDF out of it.

The script is written in Python and uses python-pyx module for the PDF
formating.

The map is expected to be array of URLs to images together with their
bounding boxes. So it is able to print WMS layers, TileCache files, single
image layers and so on, tiled or single-file. It is able to set opacity of
each layer as well.

It is able to print legends to each layer on separate paper.

Currently, vectors are not supported. The map *must not* use WGS84
coordinate reference system.