[Bf-docboard-svn] bf-manual: [9141] trunk/blender_docs/manual: VSE Documentation: move sequencer text into Edit/Montage

Aaron Carlisle noreply at blender.org
Tue Mar 22 19:10:18 CET 2022 

Revision: 9141
          https://developer.blender.org/rBM9141
Author:   Blendify
Date:     2022-03-22 19:10:17 +0100 (Tue, 22 Mar 2022)
Log Message:
-----------
VSE Documentation: move sequencer text into Edit/Montage

Seperates between editor UI documentation and workflow documentation.

Part of T87729

Modified Paths:
--------------
    trunk/blender_docs/manual/addons/import_export/images_as_planes.rst
    trunk/blender_docs/manual/editors/video_sequencer/preview/header.rst
    trunk/blender_docs/manual/editors/video_sequencer/preview/sidebar.rst
    trunk/blender_docs/manual/files/blend/rename.rst
    trunk/blender_docs/manual/render/output/properties/output.rst
    trunk/blender_docs/manual/video_editing/edit/montage/index.rst
    trunk/blender_docs/manual/video_editing/edit/montage/strips/effects/multicam.rst
    trunk/blender_docs/manual/video_editing/edit/montage/strips/introduction.rst
    trunk/blender_docs/manual/video_editing/edit/montage/strips/movie.rst
    trunk/blender_docs/manual/video_editing/edit/montage/strips/scene.rst
    trunk/blender_docs/manual/video_editing/edit/montage/strips/transitions/gamma_cross.rst
    trunk/blender_docs/manual/video_editing/sequencer/index.rst
    trunk/blender_docs/manual/video_editing/sequencer/introduction.rst
    trunk/blender_docs/manual/video_editing/sequencer/navigating.rst

Added Paths:
-----------
    trunk/blender_docs/manual/video_editing/edit/montage/editing.rst
    trunk/blender_docs/manual/video_editing/edit/montage/meta.rst
    trunk/blender_docs/manual/video_editing/edit/montage/selecting.rst
    trunk/blender_docs/manual/video_editing/edit/montage/strips/

Removed Paths:
-------------
    trunk/blender_docs/manual/video_editing/sequencer/editing.rst
    trunk/blender_docs/manual/video_editing/sequencer/meta.rst
    trunk/blender_docs/manual/video_editing/sequencer/selecting.rst
    trunk/blender_docs/manual/video_editing/sequencer/strips/

Modified: trunk/blender_docs/manual/addons/import_export/images_as_planes.rst
===================================================================
--- trunk/blender_docs/manual/addons/import_export/images_as_planes.rst	2022-03-22 17:13:01 UTC (rev 9140)
+++ trunk/blender_docs/manual/addons/import_export/images_as_planes.rst	2022-03-22 18:10:17 UTC (rev 9141)
@@ -43,7 +43,7 @@
 
 Animate Image Sequences
    Import sequentially numbers images as
-   an animated :doc:`image sequence </video_editing/sequencer/strips/image>` instead of separate planes.
+   an animated :doc:`image sequence </video_editing/edit/montage/strips/image>` instead of separate planes.
    They will be imported as a *Clip* texture on a single plane.
    The frame range will automatically be set but can be changed later.
 

Modified: trunk/blender_docs/manual/editors/video_sequencer/preview/header.rst
===================================================================
--- trunk/blender_docs/manual/editors/video_sequencer/preview/header.rst	2022-03-22 17:13:01 UTC (rev 9140)
+++ trunk/blender_docs/manual/editors/video_sequencer/preview/header.rst	2022-03-22 18:10:17 UTC (rev 9141)
@@ -46,7 +46,7 @@
 .. _bpy.ops.sequencer.export_subtitles:
 
 Export Subtitles
-   Exports :doc:`Text strips </video_editing/sequencer/strips/text>`,
+   Exports :doc:`Text strips </video_editing/edit/montage/strips/text>`,
    which can act as subtitles, to a `SubRip <https://en.wikipedia.org/wiki/SubRip>`__ file (``.srt``).
    The exported file contains all Text strips in the video sequence.
 

Modified: trunk/blender_docs/manual/editors/video_sequencer/preview/sidebar.rst
===================================================================
--- trunk/blender_docs/manual/editors/video_sequencer/preview/sidebar.rst	2022-03-22 17:13:01 UTC (rev 9140)
+++ trunk/blender_docs/manual/editors/video_sequencer/preview/sidebar.rst	2022-03-22 18:10:17 UTC (rev 9141)
@@ -181,7 +181,7 @@
    :View Type: Preview
    :Panel:     :menuselection:`Sidebar --> View tab --> Scene Strip Display`
 
-It allows you to control how the images of :doc:`Scene Strips </video_editing/sequencer/strips/scene>`
+It allows you to control how the images of :doc:`Scene Strips </video_editing/edit/montage/strips/scene>`
 are displayed in the preview.
 
 .. _bpy.types.RenderSettings.sequencer_gl_preview:

Modified: trunk/blender_docs/manual/files/blend/rename.rst
===================================================================
--- trunk/blender_docs/manual/files/blend/rename.rst	2022-03-22 17:13:01 UTC (rev 9140)
+++ trunk/blender_docs/manual/files/blend/rename.rst	2022-03-22 18:10:17 UTC (rev 9141)
@@ -17,7 +17,7 @@
 :doc:`Bone </animation/armatures/bones/index>`,
 :doc:`Node </interface/controls/nodes/index>`,
 :doc:`Object </scene_layout/object/index>` and
-:doc:`Sequence Strip </video_editing/sequencer/strips/index>`.
+:doc:`Sequence Strip </video_editing/edit/montage/strips/index>`.
 
 When the operator is executed, a pop-up dialog appears.
 The text field shows the name of the current item and can be overwritten to rename the item.

Modified: trunk/blender_docs/manual/render/output/properties/output.rst
===================================================================
--- trunk/blender_docs/manual/render/output/properties/output.rst	2022-03-22 17:13:01 UTC (rev 9140)
+++ trunk/blender_docs/manual/render/output/properties/output.rst	2022-03-22 18:10:17 UTC (rev 9141)
@@ -198,7 +198,7 @@
    have to re-render all frames from the beginning. If you first render out a set
    of static images such as the default PNG format or the higher-quality OpenEXR
    (which can retain HDR pixel data), you can combine them as
-   an :doc:`Image Strip </video_editing/sequencer/strips/image>`
+   an :doc:`Image Strip </video_editing/edit/montage/strips/image>`
    in the Video Sequencer. This way, you can easily:
 
    - Restart the rendering from the place (the frame) where any problem occurred.
@@ -205,7 +205,7 @@
    - Try out different video encoding options in seconds,
      rather than minutes or hours as encoding is usually much faster than rendering the 3D scene.
    - Enjoy the rest of the features of the Video Sequencer, such as adding
-     :doc:`Image Strips </video_editing/sequencer/strips/image>`
+     :doc:`Image Strips </video_editing/edit/montage/strips/image>`
      from previous renders, audio, video clips, etc.
 
 .. tip::

Copied: trunk/blender_docs/manual/video_editing/edit/montage/editing.rst (from rev 9140, trunk/blender_docs/manual/video_editing/sequencer/editing.rst)
===================================================================
--- trunk/blender_docs/manual/video_editing/edit/montage/editing.rst	                        (rev 0)
+++ trunk/blender_docs/manual/video_editing/edit/montage/editing.rst	2022-03-22 18:10:17 UTC (rev 9141)
@@ -0,0 +1,568 @@
+
+*******
+Editing
+*******
+
+Transform
+=========
+
+.. _bpy.ops.transform.seq_slide:
+
+Move
+----
+
+.. reference::
+
+   :Menu:      :menuselection:`Strip --> Transform --> Move`
+   :Shortcut:  :kbd:`G`
+
+Pressing :kbd:`G` moves all the selected strip(s).
+Move your mouse horizontally (left/right) to change the strip's position in time.
+Move vertically (up/down) to change channels.
+
+Holding down :kbd:`Ctrl` while dragging snaps to the start and endpoints of other strips.
+The position of the mouse relative to the selection influences where the strips are snapped.
+If it is closer to the start of the selection, then the start frame of the selection gets snapped,
+else the end frame will get snapped.
+
+To "ripple edit" (make room for strips you drag) hold :kbd:`Alt` when placing a strip.
+
+You can also lock the direction to time with :kbd:`X` or to change the strip's channel with :kbd:`Y`.
+
+It is possible to move strips using mouse by dragging them while holding :kbd:`LMB`.
+Currently it is possible to move only one strip by dragging.
+
+
+Start Frame Offset
+^^^^^^^^^^^^^^^^^^
+
+The *Start Frame Offset* for that strip can be selected by clicking :kbd:`LMB` on the left handle of the strip;
+holding it down (or pressing :kbd:`G` and then moving the mouse left/right)
+changes the start frame within the strip by the number of frames you move it.
+The frame number label under the strip displays the start frame of the strip.
+
+- If you have a 20-image sequence strip, and drag the left handle to the right by 10 frames,
+  the strip will start at image 11 (images 1 to 10 will be skipped).
+  Use this to clip off a roll-up or undesired lead-in.
+- Dragging the left handle left will create a lead-in (copies) of the first frame for as many frames as you drag it.
+  Use this when you want some frames for a transition at the start of the clip.
+
+
+End Frame
+^^^^^^^^^
+
+The *End Frame* of the strip could be selected by clicking :kbd:`LMB` on the right handle of the strip;
+holding it down (or pressing :kbd:`G`) and then moving the mouse changes the ending frame within the strip.
+The frame number label over the strip displays the end frame of the strip.
+
+- Dragging the right handle to the left shortens the clip;
+  any original images at the tail are ignored. Use this to quickly clip off a roll-down.
+- Dragging the right handle to the right extends the clip.
+  For movies and images sequences, more of the animation is used until exhausted.
+  Extending a clip beyond its length will render as a copy of the last image.
+  Use this for transitions out of this clip.
+
+.. note:: Multiple selection
+
+   You can select several (handles of) strips by :kbd:`Shift-LMB` clicking: when you press :kbd:`G`,
+   everything that is selected will move with your mouse -- this means that,
+   for example, you can at the same time move a strip, shorten two others, and extend a forth one.
+
+
+Move/Extend from Current Frame
+------------------------------
+
+.. reference::
+
+   :Menu:      :menuselection:`Strip --> Transform --> Move/Extend from Current Frame`
+   :Shortcut:  :kbd:`E`
+
+With a number of strips selected, pressing :kbd:`E` lets you interactively extend the strips.
+This is similar to moving but is useful for extending (or shortening) time around the current frame.
+
+All selected strip handles to the "mouse side" of the current frame indicator will transform together,
+so you can change the duration of strips at the current frame.
+
+.. hint::
+
+   Extend is a convenient way to adjust the time of rough edits such as an "animatic" (sequential storyboards).
+   Where it's possible to select everything and adjust the length of strips around the current frame.
+   This can be especially useful when adding in audio or other elements that could cause
+   the timing to need adjustment.
+
+   When performing this operation you may want to enable :menuselection:`Markers --> Sync Markers`
+   so markers are updated too.
+
+   This simply a convenience operation, instead of manually selecting strips
+   on one side of the current frame, as well as handles on one side of overlapping strips.
+   Then selecting and transforming markers as well.
+   This avoids the manual process, so re-timing can be accessed quickly.
+
+
+.. _bpy.ops.sequencer.slip:
+
+Slip Strip Contents
+-------------------
+
+.. reference::
+
+   :Menu:      :menuselection:`Strip --> Transform --> Slip Strip Contents`
+   :Shortcut:  :kbd:`S`
+
+The Slip tool allows you to change the position of the contents of a strip without moving the strip itself.
+
+
+.. _bpy.ops.sequencer.snap:
+
+Snap Strips to the Current Frame
+--------------------------------
+
+.. reference::
+
+   :Menu:      :menuselection:`Strip --> Transform --> Snap Strips to the Current Frame`
+   :Shortcut:  :kbd:`Shift-S`
+
+Moves the strip or control point to the current frame.
+
+
+.. _bpy.ops.sequencer.offset_clear:
+
+Clear Strips Offset
+-------------------
+
+.. reference::
+
+   :Menu:      :menuselection:`Strip --> Transform --> Clear Strips Offset`
+   :Shortcut:  :kbd:`Alt-O`
+
+To reset the (soft) start/end frame handles.
+
+
+.. _bpy.ops.sequencer.swap:
+
+Swap Strips
+-----------
+
+.. reference::
+
+   :Menu:      :menuselection:`Strip --> Transform --> Swap Strips`
+
+Left :kbd:`Alt-Left`
+   Swaps the active strip with the strip to the left.
+Right :kbd:`Alt-Right`
+   Swaps the active strip with the strip to the right.
+
+
+.. _bpy.ops.sequencer.gap_remove:
+
+Remove Gaps
+-----------
+
+.. reference::
+

@@ Diff output truncated at 10240 characters. @@

More information about the Bf-docboard-svn mailing list