Misplaced Pages

This article may be too technical for most readers to understand. Please help improve it to make it understandable to non-experts, without removing the technical details. (November 2021) (Learn how and when to remove this message)

libva

Original author(s)	Intel
Initial release	2008
Stable release	2.22.0 / 2 July 2024; 6 months ago (2 July 2024)
Repository	github.com/intel/libva
Written in	C
Operating system	Linux, Android, BSD, Windows 10, Windows 11
Type	API
License	MIT License
Website	www.freedesktop.org/wiki/Software/vaapi/

Video Acceleration API (VA-API) is an open source application programming interface that allows applications such as VLC media player or GStreamer to use hardware video acceleration capabilities, usually provided by the graphics processing unit (GPU). It is implemented by the free and open-source library libva, combined with a hardware-specific driver, usually provided together with the GPU driver.

VA-API video decode/encode interface is platform and window system independent but is primarily targeted at Direct Rendering Infrastructure (DRI) in X Window System on Unix-like operating systems (including Linux, FreeBSD, Solaris), and Android, however it can potentially also be used with direct framebuffer and graphics sub-systems for video output. Accelerated processing includes support for video decoding, video encoding, subpicture blending, and rendering.

The VA-API specification was originally designed by Intel for its GMA (Graphics Media Accelerator) series of GPU hardware with the specific purpose of eventually replacing the XvMC standard as the default Unix multi-platform equivalent of Microsoft Windows DirectX Video Acceleration (DxVA) API, but today the API is no longer limited to Intel-specific hardware or GPUs. Other hardware and manufacturers can freely use this open standard API for hardware accelerated video processing with their own hardware without paying a royalty fee.

Overview

The main motivation for VA-API is to enable hardware-accelerated video decode at various entry-points (VLD, IDCT, motion compensation, deblocking) for the prevailing coding standards today (MPEG-2, MPEG-4 ASP/H.263, MPEG-4 AVC/H.264, H.265/HEVC, and VC-1/WMV3). Extending XvMC was considered, but due to its original design for MPEG-2 MotionComp only, it made more sense to design an interface from scratch that can fully expose the video decode capabilities in today's GPUs.

Supported hardware and drivers

As of 2022, VA-API is natively supported by:

• Intel Quick Sync open-source drivers for Linux
• Mesa open-source drivers for AMD and Nvidia graphics cards
• AMDGPU-PRO drivers for AMD graphics cards on Linux
• libva-vdpau-driver for cards supported by VDPAU
• Direct3D 12 implementations with the VAOn12 driver

Supported video codecs

VA-API currently supports these video codecs in the official mainline version, but note that exactly which video codecs are supported depends on the hardware and the driver's capabilities.

• MPEG-2 decode acceleration Main Profile
• VC-1 / WMV3 decode acceleration Advanced Profile
• MPEG-4 Part 2 (H.263) (a.k.a. MPEG-4 SP / MPEG-4 ASP, more commonly known as Xvid) decode acceleration
• H.264 AVC encode acceleration Main Profile
• H.264 AVC decode acceleration High Profile
  • H.264 / AVC Hardware Variable Length Decoding (VLD) - CABAC
  • H.264 / AVC Hardware Variable Length Decoding (VLD) - CAVLC
  • H.264 / AVC Hardware Inverse Transform (IT)
  • H.264 / AVC Hardware Motion Compensation (HWMC)
  • H.264 / AVC Hardware In-Loop Deblocking (ILDB)
• H.265/HEVC encode acceleration
• H.265/HEVC decode acceleration
• VP9 8-bit encode acceleration
• VP9 8-bit and 10-bit decode acceleration
• AV1 8-bit and 10-bit encode acceleration
• AV1 8-bit and 10-bit decode acceleration

Processes that can be accelerated with VA-API

Video decoding and post-processing processes that can be offloaded and accelerated if both the device drivers and GPU hardware supports them:

• Motion compensation
• Inverse discrete cosine transform
• In-loop deblocking filter
• Intra-frame prediction
• variable-length decoding, more commonly known as slice-level acceleration
• Bitstream processing (Context-adaptive variable-length coding/Context-adaptive binary arithmetic coding)

Software architecture

The current interface is window system independent, so that it can potentially be used with graphics sub-systems other than the DRI (Direct Rendering Infrastructure) in X Window System, such as direct with framebuffer, and it can work with third-party DRM (Direct Rendering Manager) libraries. In a nutshell, it is a scheme to pass various types of data buffers from the application to the GPU for decoding or encoding a compressed bit-stream.

Software supporting VA-API

• Chromium
• Bluecherry DVR client (starting from release 2.2.6)
• datarhei Restreamer real-time live video streaming
• Emby media server (starting from release 3.0.6400)
• ffmpeg, a command line tool from the FFmpeg project (starting from 3.1)
• Firefox (On Wayland since release 78 and on X11 since release 80)
• Fluendo
• Frigate NVR
• Gnash Flash / SWF player
• GStreamer through gstreamer-vaapi
• Helix media player (Linux)
• Jellyfin media server
• Kodi (formerly XBMC Media Center) (Linux)
• Kodibuntu (formerly XBMC Live) (Linux Live CD/USB operating-system)
• libavcodec
• MPlayer with custom patches and its fork mpv (native)
• MythTV (starting from release 0.25)
• OBS Studio
• OpenShot
• VLC media player (starting from release 1.1.0)
• Xine (via "xine-lib-vaapi" library) since Version 1.2.3

See also

• Distributed Codec Engine (libdce) — Texas Instruments API for the video codec engine in OMAP based embedded systems
• OpenMAX — a royalty-free cross-platform media abstraction API from the Khronos Group

References

1. "libva 2.22.0". 2 July 2024. Retrieved 2 July 2024.
2. "VA-API Video Acceleration On Intel Medfield - Phoronix". Phoronix.com. Retrieved 23 February 2019.
3. "Video4Linux2: Path to a Standardized Video Codec API" (PDF). Events.linuxfoundation.org. Archived from the original (PDF) on 6 January 2014. Retrieved 23 February 2019.
4. Nathan Willis (2009-07-01). "VA API slowly, but surely, making progress". Lwn.net.
5. "Mplayer, FFmpeg Gain VA-API Support - Phoronix". Phoronix.com. Retrieved 23 February 2019.
6. "vaapi". Freedesktop.org. Retrieved 23 February 2019.
7. ^ "Hardware video acceleration". wiki.ArchLinux.org.
8. Vilerino, Sil (2023-02-15). "Video acceleration API (VA-API) now available on Windows!". DirectX Developer Blog. Retrieved 2023-03-08.
9. ^ "Hardware/vaapi". wiki.libav.org. Archived from the original on 2017-02-01. Retrieved 2017-01-20.
10. "[Client] 2.2.6 Released – Significant CPU usage reductions included". Bluecherrydvr.com. 2 March 2017. Retrieved 23 February 2019.
11. "datarhei Restreamer".
12. "Emby Server 3.0.6400 Released". Emby.media. 29 August 2016. Retrieved 23 February 2019.
13. "Archived copy". Archived from the original on 2016-09-16. Retrieved 2016-08-31.{{cite web}}: CS1 maint: archived copy as title (link)
14. "Firefox on Fedora finally gets VA-API on Wayland". mastransky.wordpress.com. 3 June 2020. Retrieved 2020-08-19.
15. "Firefox 80 Available With VA-API On X11, WebGL Parallel Shader Compile Support". www.phoronix.com. Retrieved 2020-08-25.
16. "Fluendo".
17. "Fluendo's New Codecs Support VDPAU, VA-API - Phoronix". Phoronix.com. Retrieved 23 February 2019.
18. "Hardware Acceleration".
19. "H.264 VA-API GPU Video Acceleration For Flash - Phoronix". Phoronix.com. Retrieved 23 February 2019.
20. "Hardware-accelerated video decoding, encoding and processing on Intel graphics through VA-API". Cgit.freedesktop.org. Retrieved 23 February 2019.
21. "Mailing list entry that describes uses of VA-API". Lists.moblin.org. Retrieved 23 February 2019.
22. "RealPlayer for MID & Intel/Linux FAQ". HelixCommunity.org. Archived from the original on 2012-03-24. Retrieved 2011-05-12.
23. "Intel GPU". jellyfin.org. Retrieved 2024-12-02.
24. ^ "XBMC Gets Working Intel VA-API Support - Phoronix". Phoronix.com. Retrieved 23 February 2019.
25. "This gist contains instructions on setting up FFmpeg and Libav to use VAAPI-based hardware accelerated encoding (on supported platforms) for H.264 (and H.265 on supported hardware) video formats". Gist. Retrieved 2024-12-02.
26. "gbeauchesne / mplayer-vaapi".
27. "Release Notes - 0.25 - MythTV Official Wiki". Mythtv.org. Retrieved 23 February 2019.
28. "OBS Studio Now Supports VA-API For Video Encoding - Phoronix". www.phoronix.com. Retrieved 2020-08-06.
29. "OpenShot Library | libopenshot".
30. "VLC 1.1.0 release - VideoLAN". Videolan.org. Retrieved 23 February 2019.
31. "the xine project - News Feed". Xine-project.org. Retrieved 23 February 2019.

External links

• Official website
• Intel Media and Audio for Linux
• mobile-hw-decode
• "VA API slowly -- but surely -- making progress" – an overview from 2009
• "MPlayer, FFmpeg Gain VA-API Support" – from 2008

v t e X Window System
Architecture	Core protocol X Window selection X Window authorization X11 color names X Input Method Wayland
Extensions	X Image Extension X keyboard extension RandR X Rendering Extension Shape extension Shared memory extension X Display Manager Control Protocol X video extension X-Video Motion Compensation AIGLX GLX Multi-Pointer X Display PostScript Composite Extension Xinerama
Components and notable implementations	Display servers X.Org Server Cygwin/X X-Win32 X386 XFree86 XDarwin Xming Xsgi Xsun Xgl Xephyr XQuartz XWayland Client libraries Xlib XCB X Toolkit Intrinsics Display managers Session managers GDM KDM SDDM XDM LightDM LXDM Entrance WDM Window managers (comparison) Compositing Compiz KWin Metacity Mutter Xfwm Enlightenment Stacking 4Dwm AfterStep amiwm Blackbox CTWM cwm Fluxbox FLWM FVWM IceWM Matchbox mwm olwm Openbox Qvwm Sawfish swm tvtwm twm vtwm WindowLab Window Maker wm2 Tiling awesome dwm i3 Ion ratpoison wmii xmonad StumpWM larswm
Standards	ICCCM EWMH XDS freedesktop.org
Applications	xcalc xclock xedit xload xterm xeyes Desktop environments (comparison)

v t e Free and open-source software projects hosted by freedesktop.org
OS components	Sound PulseAudio PipeWire Graphics Compiz DRI Enchant nouveau Plymouth Wayland X.Org Server Glamor Xephyr Other Avahi D-Bus Flatpak Kmscon luit PackageKit pkg-config Systemd
Libraries	AppStream Cairo FreeType Fontconfig GStreamer libinput Mesa 3D HarfBuzz Pango Poppler Swfdec Video Acceleration API XCB Xft
Frameworks	CppUnit Open Collaboration Services (OCS) Telepathy
Meetings	Create Project Portland Project

• Application layer protocols
• Application programming interfaces
• Freedesktop.org
• Video acceleration
• Video acceleration APIs available on Linux
• X Window extensions