[Bf-docboard-svn] bf-manual: [9036] branches/blender-3.1-release/blender_docs/manual: VSE: Tranform tools

[Aaron Carlisle]

Revision: 9036
          https://developer.blender.org/rBM9036
Author:   Blendify
Date:     2022-02-26 05:12:49 +0100 (Sat, 26 Feb 2022)
Log Message:
-----------
VSE: Tranform tools

Modified Paths:
--------------
    branches/blender-3.1-release/blender_docs/manual/video_editing/preview/toolbar/index.rst

Added Paths:
-----------
    branches/blender-3.1-release/blender_docs/manual/images/editors_vse_preview_toolbar_transform.png

Added: branches/blender-3.1-release/blender_docs/manual/images/editors_vse_preview_toolbar_transform.png
===================================================================
(Binary files differ)

Index: branches/blender-3.1-release/blender_docs/manual/images/editors_vse_preview_toolbar_transform.png
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/images/editors_vse_preview_toolbar_transform.png	2022-02-25 23:38:33 UTC (rev 9035)
+++ branches/blender-3.1-release/blender_docs/manual/images/editors_vse_preview_toolbar_transform.png	2022-02-26 04:12:49 UTC (rev 9036)

Property changes on: branches/blender-3.1-release/blender_docs/manual/images/editors_vse_preview_toolbar_transform.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Modified: branches/blender-3.1-release/blender_docs/manual/video_editing/preview/toolbar/index.rst
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/video_editing/preview/toolbar/index.rst	2022-02-25 23:38:33 UTC (rev 9035)
+++ branches/blender-3.1-release/blender_docs/manual/video_editing/preview/toolbar/index.rst	2022-02-26 04:12:49 UTC (rev 9036)
@@ -3,6 +3,80 @@
   Toolbar
 ###########
 
+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.