[Bf-docboard-svn] bf-manual: [8374] trunk/blender_docs/manual/editors/3dview/navigate/walk_fly.rst: Walk/Fly: Document hotkeys as a table

Aaron Carlisle noreply at blender.org
Fri Sep 10 21:20:30 CEST 2021


Revision: 8374
          https://developer.blender.org/rBM8374
Author:   Blendify
Date:     2021-09-10 21:20:29 +0200 (Fri, 10 Sep 2021)
Log Message:
-----------
Walk/Fly: Document hotkeys as a table

This makes the documentation more clear.
This table idea should be applied to other modal hotkeys.

Modified Paths:
--------------
    trunk/blender_docs/manual/editors/3dview/navigate/walk_fly.rst

Modified: trunk/blender_docs/manual/editors/3dview/navigate/walk_fly.rst
===================================================================
--- trunk/blender_docs/manual/editors/3dview/navigate/walk_fly.rst	2021-09-10 00:06:08 UTC (rev 8373)
+++ trunk/blender_docs/manual/editors/3dview/navigate/walk_fly.rst	2021-09-10 19:20:29 UTC (rev 8374)
@@ -49,30 +49,47 @@
 It works with a combination of keyboard arrow keys and mouse movement.
 
 
-Shortcuts
----------
+Usage
+-----
 
-- Move the mouse in the direction you want to look.
-- Arrow keys or :kbd:`W`, :kbd:`A`, :kbd:`S`, :kbd:`D` move forwards/backwards and strafe left/right.
-- Teleport :kbd:`Spacebar`.
+Move the mouse in the direction you want to look and use the following hotkeys to walk around the scene.
 
-  This moves you to the location at the cross-hair
-  (offset by the *Camera Height* value set in the :doc:`Preferences </editors/preferences/index>`).
-- Jump :kbd:`V` -- only available if *Gravity* is on.
-- Move up and down :kbd:`Q`, :kbd:`E` -- only available if *Gravity* off.
-- Toggle *Gravity* :kbd:`Tab`.
-- Change the movement speed:
+When you are happy with the new view, press :kbd:`LMB` to confirm.
+In case you want to go back from where you started, press :kbd:`Esc` or :kbd:`RMB`, as usual.
 
-  - :kbd:`WheelUp` or :kbd:`NumpadPlus` to increase the movement speed for this open session.
-  - :kbd:`WheelDown` or :kbd:`NumpadMinus` to decrease the movement speed for this open session.
-  - :kbd:`Shift` (hold) -- to speed up the movement temporarily.
-  - :kbd:`Alt` (hold) -- to slow down the movement temporarily.
+If the defaults values (speed, mouse sensitivity, etc...) need adjustments for your project,
+in the :doc:`Preferences </editors/preferences/index>`.
 
-When you are happy with the new view, click :kbd:`LMB` to confirm.
-In case you want to go back from where you started, press :kbd:`Esc` or :kbd:`RMB`, as usual.
+.. list-table::
+   :widths: 10 90
 
-If the defaults values (speed, mouse sensitivity, ...) need adjustments for your project,
-in the :doc:`Preferences </editors/preferences/index>` you can select a few options for the navigation system:
+   * - :kbd:`W`/:kbd:`Up`
+     - Move forward.
+   * - :kbd:`S`/:kbd:`Down`
+     - Move backward.
+   * - :kbd:`A`/:kbd:`Left`
+     - Strafe left.
+   * - :kbd:`D`/:kbd:`Right`
+     - Strafe right.
+   * - :kbd:`E`
+     - Move up -- only available if *Gravity* off.
+   * - :kbd:`Q`
+     - Move down -- only available if *Gravity* off.
+   * - :kbd:`Spacebar`
+     - Teleport location at the cross-hair
+       (offset by the *Camera Height* value set in the :doc:`Preferences </editors/preferences/index>`).
+   * - :kbd:`WheelUp`/:kbd:`NumpadPlus`
+     - Increase the movement speed for this open session.
+   * - :kbd:`WheelDown`/:kbd:`NumpadMinus`
+     - Decrease the movement speed for this open session.
+   * - :kbd:`Shift`
+     - Speed up the movement temporarily.
+   * - :kbd:`Alt`
+     - Slow down the movement temporarily.
+   * - :kbd:`V`
+     - Jump -- only available if *Gravity* is on.
+   * - :kbd:`Tab`
+     - Toggle *Gravity*.
 
 
 Fly Navigation
@@ -88,29 +105,41 @@
 When the cursor is outside this region the view will rotate/pan.
 
 
-Shortcuts
----------
+Usage
+-----
 
-- Move the mouse outside the safe region in the direction you want to look.
-- Move the view forward/backward:
+Move the mouse outside the safe region in the direction you want to look.
 
-  - :kbd:`WheelUp` or :kbd:`NumpadPlus` to speed up the movement forward.
-  - :kbd:`WheelDown` or :kbd:`NumpadMinus` to speed up the movement backward.
+Click :kbd:`LMB` or press :kbd:`Spacebar` to keep the current view and exit fly navigation.
+In case you want to go back from where you started, press :kbd:`Esc` or :kbd:`RMB`.
 
-    So if the view is already moving forward,
-    :kbd:`WheelDown`, :kbd:`NumpadMinus` will eventually stop it and then move it backward, etc.
+.. list-table::
+   :widths: 10 90
 
-    Arrow keys or :kbd:`W`, :kbd:`A`, :kbd:`S`, :kbd:`D` can also be used to adjust the acceleration
-    and direction of the camera movement.
-- :kbd:`MMB` drag to pan the view.
-
-  In this case the view can move laterally on its local axis at the moment you drag the mouse.
-- :kbd:`Shift` precision (slow the momentum).
-- :kbd:`Ctrl` disable rotation.
-
-  While held, the view rotation doesn't influence the flight direction,
-  this allows you to fly past an object, keeping it centered in the view,
-  even as you fly away from it.
-
-Click :kbd:`LMB` or press :kbd:`Spacebar` to keep the current view and exit fly navigation.
-In case you want to go back from where you started, press :kbd:`Esc` or :kbd:`RMB`.
+   * - :kbd:`W`/:kbd:`Up`
+     - Accelerate forward.
+   * - :kbd:`S`/:kbd:`Down`
+     - Accelerate backwards.
+   * - :kbd:`A`/:kbd:`Left`
+     - Accelerate left.
+   * - :kbd:`D`/:kbd:`Right`
+     - Accelerate right.
+   * - :kbd:`E`
+     - Move up -- only available if *Gravity* off.
+   * - :kbd:`Q`
+     - Move down -- only available if *Gravity* off.
+   * - :kbd:`MMB`
+     - Drag to pan the view.
+       In this case the view can move laterally on its local axis at the moment you drag the mouse.
+   * - :kbd:`WheelUp`/:kbd:`NumpadPlus`
+     - Increase the acceleration in the direction of motion,
+       if there is no motion, start accelerating forward.
+   * - :kbd:`WheelDown`/:kbd:`NumpadMinus`
+     - Decrease the acceleration in the direction of motion,
+       if there is no motion, start accelerating backward.
+   * - :kbd:`Alt`
+     - Precision (slow the momentum).
+   * - :kbd:`Ctrl`
+     - Disable rotation -- while held, the view rotation doesn't influence the flight direction,
+       this allows you to fly past an object, keeping it centered in the view,
+       even as you fly away from it.



More information about the Bf-docboard-svn mailing list