cursor tool and better tooltips (fastplotlib#947)

* new cursor tool, basics work

* lint and update api docs

* add custom tooltip to figure

* example WIP

* manual picking, world obj -> graphic mapping

* fix

* fix gc

* stuff

* cursor and tooltips refactor, basically works

* much simpler tooltip and cursor

* move TextBox and Tooltip, update API docs

* cursor manages tooltips

* update examples

* black

* cleanup

* docstrings

* update example

* update example

* add image space transforms examples

* finish space transforms examples

* typing

* black

* docstrings

* update examples

* textbox constructor takes args, docstrings

* True -> true

* update names

* update cursor examples

* new ground truth screenshots for transforms

* black

* update

* revert persist kwarg in PlotArea animations stuff

* fix

* message for image volumes

* Update fastplotlib/graphics/_base.py

Co-authored-by: Kushal Kolar <kushalkolar@gmail.com>

---------

Co-authored-by: clewis7 <caitlin9165@gmail.com>

Author: kushalkolar

docs/source/api/graphic_features/Scale.rst

@@ -0,0 +1,35 @@
+.. _api.Scale:
+
+Scale
+*****
+
+=====
+Scale
+=====
+.. currentmodule:: fastplotlib.graphics.features
+
+Constructor
+~~~~~~~~~~~
+.. autosummary::
+    :toctree: Scale_api
+
+    Scale
+
+Properties
+~~~~~~~~~~
+.. autosummary::
+    :toctree: Scale_api
+
+    Scale.value
+
+Methods
+~~~~~~~
+.. autosummary::
+    :toctree: Scale_api
+
+    Scale.add_event_handler
+    Scale.block_events
+    Scale.clear_event_handlers
+    Scale.remove_event_handler
+    Scale.set_value
+

docs/source/api/graphic_features/index.rst

@@ -48,6 +48,7 @@ Graphic Features
     Name
     Offset
     Rotation
+    Scale
     Alpha
     AlphaMode
     Visible

docs/source/api/graphics/Graphic.rst

@@ -30,7 +30,9 @@ Properties
     Graphic.offset
     Graphic.right_click_menu
     Graphic.rotation
+    Graphic.scale
     Graphic.supported_events
+    Graphic.tooltip_format
     Graphic.visible
     Graphic.world_object
 
@@ -42,6 +44,9 @@ Methods
     Graphic.add_axes
     Graphic.add_event_handler
     Graphic.clear_event_handlers
+    Graphic.format_pick_info
+    Graphic.map_model_to_world
+    Graphic.map_world_to_model
     Graphic.remove_event_handler
     Graphic.rotate
 

docs/source/api/graphics/ImageGraphic.rst

@@ -34,7 +34,9 @@ Properties
     ImageGraphic.offset
     ImageGraphic.right_click_menu
     ImageGraphic.rotation
+    ImageGraphic.scale
     ImageGraphic.supported_events
+    ImageGraphic.tooltip_format
     ImageGraphic.visible
     ImageGraphic.vmax
     ImageGraphic.vmin
@@ -52,6 +54,9 @@ Methods
     ImageGraphic.add_polygon_selector
     ImageGraphic.add_rectangle_selector
     ImageGraphic.clear_event_handlers
+    ImageGraphic.format_pick_info
+    ImageGraphic.map_model_to_world
+    ImageGraphic.map_world_to_model
     ImageGraphic.remove_event_handler
     ImageGraphic.reset_vmin_vmax
     ImageGraphic.rotate

docs/source/api/graphics/ImageVolumeGraphic.rst

@@ -37,11 +37,13 @@ Properties
     ImageVolumeGraphic.plane
     ImageVolumeGraphic.right_click_menu
     ImageVolumeGraphic.rotation
+    ImageVolumeGraphic.scale
     ImageVolumeGraphic.shininess
     ImageVolumeGraphic.step_size
     ImageVolumeGraphic.substep_size
     ImageVolumeGraphic.supported_events
     ImageVolumeGraphic.threshold
+    ImageVolumeGraphic.tooltip_format
     ImageVolumeGraphic.visible
     ImageVolumeGraphic.vmax
     ImageVolumeGraphic.vmin
@@ -55,6 +57,9 @@ Methods
     ImageVolumeGraphic.add_axes
     ImageVolumeGraphic.add_event_handler
     ImageVolumeGraphic.clear_event_handlers
+    ImageVolumeGraphic.format_pick_info
+    ImageVolumeGraphic.map_model_to_world
+    ImageVolumeGraphic.map_world_to_model
     ImageVolumeGraphic.remove_event_handler
     ImageVolumeGraphic.reset_vmin_vmax
     ImageVolumeGraphic.rotate

docs/source/api/graphics/LineCollection.rst

@@ -38,8 +38,10 @@ Properties
     LineCollection.right_click_menu
     LineCollection.rotation
     LineCollection.rotations
+    LineCollection.scale
     LineCollection.supported_events
     LineCollection.thickness
+    LineCollection.tooltip_format
     LineCollection.visible
     LineCollection.visibles
     LineCollection.world_object
@@ -57,6 +59,9 @@ Methods
     LineCollection.add_polygon_selector
     LineCollection.add_rectangle_selector
     LineCollection.clear_event_handlers
+    LineCollection.format_pick_info
+    LineCollection.map_model_to_world
+    LineCollection.map_world_to_model
     LineCollection.remove_event_handler
     LineCollection.remove_graphic
     LineCollection.rotate

docs/source/api/graphics/LineGraphic.rst

@@ -33,9 +33,11 @@ Properties
     LineGraphic.offset
     LineGraphic.right_click_menu
     LineGraphic.rotation
+    LineGraphic.scale
     LineGraphic.size_space
     LineGraphic.supported_events
     LineGraphic.thickness
+    LineGraphic.tooltip_format
     LineGraphic.visible
     LineGraphic.world_object
 
@@ -51,6 +53,9 @@ Methods
     LineGraphic.add_polygon_selector
     LineGraphic.add_rectangle_selector
     LineGraphic.clear_event_handlers
+    LineGraphic.format_pick_info
+    LineGraphic.map_model_to_world
+    LineGraphic.map_world_to_model
     LineGraphic.remove_event_handler
     LineGraphic.rotate
 

docs/source/api/graphics/LineStack.rst

@@ -38,8 +38,10 @@ Properties
     LineStack.right_click_menu
     LineStack.rotation
     LineStack.rotations
+    LineStack.scale
     LineStack.supported_events
     LineStack.thickness
+    LineStack.tooltip_format
     LineStack.visible
     LineStack.visibles
     LineStack.world_object
@@ -57,6 +59,9 @@ Methods
     LineStack.add_polygon_selector
     LineStack.add_rectangle_selector
     LineStack.clear_event_handlers
+    LineStack.format_pick_info
+    LineStack.map_model_to_world
+    LineStack.map_world_to_model
     LineStack.remove_event_handler
     LineStack.remove_graphic
     LineStack.rotate

docs/source/api/graphics/MeshGraphic.rst

@@ -38,7 +38,9 @@ Properties
     MeshGraphic.positions
     MeshGraphic.right_click_menu
     MeshGraphic.rotation
+    MeshGraphic.scale
     MeshGraphic.supported_events
+    MeshGraphic.tooltip_format
     MeshGraphic.visible
     MeshGraphic.world_object
 
@@ -50,6 +52,9 @@ Methods
     MeshGraphic.add_axes
     MeshGraphic.add_event_handler
     MeshGraphic.clear_event_handlers
+    MeshGraphic.format_pick_info
+    MeshGraphic.map_model_to_world
+    MeshGraphic.map_world_to_model
     MeshGraphic.remove_event_handler
     MeshGraphic.rotate
 

docs/source/api/graphics/PolygonGraphic.rst

@@ -39,7 +39,9 @@ Properties
     PolygonGraphic.positions
     PolygonGraphic.right_click_menu
     PolygonGraphic.rotation
+    PolygonGraphic.scale
     PolygonGraphic.supported_events
+    PolygonGraphic.tooltip_format
     PolygonGraphic.visible
     PolygonGraphic.world_object
 
@@ -51,6 +53,9 @@ Methods
     PolygonGraphic.add_axes
     PolygonGraphic.add_event_handler
     PolygonGraphic.clear_event_handlers
+    PolygonGraphic.format_pick_info
+    PolygonGraphic.map_model_to_world
+    PolygonGraphic.map_world_to_model
     PolygonGraphic.remove_event_handler
     PolygonGraphic.rotate