manual/editors/video_sequencer/sequencer/navigating.rst

@@ -40,7 +40,7 @@ Preview as Backdrop
 
 .. _bpy.ops.sequencer.refresh_all:
 
-Refresh All :kbd:`Ctrl-R`
+Refresh All :kbd:`Ctrl-E`
    Reloads external files, re-renders the 3D Viewport, and refreshes the current frame preview.
 
    This is useful when you modified an external file or made a change in a scene that Blender
@@ -52,7 +52,7 @@ Frame Selected :kbd:`NumpadPeriod`
    Zooms the display to show only the selected strips.
 Frame All :kbd:`Home`
    Zooms the display to show all strips.
-Go to Current Frame
+Go to Current Frame :kbd:`Numpad0`
    Centers the horizontal timeline on the current frame.
 Zoom to Border :kbd:`Shift-B`
    Click and drag to draw a rectangle and zoom to this rectangle.

manual/editors/video_sequencer/sequencer/sidebar/cache.rst

@@ -3,8 +3,8 @@
 Cache
 *****
 
-The Cache is used to save frames in memory for preview,
+The Cache is used to save preview frames in memory,
-so they can be later displayed much faster than rendered from scratch.
+so they can later be displayed much faster than if they were rendered from scratch.
 Cache capacity can be set in the :doc:`System tab </editors/preferences/system>` of the Preferences.
 
 In order for this tab to be visible,
@@ -22,17 +22,21 @@ Cache Settings
 
    :Panel:     :menuselection:`Sidebar --> Cache --> Cache Settings`
 
-In this panel you can set up types of images that will be cached for all strips.
+In this panel, you can select the preview rendering stages at which strip images should be cached.
+These settings apply to all strips.
 
 Cache
    Raw
-      Cache raw images read from drive, for faster tweaking of strip parameters at the cost of memory usage.
+      Cache raw images right after they're read from the drive, for faster tweaking of strip parameters
+      at the cost of memory usage.
    Pre-processed
-      Cache preprocessed images, for faster tweaking of effects at the cost of memory usage.
+      Cache strip images after applying cropping, transformation, saturation and so on,
+      for faster tweaking of effects at the cost of memory usage.
    Composite
-      Cache intermediate composited images, for faster tweaking of stacked strips at the cost of memory usage.
+      Cache strip images after blending with lower channels and applying effects,
+      for faster tweaking of stacked strips at the cost of memory usage.
    Final
-      Cache final image for each frame.
+      Cache the final rendered frame.
 
 
 Strip Cache
@@ -43,7 +47,7 @@ Strip Cache
    :Panel:     :menuselection:`Sidebar --> Cache --> Cache Settings`
 
 This panel sets the types of images that will be cached for the active strip.
-When enabled, these properties override the `Cache Settings`_.
+When enabled, these properties override the above `Cache Settings`_.
 
 Cache
    Raw

manual/editors/video_sequencer/sequencer/sidebar/modifiers.rst

@@ -14,22 +14,21 @@ Modifiers
 .. figure:: /images/video-editing_sequencer_sidebar_modifiers_panel.png
    :align: right
 
-Modifiers are used to make adjustments on the image, like contrast,
+Modifiers are used to make adjustments to the image, like contrast,
 brightness, saturation, color balance and applying masks.
 
-You can add these modifiers directly to the selected strip,
+You can add these modifiers directly to a media strip,
-or you can use it within an "Adjustment Layer" effect strip,
+or you can use them within an :doc:`Adjustment Layer </video_editing/edit/montage/strips/adjustment>`
-which allows you to apply these modifiers onto several strips the same time.
+strip, making them apply to several media strips in one go.
 
 Use Linear Modifiers
    Calculates modifiers in :ref:`linear color space <color-management-linear-space>` instead of the
    :ref:`Sequencer color space <bpy.types.ColorManagedSequencerColorspaceSettings.name>`.
 
    Calculating modifiers in linear space will match the image processing of the compositor.
-   In most cases this should be enabled, working in a non-linear workflow could have unpredictable results.
+   In most cases, this should be enabled; working in a non-linear workflow could have unpredictable results.
 Copy to Selected Strips
-   Allows you to copy the modifiers to selected strips.
+   Copies the modifiers to the selected strips, either replacing their current modifiers or appending to them.
-   This works two ways, you can either replace the old modifiers or append/add to the previous modifiers.
 
 
 Common Options
@@ -38,9 +37,9 @@ Common Options
 Each modifier has several buttons at its top:
 
 Mute (eye icon)
-   Disables the modifier, useful to compare the image, with or without modifications.
+   Disables the modifier. Useful to compare the image with or without modifications.
 Move (up/down arrow icon)
-   These two buttons change the modifier's position in the stack which affects their computation order.
+   These two buttons change the modifier's position in the stack which affects its computation order.
 Remove ``X``
    Deletes the modifier from the stack.
 
@@ -48,22 +47,19 @@ Remove ``X``
 Masking
 -------
 
-Each Modifier has an option to mask the effect of the modifier and any modifiers below it.
+You can mask each modifier to limit the area of the image it affects. This can be done using
-For example, to correct the brightness only on a certain zone of the image,
+either a :doc:`Mask </movie_clip/masking/introduction>` or another strip.
-you can filter the Brightness/Contrast modifier.
-
-The mask can either be a Mask created in the Mask editor or use another strip as a mask.
 
 Mask Input Type
    Type of input data used for the mask.
 
    :Strip:
-      Uses the grayscale representation of the image in a strip to mask the affects of the modifier.
+      Use the grayscale representation of another strip's image.
    :Mask:
-      Use a mask data-block to mask the affects of the modifier.
+      Use a Mask data-block.
 
 Mask
-   The Strip or Mask data-block to use as an input.
+   The Strip or Mask data-block to use.
 
 Mask Time :guilabel:`Mask Input Only`
    How the start frame of the mask is calculated.
@@ -84,7 +80,7 @@ Currently, the following modifiers are supported:
 Brightness/Contrast Modifier
 ----------------------------
 
-Adjusts the brightness and contrast of the modifier input.
+Adjusts the brightness and contrast of the image.
 
 
 .. index:: Video Sequencer Modifiers; Color Balance Modifier
@@ -93,7 +89,7 @@ Adjusts the brightness and contrast of the modifier input.
 Color Balance Modifier
 ----------------------
 
-Color balance adjustments, either by the Lift, Gamma, and Gain or the Slope, Offset and Power method.
+Color balance adjustments, either by the Lift/Gamma/Gain or the Offset/Power/Slope method.
 
 This modifier works similar to the :doc:`Color Balance Node </compositing/types/color/adjust/color_balance>`.
 
@@ -119,10 +115,10 @@ Offset/Power/Slope (ASC-CDL)
       the brighter the source color is.
    Offset
       Shifts color values after applying Slope by adding the Offset :math:`o` to them. Note that
-      the selected value shown in the UI will be subtracted by 1, so the default value of 1 means
+      the selected value shown in the UI will be reduced by 1, so the default value of 1 means
       effectively no offset is applied.
    Power
-      Over-all exponent :math:`p`, which mainly adjusts the midtones.
+      Overall exponent :math:`p`, which mainly adjusts the midtones.
 
 
 .. index:: Video Sequencer Modifiers; Curves Modifier
@@ -160,7 +156,7 @@ Mask Input Type
    Type of input data used for the mask.
 
    :Strip:
-      Uses the grayscale representation of the image in a strip to affect the alpha of the current strip.
+      Use the grayscale representation of another strip to affect the alpha of the current strip.
    :Mask:
       Use a mask data-block to affect the alpha of the current strip.
 
@@ -168,7 +164,7 @@ Mask Input Type
 .. _bpy.types.SequenceModifier.input_mask_strip:
 
 Mask
-   The Strip or Mask data-block to use as an input.
+   The Strip or Mask data-block to use.
 
 .. _bpy.types.SequenceModifier.mask_time:
 
@@ -196,7 +192,7 @@ This modifier works the same as the :doc:`Tone Map Node </compositing/types/colo
 White Balance Modifier
 ----------------------
 
-Use it to adjust the white balance by choosing the color that should be white.
+Used to adjust the white balance by choosing the color that should be white.
 
 
 .. index:: Video Sequencer Modifiers; Sound Equalizer Modifier
@@ -206,4 +202,4 @@ Sound Equalizer Modifier
 ------------------------
 
 This modifier can be used to emphasize or suppress sound frequencies.
-The range is limited to 35Hz - 20kHz and +/-35dB
+The range is limited to 35Hz - 20kHz and +/-35dB.

manual/editors/video_sequencer/sequencer/sidebar/proxy.rst

@@ -5,26 +5,36 @@ Proxy
 
 As projects involve increasingly high-resolution footage,
 the performance of the video preview can decrease drastically.
-To combat this, proxies are used to maintain a smooth editing experience without compromising visual fidelity.
+To combat this, proxies are used to maintain a smooth editing experience without
+compromising visual fidelity in the end result.
 
-Proxies are optimized, lower-resolution, versions of original video files
+Proxies are optimized, lower-resolution copies of original video files
 that are used as a substitute of the high-quality source videos to increase playback performance.
 For rendering out the final project, the original, high quality source files are used.
 
+The quickest way to set up proxies is to simply select a
+:ref:`Proxy Render Size <bpy.types.SpaceSequenceEditor.proxy_render_size>`
+in the *View* tab (visible when the editor is in *Preview* or
+*Sequencer & Preview* mode). This will automatically enable the selected
+proxy resolution in all the strips and start generating the downscaled video files.
+
+You can use the *Proxy* tab if you want to configure proxies in more detail.
 
 Proxy Settings
 ==============
 
 .. reference::
 
-   :Panel:     :menuselection:`Sidebar region --> Proxy & Timecode --> Proxy Settings`
+   :Panel:     :menuselection:`Sidebar region --> Proxy --> Proxy Settings`
+
+Contains scene-wide proxy settings.
 
 .. _bpy.types.SequenceEditor.proxy_storage:
 
 Storage
    How proxies are stored for the project.
 
-   :Per Strip: Proxies are stored in the directory of the input.
+   :Per Strip: Each strip can specify where to store its proxies (see below).
    :Project: All proxies are stored in one directory.
 
       .. _bpy.types.SequenceEditor.proxy_dir:
@@ -35,13 +45,15 @@ Storage
 .. _bpy.ops.sequencer.enable_proxies:
 
 Set Selected Strip Proxies
-   Set proxy size and overwrite flag for all selected strips.
+   Shows a pop-over that lets you select the resolution(s) to generate
+   and whether to overwrite existing proxy files. Once you confirm with the *Set* button,
+   your choices are applied to the selected strips. You can view and tweak the
+   settings for individual strips in the *Strip Proxy & Timecode* panel (see below).
 
 .. _bpy.ops.sequencer.rebuild_proxy:
 
 Rebuild Proxy and Timecode Indices
-   Generates Proxies and Timecodes for all selected strips,
+   Generates proxies and time indices for all selected strips.
-   same as doing :menuselection:`Strip --> Rebuild Proxy and Timecode Indices`.
 
 
 .. _bpy.types.SequenceProxy:
@@ -57,47 +69,37 @@ Strip Proxy & Timecode
 .. figure:: /images/video-editing_sequencer_sidebar_proxy_panel.png
    :align: right
 
-Once you have chosen the :term:`Proxy`/:term:`Timecode` options,
+Contains strip-specific proxy settings. The checkbox in the header can be used to
-you need to select all strips for which you want proxies to be built.
+enable/disable proxy generation.
-Then use :menuselection:`Strip --> Rebuild Proxy and Timecode Indices`,
-or the according button in the `Proxy Settings`_ panel.
-Once all proxies are built, they will be ready to use.
-
-In order to use proxies, you have to select a
-:ref:`Proxy Render Size <bpy.types.SpaceSequenceEditor.proxy_render_size>`
-that matches one of the selected *Resolutions*.
 
 Custom Proxy
    Directory
-      By default, all generated proxy images are stored to
+      By default, all generated proxy videos are stored to
-      the ``<path of original footage>/BL_proxy/<clip name>`` folder,
+      the folder ``<path of original footage>/BL_proxy/<clip name>``,
-      but this location can be set to a custom directory using this option.
+      but this can be changed to a custom directory using this option.
    File
       Allows you to use preexisting proxies.
 
 .. _bpy.types.SequenceProxy.build:
 
 Resolutions
-   Controls the resolution(s) of the computed proxy images; multiply sizes can be selected.
+   The resolution(s) of the proxy videos to generate; multiple sizes can be selected.
-   The available options are 25%, 50%, 75%, 100 percent of original strip size.
 
 .. _bpy.types.SequenceProxy.use_overwrite:
 
 Overwrite
-   When rebuilding proxies, this option sets whether to overwrite existing proxy files or to use existing files.
+   Whether to overwrite existing proxy files or keep them.
-   Saves over any existing proxy files in the proxy storage directory.
-   When disabled, existing proxy files will be used.
 
 .. _bpy.types.SequenceProxy.quality:
 
 Quality
-   Defines the quality of the images used for proxies.
+   The video quality for proxies.
 
 .. _bpy.types.SequenceProxy.timecode:
 
-Timecode Index
+:term:`Timecode` Index
    When you are working with footage directly copied from a camera without preprocessing it,
-   there might be numerous artifacts, mostly due to seeking a given frame in the sequence.
+   there might be numerous artifacts, mostly due to seeking to a given frame in the sequence.
    This happens because such footage usually does not have correct frame rate values in the file header.
    This issue can still arise when the source clip has the same frame rate as the scene settings.
    In order for Blender to correctly calculate the frames and frame rate there are two possible solutions:

manual/editors/video_sequencer/sequencer/sidebar/strip.rst

@@ -17,15 +17,11 @@ Name
    .. _bpy.ops.sequencer.strip_color_tag_set:
 
    Color Tag
-      The color of the strip in the timeline.
+      Strips are given a :ref:`Default Color <sequencer-strip-colors>` based on their type;
-      By default, strips are given a :ref:`Default Color <sequencer-strip-colors>` based on the type of strip.
+      using the color tag, you can assign a custom color to help organize your sequence.
-      The color tag can change the color to an alternative predefined color.
-
-      This can be useful to help organize your sequence by for example,
-      giving a special color to all graphic overlays and a different color for footage.
 
 Mute
-   Toggles the strip from producing an output.
+   Uncheck to prevent the strip from producing output.
 
 
 Compositing
@@ -39,7 +35,7 @@ Blend
    The method for blending the current strip with strips in lower channels.
    See :term:`Blend Modes` for more information.
 Opacity
-   The transparency (:term:`alpha <Alpha Channel>`) of the strip.
+   The opacity (:term:`alpha <Alpha Channel>`) of the strip.
 
    When this property is animated, the opacity is drawn as an overlay on the strip.
    The overlay will look like a dark section that follows the animation curve.
@@ -156,7 +152,7 @@ Working with sound is documented further at :ref:`bpy.types.SoundSequence`.
 .. _bpy.types.SoundSequence.volume:
 
 Volume
-   Adjusts the perceived loudness or intensity of the sound
+   Adjusts the perceived loudness or intensity of the sound.
 
    When this property is animated, the volume is drawn as an overlay on the strip.
    The overlay will look like a dark section that follows the animation curve.
@@ -171,16 +167,15 @@ Volume
 
 Pan
    Used to pan the audio between speakers in multichannel audio.
-   Only mono sources can be panned, if the source file is not mono enable *Mono* to mix the channels together.
+   Only mono sources can be panned; if the source file is not mono, enable *Mono* to mix the channels together.
 
    This value basically represents the angle at
    which it's played if you multiply the value by 90 degrees.
 
-   For stereo output panning works from left (-1) to right (1);
+   For stereo, output panning works from left (-1) to center (0) and finally right (1).
-   where 0 means front/center, -1 means to the left and 1 to the right.
 
-   To address rear speakers, you can pan to those with the higher values;
+   To address rear speakers, you can pan to those with higher values,
-   where -2 is back left, and 2 is back right.
+   where -2 is back left and 2 is back right.
 
    .. tip::
 
@@ -192,14 +187,6 @@ Pan
       The number of audio channels can be configured in the
       :ref:`Audio Output <render-output-video-encoding-audio>` settings.
 
-.. _bpy.types.SoundSequence.show_waveform:
-
-Display Waveform
-   Display an approximate waveform of the sound file inside of the Sound strip.
-   The waveform reflects strip volume and its animation using :doc:`keyframes </animation/keyframes/introduction>`.
-
-   Clipping audio, i.e. values over 100% amplitude, will be shown in red in the waveform.
-
 .. _bpy.types.Sound.use_mono:
 
 Mono
@@ -217,8 +204,8 @@ Time
 
 The Time panel is used to control source and timeline position of the strip.
 
-Lock (padlock icon)
+Lock (padlock icon in panel header)
-   Prevents the strip from being moved (found in the panel header).
+   Prevents the strip from being moved.
 
 .. _bpy.types.Sequence.show_retiming_keys:
 
@@ -233,32 +220,45 @@ Channel
 .. _bpy.types.Sequence.frame_start:
 
 Start
-   Changes the starting frame number of the strip, which is the same as selecting and moving the strip.
+   Changes the starting frame of the strip, which is the same as selecting and moving the strip.
 
 .. _bpy.types.Sequence.frame_final_duration:
 
 Duration
-   Changes the length, in frames of the strip. This works by changing the end frame,
+   Changes the length (in frames) of the strip. This works by changing the end frame,
    which is the same as selecting and moving the strip's right handle.
 End
-   Specifies the ending time and ending frame number for the strip.
+   Shows the ending time and frame of the strip.
 
 .. _bpy.types.Sequence.frame_offset_start:
 .. _bpy.types.Sequence.frame_offset_end:
 
 Strip Offset Start/End
-   Can be used to either extend the strip beyond the end frame by repeating the last frame.
+   Positive values will move the strip's handles inwards, making it start later than the start
-   Or it can be used to shorten the strip, as if you were cropping the end frame.
+   of the source material and stop before its end. This lets you trim down the source material
-   This is the same as adjusting the strip handles.
+   to the part you need. You can enable the
+   :ref:`Offsets overlay <bpy.types.SpaceSequeSequencerTimelineOverlaynceEditor.show_strip_offset>`
+   to see the start and end of the full source file.
+
+   Negative values will move the strip's handles outwards, making it start earlier than the start
+   of the source material and stop after its end. This lets you show the first and/or last frame
+   as a frozen image for some time.
+
+   Instead of adjusting these offsets in the Sidebar, you can also drag the strip's handles.
 
 .. _bpy.types.MovieSequence.animation_offset_start:
 .. _bpy.types.MovieSequence.animation_offset_end:
 .. _sequencer-duration-hard:
 
 Hold Offset Start/End
-   Offset of the uncut strip content.
+   Used for trimming frames off the start/end of the source material. At first sight, this
+   does the same as the *Strip Offset* properties, but you can in fact combine them
+   to hold (freeze) a frame other than the first or last one. For example, if you set the
+   *Hold Offset Start* to 10 and the *Strip Offset Start* to -20, the video will first show
+   the 11th frame of the source for 20 frames, and then play the remaining frames.
+
 Current Frame
-   The frame number relative to the start of the active strip.
+   The Playhead's frame number relative to the start of the strip.
 
 
 Source
@@ -268,45 +268,50 @@ Source
 
    :Panel:     :menuselection:`Sidebar --> Strip --> Source`
 
-The Source panel is used to control sources of the strip
+The Source panel shows (and lets you change) the file which the strip points to,
-such as filename and file path and various methods of interpreting these files.
+as well as how this file should be displayed.
 
-Path
-   The directory that contains the source file.
-   When the file is moved, the path can be updated instead of recreating the strip.
 File
-   The file name of the source file.
+   The full path of the source file.
-   For image strips showing an image sequence, this will be different for each frame.
-Change Data/Files
-   Same as the *Path* and *File* fields, but this time combined to open the File Browser in order to
-   find the file(s) you search. Same as :menuselection:`Strip --> Inputs --> Change Paths/Files`.
 
 Color Space
-   To specify the color space of the source file.
+   The color space of the source file.
 
    The list of color spaces depends on the active :ref:`OCIO config <ocio-config>`.
    The default supported color spaces are described in detail here:
    :ref:`Default OpenColorIO Configuration <ocio-config-default-color-spaces>`
 Alpha Mode
-   If the source file has an Alpha (transparency) channel, you can choose:
+   If the source file has an Alpha (transparency) channel, you can choose between
-
+   :term:`Straight Alpha` and :term:`Premultiplied Alpha`.
-   :term:`Straight Alpha` or :term:`Premultiplied Alpha`
 Stream Index :guilabel:`Movie Strip`
-   For files with several movie streams, use the stream with the given index.
+   The video stream to use, in case there are multiple.
 Deinterlace
-   Removes fields in a video file.
+   Applies deinterlacing to analog video.
-   For example, if it is an analog video and it has even or odd interlacing fields.
 
 Source Information
    Displays information about the strip's media.
 
    Resolution
-      Resolution of the active strip image output.
+      Resolution of the active strip's image output.
    FPS :guilabel:`Movie Strip`
       The frame rate encoded into the video file.
-      If this value does not match the scene :ref:`Frame Rate <bpy.types.RenderSettings.fps>`
+      If this value does not match the scene's :ref:`Frame Rate <bpy.types.RenderSettings.fps>`,
       the perceived speed of the media will be wrong unless the speed is
-      :ref:`changed <video_editing-change_fps>` to account for the difference in frame rate.
+      :ref:`changed <video_editing-change_fps>` to account for the difference.
+
+
+Options for Image Strips
+------------------------
+
+Directory
+   The directory that contains the source file(s).
+   
+Filename
+   The name of the source file. For image sequences, this will be different for each frame.
+
+Change Data/Files
+   Opens a File Browser to let you select a new set of images (as an alternative to modifying
+   the above textboxes). Same as :menuselection:`Strip --> Inputs --> Change Paths/Files`.
 
 
 Options for Sound Strips
@@ -314,10 +319,10 @@ Options for Sound Strips
 
 Sound
    :ref:`Data-block menu <ui-data-block>` to select a sound.
-Path
+File Path
-   Path to the sound file used by this :ref:`data-block <ui-data-block>` menu.
+   Path to the file used by the selected sound :ref:`data-block <ui-data-block>`.
 Pack
-   Pack sound into the blend-file.
+   :doc:`Pack </files/blend/packed_data>` the sound into the blend-file.
 
 .. _bpy.types.Sound.use_memory_cache:
 

manual/editors/video_sequencer/sequencer/toolbar/blade.rst

@@ -8,11 +8,21 @@ Blade
 
    :Mode:      Sequencer Mode
    :Tool:      :menuselection:`Toolbar --> Blade`
-   :Shortcut:  :kbd:`Shift-K`
+   :Shortcut:  :kbd:`K`, :kbd:`Shift-K`
 
-Soft
+Cuts a strip in two. This can be done in two different ways:
-   This cuts the strip in two at the location of the click.
+
-   This will result in two strips which use the same source, fitting the original strip's timing and length.
+- Select the tool in the Toolbar and click a strip at the time point where you want to split it.
-Hard
+- Alternatively, select one or more strips, place the Playhead at the time point where you want to
-   Like *Soft Blade*, it cuts a strip in two distinct strips;
+  split them, and press one of the keyboard shortcuts below.
-   but you will not be able to drag the endpoints to show the frames past the cut of each resulting strip.
+
+There are also two different split types to choose from:
+
+Soft :kbd:`K`
+   After splitting, it's still possible to restore the cut content in the new strips
+   by dragging their handles.
+
+Hard :kbd:`Shift-K`
+   After splitting, it's not possible to restore the cut content by dragging handles.
+   However, you can still restore it by changing the :ref:`Hold Offset <sequencer-duration-hard>`
+   in the Sidebar.