OEDepict TK 2.2.0
================================================================================

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

* :oe:func:`OEDepict::OEPrepareDepiction` now generates canonical depiction
  coordinates, i.e., the same 2D coordinates are generated regardless of the atom and
  bond ordering in the molecule.
  See the effect of this change in :ref:`Table: Example of default element color changes
  <table_OEPrepareDepictionChange>`.

  .. _table_OEPrepareDepictionChange:

  .. list-table:: **Example of generating depiction coordinates by the OEPrepareDepiction function**

     * - **OEDepict TK 2.1.0**
       - **OEDepict TK 2.2.0**
     * - .. image:: ../../depicttk/images/releasenotes-2.2.0/CoordinateGeneration-toolkits2013_Feb.*
       - .. image:: ../../depicttk/images/releasenotes-2.2.0/CoordinateGeneration-toolkits2013_Jun.*

* Added the following non-linear color gradient to OESystem:

  * :ref:`OEExponentColorGradient <OESystem_OEExponentColorGradient>`
  * :ref:`OEExponentialColorGradient <OESystem_OEExponentialColorGradient>`
  * :ref:`OELogarithmicColorGradient <OESystem_OELogarithmicColorGradient>`

  These classes along with the :ref:`OELinearColorGradient <OESystem_OELinearColorGradient>` class
  now derive from the :ref:`OEColorGradientBase <OESystem_OEColorGradientBase>` base class.

* :oe:func:`OEDepict::OEAddHighlighting` function overloads added that take both atom
  and bond predicates.

* :oe:meth:`OEDepict::OEAlignmentOptions::SetFixedCoords` method added
  that forces the :oe:func:`OEDepict::OEPrepareAlignedDepiction`
  function to use the coordinates in the reference molecule instead of
  depicting them from scratch. 

* :oe:meth:`OEDepict::OE2DMolDisplayOptions::SetBondLineGapScale` method added
  for changing the gap between the lines of double and triple bonds.

* :oe:meth:`OEDepict::OE2DMolDisplayOptions::SetBondLineAtomLabelGapScale`
  method added for changing the gap between the atom labels and the end
  of the bond lines.


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

* :oe:const:`OEDepict::OEStipple::NoLine` and
  :oe:const:`OEDepict::OEFill::On` pen fixed on Windows when drawing a
  pie.

* Refined the method that is used to calculate the gap between the
  atom labels and the lines of the bonds when there is a charge or
  there are more than 3 explicit hydrogen neighbors.

* Additional warning messages are thrown when either the
  :oe:func:`OEChem::OE3DToBondStereo` or the :oe:func:`OEChem::OE3DToAtomStereo`
  functions fail during :oe:func:`OEDepict::OEPrepareDepiction`.

.. oe:language:: csharp

   * :ref:`OEImageGrid <OEDepict_OEImageGrid>` and :ref:`OEImageFrame <OEDepict_OEImageFrame>` in C# now
     store a reference to their parent :ref:`OEImageBase <OEDepict_OEImageBase>` to
     prevent early garbage collection of the parent.


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

* All images in the documentation were automatically regenerated to
  reflect the changes made since the previous release.

* Added several code snippets to the :oe:func:`OEDepict::OERenderMolecule`
  function.
