
OEDepict TK 2.2.6
================================================================================

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

* The following changes have been made to improve the SVG images
  containing certain geometries (especially those made by the
  :ref:`OE2DPropMap <OEGrapheme_OE2DPropMap>` class):

  - :oe:const:`OEDepict::OELineCap::Butt` (the default line cup) and
    :oe:const:`OEDepict::OELineJoin::Miter` (the default line join)
    parameters for shapes (lines, rectangles, etc.) are no longer written
    into the SVG images.

  - :oe:meth:`OEDepict::OEImageBase::DrawRectangle` for SVG
    will now trim the trailing zeros and the decimal point.

  The above changes resulted in 40% smaller images and 10% faster image writing
  without any visual difference.

  .. For example:
  ..   <rect x="84.00" y="30.00" width="2.00" height="2.00" fill="#fefefe" stroke="#fefefe" stroke-linejoin="miter" stroke-linecap="round" />
  ..   <rect x="84" y="30" width="2" height="2" fill="#fefefe" stroke="#fefefe" />

* :ref:`OE2DPath <OEDepict_OE2DPath>` class has been added to allow drawing
  more complex lines connected by a series of points. The following
  methods were added to accept :ref:`OE2DPath <OEDepict_OE2DPath>` objects:

  * :oe:meth:`OEDepict::OEImageBase::DrawPath`
  * :oe:meth:`OEDepict::OEImage::DrawPath`
  * :oe:meth:`OEDepict::OEImageFrame::DrawPath`

* :oe:meth:`OEDepict::OEHighlightByColor::SetAtomExternalHighlight`
  was added to generate better highlighting for small images.

* :oe:func:`OEDepict::OEAnnotateValenceProblems` function was added
  to highlight potential atom valence problems on the molecule diagram.

* :oe:func:`OEDepict::OEWrite2DRingDictionaryReport` function was added
  to generate a multi-page report for user-defined ring dictionaries.
  See also the :ref:`chapter_2D_coordinates` chapter in the **OEChem TK** manual.

* :oe:meth:`OEDepict::OEImageBase::GetGlobalOffset` method was added
  to return the global position of the image. This is currently only
  useful for subframes of an :ref:`OEImageFrame <OEDepict_OEImageFrame>` object.


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

* :oe:func:`OEDepict::OEPrepareAlignedDepiction` has been optimized
  to be twice as fast on average.

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

* :oe:func:`OEDepict::OEAnnotateDepictionProblems` style has been redesigned to be
  more visually pleasing.

* The positioning of + signs for reactions has been improved. The + signs
  and the arrow of the reactions now scale with the default line width of
  the molecule.

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

* :ref:`ringdict2pdf<section_examples_summary_ringdict2pdf>` example
  has been added to generate a multi-page ring dictionary report.

* ``-ringdict`` parameter has been added to the following examples to utilize
  user-defined ring dictionaries:

  - :ref:`depict<section_examples_summary_depict>` example
  - :ref:`mol2img<section_examples_summary_mol2img>` example
  - :ref:`mols2pdf<section_examples_summary_mols2pdf>` example

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