Improvements for "Video Sequencer" section #104484

Merged
Aaron Carlisle merged 2 commits from Matthew-Hinson/blender-manual:video-sequencer into main 2023-08-07 02:12:56 +02:00
4 changed files with 37 additions and 48 deletions

View File

@ -4,22 +4,15 @@
Introduction Introduction
************ ************
Blender is a versatile software used for modeling, sculpting, 2D drawing, animation, and video editing. The Video Sequencer allows you to place images, videos, sounds, and scenes
Most of the work is done in so-called editors: on a timeline and combine them into a new video. This section only describes its UI;
tools for viewing and modifying your work through a specific part of Blender. to read more about its usage, see the :doc:`Video Editing </video_editing/index>` section.
There are a couple of editors that can manage video:
the :doc:`Compositor </editors/compositor>`, the :doc:`Movie Clip Editor </editors/clip/index>`,
the :doc:`Image Editor </editors/image/index>` (only for still images), and the Video Sequencer.
This section describes only the interface of the Video Sequencer,
to read more about usage of the Video Sequencer read the :doc:`Video Editing </video_editing/index>` section.
Editor Layout Editor Layout
============= =============
The Video Sequencer is composed of multiple regions (see figure 1). The Video Sequencer is composed of multiple regions.
They are described in more detail in the next sections. They are described in more detail in the next sections.
Figure 1 shows the combined *Sequencer & Preview* view type. Figure 1 shows the combined *Sequencer & Preview* view type.
This view can be broken up into the following regions: This view can be broken up into the following regions:
@ -28,22 +21,18 @@ This view can be broken up into the following regions:
Figure 1: Sequence Editor shown in the Sequencer & Preview view type. Figure 1: Sequence Editor shown in the Sequencer & Preview view type.
Header (red), Preview (yellow), Sequencer (blue), Properties (gray),
Panels & Tabs (yellow), Toolbar (purple).
Header Header
This region displays menus and buttons for interacting with the editor. This region displays menus and buttons for interacting with the editor.
The header changes slightly depending on the selected view type (see below). The header changes slightly depending on the selected view type (see below).
Preview Preview
This region shows the output of the Sequencer at the time of the Playhead. This region shows the output of the Sequencer at the time of the Playhead.
Sequencer Sequencer
This region shows timeline for managing the montage of strips. This region shows a timeline for managing the montage of strips.
Properties Sidebar
This region shows the properties of the active strip. This region shows the properties of the active strip.
Is divided into panels and tabs. Toggle on or off with :kbd:`N` key. It's divided into panels and tabs. Toggle on or off with :kbd:`N`.
Toolbar Toolbar
This region shows a list of icons, clicking on a icon will changes the active tool. This region shows a list of tools. Toggle on or off with :kbd:`T`.
Toggle on or off with :kbd:`T` key.
.. _bpy.types.SpaceSequenceEditor.view_type: .. _bpy.types.SpaceSequenceEditor.view_type:
@ -52,7 +41,7 @@ View Types
========== ==========
The Video Sequencer has three view types which can be The Video Sequencer has three view types which can be
changed with the View Type menu (see figure 1; top left). changed with the View Type selector (see figure 1; top left).
.. figure:: /images/editors_vse_view_types.svg .. figure:: /images/editors_vse_view_types.svg
@ -63,24 +52,24 @@ Sequencer
Preview Preview
View preview window and preview properties. View preview window and preview properties.
Sequencer & Preview Sequencer & Preview
Combined view of preview and timeline and properties of both. Combined view of preview and timeline and their properties.
.. tip:: .. tip::
It is possible to create multiple instances of any view type in single workspace. It's possible to have multiple Video Sequencers in one workspace,
each with its own view type.
Performance Performance
=========== ===========
Playback performance can be improved through several ways. Playback performance can be improved in several ways.
The biggest impact on performance is to allow the Video Sequencer to cache the playback.
There are two levels of cache, the first is a RAM cache, The method with the most impact is to allow the Video Sequencer to cache the playback.
this is enabled by default but can be increased based on the amount of RAM available. There are two levels of cache: a memory cache, which is enabled by default
The next level of cache is a disk cache which stores cached strips on disk. (and can be enlarged if RAM allows), and a disk cache, which is slower but has more capacity.
A disk cache can generally cache more than a RAM cache, but it can be slower. Both of these can be configured in the :ref:`Preferences <prefs-system-video-sequencer>`.
Both of these cache options can be configured in the :ref:`Preferences <prefs-system-sound>`.
Another way to improve performance is by using :ref:`Strip Proxies <bpy.types.SequenceProxy>`. Another way to improve performance is by using :ref:`Strip Proxies <bpy.types.SequenceProxy>`.
These are used to cache images or movies in a file that is easier to playback These are copies of source images and videos with a lower resolution and/or quality,
by reducing the image quality by either decreasing the resolution and/or compressing the image. making them faster to load than the originals.

View File

@ -3,16 +3,12 @@
Sequencer Sequencer
********* *********
The Sequencer is composed of two areas (see figure 1). The Sequencer view type shows a timeline (highlighted in red in the figure below).
The *header* is shown in a yellow outline and the *timeline* with a red outline.
Optional, there can be a *Toolbar* at the left and a *Sidebar* at the right; in figure 1 they are collapsed.
.. figure:: /images/editors_vse_sequencer.svg .. figure:: /images/editors_vse_sequencer.svg
:alt: Sequencer :alt: Sequencer
Figure 1: Sequencer and components Components of the Sequencer
Although the Sidebar and Toolbar belong to the Timeline area, they are discussed in a separate section.
.. toctree:: .. toctree::
:maxdepth: 2 :maxdepth: 2

View File

@ -3,12 +3,22 @@
Introduction Introduction
************ ************
This Sequencer view is where strips can be :doc:`selected </video_editing/edit/montage/selecting>`, The Sequencer view is where all the video editing happens. It shows a stack of
:doc:`modified </video_editing/edit/montage/editing>` by moving, cutting, or extending strips. :doc:`Channels </editors/video_sequencer/sequencer/channels>`,
There are also several built-in :doc:`effects </video_editing/edit/montage/strips/effects/index>` which are similar to layers in an image editing program (higher channels are displayed
in front of lower ones). Within each channel, you can create one or more
:doc:`strips </video_editing/edit/montage/strips/introduction>`, which
contain either a segment of video content (a rendered scene, an external video file...)
or an :doc:`effect </video_editing/edit/montage/strips/effects/index>` (color blending,
blurring...).
:doc:`select </video_editing/edit/montage/selecting>` and
:doc:`modify </video_editing/edit/montage/editing>` strips.
There are also several built-in
that can be combined with other strips to change their appearance. that can be combined with other strips to change their appearance.
The Sequencer view is horizontally divided into :doc:`Channels </editors/video_sequencer/sequencer/channels>` The Sequencer view is horizontally divided into
each channel can contain what is called a strip. each channel can contain what is called a strip.
A strip can be an image, animation, or any number of effects. A strip can be an image, animation, or any number of effects.
Each channel is numbered consecutively on the Y axis, Each channel is numbered consecutively on the Y axis,
@ -18,9 +28,3 @@ as it needs as long as they do not overlap. If a strip needs to overlap another,
it needs to be placed on a channel above or below the other strip. it needs to be placed on a channel above or below the other strip.
When strips are stacked, they stack from bottom to top where the lowest channel When strips are stacked, they stack from bottom to top where the lowest channel
forms the background and the highest the foreground. forms the background and the highest the foreground.
Blendify marked this conversation as resolved
Review

I believe this is still an important factoid and shouldn't be removed.

I believe this is still an important factoid and shouldn't be removed.
Review

Thank you for reviewing. As a newcomer to Blender, I was sadly more confused than informed after reading this note.

The first channel 0 is unusable as a place to put strips.

There is no such channel. (Old Blender versions appear to have had it, but even in version 2.93, channels start at number 1)

This is because it is used by the :doc:Sequencer Display </editors/video_sequencer/preview/introduction>

The link is named after the "Sequencer" view type, but points to the "Preview" view type - which is it?

to show a composite of all strips above channel 0.

I've done a bunch of experimenting with the VSE already, but never saw the empty area below Channel 1 display anything.

Is this area meant to show the union of all the strips, just like the "Summary" row in the Dope Sheet editor shows the union of all the keyframes? (In which case, how do you make it display something?)

Or is it an implementation detail for the Preview pane to render the composited video? (In which case, what benefit do users get from knowing this?)

Thank you for reviewing. As a newcomer to Blender, I was sadly more confused than informed after reading this note. > The first channel 0 is unusable as a place to put strips. There is no such channel. (Old Blender versions appear to have had it, but even in version 2.93, channels start at number 1) > This is because it is used by the :doc:`Sequencer Display </editors/video_sequencer/preview/introduction>` The link is named after the "Sequencer" view type, but points to the "Preview" view type - which is it? > to show a composite of all strips above channel 0. I've done a bunch of experimenting with the VSE already, but never saw the empty area below Channel 1 display anything. Is this area meant to show the union of all the strips, just like the "Summary" row in the Dope Sheet editor shows the union of all the keyframes? (In which case, how do you make it display something?) Or is it an implementation detail for the Preview pane to render the composited video? (In which case, what benefit do users get from knowing this?)
.. note::
The first channel 0 is unusable as a place to put strips.
This is because it is used by the :doc:`Sequencer Display </editors/video_sequencer/preview/introduction>`
to show a composite of all strips above channel 0.

View File

@ -207,7 +207,7 @@
id="tspan14660" id="tspan14660"
style="fill:#ffffff;stroke-width:0.264583" style="fill:#ffffff;stroke-width:0.264583"
x="447.79651" x="447.79651"
y="272.10986">Properties</tspan></text> y="272.10986">Sidebar</tspan></text>
<rect <rect
style="fill:none;stroke:#ffff00;stroke-width:0.79375;stroke-dasharray:3.175, 0.79375;-inkscape-stroke:none;stop-color:#000000" style="fill:none;stroke:#ffff00;stroke-width:0.79375;stroke-dasharray:3.175, 0.79375;-inkscape-stroke:none;stop-color:#000000"
id="rect23182" id="rect23182"

Before

Width:  |  Height:  |  Size: 880 KiB

After

Width:  |  Height:  |  Size: 880 KiB