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

.. only:: html

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

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

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

.. _sphx_glr__gallery_selection_tools_linear_selector_image.py:


Linear Selectors Image
======================

Example showing how to use a `LinearSelector` to select rows or columns of an image. The subplot on the right
displays the data for the selector row and column. Move the selectors independently or click the middle mouse
button to move both selectors to the clicked location.

.. GENERATED FROM PYTHON SOURCE LINES 9-74



.. image-sg:: /_gallery/selection_tools/images/sphx_glr_linear_selector_image_001.webp
   :alt: linear selector image
   :srcset: /_gallery/selection_tools/images/sphx_glr_linear_selector_image_001.webp
   :class: sphx-glr-single-img





.. code-block:: Python


    # test_example = false

    import fastplotlib as fpl
    from imageio import v3 as iio

    image_data = iio.imread("imageio:coins.png")

    figure = fpl.Figure(
        (1, 3),
        size=(700, 300),
        names=[["image", "selected row data", "selected column data"]]
    )

    # create an image
    image = figure[0, 0].add_image(image_data)

    # add a row selector
    image_row_selector = image.add_linear_selector(axis="y", edge_color="cyan")

    # add column selector
    image_col_selector = image.add_linear_selector(edge_color="cyan")

    # make a line to indicate row data
    line_image_row = figure[0, 1].add_line(image.data[0])

    # make a line to indicate column data
    line_image_col = figure[0, 2].add_line(image.data[:, 0])


    # callbacks to change the line data in subplot [0, 1]
    # to display selected row and selected column data
    def image_row_selector_changed(ev):
        ix = ev.get_selected_index()
        new_data = image.data[ix]
        # set y values of line with the row data
        line_image_row.data[:, 1] = new_data


    def image_col_selector_changed(ev):
        ix = ev.get_selected_index()
        new_data = image.data[:, ix]
        # set y values of line with the column data
        line_image_col.data[:, 1] = new_data


    # add event handlers, you can also use a decorator
    image_row_selector.add_event_handler(image_row_selector_changed, "selection")
    image_col_selector.add_event_handler(image_col_selector_changed, "selection")

    # programmatically set the selection or drag it with your mouse pointer
    image_row_selector.selection = 200
    image_col_selector.selection = 180

    figure.show()

    for subplot in figure:
        subplot.camera.zoom = 0.5


    # NOTE: fpl.loop.run() should not be used for interactive sessions
    # See the "JupyterLab and IPython" section in the user guide
    if __name__ == "__main__":
        print(__doc__)
        fpl.loop.run()


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

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


.. _sphx_glr_download__gallery_selection_tools_linear_selector_image.py:

.. only:: html

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

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

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

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

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


.. only:: html

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

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