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

From KDE UserBase Wiki
(Updating to match new version of source page)
(Updating to match new version of source page)
Line 3: Line 3:
====Stabilize====
====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.


In versions of kdenlive <= 0.9.8 There were two different methods of stabilization available in '''Kdenlive''' - 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).
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.
This video shows a side by side comparison between vstab and transcode stabilize methods.
Line 16: Line 16:


===== Stabilize =====
===== Stabilize =====
This menu item was called  ''stabilize (transcode)'' in versions of kdenlive <=0.9.8


[[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.
<br clear=all>
<br clear=all>




 
[[File:Kdenlive Stablise transcode v0.9.3.png|frame|left|Transcode Dialog in version 0.9.3 and higher]]
[[File:Kdenlive stabilise transcode.png|frame|left|Transcode Dialog in ver 0.9.2]]
In version 0.9.3, the transcode GUI was simplified.
 
 
 
<br clear=all>
<br clear=all>
In version 0.9.3 the transcode GUI was simplified see image which is Transcode Dialog in ver 0.9.3
[[File:Kdenlive Stablise transcode v0.9.3.png|frame|left|Transcode Dialog in ver 0.9.3 or higher]]
<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 what all the options mean:
'''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


'''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 is 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 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.


'''maxangle''' = maximum angle to rotate - in radians. default = -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 ver 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 after 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
'''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 version 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 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.


'''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 version 0.9.3.


'''show''' 0= draw nothing, 1 or 2 = show fields and transformsUse 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 -
'''sharpen''' Sharpen transformed imageAmount 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 used 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.  
'''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.


Technically it is the number of frames for lowpass filtering = smoothing * 2 + 1.  
'''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.


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
'''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  [http://public.hronopik.de/vid.stab/files/skiing_veryshaky_short_vs_longsmoothing_above.ogv here]  (top:3, bottom: 30)
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)
'''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
'''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
Example of the effect of running stabilize - transcode from the original author - Georg Martius.


Side by side
Side by side

Revision as of 14:07, 24 January 2015

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
Transcode Dialog in version 0.9.2

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.