[Bf-docboard-svn] bf-manual: [8226] trunk/blender_docs/manual: VSE: Update speed effect doc

[Germano Cavalcante]

Revision: 8226
          https://developer.blender.org/rBM8226
Author:   mano-wii
Date:     2021-07-23 15:00:05 +0200 (Fri, 23 Jul 2021)
Log Message:
-----------
VSE: Update speed effect doc

Matches the new UI introduced in rBf013e3de81dad88

Modified Paths:
--------------
    trunk/blender_docs/manual/images/video-editing_sequencer_strips_effects_speed-control_keyframing.png
    trunk/blender_docs/manual/video_editing/sequencer/strips/effects/speed_control.rst

Modified: trunk/blender_docs/manual/images/video-editing_sequencer_strips_effects_speed-control_keyframing.png
===================================================================
(Binary files differ)

Modified: trunk/blender_docs/manual/video_editing/sequencer/strips/effects/speed_control.rst
===================================================================
--- trunk/blender_docs/manual/video_editing/sequencer/strips/effects/speed_control.rst	2021-07-23 02:30:39 UTC (rev 8225)
+++ trunk/blender_docs/manual/video_editing/sequencer/strips/effects/speed_control.rst	2021-07-23 13:00:05 UTC (rev 8226)
@@ -5,10 +5,9 @@
 *******************
 
 Speed Control time-warps the strip, making it play faster or slower than it normally would.
-A *Global Speed* less than 1.0 makes the strip play slower; greater than 1.0
-makes it play faster. Playing faster means that some frames are skipped,
+Playing faster means that some frames are skipped,
 and the strip will run out of frames before the end frame.
-When the strip runs out of frames to display, it will just keep repeating the last one;
+When the strip runs out of frames to display, it will just keep repeating the last one
 action will appear to freeze. To avoid this,
 position the next strip under the original at a point where you want the motion to continue.
 
@@ -16,34 +15,28 @@
 Options
 =======
 
-Stretch to Input Strip Length
+Stretch
    Automatically calculates the *Speed Factor* based on the length of the input strip.
    So if you make a strip 1/2 the original size the sequence will play back at 2 times the speed.
 
-Use as Speed
-   Calculates the scale value based on a *Speed Factor*.
+Multiply
+   Multiplies the current speed of the sequence by a *Factor*.
+   So, a value of 0.5 will make the sequence half as fast while 2 would make the sequence twice as fast.
 
    .. note::
 
       You will have to manually re-adjust the length of the strip accordingly.
 
-   Speed Factor
-      Multiplies the current speed of the sequence by this value.
-      So, a value of 0.5 will make the sequence half as fast while 2 would make the sequence twice as fast.
-
 Frame Number
    Specifies a frame to remap the current frame to,
    for example, setting this value to 50 displays the 50th frame.
    This can then be manually :doc:`keyframed </animation/keyframes/index>` to recreate the animation.
 
-   Scale to Length
-      Maps the frame range on a 0-1 scale. For example, using this and a *Frame Number*
-      of 0.5 will select the frame halfway through the sequence.
+Length
+   Maps the frame range on a 0%-100% scale. For example, using this and a value of 50%
+   will select the frame halfway through the sequence.
 
-Multiply Speed
-   A multiplier applied after all other calculations.
-
-Frame Interpolation
+Interpolation
    Crossfades between frames to reduce screen tearing when the speed is slower than the original frame rate.
 
 
@@ -57,8 +50,8 @@
 You need to affect the speed of the video clip without affecting the overall frame rate.
 Select the clip and :menuselection:`Add --> Effect --> Speed Control` effect strip.
 Click to drop it and press :kbd:`N` to get the Properties.
-Uncheck the *Stretch to input strip length* option in the Effect Strip section.
-Set the Speed factor to be the factor by which you want to adjust the speed.
+Choose the *Multiply* option in the Effect Strip section.
+Set the Multiply Factor to be the factor by which you want to adjust the speed.
 To cut the displayed speed by 50%, enter 0.5.
 Now, a 275-frame clip will play at half speed, and thus display only the first 137 frames.
 
@@ -81,11 +74,10 @@
    Keyframing the Frame number.
 
 To get even finer control over your clip timing, you can use curves!
-While it is possible to keyframe the Speed factor,
+While it is possible to keyframe the Multiply factor,
 usually you want to keyframe the Frame number directly.
 
-Uncheck *Stretch to input strip length* and uncheck *Use as speed*.
-You now have a Frame number field which you can keyframe.
+Choose the *Frame Number* option. You now have a Frame number field which you can keyframe.
 If you want the strip to animate **at all** you will have to insert some keyframes,
 otherwise it will look like a still. In most cases you will want to use the Graph editor view
 to set the curve interpolation to Linear since the default Bézier will rarely be what you want.
@@ -104,9 +96,9 @@
 You can use the speed control to change the frame rate in frames per second (fps) of a video.
 If you are rendering your video to a sequence set,
 you can effectively increase or decrease the number of individual image files created,
-by using a Global Speed value less than or greater than one, respectively. For example,
+by using a Multiply value less than or greater than one, respectively. For example,
 if you captured a five-minute video at 30 fps and wanted to transfer that to film,
-which runs at 24 fps, you would enter a Global Speed of 30/24, or 1.25
+which runs at 24 fps, you would enter a Multiply Factor of 30/24, or 1.25
 (and Enable Frame Blending to give that film blur feel).
 Instead of producing ``5 × 60 × 30 = 9000`` frames,
 Blender would produce ``9000 / 1.25 = 7200 = 5 × 60 × 24`` frames.