wolfhece._guihydrology_handlers
===============================

.. py:module:: wolfhece._guihydrology_handlers

.. autoapi-nested-parse::

   Per-action mouse handlers for GuiHydrology.

   Mirrors the structure of ``_viewer_plugin_handlers.py``.  Each function
   extracted from ``GuiHydrology.On_Mouse_Right_Down`` / ``On_Mouse_Motion``
   becomes an independent, testable callable registered via
   ``register_action()`` in ``GuiHydrology.__init__``.

   Signature conventions
   ---------------------
   * rdown / motion handlers:  ``(viewer, MouseContext) -> None``
   * ``viewer`` is the ``GuiHydrology`` instance — accessed as a plain object
     (never imported at module level to avoid circular imports).

   Dispatch tables
   ---------------
   ``HYDRO_RDOWN_HANDLERS``   — maps ActionKind → rdown handler
   ``HYDRO_MOTION_HANDLERS``  — maps ActionKind → motion handler

   These tables are consumed by ``GuiHydrology.__init__`` when calling
   ``register_action()`` for each hydrology-specific action.







Module Contents
---------------

.. py:function:: _watershed(viewer: wolfhece.PyGuiHydrology.GuiHydrology)

   Return the watershed or None (mirrors the @property in GuiHydrology).


.. py:function:: _hydro_rdown_pick_outlet(viewer: wolfhece.PyGuiHydrology.GuiHydrology, ctx: wolfhece._viewer_plugin_handlers.MouseContext) -> None

.. py:function:: _hydro_rdown_pick_interior_point(viewer: wolfhece.PyGuiHydrology.GuiHydrology, ctx: wolfhece._viewer_plugin_handlers.MouseContext) -> None

.. py:function:: _hydro_rdown_remove_forced_exchanges(viewer: wolfhece.PyGuiHydrology.GuiHydrology, ctx: wolfhece._viewer_plugin_handlers.MouseContext) -> None

.. py:function:: _hydro_rdown_find_upstream_watershed(viewer: wolfhece.PyGuiHydrology.GuiHydrology, ctx: wolfhece._viewer_plugin_handlers.MouseContext) -> None

.. py:function:: _hydro_rdown_find_path_to_outlet(viewer: wolfhece.PyGuiHydrology.GuiHydrology, ctx: wolfhece._viewer_plugin_handlers.MouseContext) -> None

.. py:function:: _hydro_rdown_select_upstream_watershed(viewer: wolfhece.PyGuiHydrology.GuiHydrology, ctx: wolfhece._viewer_plugin_handlers.MouseContext) -> None

.. py:function:: _hydro_rdown_select_upstream_rivers(viewer: wolfhece.PyGuiHydrology.GuiHydrology, ctx: wolfhece._viewer_plugin_handlers.MouseContext) -> None

.. py:function:: _hydro_rdown_select_downstream_rivers(viewer: wolfhece.PyGuiHydrology.GuiHydrology, ctx: wolfhece._viewer_plugin_handlers.MouseContext) -> None

.. py:function:: _hydro_rdown_pick_forced_exchanges(viewer: wolfhece.PyGuiHydrology.GuiHydrology, ctx: wolfhece._viewer_plugin_handlers.MouseContext) -> None

.. py:function:: _hydro_motion_pick_forced_exchanges(viewer: wolfhece.PyGuiHydrology.GuiHydrology, ctx: wolfhece._viewer_plugin_handlers.MouseContext) -> None

.. py:data:: HYDRO_RDOWN_HANDLERS
   :type:  dict

.. py:data:: HYDRO_MOTION_HANDLERS
   :type:  dict