Setup

The provided Docker file can be used to setup a container with everything that is needed.

docker build -t ffmpeg-video-player -f Dockerfile .

Make sure to update the -v /home/rr/DevOps/:/home/ffmpeg/DevOps parameter and run the container for the first time using:

docker run --gpus 'all,"capabilities=graphics,utility,display,video,compute"' --net host --privileged --name ffmpeg-video-player -itu ffmpeg -e NVIDIA_VISIBLE_DEVICES=all -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix:rw -v /home/rr/DevOps:/home/ffmpeg/DevOps ffmpeg-video-player /bin/bash

Compilation

Each tutorial can be compiled manually using

$ cd DevOps/ffmpeg-video-player/tutorial01
$ gcc -o tutorial01 tutorial01.c -lavutil -lavformat -lavcodec -lswscale -lz -lm
$ ./tutorial01

You can also compile all the source files in this repo using the provided CMake files using

$ cd DevOps/ffmpeg-video-player/
$ cmake CMakeLists.txt -B build
$ cd build/
$ make

As an example:

ffmpeg@rr-workstation:~/DevOps/ffmpeg-video-player$ cmake CMakeLists.txt -B build
-- The C compiler identification is GNU 11.4.0
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working C compiler: /usr/bin/cc - skipped
-- Detecting C compile features
-- Detecting C compile features - done
-- Found PkgConfig: /usr/bin/pkg-config (found version "0.29.2") 
-- Checking for one of the modules 'sdl'
-- Checking for one of the modules 'sdl2'
-- Configuring done
-- Generating done
-- Build files have been written to: /home/ffmpeg/DevOps/ffmpeg-video-player/build
ffmpeg@rr-workstation:~/DevOps/ffmpeg-video-player$ cd build/
ffmpeg@rr-workstation:~/DevOps/ffmpeg-video-player/build$ make
[  5%] Built target tutorial01-deprecated
[ 11%] Built target tutorial01
[ 16%] Built target tutorial02-deprecated
[ 22%] Built target tutorial02
[ 27%] Built target create_window
[ 33%] Built target moving_rectangle
[ 38%] Built target render_present
[ 44%] Built target tutorial03-deprecated
[ 50%] Built target tutorial03-resampled-deprecated
[ 55%] Built target tutorial03-resampled
[ 61%] Built target tutorial04-deprecated
[ 66%] Built target tutorial04-resampled-deprecated
[ 72%] Built target tutorial04-resampled
[ 77%] Built target tutorial05
[ 83%] Built target tutorial06
[ 88%] Built target tutorial07
[ 94%] Built target player-sdl
[100%] Built target player-sdl2

Then run the desired tutorial:

ffmpeg@rr-workstation:~/DevOps/ffmpeg-video-player/build$ ./tutorial01/tutorial01
Invalid arguments.

Usage: ./tutorial01 <filename> <max-frames-to-decode>

e.g: ./tutorial01/tutorial01 ../Iron_Man-Trailer_HD.mp4 200

Major opcode of failed request: 151 (GLX)

In case you end up having this error when trying to execute one of the
tutorials, then refer to the Tearing section below.

Major opcode of failed request: 152 (GLX)

In case you end up having this error when trying to execute one of the
tutorials, then you are probabily have nvidia drivers installed on your system
with no NVIDIA Hardware. To check if this is the case, just run

pacman -Qs nvidia

if you find, among the other packages, the nvidia-340xx-utils and no
NVIDIA hardware in your machine, then you have to remove it

sudo pacman -R nvidia-340xx-utils

and reboot.

Tearing

Starting from tutorial03 and noticed some screen tearing happening when playing
the media. To be precise vertical tearing.

At the time of this writing I am using Arch Linux and after making sure the
problem was not my code and some troubleshooting I managed to fix the tearing.

First of all use the following command to find out your graphic card:

[rambodrahmani@rr-workstation ~]$ lspci
00:00.0 Host bridge: Intel Corporation Intel Kaby Lake Host Bridge (rev 05)
00:01.0 PCI bridge: Intel Corporation Xeon E3-1200 v5/E3-1500 v5/6th Gen Core Processor PCIe Controller (x16) (rev 05)
00:02.0 VGA compatible controller: Intel Corporation HD Graphics 630 (rev 04)
00:14.0 USB controller: Intel Corporation 200 Series PCH USB 3.0 xHCI Controller
00:16.0 Communication controller: Intel Corporation 200 Series PCH CSME HECI #1
00:17.0 SATA controller: Intel Corporation 200 Series PCH SATA controller [AHCI mode]
00:1b.0 PCI bridge: Intel Corporation 200 Series PCH PCI Express Root Port #17 (rev f0)
00:1c.0 PCI bridge: Intel Corporation 200 Series PCH PCI Express Root Port #1 (rev f0)
00:1c.2 PCI bridge: Intel Corporation 200 Series PCH PCI Express Root Port #3 (rev f0)
00:1c.6 PCI bridge: Intel Corporation 200 Series PCH PCI Express Root Port #7 (rev f0)
00:1d.0 PCI bridge: Intel Corporation 200 Series PCH PCI Express Root Port #9 (rev f0)
00:1f.0 ISA bridge: Intel Corporation 200 Series PCH LPC Controller (Z270)
00:1f.2 Memory controller: Intel Corporation 200 Series PCH PMC
00:1f.3 Audio device: Intel Corporation 200 Series PCH HD Audio
00:1f.4 SMBus: Intel Corporation 200 Series PCH SMBus Controller
00:1f.6 Ethernet controller: Intel Corporation Ethernet Connection (2) I219-LM
01:00.0 PCI bridge: PLX Technology, Inc. PEX 8747 48-Lane, 5-Port PCI Express Gen 3 (8.0 GT/s) Switch (rev ca)
02:08.0 PCI bridge: PLX Technology, Inc. PEX 8747 48-Lane, 5-Port PCI Express Gen 3 (8.0 GT/s) Switch (rev ca)
02:10.0 PCI bridge: PLX Technology, Inc. PEX 8747 48-Lane, 5-Port PCI Express Gen 3 (8.0 GT/s) Switch (rev ca)
06:00.0 USB controller: ASMedia Technology Inc. Device 2142
07:00.0 Ethernet controller: Intel Corporation I210 Gigabit Network Connection (rev 03)
08:00.0 USB controller: ASMedia Technology Inc. Device 2142

As you can see I am using the

Intel Corporation HD Graphics 630 (rev 04)

Often it is not recommended, however for the DDX driver (which provides 2D
acceleration in Xorg), install the xf86-video-intel package.

The Intel kernel module should load fine automatically on system boot.

The SNA acceleration method causes tearing on some machines. To fix this, enable
the “TearFree” option in the driver by adding the following line to your
configuration file:

/etc/X11/xorg.conf.d/20-intel.conf

Section "Device"
 Identifier  "Intel Graphics"
 Driver      "intel"
 Option      "TearFree" "true"
EndSection

and reboot.

An FFmpeg and SDL Tutorial