Kdenlive/Manual/Clip Menu/Stabilize/en: Difference between revisions

Latest revision as of 15:50, 2 May 2019

Other languages:

Stabilize

This menu item is available from right-click on a clip in the Project Tree or under the Project menu when a clip is selected in the Project Tree.

This feature applies image stabilization algorithms to the clip which can reduce the shakiness of a bit of footage.

In versions 0.9.8 and earlier of Kdenlive, there were two different methods of stabilization available: vstab and transcode. In version 0.9.10, the vstab method was removed leaving us with just the "transcode" method (based on this work).

This video shows a side by side comparison between vstab and transcode stabilize methods.

Stabilize

This menu item was called stabilize (transcode) in versions 0.9.2 and earlier.

Transcode Dialog in version 0.9.3 and higher

In version 0.9.3, the transcode GUI was simplified.

Based on the tooltips from this screen and the docs here, this is what all the options mean:

optzoom = use optimal zoom (calculated from transforms). Causes video to zoom until 90% of transformations are hidden. Default is checked. Hint: You can further zoom in with the zoom option.

accuracy = accuracy of shakiness detection. Should be >= shakiness factor. 1: low (fast processing). 15: high (slow processing). Default: 4. Recommended: 8.

algo = algorithm used. Checked = small measurement fields. Default = checked. Unchecked means use brute force algorithm. The brute force algorithm is deprecated and this option is not available after version 0.9.3.

maxangle = maximum angle to rotate in radians. Default = -1, which means no limit.

relative Unchecked = absolute transform (don't use this). Checked = relative transform. Default is checked. This option is not available in version 0.9.3 - it uses relative transform.

zoom - Additional zoom during transform. Percentage to zoom > 0 = zoom in, < 0 = zoom out. The zoom specified here is in addition to the optimum zoom calculated by the program when optzoom is checked. Default = 0.

shakiness How shaky is the video? And how quick is the camera? 1: little (fast processing). 10: very strong/quick (slow processing). Default = 4. Note: large values may also reduce the accuracy. This is due to the internals of the movement-detection. Typically you don't need a value greater than 7.

invert Invert the transform. Default = unchecked. Inverting the transform is pointless - leave unchecked. This option is not available in version 0.9.3.

sharpen Sharpen transformed image. Amount of sharpening: 0: no sharpening. Uses filter unsharp with 5x5 matrix. Default = 0.8.

stepsize Step size of search process. Region around minimum is scanned with 1 pixel resolution. Default = 6.

show 0 = draw nothing, 1 or 2 = show fields and transforms. Use 1 or 2 to preview what the process is going to do. example. Default = 0. Non-zero values of this parameter are not relevant in the Kdenlive implementation - use zero. This option is not available in version 0.9.3.

mincontrast Below this contrast, the field is discarded. Range 0-1. Default = 0.3. You may want to use a smaller value for a really low contrast clip.

smoothing Controls the amount of smoothing/stabilization. The larger the value for smoothing, the more camera movements are compensated. The resulting clip has a lower change in camera speed. Technically it is the number of frames for lowpass filtering = (smoothing * 2) + 1. For example, with a with 25 fps clip, a value of 12 for the smoothing factor means we would smooth over one second - 12 frames behind the current frame + the current frame (1) + 12 frames after the current frame. Default =10.

Demo of the difference here (top:3, bottom: 30).

maxshift Maximal number of pixels to translate image. Default = -1. No limit.

crop Unchecked means the border of the transformed frames contains the pixels from previous frames. Checked = black background. Default = unchecked.

Example of the effect of running stabilize - transcode from the original author - Georg Martius.

Side by side

Deshaked

Original

stabilize (vstab) - ver <=0.9.8

This is based on this work and is not available in versions of kdenlive >= 0.9.10.

This tutorial shows how to use the stabilize feature - vstab version:

The "shutter angle" setting that the narrator says he does not know what it does (1:35) ... Shutter angle is an angle that images could be maximum rotated for stabilization. see here.

@@ Line 3: / Line 3: @@
 ====Stabilize====
-This menu item is available from [[Special:MyLanguage/Kdenlive/Manual/Projects_and_Files/Project_Tree#Project Tree - Right Click Menu|right click]] on a clip in the project tree or under the [[Special:MyLanguage/Kdenlive/Manual/Project_Menu|project menu]] when a clip is selected in the project tree.
+This menu item is available from [[Special:MyLanguage/Kdenlive/Manual/Projects_and_Files/Project_Tree#Project Tree - Right Click Menu|right-click]] on a clip in the Project Tree or under the [[Special:MyLanguage/Kdenlive/Manual/Project_Menu|Project]] menu when a clip is selected in the Project Tree.
-This feature applies image stabilization algorithms to the clip which can reduce the shakiness of a shaky bit of footage.
+This feature applies image stabilization algorithms to the clip which can reduce the shakiness of a bit of footage.
-There are two different methods of stabilization available in '''Kdenlive''' - vstab and transcode.
+In versions 0.9.8 and earlier of Kdenlive, there were two different methods of stabilization available: vstab and transcode. In version 0.9.10, the vstab method was removed leaving us with just the "transcode"  method (based on [http://public.hronopik.de/vid.stab/ this] work).
 This video shows a side by side comparison between vstab and transcode stabilize methods.
@@ Line 14: / Line 14: @@
-===== stabilize (vstab) =====
-This is based on [http://vstab.sourceforge.net/ this] work.
+===== Stabilize =====
-This tutorial shows how to use the stabilize feature - vstab version:
+[[File:Kdenlive stabilise transcode.png|frame|left|Transcode Dialog in version 0.9.2]]
+This menu item was called  ''stabilize (transcode)'' in versions 0.9.2 and earlier.
-{{#ev:youtube|SWCoqZLJNgY}}
+<br clear=all>
-The "shutter angle" setting that the narrator says he does not know what it does (1:35) ... Shutter angle is an angle that images could be maximum rotated for stabilization. see [http://www.mltframework.org/bin/view/MLT/FilterVideostab here].
-===== stabilize (transcode) =====
-Transcode Dialog in ver 0.9.2
-[[File:Kdenlive stabilise transcode.png]]
+[[File:Kdenlive Stablise transcode v0.9.3.png|frame|left|Transcode Dialog in version 0.9.3 and higher]]
+In version 0.9.3, the transcode GUI was simplified.
+<br clear=all>
+Based on the tooltips from this screen and the docs [http://public.hronopik.de/vid.stab/features.php?lang=en here], this is what all the options mean:
-In version 0.9.3 the transcode GUI was simplified see image which is Transcode Dialog in ver 0.9.3
+'''optzoom''' = use optimal zoom  (calculated from transforms). Causes video to zoom until 90% of transformations are hidden.  Default is checked. Hint: You can further zoom in with the zoom option.
-[[File:Kdenlive Stablise transcode v0.9.3.png]]
+'''accuracy''' = accuracy of shakiness detection. Should be  >= shakiness factor. 1: low (fast processing). 15: high (slow processing).  Default: 4. Recommended: 8.
-Based on the tooltips from this screen and the docs [http://public.hronopik.de/vid.stab/features.php?lang=en here] this what all the options mean:
+'''algo''' = algorithm used. Checked = small measurement fields. Default = checked. Unchecked means use brute force algorithm. The brute force algorithm is deprecated and this option is not available after version 0.9.3.
-'''optzoom''' = use optimal zoom  (calculated from transforms). Causes video to zoom until 90% of transformations are hidden.  default - checked. Hint: You can further zoom in with the zoom option
+'''maxangle''' = maximum angle to rotate in radians. Default = -1, which means no limit.
-'''accuracy''' = accuracy of shakiness detection. Should be  >=shakiness factor. 1: low (fast processing) 15: high (slow processing)  - default 4. Recommended 8
+'''relative'''  Unchecked = absolute transform (don't use this). Checked = relative transform. Default is checked. This option is not available in version 0.9.3 - it uses relative transform.
-'''algo''' (= algorithm used)   checked= small measurement fields - default = checked. Unchecked means use brute force algorithm. The brute force algorithm is deprecated and this option is not available in ver 0.9.3.
+'''zoom''' - Additional zoom during transform. Percentage to zoom > 0 = zoom in, < 0 = zoom out.  The zoom specified here is in addition to the optimum zoom calculated by the program when optzoom is checked. Default = 0.
-'''maxangle''' = maximum angle to rotate - in radians. default = -1  which means no limit
+'''shakiness''' How shaky is the video? And how quick is the camera? 1: little (fast processing). 10: very strong/quick (slow processing). Default = 4. Note: large values may also reduce the accuracy. This is due to the internals of the movement-detection. Typically you don't need a value greater than 7.
-'''relative'''  unchecked = absolute transform (don't use this), checked = relative transform. Default is checked. This option is not available in ver 0.9.3 - it uses relative transform.
+'''invert''' Invert the transform. Default = unchecked. Inverting the transform is pointless - leave unchecked. This option is not available in version 0.9.3.
-'''zoom''' - Additional zoom during transform. Percentage to zoom > 0 = zoom in, <0 = zoom out.  The zoom specified here is additional to the optimum zoom calculated by the program when optzoom is checked. default = 0
+'''sharpen''' Sharpen transformed image.  Amount of sharpening: 0: no sharpening. Uses filter unsharp with 5x5 matrix. Default = 0.8.
-'''shakiness''' - how shaky is the video. and how quick is the camera? 1: little (fast processing) 10: very strong/quick (slow processing) Default = 4. Note: large values may also reduce the accuracy. This is due to the internals of the movement-detection. Typically you don't need a value greater than 7.
+'''stepsize''' Step size of search process. Region around minimum is scanned with 1 pixel resolution. Default = 6.
-'''invert''' - invert the transform. default = unchecked. Inverting the transform is pointless - leave unchecked. This option is not available in ver 0.9.3.
+'''show''' 0 = draw nothing, 1 or 2 = show fields and transforms.  Use 1 or 2 to preview what the process is going to do.   [http://public.hronopik.de/vid.stab/files/skiing_veryshaky_visualized8_short.ogv example]. Default = 0. Non-zero values of this parameter are not relevant in the '''Kdenlive''' implementation - use zero.  This option is not available in version 0.9.3.
-'''sharpen''' - sharpen transformed image.  amount of sharpening: 0: no sharpening. uses filter unsharp with 5x5 matrix Default = 0.8
+'''mincontrast''' Below this contrast, the field is discarded.  Range 0-1. Default = 0.3. You may want to use a smaller value for a really low contrast clip.
-'''stepsize''' - step size of search process, region around minimum   is scanned with 1 pixel resolution- default = 6
+'''smoothing''' Controls the amount of smoothing/stabilization. The larger the value for smoothing, the more camera movements are compensated. The resulting clip has a lower change in camera speed.
+Technically it is the number of frames for lowpass filtering = (smoothing * 2) + 1.
+For example, with a with 25 fps clip, a value of 12 for the smoothing factor means we would smooth over one second - 12 frames behind the current frame + the current frame (1) + 12 frames after the current frame. Default =10.
-'''show''' 0= draw nothing, 1 or 2 = show fields and transforms.  Use 1 or 2 to preview what the process is going to do.   [http://public.hronopik.de/vid.stab/files/skiing_veryshaky_visualized8_short.ogv example] default = 0. Non-zero values of this parameter are not relevant in the '''Kdenlive''' implementation - use zero.  This option is not available in ver 0.9.3 -
+Demo of the difference  [http://public.hronopik.de/vid.stab/files/skiing_veryshaky_short_vs_longsmoothing_above.ogv here]  (top:3, bottom: 30).
-'''mincontrast''' below this contrast - the field is discarded.  Range 0-1 default =0.3. You may want to used a smaller value for a really low contrast clip.
+'''maxshift''' Maximal number of pixels to translate image. Default = -1. No limit.
-'''smoothing''' Controls the amount of smoothing/stabilization. The larger the value for smoothing the more camera movements are compensated. The resulting clip has a lower change in camera speed.
+'''crop''' Unchecked means the border of the transformed frames contains the pixels from previous frames. Checked = black background. Default = unchecked.
-Technically it is the number of frames for lowpass filtering = smoothing * 2 + 1.
+Example of the effect of running stabilize - transcode from the original author - Georg Martius.
-Eg with a with 25 fps clip, a value of 12 for the smoothing factor means we would smooth over one second - 12 frames behind the current frame + the current frame (1) + 12 frames after the current frame. default =10
-Demo of the difference  [http://public.hronopik.de/vid.stab/files/skiing_veryshaky_short_vs_longsmoothing_above.ogv here]  (top:3, bottom: 30)
-'''maxshift''' maximal number of pixels to translate image.    (default = -1 no limit)
-'''crop''' unchecked = The border of the transformed frames contains the pixels from previous frames. Checked = black background. default = unchecked
-Example of the effect of running stabilize - transcode from the original author - Georg Martius
 Side by side
@@ Line 83: / Line 72: @@
 Original
 {{#ev:youtube|cRA5H1LYzM4}}
+===== stabilize (vstab) - ver <=0.9.8  =====
+This is based on [http://vstab.sourceforge.net/ this] work and is not available in versions of kdenlive >= 0.9.10.
+This tutorial shows how to use the stabilize feature - vstab version:
+{{#ev:youtube|SWCoqZLJNgY}}
+The "shutter angle" setting that the narrator says he does not know what it does (1:35) ... Shutter angle is an angle that images could be maximum rotated for stabilization. see [http://www.mltframework.org/bin/view/MLT/FilterVideostab here].