[Bf-docboard-svn] bf-manual: [9038] trunk/blender_docs/manual: Merge branch 'blender-3.1-release'

[Aaron Carlisle]

Revision: 9038
          https://developer.blender.org/rBM9038
Author:   Blendify
Date:     2022-02-26 05:50:41 +0100 (Sat, 26 Feb 2022)
Log Message:
-----------
Merge branch 'blender-3.1-release'

Modified Paths:
--------------
    trunk/blender_docs/manual/editors/3dview/navigate/walk_fly.rst
    trunk/blender_docs/manual/video_editing/preview/toolbar/index.rst

Added Paths:
-----------
    trunk/blender_docs/manual/images/editors_vse_preview_toolbar_transform.png

Property Changed:
----------------
    trunk/blender_docs/

Index: trunk/blender_docs
===================================================================
--- trunk/blender_docs	2022-02-26 04:42:09 UTC (rev 9037)
+++ trunk/blender_docs	2022-02-26 04:50:41 UTC (rev 9038)

Property changes on: trunk/blender_docs
___________________________________________________________________
Modified: svn:mergeinfo
## -1,4 +1,4 ##
 /branches/blender-2.92-release/blender_docs:7610-7921
 /branches/blender-2.93-release/blender_docs:7959-8113
-/branches/blender-3.0-release/blender_docs:8543-9029
-/branches/blender-3.1-release/blender_docs:8904-9032
\ No newline at end of property
+/branches/blender-3.0-release/blender_docs:8543-9034
+/branches/blender-3.1-release/blender_docs:8904-9037
\ No newline at end of property
Modified: trunk/blender_docs/manual/editors/3dview/navigate/walk_fly.rst
===================================================================
--- trunk/blender_docs/manual/editors/3dview/navigate/walk_fly.rst	2022-02-26 04:42:09 UTC (rev 9037)
+++ trunk/blender_docs/manual/editors/3dview/navigate/walk_fly.rst	2022-02-26 04:50:41 UTC (rev 9038)
@@ -90,6 +90,8 @@
      - Jump -- only available if *Gravity* is on.
    * - :kbd:`Tab`
      - Toggle *Gravity*.
+   * - :kbd:`Z`
+     - Enable Z axis correction by disabling momentum along the Z axis.
 
 
 Fly Navigation

Copied: trunk/blender_docs/manual/images/editors_vse_preview_toolbar_transform.png (from rev 9037, branches/blender-3.1-release/blender_docs/manual/images/editors_vse_preview_toolbar_transform.png)
===================================================================
(Binary files differ)

Modified: trunk/blender_docs/manual/video_editing/preview/toolbar/index.rst
===================================================================
--- trunk/blender_docs/manual/video_editing/preview/toolbar/index.rst	2022-02-26 04:42:09 UTC (rev 9037)
+++ trunk/blender_docs/manual/video_editing/preview/toolbar/index.rst	2022-02-26 04:50:41 UTC (rev 9038)
@@ -3,6 +3,96 @@
   Toolbar
 ###########
 
+Cursor
+   Changes the location of the :ref:`editors_sequencer_preview_2d-cursor`.
+
+   To use the tool, :kbd:`LMB` within the preview area to move the cursor to that position.
+   You can also click and drag to interactively position the cursor.
+
+   The movement of the cursor can be constrained along the global/local X or Y axis by pressing :kbd:`X` or :kbd:`Y`,
+   pressing the hotkeys will cycle between global/local orientations and disabling constraints.
+
+   Holding :kbd:`Shift` will move the cursor in smaller increments for more precision.
+   You may also type in an exact amount to move for absolute precision.
+
+   While the operation is running a message will display in the header indicating
+   the distance in pixels the cursor has moved in each of the cardinal directions.
+   The third number, between parenthesis, is the Euclidean distance the cursor has moved.
+
+Move :kbd:`G`
+   Changes the location of the selected image by adjusting the strip's
+   :ref:`Position <bpy.types.SequenceTransform.offset>` properties.
+
+   To use the tool, :kbd:`LMB` on the image and drag it to the desired position.
+   If :ref:`Active Tools <bpy.types.SpaceSequenceEditor.show_gizmo_tool>`
+   is enabled, you can also move the image by dragging the gizmo.
+
+   The movement of the image can be constrained along the global/local X or Y axis by pressing :kbd:`X` or :kbd:`Y`,
+   pressing the hotkeys will cycle between global/local orientations and disabling constraints.
+
+   Holding :kbd:`Shift` will move the image in smaller increments for more precision.
+   You may also type in an exact amount to move for absolute precision.
+
+   While the operation is running a message will display in the header indicating
+   the distance in pixels the image has moved in each of the cardinal directions.
+   The third number, between parenthesis, is the Euclidean distance the image has moved.
+
+Rotate :kbd:`R`
+   Moves the selected image's in a circle about the :ref:`Pivot Point <bpy.types.SequencerToolSettings.pivot_point>`
+   by adjusting the strip's :ref:`Rotation <bpy.types.SequenceTransform.rotation>` property.
+   By default, the image will rotate around its median but this can be changed by changing the Pivot Point.
+
+   To use the tool, :kbd:`LMB` on the image and drag it (in a circle) to the desired position.
+   The further away the mouse cursor is from the Pivot point, the slower the rotation movement is.
+   You can also use the Arrow-keys to move the handle very precisely.
+   If :ref:`Active Tools <bpy.types.SpaceSequenceEditor.show_gizmo_tool>`
+   is enabled, you can also rotate the image by dragging the gizmo.
+
+   Holding :kbd:`Shift` will rotate the image in smaller increments for more precision.
+   You may also type in an exact amount to move for absolute precision.
+
+   While the operation is running a message will display in the header indicating
+   the amount of rotation in the scene's rotation unit.
+
+Scale :kbd:`S`
+   Changes the size of the image by adjusting the strip's
+   :ref:`Scale <bpy.types.SequenceTransform.scale>` properties.
+   The scaling used the :ref:`Pivot Point <bpy.types.SequencerToolSettings.pivot_point>` as reference.
+   So, for example, if the Pivot Point is set to *2D Cursor*,
+   scaling down a strip will also move the strip in the direction of the 2D cursor.
+
+   To use the tool, :kbd:`LMB` on the image and drag it to the desired size.
+   The further away the mouse cursor is initially from the Pivot point, the more precise the scaling is.
+   You can also use the Arrow-keys to adjust the scale very precisely.
+   If :ref:`Active Tools <bpy.types.SpaceSequenceEditor.show_gizmo_tool>`
+   is enabled, you can also scale the image by dragging the gizmo.
+
+   The scale of the image can be constrained along the global/local X or Y axis by pressing :kbd:`X` or :kbd:`Y`,
+   pressing the hotkeys will cycle between global/local orientations and disabling constraints.
+
+   Holding :kbd:`Shift` will scale the image in smaller increments for more precision.
+   You may also type in an exact amount to scale for absolute precision.
+
+   The amount of scaling is relative meaning a scale value of 0.4 will scale the image to 40% of its size.
+
+   message will display in the header indicating
+   the distance in pixels the image has moved in each of the cardinal directions.
+   The third number, between parenthesis, is the Euclidean distance the image has moved.
+
+   While the operation is running a message will display in the header indicating
+   the amount the image has been scaled in each of the cardinal directions.
+
+Transform
+   Supports any combination of the moving, rotating, scaling at the same time.
+   In the figure below, the Transform tool is enabled and strip 3 selected.
+
+   .. figure:: /images/editors_vse_preview_toolbar_transform.png
+
+      The Transform tool
+
+   With the four squares at the corners of the strip, you can scale the strip.
+   The circle on top is for rotating and the crosshair in the middle is for moving the strip.
+
 Sample
    Used to sample a pixel's color from the preview.