[Bf-docboard-svn] bf-manual: [9429] trunk/blender_docs/manual/editors: Improve "3D Viewport" section (Part 1 - root pages)

Aaron Carlisle noreply at blender.org
Sun Jul 24 21:15:37 CEST 2022 

Revision: 9429
          https://developer.blender.org/rBM9429
Author:   Blendify
Date:     2022-07-24 21:15:37 +0200 (Sun, 24 Jul 2022)
Log Message:
-----------
Improve "3D Viewport" section (Part 1 - root pages)

Extended/updated a bunch of text for conciseness and clarity - as well as completeness, because it surprisingly seems that some basic shortcuts like Ctrl-Tab, Tab and Shift-RMB are not mentioned in (this part of?) the documentation.

Author: @arc_

Differential Revision: https://developer.blender.org/D15448

Modified Paths:
--------------
    trunk/blender_docs/manual/editors/3dview/3d_cursor.rst
    trunk/blender_docs/manual/editors/3dview/introduction.rst
    trunk/blender_docs/manual/editors/3dview/modes.rst
    trunk/blender_docs/manual/editors/3dview/selecting.rst
    trunk/blender_docs/manual/editors/3dview/sidebar.rst
    trunk/blender_docs/manual/editors/3dview/startup_scene.rst
    trunk/blender_docs/manual/editors/3dview/viewport_render.rst
    trunk/blender_docs/manual/editors/index.rst
    trunk/blender_docs/manual/editors/preferences/navigation.rst

Modified: trunk/blender_docs/manual/editors/3dview/3d_cursor.rst
===================================================================
--- trunk/blender_docs/manual/editors/3dview/3d_cursor.rst	2022-07-24 19:13:20 UTC (rev 9428)
+++ trunk/blender_docs/manual/editors/3dview/3d_cursor.rst	2022-07-24 19:15:37 UTC (rev 9429)
@@ -5,46 +5,58 @@
 3D Cursor
 *********
 
-The 3D Cursor is a point in 3D space which can be used for a number of purposes.
+The 3D Cursor is a point in space that has both a location and a rotation.
+It's used for a number of purposes. For example, it defines where newly
+added objects are placed, and can also be used to manually position and orient
+the transform gizmo (see :doc:`Pivot Point </editors/3dview/controls/pivot_point/index>`
+and :doc:`Transform Orientation </editors/3dview/controls/orientation>`).
+Some tools, such as :doc:`Bend </modeling/meshes/editing/mesh/transform/bend>`,
+also use the Cursor.
 
 
 Placement
 =========
 
-There are a few methods to position the 3D cursor.
+There are a few methods to position the 3D Cursor.
 
 
 Direct Placement with the Mouse
 -------------------------------
 
+.. reference::
+
+   :Mode:      Object, Edit, and Pose Mode
+   :Tool:      Cursor
+   :Shortcut:  :kbd:`Shift-RMB`
+
 .. figure:: /images/editors_3dview_3d-cursor_two-view-positioning.png
    :align: center
 
-   Positioning the 3D cursor with two orthogonal views.
+   Positioning the 3D Cursor with two orthogonal views.
 
-With the cursor tool enabled, using :kbd:`LMB` in the 3D Viewport will place the 3D cursor
-directly under your mouse pointer.
+The Cursor tool offers the most flexibility. Simply select it in the Toolbar
+and click a point in the scene with :kbd:`LMB` to place the 3D Cursor there.
+In the tool settings, you can choose how it should be oriented:
+by default, it matches the view orientation, but you can also make it
+match the surface normal of a piece of geometry,
+or the :doc:`transform orientation </editors/3dview/controls/orientation>`.
 
-The view space is used to control the rotation of the 3D Cursor.
+Alternatively, you can press :kbd:`Shift-RMB` with any tool selected.
+In this case, the 3D Cursor will always be aligned to the view orientation.
 
 For accuracy you should use two perpendicular orthogonal 3D Viewports,
 i.e. any combination of top :kbd:`Numpad7`, front :kbd:`Numpad1` and side :kbd:`Numpad3`.
 That way you can control the positioning along two axes in one view and
-determine depth in the second view.
+determine the depth in the other.
 
-By default the depth of the geometry under the cursor is used,
-this can be disabled using the *Cursor Surface Project* toggle
+By default, the depth of the geometry under the cursor is used.
+This can be disabled using the *Cursor Surface Project* toggle
 in the :doc:`Preferences </editors/preferences/editing>`.
 
-.. seealso::
 
-   The :doc:`Snap Menu </editors/3dview/controls/snapping>`
-   which allows the cursor placement relative to scene objects.
+Sidebar
+-------
 
-
-3D Cursor Panel
----------------
-
 .. reference::
 
    :Mode:      All Modes
@@ -54,21 +66,19 @@
 
    The 3D Cursor panel of the Sidebar region.
 
-The 3D cursor can also be positioned and oriented by editing these values:
+The 3D Cursor can also be positioned and oriented by editing the
+respective values in the Sidebar.
 
-Location
-   The location of the 3D Cursor.
 
-Rotation
-   The rotation of the 3D Cursor.
+Snapping
+--------
 
-Rotation Mode
-   The Rotation mode of the 3D Cursor.
+.. reference::
 
+   :Mode:      Object, Edit, and Pose Mode
+   :Menu:      :menuselection:`Object/Mesh/... --> Snap --> Cursor to ...`
+   :Shortcut:  :kbd:`Shift-S`
 
-Usage
-=====
-
-The 3D Cursor is used as the origin for any added object, can be used and moved with
-the :doc:`snap tool </editors/3dview/controls/snapping>`, and is an option for
-the :doc:`pivot point </editors/3dview/controls/pivot_point/index>`.
+One more way of positioning the 3D Cursor is through the Snap menu,
+which allows you to move the Cursor to the origin of the selected object
+for example.

Modified: trunk/blender_docs/manual/editors/3dview/introduction.rst
===================================================================
--- trunk/blender_docs/manual/editors/3dview/introduction.rst	2022-07-24 19:13:20 UTC (rev 9428)
+++ trunk/blender_docs/manual/editors/3dview/introduction.rst	2022-07-24 19:15:37 UTC (rev 9429)
@@ -16,63 +16,79 @@
 
 The header contains various menus and controls based on
 the current :doc:`mode </editors/3dview/modes>`.
+Its items are split into three groups:
 
-Tools and modes in the 3D Viewport header are split in three groups of buttons:
 
-
 Mode & Menus
 ------------
 
-Mode
-   The 3D Viewport has :doc:`several modes </editors/3dview/modes>`
-   used for editing different kinds of data.
+Mode :kbd:`Ctrl-Tab`
+   The 3D Viewport has several :doc:`modes </editors/3dview/modes>`
+   used for editing different kinds of data. For example, the default Object Mode
+   would let you place a character in the scene, while Pose Mode would allow
+   you to pose it.
+   
+   The shortcut :kbd:`Ctrl-Tab` brings up a pie menu for quick mode switching.
+   If you have an :doc:`Armature </animation/armatures/introduction>` selected,
+   it'll instead switch between Object Mode and Pose Mode.
+   
+   Pressing :kbd:`Tab` will switch between Object Mode and Edit Mode for objects
+   that support it.
 
 View
-   This menu offers tools to :doc:`navigate </editors/3dview/navigate/index>` in 3D space.
+   This menu offers tools for :doc:`navigating </editors/3dview/navigate/introduction>` in 3D space.
 
-Other menus depend on the current mode, Object Mode menus listed below:
+The other menus depend on the current mode, Object Mode menus listed below:
 
 Select
    Contains tools for :ref:`selecting <object-select-menu>` objects.
-Add
-   Gives a list of different :ref:`objects types <objects-types>` that can be added to a scene.
+Add :kbd:`Shift-A`
+   Contains a list of different :ref:`objects types <objects-types>` that can be added to the scene.
 Object
-   This menu appears when in Object Mode.
-   it contains tools to edit :doc:`objects </scene_layout/object/editing/transform/introduction>`.
-   In Edit Mode, it will change to the appropriate menu with :doc:`editing tools </modeling/index>`.
+   Contains tools for operating on :doc:`objects </scene_layout/object/editing/transform/introduction>`,
+   such as duplicating them. A subset of these tools can also be accessed by rightclicking
+   in the 3D Viewport.
 
 
 Transform Controls
 ------------------
 
-Transform Orientations
-   Use to select and modify the active :doc:`Transform Orientations </editors/3dview/controls/orientation>`.
-Pivot Point
-   Used to change the reference point (or :term:`Pivot Point`) used by many mesh manipulation tools.
+Transform Orientation :kbd:`Comma`
+   Used to change the :doc:`Transform Orientation </editors/3dview/controls/orientation>`,
+   which affects the rotation of the transform gizmo.
+Pivot Point :kbd:`Period`
+   Used to change the :doc:`Pivot Point </editors/3dview/controls/pivot_point/index>`,
+   which affects the location of the transform gizmo.
+Snapping :kbd:`Shift-Tab`
+   Offers options for :doc:`snapping </editors/3dview/controls/snapping>` items
+   to others that are nearby. You can hold :kbd:`Ctrl` to toggle snapping on/off temporarily
+   (as long as the key is held).
+Proportional Editing :kbd:`O`
+   Used to smoothly transform unselected items that are near the selected ones.
+   See :doc:`/editors/3dview/controls/proportional_editing`.
 
-   Read more about :doc:`Pivot Points </editors/3dview/controls/pivot_point/index>`.
-Snapping
-   Controls the :doc:`snapping tools </editors/3dview/controls/snapping>`
-   that help with transforming and modeling objects.
-Proportional Edit
-   :doc:`Proportional Edit </editors/3dview/controls/proportional_editing>`.
 
-
 Display & Shading
 -----------------
 
 Object Type Visibility
-   Change the :doc:`Object Type Visibility </editors/3dview/display/visibility>`
-   and selectability of objects in the 3D Viewport.
+   Change which types of objects are visible/selectable in the 3D Viewport.
+   See :doc:`Object Type Visibility </editors/3dview/display/visibility>`.
 Viewport Gizmos
-   Change the way how :doc:`gizmos </editors/3dview/display/gizmo>` are
+   Change how :doc:`gizmos </editors/3dview/display/gizmo>` are
    displayed in the 3D Viewport.
 Viewport Overlays
-   Change the way how :doc:`overlays </editors/3dview/display/overlays>` are
+   Change how :doc:`overlays </editors/3dview/display/overlays>` are
    displayed in the 3D Viewport.
-X-Ray
-   Show the whole scene transparent. This is a shortcut to
-   the :ref:`X-ray <3dview-shading-xray>` option inside the shading control.
+X-Ray :kbd:`Alt-Z`
+   Make the whole scene transparent, allowing you to see and select items that
+   would otherwise be occluded.
+   This is a shortcut to the X-Ray option inside the
+   :ref:`Viewport Shading  <3dview-shading-xray>` popover.
+   
+   In Pose Mode, this same button controls a different setting with its own separate on/off state.
+   Rather than making the scene transparent, it shows the armature in front of any geometry.
+   
 Viewport Shading
    Change the :doc:`shading </editors/3dview/display/shading>` of the 3D Viewport.
 
@@ -80,7 +96,7 @@
 Toolbar Region
 ==============
 
-The Toolbar is a context-sensitive region containing tools depending on the current mode
+The Toolbar contains tools depending on the current mode
 (for example, modeling tools in *Edit Mode*, brush tools in *Sculpt Mode*...).
 
 See :doc:`Tools </editors/3dview/toolbar/index>` for more information.
@@ -89,7 +105,7 @@
 Sidebar Region
 ==============
 
-The Sidebar region contains properties of the active object and selected objects (such as their locations),
-as well as properties of the editor itself.
+The Sidebar region contains properties of the active object and tool,
+as well as of the viewport itself.
 
-See :doc:`Sidebar Panels </editors/3dview/sidebar>` for more information.
+See :doc:`Sidebar </editors/3dview/sidebar>` for more information.

Modified: trunk/blender_docs/manual/editors/3dview/modes.rst
===================================================================
--- trunk/blender_docs/manual/editors/3dview/modes.rst	2022-07-24 19:13:20 UTC (rev 9428)

@@ Diff output truncated at 10240 characters. @@

More information about the Bf-docboard-svn mailing list