Panning is done by clicking the middle mouse button, and zooming is done by

right-clicking the scene and dragging the mouse up and down. Unlike 2D plots,

the toolbar pan and zoom buttons are not used.

mplot3d/view_angles.rst

.. _toolkit_mplot3d-view-angles:

mplot3d View Angles

How to define the view angle

The position of the viewport "camera" in a 3D plot is defined by three angles:

elevation, azimuth, and roll. From the resulting position, it always points

towards the center of the plot box volume. The angle direction convention is

shared with

`PyVista <https://docs.pyvista.org/api/core/camera.html>`_ and

`MATLAB <https://www.mathworks.com/help/matlab/ref/view.html>`_

(though MATLAB lacks a roll angle). Note that a positive roll angle rotates the

viewing plane clockwise, so the 3d axes will appear to rotate

counter-clockwise.

.. image:: /_static/mplot3d_view_angles.png

:align: center

:scale: 50

Rotating the plot using the mouse will control only the azimuth and elevation,

but all three angles can be set programmatically::

Primary view planes

To look directly at the primary view planes, the required elevation, azimuth,

and roll angles are shown in the diagram of an "unfolded" plot below. You could

print out this image and fold it into a box where each plane forms a side of

the box. These are further documented in the `.mplot3d.axes3d.Axes3D.view_init`

API.

.. image:: /_static/mplot3d_primary_view_planes.png

:align: center