.. include:: ../../common/cookbook/cookbook-hyperlinks

.. include:: ../substitutions

.. oe:namespace:: OEGrapheme

.. meta::
   :keywords: OERenderShapeQuery

.. oe:function:: OERenderShapeQuery

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

      .. oe:api::

         void OERenderShapeQuery(OEDepict::OEImageBase& image,
                                 const OEShapeQueryDisplay& disp)

   .. oe:language:: python

      .. oe:api:: python

         OERenderShapeQuery(image: OEImageBase, qdisp: OEShapeQueryDisplay) -> None

   Renders the reference molecule of the shape overlap.

   *image*
     The image on which the reference molecule is rendered.

   *disp*
     The :ref:`OEShapeQueryDisplay <OEGrapheme_OEShapeQueryDisplay>` object
     that holds the data necessary to depict the reference molecule
     of a shape overlap.

   The following code snippet shows how to use the :oe:func:`OEGrapheme::OERenderShapeQuery`
   function. The image created is shown in
   :ref:`Figure: Example of using the OERenderShapeQuery function<figure_OERenderShapeQuery>`.

   .. oe:source:: RenderShapeQuery.py
      :language: python
      :noindent:
      :frag:     SNIPPET-RENDER-SHAPE-QUERY

   .. oe:source:: RenderShapeQuery.cpp
      :language: c++
      :noindent:
      :frag:     SNIPPET-RENDER-SHAPE-QUERY

   .. oe:source:: RenderShapeQuery.java
      :language: java
      :noindent:
      :frag:     SNIPPET-RENDER-SHAPE-QUERY

   .. oe:source:: RenderShapeQuery.cs
      :language: csharp
      :noindent:
      :frag:     SNIPPET-RENDER-SHAPE-QUERY


   .. _figure_OERenderShapeQuery:

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

      **Example of using the OERenderShapeQuery function**

   .. seealso::

      * :ref:`OEShapeQueryDisplayOptions <OEGrapheme_OEShapeQueryDisplayOptions>` class
      * :oe:func:`OEGrapheme::OERenderColorOverlap` function
      * :oe:func:`OEGrapheme::OERenderShapeOverlap` function

   .. admonition:: Code Example

      * :ref:`section_examples_summary_shapeoverlap2pdf` example
      * `Visualizing Shape and Color Overlap`_ **OpenEye Python Cookbook** recipe
