OEDepict TK 2.0.0
================================================================================

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

* Using :ref:`OE2DPoint <OEDepict_OE2DPoint>` that represents coordinates
* Using :ref:`OEColor <OESystem_OEColor>` that handles transparency
* Adding :ref:`OELinearColorGradient <OESystem_OELinearColorGradient>` class that allows
  color ramping   
* Supporting various font properties (:ref:`OEFont <OEDepict_OEFont>`)
     - size
     - color 
     - style (italic, bold) (:oe:constns:`OEDepict::OEFontStyle`)
     - family  (Arial, Helvetica, etc.) (:oe:constns:`OEDepict::OEFontFamily`)
* Supporting various line properties (:ref:`OEPen <OEDepict_OEPen>`)
     - line width
     - background, foreground color 
     - various stipple styles (:oe:constns:`OEDepict::OEStipple`)
     - standard line join, line cup styles (:oe:constns:`OEDepict::OELineJoin`, :oe:constns:`OEDepict::OELineCap`)
* Providing convenient molecule depiction that is highly customizable (:ref:`OE2DMolDisplayOptions <OEDepict_OE2DMolDisplayOptions>`)
    * different aromatic ring representations (:oe:constns:`OEDepict::OEAromaticStyle`)     
    * atom coloring (monochrome, CPK)  (:oe:constns:`OEDepict::OEAtomColorStyle`)  
    * bond coloring (atom-based, monochrome) (:oe:constns:`OEDepict::OEBondColorStyle`)  
    * various atom stereo representations  (:oe:constns:`OEDepict::OEAtomStereoStyle`)  
    * various bond stereo representations  (:oe:constns:`OEDepict::OEBondStereoStyle`)  
    * various explicit/implicit hydrogen representations (:oe:constns:`OEDepict::OEHydrogenStyle`) 
    * depicting atom properties (:ref:`OEDisplayAtomPropBase <OEDepict_OEDisplayAtomPropBase>`)
    * depicting bond properties (:ref:`OEDisplayBondPropBase <OEDepict_OEDisplayBondPropBase>`)
    * setting atom label, atom and bond property label font styles 
    * various super atom styles (:oe:constns:`OEDepict::OESuperAtomStyle`)
* Depicting atom radicals (:oe:constns:`OEDepict::OERadicalDisplayType`)
* Adding the :oe:func:`OEDepict::OEPrepareDepiction` function that
  prepares a molecule before depiction.
* Adding the :oe:func:`OEDepict::OEPrepareAlignedDepiction` function that
  generates 2D-coordinates of a molecule to maximize its alignment to a
  reference molecule.
* Introducing the :ref:`OEImageFrame <OEDepict_OEImageFrame>` and
  the :ref:`OEImageGrid <OEDepict_OEImageGrid>` classes that allows various molecule
  layouts (see the :ref:`Molecule Layouts<chapter_image_layout>` chapter)
* Implementing three customizable highlighting styles and allowing to
  utilize user-defined ones (see also the :ref:`Highlighting<chapter_highlighting>` chapter)
  - ball and stick (:ref:`OEHighlightByBallAndStick <OEDepict_OEHighlightByBallAndStick>`)
  - color (:ref:`OEHighlightByColor <OEDepict_OEHighlightByColor>`)
  - stick (:ref:`OEHighlightByStick <OEDepict_OEHighlightByStick>`)
* Adding the :oe:func:`OEDepict::OEAddHighlighting` function that 
  helps to highlight atoms and/or bonds 
* Implementing three arrow drawing functions:
  * :oe:func:`OEDepict::OEDrawEquilibriumArrow`
  * :oe:func:`OEDepict::OEDrawReactionArrow`
  * :oe:func:`OEDepict::OEDrawResonanceArrow`
* Adding functions that automatically generate standard interfaces for 
  OEDepict applications:
  - :oe:func:`OEDepict::OEConfigure2DMolDisplayOptions`
  - :oe:func:`OEDepict::OEConfigureHighlightParams`
  - :oe:func:`OEDepict::OEConfigureImageGridParams`
  - :oe:func:`OEDepict::OEConfigureMultiPageParams`
* Adding various rendering functions (:oe:func:`OEDepict::OERenderMolecule`)
* Adding functions to write images (:oe:func:`OEDepict::OEWriteImage`)
* Supporting the following image file formats:

  ======================================= =====================
  Graphics File Format                    File Extension       
  ======================================= =====================
  PNG (Portable Network Graphics)         :file:`.png`         
  SVG (Scalable Vector Graphics)          :file:`.svg`         
  *bare* SVG (with no header)             :file:`.bsvg`        
  Postscript                              :file:`.ps`          
  Encapsulated PostScript                 :file:`.eps`         
  PDF (Portable Document Format)          :file:`.pdf`         
  ======================================= =====================

.. oe:language:: python java

   .. note:: 

      *PNG* support is based upon the `cairo graphics library
      <http://cairographics.org>`_ on Linux. Most linux distributions
      install this shared library by default, but it may be possible
      for a super stripped down installation to not include
      it. **OEDepict TK** has no specific version requirement for this
      library, so the *cairo* package can be installed through
      traditional distribution specific means: rpm, yum, yast, zypper,
      etc.


.. oe:language:: c++

   .. note:: 

      *PNG* support is based upon the `cairo graphics library
      <http://cairographics.org>`_ on Linux. Building a C++
      application with *PNG* support will require a version
      of *libcairo* to be installed. **OEDepict TK** has no specific
      version requirement for this library, so the *cairo*
      package can be installed through traditional distribution
      specific means: rpm, yum, yast, zypper, etc.

      It is also possible to link to a version of **OEDepict TK**
      without any dependency on *libcairo* by linking
      *oedepict-noraster* instead.

* Supporting multi-page images (see the :ref:`Multi Page Image<chapter_multipage>` chapter)
* Supporting to depict MDL queries (see the :ref:`MDL Query Depiction<chapter_mdlquery>` chapter)
* Supporting MDL reaction depiction (see the :ref:`MDL Reaction Depiction<chapter_mdlreaction>` chapter)
* Providing more than 40 example codes in four different languages
  (C++, Python, Java, C#) that demonstrate the functionalities of the
  the new toolkit.
* Providing 10 C++ applications (see the
  :ref:`OEDepict Examples Summary<oedepict_chapter_examples_summary>` chapter)

.. _release_notes_deprecated_ogham:

Deprecated Ogham 
--------------------------------------------------------------------------------

The following classes, functions and namespaces are **not** going to be supported
any longer and will be deprecated in the future:  

  Deprecated Ogham classes:

  * ``OE8BitImage``
  * ``OEAtomStyle``
  * ``OEBondStyle``
  * ``OEDepictBase``
  * ``OEDepictColor``
  * ``OEDepictView``
  * ``OEPSImage``
  * ``OEPoly``
  * ``OEPolyF``
  * ``OESVGImage``
  * ``OEVert``
  * ``OEVertF``

  Deprecated Ogham functions:

  * ``OEWriteBMP``
  * ``OEWriteEPS``
  * ``OEWriteGIF``
  * ``OEWritePPM``
  * ``OEWriteRGB``
  * ``OEWriteXPM``

  Deprecated Ogham namespace:

  * ``OENamedColor``
