.. oe:namespace:: OEDepict

.. oe:constnamespace:: OEDepictOrientation

   This namespace contains constants that control the preferred orientation 
   of the 2D coordinates when calling the :oe:func:`OEDepict::OEPrepareDepiction` 
   function. 

   .. seealso::

      * :oe:meth:`OEDepict::OEPrepareDepictionOptions::GetDepictOrientation` method
      * :oe:meth:`OEDepict::OEPrepareDepictionOptions::SetDepictOrientation` method
      * :oe:func:`OEDepict::OEPrepareDepiction` function

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


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

   .. oe:constant:: Default

      The default orientation is 
      :oe:const:`OEDepict::OEDepictOrientation::Original`.

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

   .. oe:constant:: Horizontal

      The orientation of the 2D coordinates is changed in order to maximize
      the scaling of the molecule for horizontal images.   
      See example above of depicting molecules with   
      :oe:const:`OEDepict::OEDepictOrientation::Default` and
      :oe:const:`OEDepict::OEDepictOrientation::Horizontal` orientations.

      .. _table_OEDepictOrientation_Horizonal:

      .. list-table::
         :widths: 100 100
         :header-rows: 1

         * - :oe:const:`OEDepict::OEDepictOrientation::Default`
           - :oe:const:`OEDepict::OEDepictOrientation::Horizontal`
         * - .. image:: ../images/OEDepictOrientation_Horizontal_Default.*
           - .. image:: ../images/OEDepictOrientation_Horizontal.*


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

   .. oe:constant:: Original

      No-op *i.e* the orientation of the 2D coordinates are not
      optimized in order to maximize the molecule scaling.

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

   .. oe:constant:: Square

      The orientation of the 2D coordinates is changed in order to maximize
      the scaling of the molecule for square images.   
      See example above of depicting molecules with     
      :oe:const:`OEDepict::OEDepictOrientation::Default` and
      :oe:const:`OEDepict::OEDepictOrientation::Square` orientations.

      .. _table_OEDepictOrientation_Square:

      .. list-table::
         :widths: 100 100
         :header-rows: 1

         * - :oe:const:`OEDepict::OEDepictOrientation::Default`
           - :oe:const:`OEDepict::OEDepictOrientation::Square`
         * - .. image:: ../images/OEDepictOrientation_Square_Default.*
           - .. image:: ../images/OEDepictOrientation_Square.*


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

   .. oe:constant:: Vertical
   
      The orientation of the 2D coordinates is changed in order to maximize
      the scaling of the molecule for vertical images.   
      See example above of depicting molecules with   
      :oe:const:`OEDepict::OEDepictOrientation::Default` and
      :oe:const:`OEDepict::OEDepictOrientation::Vertical` orientations.

      .. _table_OEDepictOrientation_Vertical:

      .. list-table::
         :widths: 100 100
         :header-rows: 1

         * - :oe:const:`OEDepict::OEDepictOrientation::Default`
           - :oe:const:`OEDepict::OEDepictOrientation::Vertical`
         * - .. image:: ../images/OEDepictOrientation_Vertical_Default.*
           - .. image:: ../images/OEDepictOrientation_Vertical.*
   

