much simpler tooltip and cursor

clewis7 · Jan 14, 2026 · Nov 19, 2025 · Nov 19, 2025 · Nov 20, 2025 · Nov 20, 2025
commit 9323e3a82720dd65930451638b70fa4a6bcd7fa3
@@ -34,6 +34,9 @@ def create_ripple(shape=(100, 100), phase=0.0, freq=np.pi / 4, ampl=1.0):
     z, mode="basic", cmap="viridis", clim=(-max_z, max_z)
 )
 
+# enable continuous updates for the tooltip
+figure[0, 0].tooltip.continuous_update = True
+
 figure[0, 0].camera.show_object(surface.world_object, (-1, 3, -1), up=(0, 0, 1))
 figure.show()
 

diff --git a/examples/misc/cursor_custom_tooltip.py b/examples/misc/cursor_custom_tooltip.py
diff --git a/examples/misc/cursor_manual.py b/examples/misc/cursor_manual.py
@@ -0,0 +1,49 @@
+"""
+Cursor transform
+================
+
+Create a cursor and add them to subplots with a transform function. An example usecase is image registration.
+"""
+
+# test_example = False
+# sphinx_gallery_pygfx_docs = 'screenshot'
+
+import numpy as np
+import fastplotlib as fpl
+import imageio.v3 as iio
+
+
+# get an image
+img1 = iio.imread("imageio:camera.png")
+
+# create another image, but it is offset
+img2 = np.zeros(img1.shape)
+img2[50:, 20:] = img1[:-50, :-20]
+
+figure = fpl.Figure((1, 2))
+
+# add images
+figure[0, 0].add_image(img1)
+figure[0, 1].add_image(img2)
+
+# create cursor
+cursor = fpl.Cursor("crosshair")
+
+# add first subplot to cursor
+cursor.add_subplot(figure[0, 0])
+
+# a transform function for subplot 2 to indicate that the data is shifted
+def transform_func(pos):
+    return (pos[0] + 20, pos[1] + 50)
+
+# add second subplot with a transform
+cursor.add_subplot(figure[0, 1], transform=transform_func)
+
+figure.show()
+
+
+# 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()
@@ -31,20 +31,26 @@
 )
 
 
-def tooltip_info(ev) -> str:
+def tooltip_info(pick_info: dict) -> str:
     # get index of the scatter point that is being hovered
-    index = ev.pick_info["vertex_index"]
+    index = pick_info["vertex_index"]
 
     # get the species name
 >
     cluster = agg.labels_[index]
-    info = f"species: {dataset['target_names'][target]}\ncluster: {cluster}"
+
+    # the default formatting of the pick info
+    default_info = scatter.format_pick_info(pick_info)
+
+    info = (f"species: {dataset['target_names'][target]}\n"
+            f"cluster: {cluster}\n\n"
+            f"{default_info}")
 
     # return this string to display it in the tooltip
     return info
 
 
-figure.tooltip_manager.register(scatter, custom_info=tooltip_info)
+scatter.tooltip_format = tooltip_info
 
 figure.show()
 

diff --git a/fastplotlib/graphics/__init__.py b/fastplotlib/graphics/__init__.py
@@ -1,5 +1,4 @@
-from ._tooltip import Tooltip
-from ._base import Graphic, GraphicTooltip
+from ._base import Graphic
 from .line import LineGraphic
 from .scatter import ScatterGraphic
 from .image import ImageGraphic
@@ -8,11 +7,10 @@
 from .mesh import MeshGraphic, SurfaceGraphic, PolygonGraphic
 from .text import TextGraphic
 from .line_collection import LineCollection, LineStack
+from ._tooltip import TextBox, Tooltip
 
 
 __all__ = [
-    "Tooltip",
-    "GraphicTooltip",
     "Graphic",
     "LineGraphic",
     "ScatterGraphic",
@@ -25,4 +23,6 @@
     "TextGraphic",
     "LineCollection",
     "LineStack",
+    "TextBox",
+    "Tooltip",
 ]