
.. oe:namespace:: OEDepict

.. oe:constnamespace:: OELayerPosition

   This namespace contains constants representing the position of
   layers available for an :ref:`OE2DMolDisplay <OEDepict_OE2DMolDisplay>` class.

   .. seealso::

      * :oe:meth:`OEDepict::OE2DMolDisplay::GetLayer`

   The :oe:constns:`OEDepict::OELayerPosition` namespace contains the 
   following constants:

   .. ################################################################
      #
      ################################################################

   .. oe:constant:: Above

      Provides access to **above** image (:ref:`OEImage <OEDepict_OEImage>`) of a
      :ref:`OE2DMolDisplay <OEDepict_OE2DMolDisplay>` object.
      Everything drawn to this image  will be rendered last 
      when calling the :oe:func:`OEDepict::OERenderMolecule` function,
      as a result the image will appear **above** the molecule depiction.
      See example in :ref:`Figure: Example of drawing a triangle into the above layer<figure_OELayerPosition_Above>`.

      .. _figure_OELayerPosition_Above:

      .. figure:: ../images/OELayerPosition_Above.*
         :align:  center

         **Example of drawing a triangle into the above layer**


   .. ################################################################
      #
      ################################################################

   .. oe:constant:: Below

      Provides access to **below** image (:ref:`OEImage <OEDepict_OEImage>`) of a
      :ref:`OE2DMolDisplay <OEDepict_OE2DMolDisplay>` object.
      Everything drawn to this image  will be rendered first 
      when calling the :oe:func:`OEDepict::OERenderMolecule` function,
      as a result the image will appear **below** the molecule depiction.

      For example, the sticks drawn to highlighting bonds when using the
      :oe:const:`OEDepict::OEHighlightStyle::Stick` style all drawn 
      into a *below* layer.
      See example in :ref:`Figure: Example of drawing a triangle into the below layer<figure_OELayerPosition_Below>`.

      .. _figure_OELayerPosition_Below:

      .. figure:: ../images/OELayerPosition_Below.*
         :align:  center

         **Example of drawing a triangle into the below layer**


   .. ################################################################
      #
      ################################################################

   .. oe:constant:: SVG

      This layer is used internally when generating interactive SVG
      images.
