Add pan and zoom toolbar handling to 3D Axes (Replaces PR#22614) (matplotlib#23449)

* ENH: Add pan and zoom toolbar handling to 3D Axes

1) This moves the pan logic that was already in the mouse move handler
into the "drag_pan" method to make it available from the toolbar.

2) This expands upon the panning logic to enable a zoom-to-box feature.
The zoom-to-box is done relative to the Axes, so it shrinks/expands
the box as a fraction of each delta, from lower-left Axes to lower-left
zoom-box. Thus, it tries to handle non-centered zooms, which adds more
cases to handle versus the current right-click zoom only scaling from
the center of the projection.

* Rewrite zooming with bounding box

* Rewrite 3d panning to work with a roll angle

* Whats new for zoom and pan buttons

* Make pan button configurable

* Do not jump when zooming and mouse goes over other subplot

* Rework zooming for 3d plots

* Handle x/y lock when zooming and panning

* Update tests

* Docstrings

* Dont assume a scale_z

* Limit zoom box

* Test zoom pan key modifiers

* Save some calculation by saving view axes

* Deprecation warnings for Axes3D.eye, .vvec

* Remove Axes3D._prepare_view_from_bbox for now

* Comments and docstrings

* Switch from uvn to uvw

* Save aspect to axes

* Constrain zooming with mouse when one of the equal aspect ratios is set

* Cleanup

* Cleanup

* Consolidate finding equal aspect axis indices

* linting

* More intuitive scaling

* Box zoom keeps existing aspect ratios

* Linting

* Code review comments

* Revert parameters for view_transformation

* Fix new 3d pan/zoom view going on view stack twice

* Better clipping

* Test 3d toolbar navigation

* Privatize helper functions

* Deprecations

* Code review changes

* Deprecation note

* Undeprecate proj3d.view_transformation

* Undeprecate proj3d.view_transformation

* Update doc/api/next_api_changes/deprecations/23449-SS.rst


Co-authored-by: Greg Lucas <[email protected]>
Co-authored-by: Scott Shambaugh <[email protected]>
Co-authored-by: Oscar Gustafsson <[email protected]>

Author: 3 people

doc/api/next_api_changes/deprecations/23449-SS.rst

@@ -0,0 +1,3 @@
+``axes3d.vvec``, ``axes3d.eye``, ``axes3d.sx``, and ``axes3d.sy``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+... are deprecated without replacement.

doc/users/next_whats_new/3d_plot_pan_zoom.rst

@@ -0,0 +1,8 @@
+3D plot pan and zoom buttons
+----------------------------
+
+The pan and zoom buttons in the toolbar of 3D plots are now enabled.
+Unselect both to rotate the plot. When the zoom button is pressed,
+zoom in by using the left mouse button to draw a bounding box, and
+out by using the right mouse button to draw the box. When zooming a
+3D plot, the current view aspect ratios are kept fixed.