.. oe:namespace:: OEDepict

..  _OEDepict_OEAtomColorStyle:

.. oe:constnamespace:: OEAtomColorStyle

   This namespace contains constants representing various atom
   coloring styles of molecule depiction.

   .. seealso::

      * :oe:meth:`OEDepict::OE2DMolDisplayOptions::GetAtomColorStyle` method
      * :oe:meth:`OEDepict::OE2DMolDisplayOptions::SetAtomColorStyle` method
      * :oe:func:`OEDepict::OEGetDefaultAtomColor` function

   **After** setting the atom color style of an
   :ref:`OE2DMolDisplayOptions <OEDepict_OE2DMolDisplayOptions>` object:

   * The color of the background can be changed by using the
     :oe:meth:`OEDepict::OE2DMolDisplayOptions::SetBackgroundColor`
     method.

   * The color that is associated with a specific atomic number can
     be changed by using the
     :oe:meth:`OEDepict::OE2DMolDisplayOptions::SetAtomColor`
     method.

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

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

   .. oe:constant:: Default

      The default atom color style is
      :oe:const:`OEDepict::OEAtomColorStyle::WhiteCPK`.


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

   .. oe:constant:: BlackCPK

      The color of the background is
      :oe:const:`OEDarkBackgroundColor<OEDepict::OEDepict::OEDarkBackgroundColor>`.
      The atoms are colored using the :term:`CPK` color convention.
      See example in :ref:`Figure: Example of using the 'BlackCPK'
      atom color style<figure_OEAtomColorStyle_BlackCPK>`.

      .. _figure_OEAtomColorStyle_BlackCPK:

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

         **Example of using the 'BlackCPK' atom color style**


      .. seealso::

         * :ref:`chapter_element_color` chapter


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

   .. oe:constant:: BlackMonochrome

      The color of the background is
      :oe:const:`OEDarkBackgroundColor<OEDepict::OEDepict::OEDarkBackgroundColor>`.
      Atoms and bonds are depicted using the :oe:const:`OEWhite<OESystem::OESystem::OEWhite>` color.
      See example in :ref:`Figure: Example of using the 'BlackMonochrome'
      atom color style<figure_OEAtomColorStyle_BlackMonochrome>`.

      .. _figure_OEAtomColorStyle_BlackMonochrome:

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

         **Example of using the 'BlackMonochrome' atom color style**


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

   .. oe:constant:: WhiteCPK

      The color of the background is
      :oe:const:`OELightBackgroundColor<OEDepict::OEDepict::OELightBackgroundColor>`.
      The atoms are colored using the :term:`CPK` color convention.
      See example in :ref:`Figure: Example of using the 'WhiteCPK'
      atom color style<figure_OEAtomColorStyle_WhiteCPK>`.

      .. _figure_OEAtomColorStyle_WhiteCPK:

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

         **Example of using the 'WhiteCPK' atom color style**


      .. seealso::

         * :ref:`chapter_element_color` chapter

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

   .. oe:constant:: WhiteMonochrome

      The color of the background is
      :oe:const:`OELightBackgroundColor<OEDepict::OEDepict::OELightBackgroundColor>`.
      Atoms and bonds are depicted using the :oe:const:`OEBlack<OESystem::OESystem::OEBlack>` color.
      See example in :ref:`Figure: Example of using the WhiteMonochrome'
      atom color style<figure_OEAtomColorStyle_WhiteMonochrome>`.

      .. _figure_OEAtomColorStyle_WhiteMonochrome:

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

         **Example of using the 'WhiteMonochrome' atom color style**

