OEDepict TK 2.1.0
================================================================================

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

* Added a new highlighting style, :oe:const:`OEDepict::OEHighlightStyle::Cogwheel`,
  and the corresponding highlighting class :ref:`OEHighlightByCogwheel <OEDepict_OEHighlightByCogwheel>`.

* Added accessor methods for many parameters to the following highlighting classes:

  * :ref:`OEHighlightByBallAndStick <OEDepict_OEHighlightByBallAndStick>`
  * :ref:`OEHighlightByColor <OEDepict_OEHighlightByColor>`
  * :ref:`OEHighlightByStick <OEDepict_OEHighlightByStick>`

* Added :oe:meth:`OEDepict::OE2DMolDisplayOptions::SetBondWidthScaling` method
  that allows line width of the bonds to be increased or decreased based upon
  the molecule scaling factor.

* Added the following classes and functions to provide a convenient way to
  generate multi-page reports.

  * :ref:`OEReportOptions <OEDepict_OEReportOptions>` and :ref:`OEReport <OEDepict_OEReport>` classes
  * :oe:func:`OEDepict::OEConfigureReportOptions` and :oe:func:`OEDepict::OESetupReportOptions` functions
  * :oe:func:`OEDepict::OEWriteReport` function

.. oe:language:: csharp

   * Fixed a bug in LineStipple in the C# native OEMolDepiction implementation. 
     And added the missing DrawPie() method.

.. oe:language:: c++

   * Reimplemented the following C++ **OEDepict TK** examples by utilizing the
     new :ref:`OEReport <OEDepict_OEReport>` class:

     * :ref:`mols2pdf<section_examples_summary_mols2pdf>`
     * :ref:`viewmdlsearch<section_examples_summary_viewmdlsearch>`

.. oe:language:: python

   * Reimplemented the following Python **OEDepict TK** examples by utilizing the
     new :ref:`OEReport <OEDepict_OEReport>` class:

     * :ref:`mols2pdf.py<section_examples_summary_mols2pdf>`
     * :ref:`viewmdlsearch.py<section_examples_summary_viewmdlsearch>`

.. oe:language:: java

   * Implemented the following Java **OEDepict TK** examples:

     * :ref:`Mols2PDF<section_examples_summary_mols2pdf>`
     * :ref:`ViewMDLSearch<section_examples_summary_viewmdlsearch>`
     * :ref:`SMARTSAlign2D<section_examples_summary_smartsalign2D>`

.. oe:language:: csharp

   * Implemented the following C# **OEDepict TK** examples:

     * :ref:`Mols2PDF<section_examples_summary_mols2pdf>`
     * :ref:`ViewMDLSearch<section_examples_summary_viewmdlsearch>`
     * :ref:`SMARTSAlign2D<section_examples_summary_smartsalign2D>`


* Added the :oe:meth:`OEDepict::OEMultiPageImageFile::GetPage` method that
  provides access to the individual pages of a multi-page image file.

* Added the :oe:func:`OEDepict::OEConfigureImageGridNumColumns` and
  :oe:func:`OEDepict::OEConfigureImageGridNumRows` functions to take
  the default number of columns and rows.

* :oe:func:`OEDepict::OEPrepareAlignedDepiction` has been improved the
  generate better 2D molecule alignments by:

  * Allowing rotations around unspecified cis/trans double bonds
  * Refining the method that scores alignments based on internal atom clashes


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

* Added darker default colors for some of the elements for the
  :oe:const:`OEDepict::OEAtomColorStyle::WhiteCPK` color scheme.
  See the effect of these changes in :ref:`Table: Example of default element color changes
  <table_ElementColors>`.

  .. _table_ElementColors:

  .. list-table:: **Example of default element color changes**

     * - **OEDepict TK 2.0.4**
       - **OEDepict TK 2.1.0**
     * - .. image:: ../../depicttk/images/releasenotes-2.1.0/PeriodicTable-WhiteCPK-Example-toolkits2012_Oct.*
       - .. image:: ../../depicttk/images/releasenotes-2.1.0/PeriodicTable-WhiteCPK-Example-toolkits2013_Feb.*


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

* Fixed the coordinate system to start from the top-left corner for
  raster images on OS X when using the
  :oe:meth:`OEDepict::OEImageBase::DrawPoint` method. This was causing
  images to appear flipped around the y-axis.

* The colors for :oe:func:`OEDepict::OEGetHighlightColor` were
  sometimes not initialized properly due to undefined library
  initialization order. This was causing the function to always return
  white.

* Atoms that have both the atomic number and the atom map index of
  zero will now be rendered as ``*``.

* Synchronized code examples in all four supported languages
  (C++, Python, Java and C#) to ensure that they have the same behavior
  and generate identical images.

* :oe:func:`OEDepict::OEPrepareDepiction` and
  :oe:func:`OEDepict::OEDepictCoordinates` could crash or generate
  random coordinates for molecules with adjacent spiro centers.

.. oe:language:: python

   * Methods that return a :ref:`OE2DPoint <OEDepict_OE2DPoint>` reference,
     e.g. :oe:meth:`OEDepict::OE2DAtomDisplay::GetCoords`, will now
     return a copy of the :ref:`OE2DPoint <OEDepict_OE2DPoint>` instead in
     Python to avoid destructor ordering problems.

   * Wrapping the following methods in Python:

     * :oe:meth:`OEDepict::OE2DPoint::operator+=`
     * :oe:meth:`OEDepict::OE2DPoint::operator-=`
     * :oe:meth:`OEDepict::OE2DPoint::operator*=`
     * :oe:meth:`OEDepict::OE2DPoint::operator/=`


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

* Added the :ref:`Multi Page Reports<section_multipage_report>`
  section to document the usage of the :ref:`OEReport <OEDepict_OEReport>`
  object.

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