From ca2db41172a9d2363d8507dc6f48cd05d2f6c1e5 Mon Sep 17 00:00:00 2001 From: Matthew Hinson Date: Fri, 2 Jun 2023 16:15:17 +0200 Subject: [PATCH 1/2] Improvements for "Video Sequencer" section --- .../editors/video_sequencer/introduction.rst | 51 ++++++++----------- manual/images/editors_vse_overview.svg | 2 +- 2 files changed, 21 insertions(+), 32 deletions(-) diff --git a/manual/editors/video_sequencer/introduction.rst b/manual/editors/video_sequencer/introduction.rst index fd80c0d1d..a69022dc8 100644 --- a/manual/editors/video_sequencer/introduction.rst +++ b/manual/editors/video_sequencer/introduction.rst @@ -4,22 +4,15 @@ Introduction ************ -Blender is a versatile software used for modeling, sculpting, 2D drawing, animation, and video editing. -Most of the work is done in so-called editors: -tools for viewing and modifying your work through a specific part of Blender. - -There are a couple of editors that can manage video: -the :doc:`Compositor `, the :doc:`Movie Clip Editor `, -the :doc:`Image Editor ` (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 ` section. +The Video Sequencer allows you to place images, videos, sounds, and scenes +on a timeline and combine them into a new video. This section only describes its UI; +to read more about its usage, read the :doc:`Video Editing ` section. 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. Figure 1 shows the combined *Sequencer & Preview* view type. 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. - Header (red), Preview (yellow), Sequencer (blue), Properties (gray), - Panels & Tabs (yellow), Toolbar (purple). - Header This region displays menus and buttons for interacting with the editor. The header changes slightly depending on the selected view type (see below). Preview This region shows the output of the Sequencer at the time of the Playhead. Sequencer - This region shows timeline for managing the montage of strips. -Properties + This region shows a timeline for managing the montage of strips. +Sidebar 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 - This region shows a list of icons, clicking on a icon will changes the active tool. - Toggle on or off with :kbd:`T` key. + This region shows a list of tools. Toggle on or off with :kbd:`T`. .. _bpy.types.SpaceSequenceEditor.view_type: @@ -52,7 +41,7 @@ View Types ========== 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 @@ -63,24 +52,24 @@ Sequencer Preview View preview window and preview properties. Sequencer & Preview - Combined view of preview and timeline and properties of both. + Combined view of preview and timeline and their properties. .. 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 =========== -Playback performance can be improved through 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, -this is enabled by default but can be increased based on the amount of RAM available. -The next level of cache is a disk cache which stores cached strips on disk. -A disk cache can generally cache more than a RAM cache, but it can be slower. -Both of these cache options can be configured in the :ref:`Preferences `. +Playback performance can be improved in several ways. + +The method with the most impact is to allow the Video Sequencer to cache the playback. +There are two levels of cache: a memory cache, which is enabled by default +(and can be enlarged if RAM allows), and a disk cache, which is slower but has more capacity. +Both of these can be configured in the :ref:`Preferences `. Another way to improve performance is by using :ref:`Strip Proxies `. -These are used to cache images or movies in a file that is easier to playback -by reducing the image quality by either decreasing the resolution and/or compressing the image. +These are copies of source images and videos with a lower resolution and/or quality, +making them faster to load than the originals. diff --git a/manual/images/editors_vse_overview.svg b/manual/images/editors_vse_overview.svg index 617f014a7..9cd3916c0 100644 --- a/manual/images/editors_vse_overview.svg +++ b/manual/images/editors_vse_overview.svg @@ -207,7 +207,7 @@ id="tspan14660" style="fill:#ffffff;stroke-width:0.264583" x="447.79651" - y="272.10986">Properties + y="272.10986">Sidebar Date: Thu, 6 Jul 2023 18:14:17 +0200 Subject: [PATCH 2/2] Video sequencer intermediate work --- .../editors/video_sequencer/introduction.rst | 2 +- .../video_sequencer/sequencer/index.rst | 8 ++----- .../sequencer/introduction.rst | 24 +++++++++++-------- 3 files changed, 17 insertions(+), 17 deletions(-) diff --git a/manual/editors/video_sequencer/introduction.rst b/manual/editors/video_sequencer/introduction.rst index a69022dc8..d12e5159f 100644 --- a/manual/editors/video_sequencer/introduction.rst +++ b/manual/editors/video_sequencer/introduction.rst @@ -6,7 +6,7 @@ Introduction The Video Sequencer allows you to place images, videos, sounds, and scenes on a timeline and combine them into a new video. This section only describes its UI; -to read more about its usage, read the :doc:`Video Editing ` section. +to read more about its usage, see the :doc:`Video Editing ` section. Editor Layout diff --git a/manual/editors/video_sequencer/sequencer/index.rst b/manual/editors/video_sequencer/sequencer/index.rst index 8e727b63f..7b34c9827 100644 --- a/manual/editors/video_sequencer/sequencer/index.rst +++ b/manual/editors/video_sequencer/sequencer/index.rst @@ -3,16 +3,12 @@ Sequencer ********* -The Sequencer is composed of two areas (see figure 1). -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. +The Sequencer view type shows a timeline (highlighted in red in the figure below). .. figure:: /images/editors_vse_sequencer.svg :alt: Sequencer - Figure 1: Sequencer and components - -Although the Sidebar and Toolbar belong to the Timeline area, they are discussed in a separate section. + Components of the Sequencer .. toctree:: :maxdepth: 2 diff --git a/manual/editors/video_sequencer/sequencer/introduction.rst b/manual/editors/video_sequencer/sequencer/introduction.rst index 7068024ad..c71fd490a 100644 --- a/manual/editors/video_sequencer/sequencer/introduction.rst +++ b/manual/editors/video_sequencer/sequencer/introduction.rst @@ -3,12 +3,22 @@ Introduction ************ -This Sequencer view is where strips can be :doc:`selected `, -:doc:`modified ` by moving, cutting, or extending strips. -There are also several built-in :doc:`effects ` +The Sequencer view is where all the video editing happens. It shows a stack of +:doc:`Channels `, +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 `, which +contain either a segment of video content (a rendered scene, an external video file...) +or an :doc:`effect ` (color blending, +blurring...). + + +:doc:`select ` and +:doc:`modify ` strips. +There are also several built-in that can be combined with other strips to change their appearance. -The Sequencer view is horizontally divided into :doc:`Channels ` +The Sequencer view is horizontally divided into each channel can contain what is called a strip. A strip can be an image, animation, or any number of effects. 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. When strips are stacked, they stack from bottom to top where the lowest channel forms the background and the highest the foreground. - -.. note:: - - The first channel 0 is unusable as a place to put strips. - This is because it is used by the :doc:`Sequencer Display ` - to show a composite of all strips above channel 0. -- 2.30.2