diff --git a/manual/editors/video_sequencer/sequencer/navigating.rst b/manual/editors/video_sequencer/sequencer/navigating.rst index c3dcb368d..32f4491a9 100644 --- a/manual/editors/video_sequencer/sequencer/navigating.rst +++ b/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. diff --git a/manual/editors/video_sequencer/sequencer/sidebar/cache.rst b/manual/editors/video_sequencer/sequencer/sidebar/cache.rst index 7fc85174f..90ce80993 100644 --- a/manual/editors/video_sequencer/sequencer/sidebar/cache.rst +++ b/manual/editors/video_sequencer/sequencer/sidebar/cache.rst @@ -3,8 +3,8 @@ Cache ***** -The Cache is used to save frames in memory for preview, -so they can be later displayed much faster than rendered from scratch. +The Cache is used to save preview frames in memory, +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 ` 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, scaling, 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 diff --git a/manual/editors/video_sequencer/sequencer/sidebar/modifiers.rst b/manual/editors/video_sequencer/sequencer/sidebar/modifiers.rst index 0cdec5ead..ce1e14961 100644 --- a/manual/editors/video_sequencer/sequencer/sidebar/modifiers.rst +++ b/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, -or you can use it within an "Adjustment Layer" effect strip, -which allows you to apply these modifiers onto several strips the same time. +You can add these modifiers directly to a media strip, +or you can use them within an :doc:`Adjustment Layer ` +strip, making them apply to several media strips in one go. Use Linear Modifiers Calculates modifiers in :ref:`linear color space ` instead of the :ref:`Sequencer color space `. 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. - This works two ways, you can either replace the old modifiers or append/add to the previous modifiers. + Copies the modifiers to the selected strips, either replacing their current modifiers or appending to them. 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. -For example, to correct the brightness only on a certain zone of the image, -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. +You can mask each modifier to limit the area of the image it affects. This can be done using +either a :doc:`Mask ` or another strip. 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 `. @@ -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 ` +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 +(or create proxies for image sequences). 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,14 +43,21 @@ 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 choose 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). + + In the *Preview* mode, where the *Proxy* tab is not available, + this is instead done through the menu :menuselection:`View --> Proxy --> Setup`. .. _bpy.ops.sequencer.rebuild_proxy: Rebuild Proxy and Timecode Indices - Generates Proxies and Timecodes for all selected strips, - same as doing :menuselection:`Strip --> Rebuild Proxy and Timecode Indices`. + Generates proxies and time indices for the selected strips. + In the *Preview* mode, where the *Proxy* tab is not available, + this is instead done through the menu :menuselection:`View --> Proxy --> Rebuild`. .. _bpy.types.SequenceProxy: .. _bpy.types.MovieSequence.use_proxy: @@ -57,47 +72,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, -you need to select all strips for which you want proxies to be built. -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 ` -that matches one of the selected *Resolutions*. +Contains strip-specific proxy settings. The checkbox in the header can be used to +enable/disable proxy generation. Custom Proxy Directory - By default, all generated proxy images are stored to - the ``/BL_proxy/`` folder, - but this location can be set to a custom directory using this option. + By default, all generated proxy videos are stored to + the folder ``/BL_proxy/``, + 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 available options are 25%, 50%, 75%, 100 percent of original strip size. + The resolution(s) of the proxy videos to generate; multiple sizes can be selected. .. _bpy.types.SequenceProxy.use_overwrite: Overwrite - When rebuilding proxies, this option sets whether to overwrite existing proxy files or to use existing files. - Saves over any existing proxy files in the proxy storage directory. - When disabled, existing proxy files will be used. + Whether to overwrite existing proxy files or keep them. .. _bpy.types.SequenceProxy.quality: Quality - Defines the quality of the images used for proxies. + The video/image 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: diff --git a/manual/editors/video_sequencer/sequencer/sidebar/strip.rst b/manual/editors/video_sequencer/sequencer/sidebar/strip.rst index 4aa8897f7..7525d75cb 100644 --- a/manual/editors/video_sequencer/sequencer/sidebar/strip.rst +++ b/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. - By default, strips are given a :ref:`Default Color ` based on the type of strip. - 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. + Strips are given a :ref:`Default Color ` based on their type; + using the color tag, you can assign a custom color to help organize your sequence. 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 `) of the strip. + The opacity (:term:`alpha `) 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); - where 0 means front/center, -1 means to the left and 1 to the right. + For stereo, output panning works from left (-1) to center (0) and finally right (1). - To address rear speakers, you can pan to those with the higher values; - where -2 is back left, and 2 is back right. + To address rear speakers, you can pan to those with higher values, + 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 ` 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 `. - - 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) - Prevents the strip from being moved (found in the panel header). +Lock (padlock icon in 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. - Or it can be used to shorten the strip, as if you were cropping the end frame. - This is the same as adjusting the strip handles. + Positive values will move the strip's handles inwards, making it start later than the start + of the source material and stop before its end. This lets you trim down the source material + to the part you need. You can enable the + :ref:`Offsets overlay ` + 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 21 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 -such as filename and file path and various methods of interpreting these files. +The Source panel shows (and lets you change) the file which the strip points to, +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. - 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`. + The full path of the source file. 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 `. The default supported color spaces are described in detail here: :ref:`Default OpenColorIO Configuration ` Alpha Mode - If the source file has an Alpha (transparency) channel, you can choose: - - :term:`Straight Alpha` or :term:`Premultiplied Alpha` + If the source file has an Alpha (transparency) channel, you can choose between + :term:`Straight Alpha` and :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. - For example, if it is an analog video and it has even or odd interlacing fields. + Applies deinterlacing to analog video. 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 ` + If this value does not match the scene's :ref:`Frame Rate `, the perceived speed of the media will be wrong unless the speed is - :ref:`changed ` to account for the difference in frame rate. + :ref:`changed ` 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 ` to select a sound. -Path - Path to the sound file used by this :ref:`data-block ` menu. +File Path + Path to the file used by the selected sound :ref:`data-block `. Pack - Pack sound into the blend-file. + :doc:`Pack ` the sound into the blend-file. .. _bpy.types.Sound.use_memory_cache: diff --git a/manual/editors/video_sequencer/sequencer/toolbar/blade.rst b/manual/editors/video_sequencer/sequencer/toolbar/blade.rst index 50bde59a1..599eedfad 100644 --- a/manual/editors/video_sequencer/sequencer/toolbar/blade.rst +++ b/manual/editors/video_sequencer/sequencer/toolbar/blade.rst @@ -8,11 +8,24 @@ Blade :Mode: Sequencer Mode :Tool: :menuselection:`Toolbar --> Blade` - :Shortcut: :kbd:`Shift-K` + :Shortcut: :kbd:`K`, :kbd:`Shift-K` -Soft - 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. -Hard - Like *Soft Blade*, it cuts a strip in two distinct strips; - but you will not be able to drag the endpoints to show the frames past the cut of each resulting strip. +Cuts a strip in two. Specifically, it first shortens the strip so it only shows the content +up to the cut point, then adds a second strip that shows the content after the cut point. + +Splitting be done in two different ways: + +- Select the tool in the Toolbar and click a strip at the time point where you want to split it. +- Alternatively, select one or more strips, place the Playhead at the time point where you want to + split them, and press one of the keyboard shortcuts below. + +You can choose between the following split types: + +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 ` + in the Sidebar. diff --git a/manual/images/video-editing_sequencer_sidebar_proxy_panel.png b/manual/images/video-editing_sequencer_sidebar_proxy_panel.png index c7b37e81f..e9040d903 100644 --- a/manual/images/video-editing_sequencer_sidebar_proxy_panel.png +++ b/manual/images/video-editing_sequencer_sidebar_proxy_panel.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:d952ed73308c2b63f29edf03d4f7b1f4c66fa94ee4caa5f3bdd3e9b77638b391 -size 10206 +oid sha256:ca5e4edd56753fd69da17f82358956382199fa398820eecc2cb0c38021338bd2 +size 12489