[Bf-docboard-svn] bf-manual: [9081] trunk/blender_docs/manual: Video Editing: Move preview toolbar to editor documentation

Aaron Carlisle noreply at blender.org
Thu Mar 3 21:26:44 CET 2022 

Revision: 9081
          https://developer.blender.org/rBM9081
Author:   Blendify
Date:     2022-03-03 21:26:44 +0100 (Thu, 03 Mar 2022)
Log Message:
-----------
Video Editing: Move preview toolbar to editor documentation

Modified Paths:
--------------
    trunk/blender_docs/manual/editors/video_sequencer/preview/index.rst
    trunk/blender_docs/manual/video_editing/preview/index.rst

Added Paths:
-----------
    trunk/blender_docs/manual/editors/video_sequencer/preview/toolbar.rst

Removed Paths:
-------------
    trunk/blender_docs/manual/video_editing/preview/toolbar/

Modified: trunk/blender_docs/manual/editors/video_sequencer/preview/index.rst
===================================================================
--- trunk/blender_docs/manual/editors/video_sequencer/preview/index.rst	2022-03-03 20:21:00 UTC (rev 9080)
+++ trunk/blender_docs/manual/editors/video_sequencer/preview/index.rst	2022-03-03 20:26:44 UTC (rev 9081)
@@ -9,4 +9,5 @@
    introduction.rst
    controls/index.rst
    display/index.rst
+   toolbar.rst
    sidebar.rst

Copied: trunk/blender_docs/manual/editors/video_sequencer/preview/toolbar.rst (from rev 9080, trunk/blender_docs/manual/video_editing/preview/toolbar/index.rst)
===================================================================
--- trunk/blender_docs/manual/editors/video_sequencer/preview/toolbar.rst	                        (rev 0)
+++ trunk/blender_docs/manual/editors/video_sequencer/preview/toolbar.rst	2022-03-03 20:26:44 UTC (rev 9081)
@@ -0,0 +1,133 @@
+
+###########
+  Toolbar
+###########
+
+Tweak :kbd:`W`
+   Perform a multiple actions; first of it can be select images and by consequence their associated strip.
+   Second it can move strips using the same principles as the :ref:`Move tool <tool-vse-preview-move>`.
+   Using the shortcut :kbd:`W`, will cycle between this tool and other sub-tools described below.
+
+   :ref:`Select Box <tool-select-box>` :kbd:`B`
+      Selects images within a rectangular box drawn in the Preview area.
+
+      To use the tool, :kbd:`LMB` and drag within the preview area to draw a rectangle,
+      releasing the mouse confirms the selection.
+
+      You can also just :kbd:`LMB` to preform a normal single item selection.
+
+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.
+
+.. _tool-vse-preview-move:
+
+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.
+
+   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.
+
+   To use the Sample tool, :kbd:`LMB` anywhere in the preview.
+   Information about the pixel under the mouse cursor is shown in an overlay at the bottom of the editor.
+
+   In the order of appearance, the following information is shown:
+
+   - The X and Y coordinates of the clicked pixel. Remember that the left bottom corner is location (0, 0).
+   - The values for the red, green, and blue component as from the color picker.
+   - The alpha value of the pixel.
+   - The color-managed values of the red, green, and blue component (the color as you see in the preview).
+   - The hue, saturation, value, and luminance equivalent values of the color-managed values.
+
+   .. figure:: /images/editors_vse_preview_sample-tool.png
+
+      Sample tool example.
+
+:ref:`Annotate <tool-annotate-freehand>`
+   Draw free-hand annotation.
+
+   :ref:`Annotate Line <tool-annotate-line>`
+      Draw straight line annotation.
+   :ref:`Annotate Polygon <tool-annotate-polygon>`
+      Draw a polygon annotation.
+   :ref:`Annotate Eraser <tool-annotate-eraser>`
+      Erase previous drawn annotations.

Modified: trunk/blender_docs/manual/video_editing/preview/index.rst
===================================================================
--- trunk/blender_docs/manual/video_editing/preview/index.rst	2022-03-03 20:21:00 UTC (rev 9080)
+++ trunk/blender_docs/manual/video_editing/preview/index.rst	2022-03-03 20:26:44 UTC (rev 9081)
@@ -7,4 +7,3 @@
    :maxdepth: 2
 
    introduction.rst
-   toolbar/index.rst

More information about the Bf-docboard-svn mailing list