.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "_gallery/events/cmap_event.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. note::
        :class: sphx-glr-download-link-note

        :ref:`Go to the end <sphx_glr_download__gallery_events_cmap_event.py>`
        to download the full example code.

.. rst-class:: sphx-glr-example-title

.. _sphx_glr__gallery_events_cmap_event.py:


cmap event
==========

Add a cmap event handler to multiple graphics. When any one graphic changes the cmap, the cmap of all other graphics
is also changed.

This also shows how bidirectional events are supported.

.. GENERATED FROM PYTHON SOURCE LINES 10-75



.. image-sg:: /_gallery/events/images/sphx_glr_cmap_event_001.webp
   :alt: cmap event
   :srcset: /_gallery/events/images/sphx_glr_cmap_event_001.webp
   :class: sphx-glr-single-img


.. rst-class:: sphx-glr-script-out

 .. code-block:: none

    Imageio: 'moon.png' was not found on your computer; downloading it now.
    Try 1. Download from https://github.com/imageio/imageio-binaries/raw/master/images/moon.png (44 kB)
    Downloading: 8192/45494 bytes (18.0%)45494/45494 bytes (100.0%)
      Done
    File saved as /home/runner/.imageio/images/moon.png.
    /home/runner/work/fastplotlib/fastplotlib/fastplotlib/graphics/features/_base.py:18: UserWarning: casting float64 array to float32
      warn(f"casting {array.dtype} array to float32")







|

.. code-block:: Python


    # test_example = false

    import numpy as np
    import fastplotlib as fpl
    import imageio.v3 as iio

    # load images
    img1 = iio.imread("imageio:camera.png")
    img2 = iio.imread("imageio:moon.png")

    # Create a figure
    figure = fpl.Figure(
        shape=(2, 2),
        size=(700, 560),
        names=["camera", "moon", "sine", "cloud"],
    )

    # create graphics
    figure["camera"].add_image(img1)
    figure["moon"].add_image(img2)

    # sine wave
    xs = np.linspace(0, 4 * np.pi, 100)
    ys = np.sin(xs)

    figure["sine"].add_line(np.column_stack([xs, ys]))

    # make a 2D gaussian cloud
    cloud_data = np.random.normal(0, scale=3, size=1000).reshape(500, 2)
    figure["cloud"].add_scatter(
        cloud_data,
        sizes=3,
        cmap="plasma",
        cmap_transform=np.linalg.norm(cloud_data, axis=1)  # cmap transform using distance from origin
    )
    figure["cloud"].axes.intersection = (0, 0, 0)

    # show the plot
    figure.show()


    # event handler to change the cmap of all graphics when the cmap of any one graphic changes
    def cmap_changed(ev: fpl.GraphicFeatureEvent):
        # get the new cmap
        new_cmap = ev.info["value"]

        # set cmap of the graphics in the other subplots
        for subplot in figure:
            subplot.graphics[0].cmap = new_cmap


    for subplot in figure:
        # add event handler to the graphic added to each subplot
        subplot.graphics[0].add_event_handler(cmap_changed, "cmap")


    # change the cmap of graphic image, triggers all other graphics to set the cmap
    figure["camera"].graphics[0].cmap = "jet"

    # NOTE: `if __name__ == "__main__"` is NOT how to use fastplotlib interactively
    # please see our docs for using fastplotlib interactively in ipython and jupyter
    if __name__ == "__main__":
        print(__doc__)
        fpl.loop.run()


.. rst-class:: sphx-glr-timing

   **Total running time of the script:** (0 minutes 1.010 seconds)


.. _sphx_glr_download__gallery_events_cmap_event.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download Jupyter notebook: cmap_event.ipynb <cmap_event.ipynb>`

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download Python source code: cmap_event.py <cmap_event.py>`

    .. container:: sphx-glr-download sphx-glr-download-zip

      :download:`Download zipped: cmap_event.zip <cmap_event.zip>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_