.. _data_imagepyramid:

ImagePyramid
=============

.. note:: GeoServer does not come built-in with support for Image Pyramid; it must be installed through an extension. Proceed to :ref:`imagepyramid_install` for installation details.

An image pyramid is several layers of an image rendered at various image sizes, to be shown at different zoom levels.

.. _imagepyramid_install:

Installing the ImagePyramid extension
-------------------------------------

#. Download the ImagePyramid extension from the `GeoServer download page 
   <http://geoserver.org/download>`_.

   .. warning:: Make sure to match the version of the extension to the version of the GeoServer instance!

#. Extract the contents of the archive into the ``WEB-INF/lib`` directory of the GeoServer installation.

Adding an ImagePyramid data store
---------------------------------

Once the extension is properly installed :guilabel:`ImagePyramid` will be an option in the :guilabel:`Raster Data Sources` list when creating a new data store.

.. figure:: images/imagepyramidcreate.png
   :align: center

   *ImagePyramid in the list of raster data stores*

Configuring an ImagePyramid data store
--------------------------------------

.. figure:: images/imagepyramidconfigure.png
   :align: center

   *Configuring an ImagePyramid data store*

.. list-table::
   :widths: 20 80

   * - **Option**
     - **Description**
   * - ``Workspace``
     - 
   * - ``Data Source Name``
     - 
   * - ``Description``
     - 
   * - ``Enabled``
     -  
   * - ``URL``
     -