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:
https://opensource.org/licenses/MIT
&
https://opensource.org/licenses/BSD-3-Clause
For Ubuntu 16.04 and above
# apt install autoconf libtool libdrm-dev xorg xorg-dev openbox libx11-dev libgl1-mesa-glx libgl1-mesa-dev
Equivalents for other distributions should work.
Libva - https://github.com/intel/libva
GmmLib - https://github.com/intel/gmmlib (please check https://github.com/intel/media-driver/wiki/Comparability-with-GmmLib)
- Build and install libva master
- Build and install gmmlib master
- Get media repo and format the workspace folder as below (suggest the workspace to be a dedicated one for media driver build):
<workspace>
|- media-driver
$ mkdir <workspace>/build_media
$ cd <workspace>/build_media
$ cmake ../media-driver
$ make -j8
$ 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
BDW (Broadwell)
SKL (Skylake)
BXT (Broxton) / APL (Apollo Lake)
KBL (Kaby Lake)
CFL (Coffee Lake)
CNL (Cannonlake)
ICL (Ice Lake)
| CODEC | BDW | SKL | BXT/APL | KBL | CFL | CNL | ICL |
|---|---|---|---|---|---|---|---|
| H.264 | D/E1 | D/E1 | D/E1/E2 | D/E1/E2 | D/E1/E2 | D/E1 | D/E1/E2 |
| MPEG-2 | D/E1 | D/E1 | D | D/E1 | D/E1 | D/E1 | D/E1 |
| VC-1 | D | D | D | D | D | D | D |
| JPEG | D | D/E2 | D/E2 | D/E2 | D/E2 | D/E2 | D/E2 |
| VP8 | D | D | D | D | D | D/E1 | D/E1 |
| HEVC | D/E1 | D/E1 | D/E1 | D/E1 | D/E1 | D/E1/E2 | |
| HEVC 10bit | D | D | D | D/E1 | D/E1/E2 | ||
| VP9 | D | D | D | D | D/E2 | ||
| VP9 10bit | D | D | D | D/E2 |
D - decoding
E1 - VME based encoding
E2 - Low power encoding
| Video Processing | BDW | SKL | BXT/APL | KBL | CFL | CNL | ICL |
|---|---|---|---|---|---|---|---|
| Blending | Y | Y | Y | Y | Y | Y | Y |
| CSC (Color Space Conversion) | Y | Y | Y | Y | Y | Y | Y |
| De-interlace | Y | Y | Y | Y | Y | Y | Y |
| De-noise | Y | Y | Y | Y | Y | Y | Y |
| Luma Key | Y | Y | Y | Y | Y | Y | Y |
| Mirroring | Y | Y | Y | Y | Y | Y | Y |
| ProcAmp (brightness,contrast,hue,saturation) | Y | Y | Y | Y | Y | Y | Y |
| Rotation | Y | Y | Y | Y | Y | Y | Y |
| Scaling | Y | Y | Y | Y | Y | Y | Y |
| Sharpening | Y | Y | Y | Y | Y | Y | Y |
| STD/E (Skin Tone Detect & Enhancement) | Y | Y | Y | Y | Y | Y | Y |
| TCC (Total Color Control) | Y | Y | Y | Y | Y | Y | Y |
| Color fill | Y | Y | Y | Y | Y | Y | Y |
| Chroma Siting | N | Y | Y | Y | Y | Y | Y |
-
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 commit 0b71cea29fc29bbd8e9dd9c641fee6bd75f6827
-
HuC firmware is needed for AVC 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:
- APL, KBL: starting from kernel 4.11
- CFL: starting from kernel 4.15
-
Restriction in implementation of vaGetImage: Source format (surface) should be same with destination format (image).
-
ICL encoding and decoding require special kernel mode driver (issue#267/PR#271), please refer to i915 kernel mode driver documentation for supporting status.