
OEDepict TK 2.2.2
================================================================================

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

* :oe:func:`OEDepict::OEPrepareAlignedDepiction` can now take a
  :ref:`OESubSearch <OEChem_OESubSearch>` or :ref:`OEMCSSearch <OEChem_OEMCSSearch>` object
  to allow the layout to be driven by multiple atom mappings at the
  same time. The mapping that generates the best alignment will be
  returned in an :ref:`OEAlignmentResult <OEDepict_OEAlignmentResult>` object.

* :oe:func:`OEDepict::OEGetDefaultAtomColor` added to return the
  default color associated with an atomic number for the given atom
  color style.

* :oe:const:`OEGreenBoxPen<OEDepict::OEDepict::OEGreenBoxPen>` and
  :oe:const:`OEGreenPen<OEDepict::OEDepict::OEGreenPen>` pens added.

* :oe:func:`OEDepict::OEDepictCoordinates` is now deprecated. 2D
  coordinate generation is now included in ``OEChem`` as the
  :oe:func:`OEChem::OEGenerate2DCoordinates` function. Please switch to
  using that function instead.

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

* Improved the positioning of atom properties by considering the position of implicit
  hydrogen labels.
  See the effect of this change in :ref:`Table: Example of improving the positioning of atom properties
  <table_AtomPropPositioning>`.

  .. _table_AtomPropPositioning:

  .. list-table:: **Example of improving the positioning of atom properties**

     * - **OEDepict TK 2.2.1**
       - **OEDepict TK 2.2.2**
     * - .. image:: ../../depicttk/images/releasenotes-2.2.2/AtomPropPosition_toolkits2013_Oct.*
       - .. image:: ../../depicttk/images/releasenotes-2.2.2/AtomPropPosition_toolkits2014_Feb.*

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

* **OEDepict TK** will automatically render enhanced stereo by default
  now. Previously, the
  :oe:func:`OEDepict::OEConfigure2DMolDisplayOptions` function would
  not automatically enable rendering enhanced stereo information.  The
  behavior can be changed by the
  :oe:const:`OEDepict::OEAtomStereoStyle::Display::MDLStereoCenter` and
  :oe:const:`OEDepict::OE2DMolDisplaySetup::AtomStereoStyle` constants.

* Increased the gap between the bond end and the atomic label for
  iodine (atomic label "I").

* Added "BRIEF" line to interfaces of **OEDepict TK** examples.

* :oe:func:`OEDepict::OEWriteImage` and
  :oe:func:`OEDepict::OERenderMolecule` that take an
  :ref:`oeostream <OEPlatform_oeostream>` no longer call the stream's ``close``
  method. It is the responsibility of the caller to call ``close`` on
  the stream if it is appropriate.

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

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