[Bf-docboard-svn] bf-manual: [9114] trunk/blender_docs/manual: Various Improvements to 3D View Docs

Campbell Barton noreply at blender.org
Tue Mar 15 02:09:37 CET 2022 

Revision: 9114
          https://developer.blender.org/rBM9114
Author:   campbellbarton
Date:     2022-03-15 02:09:37 +0100 (Tue, 15 Mar 2022)
Log Message:
-----------
Various Improvements to 3D View Docs

- Remove unnecessary note about square image for the UV layout export add-on.
- Remove unnecessarily specific comment about middle-mouse emulation
  and area focus in the 3D viewports "Orbit" docs.
- Note that Alt locks to axes when orbiting.
- Link to rotate angle preference from "Roll" docs.
- Link to "Auto Perspective" from projection docs.

Modified Paths:
--------------
    trunk/blender_docs/manual/addons/import_export/mesh_uv_layout.rst
    trunk/blender_docs/manual/editors/3dview/navigate/navigation.rst
    trunk/blender_docs/manual/editors/3dview/navigate/projections.rst
    trunk/blender_docs/manual/editors/preferences/navigation.rst
    trunk/blender_docs/manual/sculpt_paint/navigation.rst
    trunk/blender_docs/manual/troubleshooting/3d_view.rst

Modified: trunk/blender_docs/manual/addons/import_export/mesh_uv_layout.rst
===================================================================
--- trunk/blender_docs/manual/addons/import_export/mesh_uv_layout.rst	2022-03-15 00:36:05 UTC (rev 9113)
+++ trunk/blender_docs/manual/addons/import_export/mesh_uv_layout.rst	2022-03-15 01:09:37 UTC (rev 9114)
@@ -55,6 +55,6 @@
 Format
    Select the type of image file to save (``.png``, ``.eps``, ``.svg``).
 Size
-   select the size of the image in pixels. The image be square.
+   Select the size of the image in pixels.
 Fill Opacity
    Set the opacity of the fill.

Modified: trunk/blender_docs/manual/editors/3dview/navigate/navigation.rst
===================================================================
--- trunk/blender_docs/manual/editors/3dview/navigate/navigation.rst	2022-03-15 00:36:05 UTC (rev 9113)
+++ trunk/blender_docs/manual/editors/3dview/navigate/navigation.rst	2022-03-15 01:09:37 UTC (rev 9114)
@@ -3,6 +3,7 @@
 Navigation
 **********
 
+
 .. _bpy.ops.view3d.view_orbit:
 
 Orbit
@@ -20,24 +21,17 @@
 If you start in the middle of the area and move up and down or left and right,
 the view is rotated around the middle of the area.
 
+Holding :kbd:`Alt` while dragging locks to axes.
+
 To change the viewing angle in discrete steps, use :kbd:`Numpad8` and :kbd:`Numpad2`
 or use :kbd:`Numpad4` and :kbd:`Numpad6`
 to rotate the scene around the global Z axis from your current point of view.
 Finally :kbd:`Numpad9` switches to the opposite side of the view.
 
-Or if the :ref:`Emulate 3 Button Mouse <preferences-input-emulate-mouse>`
-option is select in the Preferences you can press and hold :kbd:`Alt`
-while dragging :kbd:`LMB` in the viewport's area.
-
-.. note:: Hotkeys
-
-   Remember that most hotkeys affect the **active** area (the one that has focus),
-   so check that the mouse cursor is in the area you want to work in before you use the hotkeys.
-
 .. seealso::
 
    - :ref:`Orbit Style Preference <prefs-input-orbit-style>`
-   - :ref:`Auto-Perspective Preference <prefs-interface-auto-perspective>`
+   - :ref:`Auto-Perspective Preference <prefs-navigation-auto_perspective>`
 
 
 Roll
@@ -49,7 +43,8 @@
    :Menu:      :menuselection:`View --> Navigation --> Roll`
    :Shortcut:  :kbd:`Shift-Numpad4`, :kbd:`Shift-Numpad6`
 
-Rotate the viewport camera around its local Z axis in 15° discrete steps.
+Rotate the viewport camera around its local Z axis in 15° discrete steps by default,
+see :ref:`rotation angle <prefs-navigation-rotation_angle>` preference to configure.
 
 
 .. _bpy.ops.view3d.view_pan:

Modified: trunk/blender_docs/manual/editors/3dview/navigate/projections.rst
===================================================================
--- trunk/blender_docs/manual/editors/3dview/navigate/projections.rst	2022-03-15 00:36:05 UTC (rev 9113)
+++ trunk/blender_docs/manual/editors/3dview/navigate/projections.rst	2022-03-15 01:09:37 UTC (rev 9114)
@@ -46,5 +46,6 @@
 
 .. seealso::
 
+   - :ref:`Auto-Perspective Preference <prefs-navigation-auto_perspective>`
    - :ref:`Render perspective <camera-lens-type>`
    - :term:`Camera Projections <Projection>`

Modified: trunk/blender_docs/manual/editors/preferences/navigation.rst
===================================================================
--- trunk/blender_docs/manual/editors/preferences/navigation.rst	2022-03-15 00:36:05 UTC (rev 9113)
+++ trunk/blender_docs/manual/editors/preferences/navigation.rst	2022-03-15 01:09:37 UTC (rev 9114)
@@ -35,7 +35,7 @@
      of rotation per-pixel to control how fast the 3D Viewport rotates.
    - Trackball: *Orbit Sensitivity* as a simple factor for how fast the 3D Viewport rotates.
 
-.. _prefs-orbit-around-selection:
+.. _prefs-navigation-orbit_around_selection:
 
 Orbit Around Selection
    The selection center becomes the rotation center of the viewport.
@@ -50,15 +50,18 @@
       it can be inconvenient for larger objects such as a terrain mesh,
       where the center is not necessarily a point of interest.
 
-.. _prefs-interface-auto-perspective:
-.. _prefs-auto-depth:
 
 Auto
+   .. _prefs-navigation-auto_depth:
+
    Perspective
       When enabled, the view switches to perspective when orbiting the view,
       setting axis views (Top, Side, Front, Back, etc.), sets the view to orthographic.
 
       When disabled, orthographic/perspective mode needs to be changed manually.
+
+   .. _prefs-navigation-auto_perspective:
+
    Auto Depth
       Use the depth under the mouse to improve view pan, rotate, zoom functionality.
       Useful in combination with *Zoom To Mouse Position*.
@@ -67,6 +70,8 @@
    Time (in milliseconds) the animation takes when changing views
    (Top/Side/Front/Camera...). Reduce to zero to remove the animation.
 
+.. _prefs-navigation-rotation_angle:
+
 Rotation Angle
    Rotation step size in degrees, when :kbd:`Numpad4`, :kbd:`Numpad6`, :kbd:`Numpad8`,
    or :kbd:`Numpad2` are used to rotate the 3D Viewport.
@@ -111,7 +116,7 @@
 
    .. tip::
 
-      This is useful in combination with :ref:`Auto Depth <prefs-auto-depth>`
+      This is useful in combination with :ref:`Auto Depth <prefs-navigation-auto_depth>`
       to quickly zoom into the point under the cursor.
 
 Invert Zoom Direction

Modified: trunk/blender_docs/manual/sculpt_paint/navigation.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/navigation.rst	2022-03-15 00:36:05 UTC (rev 9113)
+++ trunk/blender_docs/manual/sculpt_paint/navigation.rst	2022-03-15 01:09:37 UTC (rev 9114)
@@ -7,4 +7,4 @@
    Center the View on the average position of the last stroke.
 Orbit Around the Last Stroke
    You can orbit the view around the average position of the last stroke,
-   if you enable :ref:`Orbit Around Selection <prefs-orbit-around-selection>`.
+   if you enable :ref:`Orbit Around Selection <prefs-navigation-orbit_around_selection>`.

Modified: trunk/blender_docs/manual/troubleshooting/3d_view.rst
===================================================================
--- trunk/blender_docs/manual/troubleshooting/3d_view.rst	2022-03-15 00:36:05 UTC (rev 9113)
+++ trunk/blender_docs/manual/troubleshooting/3d_view.rst	2022-03-15 01:09:37 UTC (rev 9114)
@@ -126,7 +126,7 @@
 
 - Use :ref:`View Dolly <3dview-nav-zoom-dolly>`.
 - Use :ref:`Walk/Fly Navigation <3dview-fly-walk>`.
-- Use :ref:`Auto Depth <prefs-auto-depth>` and :ref:`Zoom to Mouse Position <prefs-zoom-mouse-pos>`.
+- Use :ref:`Auto Depth <prefs-navigation-auto_depth>` and :ref:`Zoom to Mouse Position <prefs-zoom-mouse-pos>`.
   These tools will make sure the distance is always the value under the mouse cursor,
 - Use :ref:`3dview-nav-zoom-region` as it also resets the center point when zooming.
 - Center the view around the mouse cursor :kbd:`Alt-MMB`.

More information about the Bf-docboard-svn mailing list