The Intel(R) Media Driver for VAAPI is a new VA-API (Video Acceleration API) user mode driver supporting hardware accelerated decoding, encoding, and video post processing for GEN based graphics hardware.
The Intel(R) Media Driver for VAAPI is distributed under the MIT license with portions covered under the BSD 3-clause “New” or “Revised” License. You may obtain a copy of the License at MIT & BSD-3-Clause
For Ubuntu 16.04+
apt install autoconf libtool libdrm-dev xorg xorg-dev openbox libx11-dev libgl1-mesa-glx libgl1-mesa-dev
Equivalents for other distributions should work.
<workspace> |- media-driver
$ mkdir <workspace>/build_media
$ cd <workspace>/build_media
$ cmake ../media-driver
$ make -j"$(nproc)"
$ sudo make install
This will install the following files (e.g. on Ubuntu):
-- Installing: /usr/lib/x86_64-linux-gnu/dri/iHD_drv_video.so -- Installing: /etc/profile.d/intel-media.sh -- Installing: /usr/lib/x86_64-linux-gnu/igfxcmrt64.so
For iHD_drv_video.so please export related LIBVA environment variables.
export LIBVA_DRIVERS_PATH=<path-contains-iHD_drv_video.so> export LIBVA_DRIVER_NAME=iHD
Media driver contains three components as below
Media driver supports two build types as below
CODEC | Build Types | BDW | SKL | BXT/APL | KBL | CFL | WHL | CML | ICL* |
---|---|---|---|---|---|---|---|---|---|
AVC | Full Feature Free Kernel | D/Es D | D/E/Es D/E | D/E/Es D/E | D/E/Es D/E | D/E/Es D/E | D/E/Es D/E | D/E/Es D/E | D/E/Es D/E |
MPEG-2 | Full Feature Free Kernel | D/Es D | D/Es D | D D | D/Es D | D/Es D | D/Es D | D/Es D | D/Es D |
VC-1 | Full Feature Free Kernel | D | D | D | D | D | D | D | D |
JPEG | Full Feature Free Kernel | D D | D/E D/E | D/E D/E | D/E D/E | D/E D/E | D/E D/E | D/E D/E | D/E D/E |
VP8 | Full Feature Free Kernel | D D | D D | D D | D/Es D | D/Es D | D/Es D | D/Es D | D/Es D |
HEVC 8bit | Full Feature Free Kernel | D/Es D | D/Es D | D/Es D | D/Es D | D/Es D | D/Es D | D/E/Es D/E | |
HEVC 8bit 422 | Full Feature Free Kernel | D/Es D | |||||||
HEVC 8bit 444 | Full Feature Free Kernel | D/E D/E | |||||||
HEVC 10bit | Full Feature Free Kernel | D D | D/Es D | D/Es D | D/Es D | D/Es D | D/E/Es D/E | ||
HEVC 10bit 422 | Full Feature Free Kernel | D/Es D | |||||||
HEVC 10bit 444 | Full Feature Free Kernel | D/E D/E | |||||||
VP9 8bit | Full Feature Free Kernel | D D | D D | D D | D D | D D | D/E D/E | ||
VP9 8bit 444 | Full Feature Free Kernel | D/E D/E | |||||||
VP9 10bit | Full Feature Free Kernel | D D | D D | D D | D D | D/E D/E | |||
VP9 10bit 444 | Full Feature Free Kernel | D/E D/E |
* ICL encoding is pending on i915 support on upstream, for more information, please check Known Issues and Limitations #5.
For more information, please refer to
Features | Build Types | BDW | SKL | BXT/APL | KBL | CFL | WHL | CML | ICL |
---|---|---|---|---|---|---|---|---|---|
Blending | Full Feature Free Kernel | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes Yes |
CSC (Color Space Conversion) | Full Feature Free Kernel | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes Yes |
De-interlace | Full Feature Free Kernel | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes Yes |
De-noise | Full Feature Free Kernel | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
Luma Key | Full Feature Free Kernel | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes Yes |
Mirroring | Full Feature Free Kernel | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes Yes |
ProcAmp (brightness,contrast,hue,saturation) | Full Feature Free Kernel | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes Yes |
Rotation | Full Feature Free Kernel | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes Yes |
Scaling | Full Feature Free Kernel | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes Yes |
Sharpening | Full Feature Free Kernel | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes Yes |
STD/E (Skin Tone Detect & Enhancement) | Full Feature Free Kernel | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
TCC (Total Color Control) | Full Feature Free Kernel | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
Color fill | Full Feature Free Kernel | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes Yes |
Chroma Siting | Full Feature Free Kernel | | Yes | Yes | Yes | Yes | Yes | Yes | Yes Yes |
HDR10 Tone Mapping | Full Feature Free Kernel | | | | | | | | Yes |
For more feature information, please refer to Supported video processing csc/scaling format
You could follow below build options to enable these two builds.
Intel(R) Media Driver for VAAPI is recommended to be built against gcc compiler v6.1 or later, which officially supported C++11.
SKL: Green or other incorrect color will be observed in output frames when using YV12/I420 as input format for csc/scaling/blending/rotation, etc. on Ubuntu 16.04 stock (with kernel 4.10). The issue can be addressed with the kernel patch: WaEnableYV12BugFixInHalfSliceChicken7
HuC firmware is needed for AVC/HEVC/VP9 low power encoding bitrate control, including CBR, VBR, etc. As of now, HuC firmware support is disabled in Linux kernels by default. Please, refer to i915 kernel mode driver documentation to learn how to enable it. Mind that HuC firmware support presents in the following kernels for the specified platforms:
ICL: preliminary support and may not be fully functional. It requires Linux kernel 4.17+ loaded with i915.alpha_support=1 parameter to be tried.
ICL encoding has two known issues: