/video_frame_interpolator

Multimedia project

Primary LanguagePython

Video Frame Interpolator

This is a project for a university subject (Multimedia).

This Python program simulates ffmpeg's minterpolate command.

Requirements

After cloning this repo, in order execute the program in your Python environment you need to install the following modules using pip:

  • numpy
  • pims
  • opencv
  • pyqt5
pip install numpy
pip install pims
pip install av
pip install opencv-python-headless
pip install pyqt5

Alternatively, you can find in Realeases the executables for Linux, Windows and MacOS.

In the repo is also provided a script used to calculate quality metrics between two videos of the same framerate, for a qualitative comparison.

Usage

python3 interpolator.py

From the GUI (written in Qt5 with pyqt5), the user can choose an input video file; in this repo is provided a file asahi.mp4, used as test during the developement of this script. Next, the user has to enter the output filename with the extension .mp4. The user can then choose the desired new framerate of the output video (higher or lower than the input one).

If the choosen framerate is higher than the input one, the user has to choose between three interpolation modes:

  • dup: all the "missing frames" in the output video are equal to their predecessor (so, the frame i is a duplicate of the frame i-1) [FAST];
  • blend: all the "missing frames" in the output video are blended calculating the mean between their predecessor and their successor (so, the frame i is extimated by an average between the frame i-1 and the frame i+1) [SLOW];
  • mci: all the "missing frames" in the output video are extimated using a motion compensated interpolation (so, the motion vectors from anchor frame i-1 to target frame i+1 are calculated to extimate the missing frame i). As for now, to extimate the Optical Flow, can be used the Gunnar-Farneback's dense method or the Lucas-Kanade sparse method [SLOWEST].

If, instead, the choosen framerate is lower than the input one, the output will result in a video with a reduced framerate (for example, from 30fps to 5fps).

When the interpolation is completed, the user can also compare the input and the output videos to see the differences between them.

Known bugs

  • Giving an odd framerate output (i.e.: 31, 63, 77, ...) results in an output with different duration than the input;
  • Commandline gives an ambiguous [ERROR:0] global /.../opencv/modules/videoio/src/cap_ffmpeg_impl.hpp (2811) open VIDEOIO/FFMPEG: Failed to initialize VideoWriter, but it actually calls it and successfully writes the output video.

TO-DOs

  • support to framerates lower than the input one (for example, convert a 30fps video in a 15fps one);
  • GUI in pyQt5;
  • mci ffmpeg command: motion compensated interpolation via motion vectors.
  • Lucas-Kanade extimation method (alternative to Gunnar-Farneback);