fastplotlib · clewis7 · Jan 14, 2026 · Nov 19, 2025 · Nov 19, 2025 · Nov 20, 2025
@@ -0,0 +1,42 @@
+.. _api.Cursor:
+
+Cursor
+******
+
+======
+Cursor
+======
+.. currentmodule:: fastplotlib
+
+Constructor
+~~~~~~~~~~~
+.. autosummary::
+    :toctree: Cursor_api
+
+    Cursor
+
+Properties
+~~~~~~~~~~
+.. autosummary::
+    :toctree: Cursor_api
+
+    Cursor.alpha
+    Cursor.color
+    Cursor.edge_color
+    Cursor.edge_width
+    Cursor.marker
+    Cursor.mode
+    Cursor.pause
+    Cursor.position
+    Cursor.size
+    Cursor.size_space
+
+Methods
+~~~~~~~
+.. autosummary::
+    :toctree: Cursor_api
+
+    Cursor.add_subplot
+    Cursor.clear
+    Cursor.remove_subplot
+
diff --git a/docs/source/api/tools/GraphicTooltip.rst b/docs/source/api/tools/GraphicTooltip.rst
@@ -0,0 +1,40 @@
+.. _api.GraphicTooltip:
+
+GraphicTooltip
+**************
+
+==============
+GraphicTooltip
+==============
+.. currentmodule:: fastplotlib
+
+Constructor
+~~~~~~~~~~~
+.. autosummary::
+    :toctree: GraphicTooltip_api
+
+    GraphicTooltip
+
+Properties
+~~~~~~~~~~
+.. autosummary::
+    :toctree: GraphicTooltip_api
+
+    GraphicTooltip.background_color
+    GraphicTooltip.font_size
+    GraphicTooltip.outline_color
+    GraphicTooltip.padding
+    GraphicTooltip.text_color
+    GraphicTooltip.world_object
+
+Methods
+~~~~~~~
+.. autosummary::
+    :toctree: GraphicTooltip_api
+
+    GraphicTooltip.clear
+    GraphicTooltip.display
+    GraphicTooltip.register
+    GraphicTooltip.unregister
+    GraphicTooltip.unregister_all
+
@@ -32,7 +32,6 @@ Methods
 .. autosummary::
     :toctree: Tooltip_api
 
-    Tooltip.register
-    Tooltip.unregister
-    Tooltip.unregister_all
+    Tooltip.clear
+    Tooltip.display
 
@@ -6,3 +6,5 @@ Tools
 
     HistogramLUTTool
     Tooltip
+    GraphicTooltip
+    Cursor
@@ -0,0 +1,33 @@
+"""
+Cursor tool
+===========
+
+Example with multiple subplots and an interactive cursor
+that marks the same position in each subplot
+"""
+
+import numpy as np
+import fastplotlib as fpl
+import imageio.v3 as iio
+
+img1 = iio.imread("imageio:camera.png")
+img2 = iio.imread("imageio:astronaut.png")
+
+scatter_data = np.random.normal(loc=256, scale=(50), size=(500)).reshape(250, 2)
+
+
+figure = fpl.Figure(shape=(2, 2))
+
+figure[0, 0].add_image(img1)
+figure[0, 1].add_image(img2)
+figure[1, 0].add_scatter(scatter_data, sizes=5)
+
+cursor = fpl.Cursor(mode="crosshair", color="cyan")
+
+for subplot in figure:
+    cursor.add_subplot(subplot)
+
+figure.show_tooltips = True
+
+figure.show()
+fpl.loop.run()
@@ -21,7 +21,7 @@
 from ._subplot import Subplot
 from ._engine import GridLayout, WindowLayout, ScreenSpaceCamera
 from .. import ImageGraphic
-from ..tools import Tooltip
+from ..tools import GraphicTooltip
 
 
 class Figure:
@@ -461,7 +461,7 @@ def __init__(
         self._overlay_scene = pygfx.Scene()
 
         # tooltip in overlay render pass
-        self._tooltip_manager = Tooltip()
+        self._tooltip_manager = GraphicTooltip()
         self._overlay_scene.add(self._tooltip_manager.world_object)
 
         self._show_tooltips = show_tooltips
@@ -534,7 +534,7 @@ def names(self) -> np.ndarray[str]:
         return names
 
     @property
-    def tooltip_manager(self) -> Tooltip:
+    def tooltip_manager(self) -> GraphicTooltip:
         """manage tooltips"""
         return self._tooltip_manager
 

@@ -1,7 +1,10 @@
 from ._histogram_lut import HistogramLUTTool
-from ._tooltip import Tooltip
+from ._tooltip import Tooltip, GraphicTooltip
+from ._cursor import Cursor
 
 __all__ = [
     "HistogramLUTTool",
     "Tooltip",
+    "GraphicTooltip",
+    "Cursor",
 ]
-Original file line number
+Diff line change
@@ Expand Up / @@ -6,3 +6,5 @@ Tools @@
         HistogramLUTTool
         Tooltip
+        GraphicTooltip
+        Cursor