OEDepict TK 2.0.2
================================================================================

New features
--------------------------------------------------------------------------------

* Adding a scaling factor that can be used to increase or decrease the size
  of the fonts used to depict atom properties.
  (:oe:meth:`OEDepict::OE2DMolDisplayOptions::SetAtomPropLabelFontScale`)

* Adding a scaling factor that can be used to increase or decrease the size
  of the fonts used to depict bond properties.
  (:oe:meth:`OEDepict::OE2DMolDisplayOptions::SetBondPropLabelFontScale`)

.. oe:language:: python

   * Adding the following examples:

     * :ref:`depict.py<section_examples_summary_depict>`
     * :ref:`match2img.py<section_examples_summary_match2img>`
     * :ref:`mcsalign2D.py<section_examples_summary_mcsalign2D>`
     * :ref:`mdlquery2img.py<section_examples_summary_mdlquery2img>`
     * :ref:`mdlreaction2img.py<section_examples_summary_mdlreaction2img>`
     * :ref:`mols2pdf.py<section_examples_summary_mols2pdf>`
     * :ref:`mols2img.py<section_examples_summary_mols2img>`
     * :ref:`smartsalign2D.py<section_examples_summary_smartsalign2D>`
     * :ref:`viewmdlsearch.py<section_examples_summary_viewmdlsearch>`

.. oe:language:: java

   * Adding the following examples:

     * :ref:`Depict.java<section_examples_summary_depict>`
     * :ref:`Match2Img.java<section_examples_summary_match2img>`
     * :ref:`MCSAlign2D.java<section_examples_summary_mcsalign2D>`
     * :ref:`MDLQuery2Img.java<section_examples_summary_mdlquery2img>`
     * :ref:`MDLReaction2Img.java<section_examples_summary_mdlreaction2img>`
     * :ref:`Mol2Img.java<section_examples_summary_mol2img>`
     * :ref:`Mols2Img.java<section_examples_summary_mols2img>`


.. oe:language:: csharp

   * Adding the following examples:

     * :ref:`Depict.cs<section_examples_summary_depict>`
     * :ref:`Match2Img.cs<section_examples_summary_match2img>`
     * :ref:`MCSAlign2D.cs<section_examples_summary_mcsalign2D>`
     * :ref:`MDLQuery2Img.cs<section_examples_summary_mdlquery2img>`
     * :ref:`MDLReaction2Img.cs<section_examples_summary_mdlreaction2img>`
     * :ref:`Mol2Img.cs<section_examples_summary_mol2img>`
     * :ref:`Mols2Img.cs<section_examples_summary_mols2img>`

*  The constructor of the :ref:`OEImage <OEDepict_OEImage>` class now takes a
   background color that is used to clear the image upon construction.
   A :file:`.png` image with transparent background can be generated by
   using the :oe:const:`OETransparentColor<OESystem::OESystem::OETransparentColor>`
   color as a background color when constructing an :ref:`OEImage <OEDepict_OEImage>`
   object.

*  Fixing the run-time initialization of the color that is used to
   depict super atoms.

Major bug fixes
--------------------------------------------------------------------------------

* The cairo graphics library (http://cairographics.org) used to draw
  :file:`.png` images on Linux has a bug where it is not thread safe
  when rendering text. **OEDepict TK** now performs its own mutual
  exclusion when calling into the cairo graphics library for text
  rendering to ensure thread safety.

* Improving the depiction of super atoms
  (See examples in the :oe:constns:`OEDepict::OESuperAtomStyle` namespace)

Minor bug fixes
--------------------------------------------------------------------------------

* :oe:func:`OEDepict::OERenderMolecule` called with an image and a
  molecule now uses the width and height of the image being passed.

* Fixing a problem where isolated atoms were not highlighted when using
  the :oe:const:`OEDepict::OEHighlightStyle::Color` and
  :oe:const:`OEDepict::OEHighlightStyle::Stick` highlighting styles.
 
* :oe:func:`OEDepict::OEDepictCoordinates` throws a warning when trying
  to generate 2D coordinates for a two member ring, for example,
  ``C1N1``. The function will then fall back to trying to generate
  coordinates for those atoms as a chain.

* The :oe:func:`OEChem::OEDisassembleExpressions` function tags atoms
  and bonds of the query molecule that can later be used by the
  :ref:`OE2DMolDisplay <OEDepict_OE2DMolDisplay>` constructor when creating atom and
  bond displays. 
 
* Throwing a warning when attempting to draw a line or an arc with
  the :oe:const:`OEDepict::OEStipple::NoLine` pen property.
  Throwing a warning when attempting to draw a rectangle, circle, triangle
  or a polygon with :oe:const:`OEDepict::OEStipple::NoLine` and
  :oe:const:`OEDepict::OEFill::Off` pen properties.

* Making sure that no radical dots are displayed for a query atom that
  has implicit hydrogen count information.

* Before registering an aromatic ring for the
  :oe:const:`OEDepict::OEAromaticStyle::Circle` style,
  a check is performed to ensure that the detected ring is not a
  fused ring of two smaller rings.
 
* Making the background color consistent for the monochrome atom color
  styles.
  (See:  :oe:const:`OEDepict::OEAtomColorStyle::WhiteMonochrome` and
  :oe:const:`OEDepict::OEAtomColorStyle::BlackMonochrome`)

* When two molecules are aligned by calling the
  :oe:func:`OEDepict::OEPrepareAlignedDepiction`
  function, the fit molecule is scaled by the average bond length of the
  reference molecule.

Deprecated Ogham
--------------------------------------------------------------------------------

* Deprecating the ``OEDepictFixedCoordinates`` function.
  For molecule alignment, please use the :oe:func:`OEDepict::OEPrepareAlignedDepiction`
  function.

Documentation changes
--------------------------------------------------------------------------------

* Renaming the Application chapter to
  :ref:`OEDepict Examples Summary<oedepict_chapter_examples_summary>`
  and inserting the source code of the examples into the
  `Examples` chapter.

* Adding code snippets for the :oe:func:`OEDepict::OEAddHighlighting` function.

* Describing the layout of a depicted atom in the :ref:`OE2DAtomDisplay <OEDepict_OE2DAtomDisplay>`
  class.

* All images in this manual are now automatically generated as part of the release
  process and tested against benchmark images on all supported platforms.
