172 lines
4.9 KiB

.. _bpy.ops.view3d.view_orbit:
.. reference::
:Mode: All modes
:Menu: :menuselection:`View --> Navigation --> Orbit`
:Shortcut: :kbd:`MMB`, :kbd:`Numpad2`, :kbd:`Numpad4`, :kbd:`Numpad6`, :kbd:`Numpad8`.
Rotate the view around the point of interest by clicking and dragging
:kbd:`MMB` on the viewport's area.
:kbd:`RMB` cancels the orbit operation.
The :kbd:`Alt` key has several effects on orbiting:
- Clicking a point with :kbd:`Alt-MMB` will make it the point of interest:
it becomes the central point which the view orbits around.
- Holding :kbd:`Alt` and then dragging with :kbd:`MMB` in a certain direction
will :doc:`align </editors/3dview/navigate/viewpoint>` the view to an axis
and make it orthographic.
- Dragging with :kbd:`MMB` and then holding :kbd:`Alt`
will perform an orbit while also snapping to the world axes,
as well as the diagonals between them.
To change the viewing angle in discrete steps, use :kbd:`Numpad8` and :kbd:`Numpad2`
to go up and down, or :kbd:`Numpad4` and :kbd:`Numpad6` for left and right.
You can also press :kbd:`Numpad9` to switch to the opposite side of the view
(rotates the camera 180° around the Z axis).
.. seealso::
- :ref:`Orbit Style Preference <prefs-input-orbit-style>`
- :ref:`Auto-Perspective Preference <prefs-navigation-auto_perspective>`
.. _bpy.ops.view3d.view_roll:
.. reference::
:Mode: All modes
:Menu: :menuselection:`View --> Navigation --> Roll`
:Shortcut: :kbd:`Shift-Numpad4`, :kbd:`Shift-Numpad6`
Rotate the viewport camera around its viewing direction in 15° discrete steps by default.
See the :ref:`rotation angle <prefs-navigation-rotation_angle>` preference to configure.
To reset the roll, you can first align the view to the global X axis
using :kbd:`Numpad3`, then orbit to get back to the regular perspective view.
:kbd:`RMB` cancels the roll operation.
.. _bpy.ops.view3d.view_pan:
.. reference::
:Mode: All modes
:Menu: :menuselection:`View --> Navigation --> Pan`
:Shortcut: :kbd:`Shift-MMB`, :kbd:`Ctrl-Numpad2`, :kbd:`Ctrl-Numpad4`,
:kbd:`Ctrl-Numpad6`, :kbd:`Ctrl-Numpad8`
Moves the view up, down, left and right.
To pan the view, hold down :kbd:`Shift` and drag :kbd:`MMB` in the 3D Viewport.
For discrete steps, use the hotkeys :kbd:`Ctrl-Numpad8`, :kbd:`Ctrl-Numpad2`,
:kbd:`Ctrl-Numpad4` and :kbd:`Ctrl-Numpad6` as with orbiting.
:kbd:`RMB` cancels the orbit operation.
.. _bpy.ops.view3d.zoom:
Zoom In/Out
.. reference::
:Mode: All modes
:Menu: :menuselection:`View --> Navigation --> Zoom In/Out`
:Shortcut: :kbd:`Ctrl-MMB`, :kbd:`Wheel`, :kbd:`NumpadPlus`, :kbd:`NumpadMinus`
Moves the view closer to, or further away from, the point of interest.
You can zoom in and out by rolling the :kbd:`Wheel` or dragging with :kbd:`Ctrl-MMB`.
To zoom with discrete steps, use the hotkeys :kbd:`NumpadPlus` and :kbd:`NumpadMinus`.
.. hint::
If you get lost in 3D space (which is not uncommon),
:ref:`bpy.ops.view3d.view_all` and :ref:`bpy.ops.view3d.view_selected`
can be used to show the contents of your scene.
:kbd:`RMB` cancels the zoom operation.
.. _bpy.ops.view3d.zoom_border:
Zoom Region
.. reference::
:Mode: All modes
:Menu: :menuselection:`View --> Navigation --> Zoom Region...`
:Shortcut: :kbd:`Shift-B`
The *Zoom Region* tool allows you to specify a rectangular region
by dragging with :kbd:`LMB`. The view will then zoom in on this region.
You can also drag with :kbd:`MMB` to zoom out instead.
.. _bpy.ops.view3d.dolly:
Dolly View
.. reference::
:Mode: All modes
:Menu: :menuselection:`View --> Navigation --> Dolly View...`
:Shortcut: :kbd:`Shift-Ctrl-MMB`
In most cases it's sufficient to zoom the view to get a closer look at something.
However, zooming only gets you up to the point of interest and no further.
If you hit this point where zooming no longer works, you can instead Dolly
by holding :kbd:`Shift-Ctrl` and dragging up or down with :kbd:`MMB`.
This will move the point of interest (and the view along with it).
:kbd:`RMB` cancels the dolly operation.
.. NOTE(@campbellbarton): "Frame All" & "Frame Selected" could be documented elsewhere,
however there doesn't seem to be an ideal location as only items in the View sub-menus have their own files.
Loosely speaking these are navigation - so keep here.
.. _bpy.ops.view3d.view_all:
Frame All
.. reference::
:Mode: All modes
:Menu: :menuselection:`View --> Frame All`
:Shortcut: :kbd:`Home`
Changes the view so that you can see all objects.
.. _bpy.ops.view3d.view_selected:
Frame Selected
.. reference::
:Mode: All modes
:Menu: :menuselection:`View --> Frame Selected`
:Shortcut: :kbd:`NumpadPeriod`
Changes the view so that you can see the selected object(s).