vidstabtransform


Video stabilization/deshaking: pass 2 of 2, see for pass 1.

Read a file with transform information for each frame and apply/compensate them. Together with the filter this can be used to deshake videos. See also . It is important to also use the filter, see below.

To enable compilation of this filter you need to configure FFmpeg with --enable-libvidstab.

'input'

Set path to the file used to read the transforms. Default value is 'transforms.trf'.

'smoothing'

Set the number of frames (value*2 + 1) used for lowpass filtering the camera movements. Default value is 10.

For example a number of 10 means that 21 frames are used (10 in the past and 10 in the future) to smoothen the motion in the video. A larger value leads to a smoother video, but limits the acceleration of the camera (pan/tilt movements). 0 is a special case where a static camera is simulated.

'optalgo'

Set the camera path optimization algorithm.

Accepted values are:

'gauss'

gaussian kernel low-pass filter on camera motion (default)

'avg'

averaging on transformations

'maxshift'

Set maximal number of pixels to translate frames. Default value is -1, meaning no limit.

'maxangle'

Set maximal angle in radians (degree*PI/180) to rotate frames. Default value is -1, meaning no limit.

'crop'

Specify how to deal with borders that may be visible due to movement compensation.

Available values are:

'keep'

keep image information from previous frame (default)

'black'

fill the border black

'invert'

Invert transforms if set to 1. Default value is 0.

'relative'

Consider transforms as relative to previous frame if set to 1, absolute if set to 0. Default value is 0.

'zoom'

Set percentage to zoom. A positive value will result in a zoom-in effect, a negative value in a zoom-out effect. Default value is 0 (no zoom).

'optzoom'

Set optimal zooming to avoid borders.

Accepted values are:

'0'

disabled

'1'

optimal static zoom value is determined (only very strong movements will lead to visible borders) (default)

'2'

optimal adaptive zoom value is determined (no borders will be visible), see 'zoomspeed'

Note that the value given at zoom is added to the one calculated here.

'zoomspeed'

Set percent to zoom maximally each frame (enabled when 'optzoom' is set to 2). Range is from 0 to 5, default value is 0.25.

'interpol'

Specify type of interpolation.

Available values are:

'no'

no interpolation

'linear'

linear only horizontal

'bilinear'

linear in both directions (default)

'bicubic'

cubic in both directions (slow)

'tripod'

Enable virtual tripod mode if set to 1, which is equivalent to relative=0:smoothing=0. Default value is 0.

Use also tripod option of .

'debug'

Increase log verbosity if set to 1. Also the detected global motions are written to the temporary file 'global_motions.trf'. Default value is 0.