.. # split from OEGraphemeFunctions.rst:1435

.. include:: ../substitutions

.. oe:namespace:: OEGrapheme

.. meta::
   :keywords: OEDrawNecklaceSurfaceArc

.. oe:function:: OEDrawNecklaceSurfaceArc

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

      .. oe:api::

         bool OEDrawNecklaceSurfaceArc(OEDepict::OEImageBase& image,
                                       const OEDepict::OE2DPoint& center,
                                       double bgnAngle, double endAngle,
                                       double radius,
                                       const OEDepict::OEPen& pen,
                                       double edgeAngle = 10.0,
                                       double patternAngle = 20.0,
                                       double minPatternWidthRatio = 0.15,
                                       double maxPatternWidthRatio = 0.15)

   .. oe:language:: python

      .. oe:api:: python

         OEDrawNecklaceSurfaceArc(image: OEImageBase, c: OE2DPoint,
                                  bgnAngle: float, endAngle: float,
                                  radius: float, pen: OEPen,
                                  edgeAngle: float = 10.0,
                                  patternAngle: float = 20.0,
                                  minPatternWidthRatio: float = 0.15,
                                  maxPatternWidthRatio: float = 0.15) -> bool

   Draws an arc with the :oe:const:`OEGrapheme::OESurfaceArcStyle::Necklace` style.

   .. _figure_draw_surface_arc_necklace:

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

      **OEDrawNecklaceSurfaceArc**

   *image*
     |arc_image|

   *center*
     |arc_center|

   *bgnAngle, endAngle*
     |arc_angles|

   *radius*
     |arc_radius|

   *pen*
     |arc_pen|

   *edgeAngle*
     |arc_edgeangle|

     See example (B) in :ref:`Figure: OEDrawNecklaceSurfaceArc<figure_draw_surface_arc_necklace>`.

   *patternAngle*
     |arc_pattern_angle|

     See example (C) in :ref:`Figure: OEDrawNecklaceSurfaceArc<figure_draw_surface_arc_necklace>`.

   *minPatternWidthRatio, maxPatternWidthRatio*
     |arc_width_ratio|

     See examples (D) and (E) in :ref:`Figure: OEDrawNecklaceSurfaceArc<figure_draw_surface_arc_necklace>`.

   .. seealso::

      * :ref:`OENecklaceArcFxn <OEGrapheme_OENecklaceArcFxn>` class

