:tocdepth: 3

:py:mod:`gws.lib.mapserver`
===========================

.. py:module:: gws.lib.mapserver

.. autoapi-nested-parse::

   MapServer support.

   This module dynamically creates and renders MapServer maps.

   To render a map, create a map object with `new_map`, add layers to it using ``add_`` methods
   and invoke ``draw``.

   Reference: MapServer documentation (https://mapserver.org/documentation.html)

   Example usage::

       import gws
       import gws.lib.mapserver as ms

       # create a new map
       map = ms.new_map()

       # add a raster layer from an image file
       map.add_layer(
           gws.MapServerLayerOptions(
               type=gws.MapServerLayerType.raster,
               path='/path/to/image.tif',
           )
       )

       # add a layer using a configuration string
       map.add_layer_from_config('''
           LAYER
               TYPE LINE
               STATUS ON
               FEATURE
                   POINTS
                       751539 6669003
                       751539 6672326
                       755559 6672326
                   END
               END
               CLASS
                   STYLE
                       COLOR 0 255 0
                       WIDTH 5
                   END
               END
           END
       ''')

       # draw the map into an Image object
       img = map.draw(
           bounds=gws.Bounds(
               extent=[738040, 6653804, 765743, 6683686],
               crs=gws.lib.crs.WEBMERCATOR,
           ),
           size=(800, 600),
       )

       # save the image to a file
       img.to_path('/path/to/output.png')




**Source code:** :source:`gws.lib.mapserver<gws/lib/mapserver/__init__.py>`


Submodules
----------
.. toctree::
   :titlesonly:
   :maxdepth: 1

   core/index.rst
   util/index.rst



Package Contents
----------------



.. py:exception:: Error


   Bases: :py:obj:`gws.Error`

   Generic GWS error.


.. py:class:: Map(config: str = '')


   MapServer map object wrapper.

   .. py:attribute:: mapObj
      :type:  mapscript.mapObj

   .. py:method:: add_layer(opts: gws.MapServerLayerOptions) -> mapscript.layerObj

      Adds a layer to the map.


   .. py:method:: add_layer_from_config(config: str) -> mapscript.layerObj

      Adds a layer to the map using a configuration string.


   .. py:method:: copy() -> Map

      Creates a copy of the current map object.


   .. py:method:: draw(bounds: gws.Bounds, size: gws.Size) -> gws.Image

      Renders the map within the given bounds and size.

      :param bounds: The spatial extent to render.
      :param size: The output image size.

      :returns: The rendered map image.


   .. py:method:: style_symbol(style: gws.StyleValues) -> mapscript.styleObj

   .. py:method:: to_string() -> str

      Converts the map object to a configuration string.



.. py:function:: new_map(config: str = '') -> Map

   Creates a new Map instance from a Mapfile string.


.. py:function:: version() -> str

   Returns the MapServer version string.