.. include:: ../../toolkit-substitutions
.. include:: ../substitutions

.. oe:namespace:: OEDepict


.. _OEDepict_OEBondSVGBondIdxMarkup:

.. oe:class:: OEBondSVGBondIdxMarkup

   .. oe:api::

      class OEBondSVGBondIdxMarkup : public OEBondSVGMarkupBase

   This class represents the :ref:`OEBondSVGBondIdxMarkup <OEDepict_OEBondSVGBondIdxMarkup>` bond
   SVG markup functor.  If this functor is passed to the
   :oe:meth:`OEDepict::OE2DMolDisplayOptions::SetBondSVGMarkupFunctor`
   method, the bonds will be not marked in the :file:`svg` image when
   calling the :ref:`OERenderMolecule <OEDepict_OERenderMolecule>` function.

   .. seealso::

      * :ref:`chapter_svg` chapter
      * :oe:meth:`OEDepict::OE2DMolDisplayOptions::SetBondSVGMarkupFunctor` method
      * :ref:`OEBondSVGNoMarkup <OEDepict_OEBondSVGNoMarkup>` class

   The following methods are publicly inherited from
   :ref:`OEBondSVGMarkupBase <OEDepict_OEBondSVGMarkupBase>`:

   ==================================================================== ==================================================================== ====================================================================
   :oe:meth:`CreateCopy<OEDepict::OEBondSVGMarkupBase::CreateCopy>`     :oe:meth:`GetClassName<OEDepict::OEBondSVGMarkupBase::GetClassName>` :oe:meth:`GetGroupId<OEDepict::OEBondSVGMarkupBase::GetGroupId>`
   ==================================================================== ==================================================================== ====================================================================

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

   .. oe:method:: Constructors

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

         .. oe:api::

            OEBondSVGBondIdxMarkup(const std::string prefix = "",
                                   const std::string classname = "bond")


      .. oe:language:: python

         .. oe:api:: python

            OEBondSVGBondIdxMarkup(prefix: str = "", classname: str = "bond") -> OEBondSVGBondIdxMarkup

      Creates an :ref:`OEBondSVGBondIdxMarkup <OEDepict_OEBondSVGBondIdxMarkup>` object.

      prefix
         The string that will be added at the beginning of each bond
         :oe:cls:`group id <OEDepict::OESVGGroup>`.
         For information about valid ids see
         :oe:func:`OEDepict::OEIsValidSVGGroupId` function.
         By default, no prefix will be added.

      classname
         The :oe:cls:`class name <OEDepict::OESVGClass>` that is going to
         be used to mark bonds.
         For information about valid names see
         :oe:func:`OEDepict::OEIsValidSVGClassName` function.

      By default, the svg image for the first bond of a molecule will be
      marked as follows:

      ::

          <g id='idx=0' class='bond'>
          ..
          list of drawing elements
          ..
          <circle ... >
          </g>

      The transparent circle will be drawn at the middle of the bond.
      This can be used to manipulate the generated :file:`.svg` image
      and associate event with the SVG groups.

   .. oe:method:: CreateCopy

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

         .. oe:api::

            OEBondSVGMarkupBase* CreateCopy() const

      .. oe:language:: python

         .. oe:api:: python

            CreateCopy() -> OEBondSVGMarkupBase

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

   .. oe:method:: GetClassName

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

         .. oe:api::

            std::string GetClassName(const OEChem::OEBondBase &) const

      .. oe:language:: python

         .. oe:api:: python

            GetClassName(arg2: OEBondBase) -> str

      Returns the string that specifies the
      :oe:cls:`group id <OEDepict::OESVGGroup>`
      of an bond in an :file:`svg` image.

   .. oe:method:: GetGroupId

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

         .. oe:api::

            std::string GetGroupId(const OEChem::OEBondBase &) const

      .. oe:language:: python

         .. oe:api:: python

            GetGroupId(bond: OEBondBase) -> str

      Returns the string that specifies the
      :oe:cls:`class name <OEDepict::OESVGClass>`
      of an bond in an :file:`svg` image.
