[Bf-docboard-svn] bf-manual: [8291] trunk/blender_docs/manual: Begin Work on new Video Sequencer docs
Aaron Carlisle
noreply at blender.org
Sat Aug 7 01:49:04 CEST 2021
Revision: 8291
https://developer.blender.org/rBM8291
Author: Blendify
Date: 2021-08-07 01:49:04 +0200 (Sat, 07 Aug 2021)
Log Message:
-----------
Begin Work on new Video Sequencer docs
Part of T87729 thanks to @HUSCH for helping
Modified Paths:
--------------
trunk/blender_docs/manual/editors/index.rst
Added Paths:
-----------
trunk/blender_docs/manual/editors/video_sequencer/
trunk/blender_docs/manual/editors/video_sequencer/index.rst
trunk/blender_docs/manual/editors/video_sequencer/introduction.rst
trunk/blender_docs/manual/editors/video_sequencer/preview/
trunk/blender_docs/manual/editors/video_sequencer/preview/index.rst
trunk/blender_docs/manual/editors/video_sequencer/sequencer/
trunk/blender_docs/manual/editors/video_sequencer/sequencer/index.rst
trunk/blender_docs/manual/editors/video_sequencer/sequencer_preview.rst
trunk/blender_docs/manual/images/editors_vse_combi-sequencer-preview.png
trunk/blender_docs/manual/images/editors_vse_overview.svg
trunk/blender_docs/manual/images/editors_vse_sequencer.svg
trunk/blender_docs/manual/images/editors_vse_type.svg
trunk/blender_docs/manual/images/editors_vse_view_types.svg
Removed Paths:
-------------
trunk/blender_docs/manual/editors/sequencer.rst
Modified: trunk/blender_docs/manual/editors/index.rst
===================================================================
--- trunk/blender_docs/manual/editors/index.rst 2021-08-06 15:52:02 UTC (rev 8290)
+++ trunk/blender_docs/manual/editors/index.rst 2021-08-06 23:49:04 UTC (rev 8291)
@@ -32,7 +32,7 @@
compositor.rst
geometry_node.rst
texture_node/index.rst
- sequencer.rst
+ video_sequencer/index.rst
clip/index.rst
Deleted: trunk/blender_docs/manual/editors/sequencer.rst
===================================================================
--- trunk/blender_docs/manual/editors/sequencer.rst 2021-08-06 15:52:02 UTC (rev 8290)
+++ trunk/blender_docs/manual/editors/sequencer.rst 2021-08-06 23:49:04 UTC (rev 8291)
@@ -1,51 +0,0 @@
-
-***************
-Video Sequencer
-***************
-
-The Video Sequencer is a powerful tool used for video editing.
-
-.. figure:: /images/video-editing_introduction_screen-layout.png
-
- Default Video Editing screen layout.
-
-For more information on the Video Sequencer and video editing in Blender, see :doc:`/video_editing/index`.
-
-
-View Types
-==========
-
-.. figure:: /images/video-editing_introduction_types.png
- :align: right
-
-The Video Sequence Editor has three view types for the main view:
-
-Sequencer
- View timeline and strip properties.
-Preview
- View preview window and preview properties.
-Sequencer & Preview
- Combined view of preview and timeline and properties of both.
-
-It is possible to create multiple instances of any view type in single workspace.
-
-.. note::
-
- By default the Sequencer is enabled, however, it can be disabled
- in the :ref:`render-output-postprocess`.
-
-
-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 <prefs-system-sound>`.
-
-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
-by reducing the image quality by either decreasing the resolution and/or compressing the image.
Added: trunk/blender_docs/manual/editors/video_sequencer/index.rst
===================================================================
--- trunk/blender_docs/manual/editors/video_sequencer/index.rst (rev 0)
+++ trunk/blender_docs/manual/editors/video_sequencer/index.rst 2021-08-06 23:49:04 UTC (rev 8291)
@@ -0,0 +1,20 @@
+
+###################
+ Video Sequencer
+###################
+
+.. toctree::
+ :maxdepth: 2
+
+ introduction.rst
+
+
+View Types
+==========
+
+.. toctree::
+ :maxdepth: 2
+
+ sequencer/index.rst
+ preview/index.rst
+ sequencer_preview.rst
Property changes on: trunk/blender_docs/manual/editors/video_sequencer/index.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/blender_docs/manual/editors/video_sequencer/introduction.rst
===================================================================
--- trunk/blender_docs/manual/editors/video_sequencer/introduction.rst (rev 0)
+++ trunk/blender_docs/manual/editors/video_sequencer/introduction.rst 2021-08-06 23:49:04 UTC (rev 8291)
@@ -0,0 +1,81 @@
+
+************
+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 </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
+=============
+
+The VSE is composed of multiple areas (see figure 1). They are described in more detail in the next sections.
+Figure 1 shows the combined view *Sequencer/Preview*. You can select this view with the View Type selector.
+This view can contain the following areas:
+
+.. figure:: /images/editors_vse_overview.svg
+
+ Figure 1: Sequence Editor shown in the Sequencer & Preview view.
+
+ Header (red), Preview (Yellow), Sequencer (blue), Properties (Grey),
+ 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 the properties of the active strip.
+ Is divided into panels and tabs. Toggle on or off with :kbd:`N` key.
+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.
+
+
+View Types
+==========
+
+The Video Sequencer has three view types which can be changed with the View Type menu (see figure 1; top left).
+
+.. figure:: /images/editors_vse_view_types.svg
+
+ Figure 2: Three view types for the Video Sequence Editor
+
+Sequencer
+ View timeline and strip properties.
+Preview
+ View preview window and preview properties.
+Sequencer & Preview
+ Combined view of preview and timeline and properties of both.
+
+.. tip::
+
+ It is possible to create multiple instances of any view type in single workspace.
+
+
+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 <prefs-system-sound>`.
+
+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
+by reducing the image quality by either decreasing the resolution and/or compressing the image.
Property changes on: trunk/blender_docs/manual/editors/video_sequencer/introduction.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/blender_docs/manual/editors/video_sequencer/preview/index.rst
===================================================================
--- trunk/blender_docs/manual/editors/video_sequencer/preview/index.rst (rev 0)
+++ trunk/blender_docs/manual/editors/video_sequencer/preview/index.rst 2021-08-06 23:49:04 UTC (rev 8291)
@@ -0,0 +1,27 @@
+
+*******
+Preview
+*******
+
+The Preview contains two areas (see figure 1), the *header* is show
+in a yellow outline with the black *Preview window* (red outline) underneath.
+This Preview window has no fixed dimensions; you can zoom in or move indefinitely.
+However, in figure 1 you see a checkered area (green outline).
+This preview has the aspect ratio of the Project Dimensions; e.g. 1920 x 1080 pixels in figure 1.
+But, because the source strip could be scaled in a different resolution,
+the yellow outline shows the area that the source strip occupies.
+As you can see, the Open movie "Spring" has a different resolution than
+the project and letterboxes are added at the top and bottom of the image.
+
+In contrast with the :doc:`Sequencer View </editors/video_sequencer/sequencer/index>` example,
+both the Toolbar and Sidebar are expanded in figure 1.
+The gizmos however are unique for the Preview.
+
+.. figure:: /images/editors_vse_type.svg
+ :alt: Preview window
+
+ Figure 1: Preview window of VSE
+
+Sequencer preview is used to display result of rendering Sequencer timeline.
+This can be further configured to display output from certain channel, overlay or image analyzer (scope).
+You can adjust the view by zooming in with :kbd:`NumpadPlus` and zoom out with :kbd:`NumpadMinus`.
Property changes on: trunk/blender_docs/manual/editors/video_sequencer/preview/index.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/blender_docs/manual/editors/video_sequencer/sequencer/index.rst
===================================================================
--- trunk/blender_docs/manual/editors/video_sequencer/sequencer/index.rst (rev 0)
+++ trunk/blender_docs/manual/editors/video_sequencer/sequencer/index.rst 2021-08-06 23:49:04 UTC (rev 8291)
@@ -0,0 +1,15 @@
+
+*********
+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.
+
+.. 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 subsection.
Property changes on: trunk/blender_docs/manual/editors/video_sequencer/sequencer/index.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/blender_docs/manual/editors/video_sequencer/sequencer_preview.rst
===================================================================
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list