.. oe:namespace:: OEGrapheme



.. meta::
   :keywords: OEBondGlyphCurvedArrow, BondGlyphCurvedArrow


.. _OEGrapheme_OEBondGlyphCurvedArrow:

.. oe:class:: OEBondGlyphCurvedArrow

   .. oe:api::

      class OEBondGlyphCurvedArrow : public OEBondGlyphBase

   By using the :ref:`OEBondGlyphCurvedArrow <OEGrapheme_OEBondGlyphCurvedArrow>` class, bonds
   can be annotated by drawing a curved arrow across them.

   .. seealso::

      * :ref:`chapter_annotation` chapter
      * :ref:`OEBondGlyphArrow <OEGrapheme_OEBondGlyphArrow>` class
      * :ref:`OEBondGlyphCircle <OEGrapheme_OEBondGlyphCircle>` class
      * :ref:`OEBondGlyphCross <OEGrapheme_OEBondGlyphCross>` class
      * :ref:`OEBondGlyphScissors <OEGrapheme_OEBondGlyphScissors>` class
      * :ref:`OEBondGlyphStitch <OEGrapheme_OEBondGlyphStitch>` class
      * :ref:`OEBondGlyphZigZag <OEGrapheme_OEBondGlyphZigZag>` class

   The following methods are publicly inherited from :ref:`OEBondGlyphBase <OEGrapheme_OEBondGlyphBase>`:

   =============================================================== ================================================================
   :oe:meth:`CreateCopy<OEGrapheme::OEBondGlyphBase::CreateCopy>`  :oe:meth:`RenderGlyph<OEGrapheme::OEBondGlyphBase::RenderGlyph>`
   =============================================================== ================================================================

   .. ################################################################
      #
      ################################################################

   .. oe:method:: Constructors

      .. oe:language:: c++ java csharp

         .. oe:api::

            OEBondGlyphCurvedArrow(const OEDepict::OEPen& pen,
                                   double arrowRadiusScale = 1.0,
                                   bool clockwise = true,
                                   double arcAngle = 270.0,
                                   unsigned int layer = OEDepict::OELayerPosition::Above)

      .. oe:language:: python

         .. oe:api:: python

            OEBondGlyphCurvedArrow(pen: OEPen, arrowRadiusScale: float = 1.0,
                                   clockwise: bool = True,
                                   arcAngle: float = 270.0, layer: int) -> OEBondGlyphCurvedArrow

      Creates an :ref:`OEBondGlyphCurvedArrow <OEGrapheme_OEBondGlyphCurvedArrow>` object with the
      specified parameters.

      .. _figure_OEBondGlyphCurvedArrow:

      .. figure:: ../images/OEBondGlyphCurvedArrow.*
         :align:  center

         **Example of bond annotations**

      *pen*
         The pen used when drawing a curved arrow at the middle of the bond.

         See examples (A) and (B) in :ref:`Figure: Example of bond annotations<figure_OEBondGlyphCurvedArrow>`.

      *arrowRadiusScale*
         The multiplier used to modify the radius of the drawn arc.

         See examples (A) and (C) in :ref:`Figure: Example of bond annotations<figure_OEBondGlyphCurvedArrow>`.

      *clockwise*
         The direction of the arrow.

         See examples (A) and (D) in :ref:`Figure: Example of bond annotations<figure_OEBondGlyphCurvedArrow>`.

      *arcAngle*
         The angel of the arc in degrees.
         The value has to be in a range of :math:`[0.0^{\circ}, 360.0^{\circ}]`.

         See examples (A) and (E) in :ref:`Figure: Example of bond annotations<figure_OEBondGlyphCurvedArrow>`.

      *layer*
         Specifies whether the curved arrow is drawn above
         (:oe:const:`OEDepict::OELayerPosition::Above`) or below
         (:oe:const:`OEDepict::OELayerPosition::Below`) the molecule.

         See examples (B) and (F) in :ref:`Figure: Example of bond annotations<figure_OEBondGlyphCurvedArrow>`.


   .. ################################################################
      #
      ################################################################

   .. oe:method:: CreateCopy

      .. oe:language:: c++ java csharp

         .. oe:api::

            OEBondGlyphBase* CreateCopy() const

      .. oe:language:: python

         .. oe:api:: python

            CreateCopy() -> OEBondGlyphCurvedArrow

      Deep copy constructor that returns a copy of the object.
      The memory for the returned :ref:`OEBondGlyphCurvedArrow <OEGrapheme_OEBondGlyphCurvedArrow>`
      object is dynamically allocated and owned by the caller.


   .. ################################################################
      #
      ################################################################

   .. oe:method:: RenderGlyph

      .. oe:language:: c++ java csharp

         .. oe:api::

            bool RenderGlyph(OEDepict::OE2DMolDisplay& disp,
                             const OEChem::OEBondBase* bond) const

      .. oe:language:: python

         .. oe:api:: python

            RenderGlyph(disp: OE2DMolDisplay, bond: OEBondBase) -> bool

      Draws a glyph (in this case a curved arrow) in the middle of the given bond.

      *disp*
         The :ref:`OE2DMolDisplay <OEDepict_OE2DMolDisplay>` object that is modified
         to annotate the specified bond.

      *bond*
         The :ref:`OEBondBase <OEChem_OEBondBase>` object being annotated.

