OEDepict TK 2.0.3
================================================================================

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

* :oe:func:`OEDepict::OEDrawCurvedArrow` function added.

* :oe:func:`OEDepict::OEPrepareAlignedDepiction` now allows more
  advanced customization of the alignment process through the
  :ref:`OEAlignmentOptions <OEDepict_OEAlignmentOptions>` class.

* **OEChem TK's** new RMSD method is used in the molecule alignment
  process to improvement alignment performance.

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

* :oe:func:`OEDepict::OEPrepareAlignedDepiction` performance
  improvement of 10% on average. 

* Windows :file:`png` images have been improved in the following ways:

  * Dash patterns for line drawing corrected.

  * Gamma correction turned off when colors are blended with
    background colors. As a result the generated :file:`png` images
    look sharper.

  * Text anti-aliasing methodology is now dependent on the font size
    to ensure fonts look good at all sizes. The method of
    anti-aliasing changes when increasing the font size from 8 to 9.

* The following atom label layout changes: 

  * If the atom has a charge, then it is rendered as a super-script on
    the right side of the atomic label.
    In the case when the implicit hydrogen symbol is placed on the right
    side of the atom, then the charge also follows the hydrogen symbol.
    (See section GR 5.1 in [Brecher-2008]_ )

  * The dot(s) representing the radical atom follows the atoms' element
    symbol on the left side.
    In the case when the implicit hydrogen symbol is placed on the right
    side of the atom, then the radical dot(s) also follows the hydrogen
    symbol.
    (See section GR 5.3 in [Brecher-2008]_ )

* Atom labels clashing with bonds have been improved by shortening the
  length of the depicted bond in certain cases. 

* MDL query molecule atom label rendering has been improved. 

* :oe:func:`OEDepict::OEDepictCoordinates` clash detection has been
  improved to avoid unnecessary stretching of the bonds of explicit
  hydrogens. A tolerance has been introduced that allows smaller
  distances between hydrogen atoms.

.. oe:language:: csharp

   * :ref:`OE2DMolDisplay <OEDepict_OE2DMolDisplay>` no longer crashes due to early
     garbage collection of the molecule.

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

* :oe:meth:`OEDepict::OE2DMolDisplayOptions::SetAtomLabelFontScale`
  upper limit has been increased from `2.0` to `3.0`. 

* New fused ring system templates added. 

* Atom and bond highlighting now scales with the molecule instead of the
  dimension of the image.

* Aromatic circles now ignore the fill style of the circle. 

* The following methods will now throw warnings if given nonsensical
  arguments:

  * :oe:meth:`OEDepict::OEImage::DrawCircle`
  * :oe:meth:`OEDepict::OEImage::DrawArc`
  * :oe:meth:`OEDepict::OEImage::DrawLine`
  * :oe:meth:`OEDepict::OEImage::DrawPolygon`
  * :oe:meth:`OEDepict::OEImage::DrawRectangle`
  * :oe:meth:`OEDepict::OEImage::DrawText`
  * :oe:meth:`OEDepict::OEImage::DrawTriangle`

  This should make drawing mistakes appear earlier in development,
  instead of only when they are rendered to a specific file format. 

* :oe:meth:`OEDepict::OE2DMolDisplay::GetAtomDisplay` and 
  :oe:meth:`OEDepict::OE2DMolDisplay::GetBondDisplay` no longer
  incorrectly check the atom and bond indices. 

* :ref:`OE2DMolDisplay <OEDepict_OE2DMolDisplay>` constructors
  now throw a warning when a molecule being depicted has 3D
  coordinates and throw an error if the molecule has no coordinates.

* :oe:meth:`OEDepict::OEImage::Clear` is now called when
  constructing a new :ref:`OEImage <OEDepict_OEImage>` object.

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

* All images are automatically regenerated to reflect the changes made
  since the previous release.

..
    # comment

    Database ACD taking the first 1000 molecules between the heavy atom
    range [5-50] and aligning them if the MCSS match is greater
    than 2 atoms.

    version: toolkits2012_Feb
    Total: 963020 alignments processed.
    number of alignments 963020
    total 54024.622 sec
    alignment 53691.273 sec (0.055753 sec/alignment)
    avg rmsd 0.265

    version: master before tagging  (April 6) OEDEBUG turned off
    Total: 963020 alignments processed.
    number of alignments 963020
    total 49194.596 sec
    alignment 48871.690 sec (0.050748 sec/alignment)
    avg rmsd 0.266
