OEDepict TK 2.3.4
================================================================================

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

* A new function, :oe:func:`OEDepict::OEPrepareMultiAlignedDepiction`,
  has been added that performs 2D molecule alignment based on common fragments
  between two molecules.

  .. figure:: ../../depicttk/images/releasenotes-2.3.4/OEPrepareMultiAlignedDepiction-Example.*
     :align:  center

     **Example of depiction with alignment based on molecule similarity**

* A new method, :oe:meth:`CreateCopy<OEDepict::OEHighlightBase::CreateCopy>`,
  has been added to the :ref:`OEHighlightBase <OEDepict_OEHighlightBase>` base class and
  all of its derived classes.

* A new function, :oe:func:`OEDepict::OEDrawCurvedRectangle`, has been added
  that renders a rectangle with rounded corners.

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

* The :ref:`OE2DMolDisplay <OEDepict_OE2DMolDisplay>` constructor previously threw an
  error when initialized with an empty molecule or with a molecule
  with no coordinates. A warning is now thrown and the object is marked
  invalid (e.g., the :oe:meth:`OEDepict::OE2DMolDisplay::IsValid` method will
  return ``false``).  In addition, an :ref:`OE2DMolDisplay <OEDepict_OE2DMolDisplay>` object
  becomes invalid if the molecule from which it was initialized is modified
  (e.g., when atoms/bonds are added or deleted).  All **OEDepict TK** functions
  handling an :ref:`OE2DMolDisplay <OEDepict_OE2DMolDisplay>` object now check the
  validity of the object prior to use.

* Reactions with only product or only reactant components are now
  depicted correctly with a reaction arrow and the "+" sign between the
  components.

* The methods :oe:meth:`OEDepict::OEImageBase::DrawArc` and
  :oe:meth:`OEDepict::OEImageBase::DrawPie` have been unified when
  generating :file:`PDF` images. As a result, arc and pie objects
  in :file:`PDF` images appear more seamless.

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

* When generating an :file:`SVG` image, the opacity of the background
  is now written into the file. This allows generating images with
  a semi-transparent background.

* For the molecules C#C and C=C, the carbon atom labels are now always
  explicitly depicted.

* When determining the scaling of a depicted molecule, the bounding box
  of each multi-line bond is now considered to ensure that no bond is
  rendered outside the canvas.

* A minor molecule scaling issue that occurred when using fixed atom label
  fonts has been fixed.

* The function :oe:func:`OEDepict::OEDrawChevronArrow` has been improved
  to handle very short arrows.  In addition, the default parameters of the
  function have been changed.

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

* A new section, :ref:`section_molalign_molsim`, has been added to demonstrate
  the new :oe:func:`OEDepict::OEPrepareMultiAlignedDepiction`
  function.

* Warnings have been added to
  :oe:func:`OEDepict::OEWriteReportToString`,
  :oe:func:`OEDepict::OERenderMoleculeToString`, and
  :oe:func:`OEDepict::OEWriteImageToString` to alert that these functions
  return bytes in Python 3.
