
Grapheme TK 1.1.0
================================================================================

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

* Added the following to visualize color forcefields:

  * :ref:`OEColorForceFieldDisplay <OEGrapheme_OEColorForceFieldDisplay>`
  * :ref:`OEColorForceFieldLegendDisplayOptions <OEGrapheme_OEColorForceFieldLegendDisplayOptions>`
  * :oe:func:`OEGrapheme::OEDrawColorForceFieldLegend`

* Added the following to visualize the reference molecule of a color
  and shape overlap:

  * :ref:`OEShapeOverlapDisplay <OEGrapheme_OEShapeOverlapDisplay>`
  * :ref:`OEShapeOverlapDisplayOptions <OEGrapheme_OEShapeOverlapDisplayOptions>`
  * :oe:func:`OEGrapheme::OERenderShapeQuery`

* Added the following to visualize shape and color overlaps:

  * :ref:`OEShapeOverlapDisplay <OEGrapheme_OEShapeOverlapDisplay>`
  * :ref:`OEShapeOverlapDisplayOptions <OEGrapheme_OEShapeOverlapDisplayOptions>`
  * :oe:func:`OEGrapheme::OERenderShapeOverlap`
  * :ref:`OEColorOverlapDisplayOptions <OEGrapheme_OEColorOverlapDisplayOptions>`
  * :oe:func:`OEGrapheme::OERenderColorOverlap`

.. note::

   A valid **shape** license is required to use any of these new shape
   or color APIs.

* Added the :ref:`OEDepictionFrom3DOptions <OEGrapheme_OEDepictionFrom3DOptions>` class that
  allows more advanced customization of the generation of 2D
  coordinates driven by the 3D conformation when calling the
  :oe:func:`OEGrapheme::OEPrepareDepictionFrom3D` function. By default,
  :oe:func:`OEGrapheme::OEPrepareDepictionFrom3D` is tuned for
  generating 2D coordinates for representing 3D overlays in 2D. This
  class allows the 2D coordinate generation to choose a set of 2D
  coordinates that are much closer to how the molecule would look in a
  3D viewer.


* Added the following to render user-defined labels when depicting
  color gradients:

  * :oe:meth:`OEGrapheme::OEColorGradientDisplayOptions::AddLabel`
  * :oe:meth:`OEGrapheme::OEColorGradientDisplayOptions::ClearLabels`
  * :oe:meth:`OEGrapheme::OEColorGradientDisplayOptions::GetLabels`

* Added :oe:meth:`OEGrapheme::OEColorGradientDisplayOptions::ClearBoxRange` method
  to remove the box range previously set to a color gradient.

* Added :oe:func:`OEGrapheme::OEGet2DSurfaceArcs` function to return
  the arcs of the molecule surface of a specific atom with the given
  radius. Varying radii can be passed to generate multiple surfaces in
  the range specified by the
  :oe:constns:`OEGrapheme::OESurfaceArcScale`
  namespace. :oe:func:`OEGrapheme::OEGetMoleculeSurfaceScale` can be
  used to determine the appropriate scale for the molecule with the
  specified radius.


.. oe:language:: c++

   * Implemented the :ref:`shapeoverlap2pdf.cpp<section_examples_summary_shapeoverlap2pdf>`
     C++ **Grapheme TK** example.

.. oe:language:: python

   * Implemented the :ref:`shapeoverlap2pdf.py<section_examples_summary_shapeoverlap2pdf>`
     Python **Grapheme TK** example.

.. oe:language:: java

   * Implemented the :ref:`ShapeOverlap2PDF.java<section_examples_summary_shapeoverlap2pdf>`
     Java **Grapheme TK** example.

   * Rewriting the ViewShapeMatch.java Java **Grapheme TK** example
     using the new classes and functions designed to depict
     shape and color overlaps.

.. oe:language:: csharp

   * Implemented the :ref:`ShapeOverlap2PDF.cs<section_examples_summary_shapeoverlap2pdf>`
     C# **Grapheme TK** example.


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

* Molecule surface arcs inside macrocycles are no longer returned. 
  See the effect of this change in :ref:`Table: Example of depicting molecule surface
  <table_ExampleMoleculeSurface>`.

  .. _table_ExampleMoleculeSurface:

  .. list-table::  **Example of depicting molecule surface**

     * - **Grapheme TK 1.0.6 (2013 Jun)**
       - **Grapheme TK 1.1.0 (2013 Oct)**
     * - .. image:: ../../graphemetk/images/releasenotes-1.1.0/Draw2DSurface_2013_Jun.*
       - .. image:: ../../graphemetk/images/releasenotes-1.1.0/Draw2DSurface_2013_Oct.*

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

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