This project will no longer be maintained by Intel.
Intel has ceased development and contributions including, but not limited to, maintenance, bug fixes, new releases, or updates, to this project.
Intel no longer accepts patches to this project.
If you have an ongoing need to use this project, are interested in independently developing it, or would like to maintain patches for the open source software community, please create your own fork of this project.
This GitHub repository is no longer active. The core project and GPU runtime continues to be actively maintained. For CPU video processing the recommended solution is to use software codecs that are part of media frameworks such as FFMpeg and GStreamer. Intel® provides plugins for frameworks to support this usage.
The oneAPI Video Processing Library (oneVPL) CPU Implementation is a runtime implementation of oneVPL API for Intel CPUs. It provides video decode, encode, and processing capabilities that run on the CPU.
See the oneVPL Specification for additional information. This is part of the oneAPI specification.
NOTE
- While the oneVPL GPU implementations are fully functional, the CPU implementation is currently for reference only and not intended to be competitive in terms of performance or features.
- This repository will only recieve critical bug fixes. No updates to features, performance, etc. are planned.
- Use of this implementation requires installation of the dispatcher provided as part of the oneVPL base repository.
graph TD;
VPL[oneVPL Dispatcher]-->oneVPL-cpu;
VPL[oneVPL Dispatcher]-->oneVPL-intel-gpu;
VPL[oneVPL Dispatcher]-->MediaSDK;
VPL[oneVPL Dispatcher]-->Future1;
VPL[oneVPL Dispatcher]-->Future2;
This CPU implementation includes the following features:
- H.265/HEVC, H.264/AVC, MPEG2, and MJPEG decode (using libavcodec)
- AV1 decode (using libdav1d and libavcodec)
- MJPEG encode (using libavcodec)
- H.265/HEVC and AV1 encode (using Scalable Video Technology for HEVC, Scalable Video Technology for AV1, and libavcodec)
- H.264/AVC encode (using OpenH264/x264 and libavcodec)
- VPP - Crop, Resize, CSC (using libavfilter/ FFmpeg filters)
Note: H.265/HEVC, H.264, and AV1 are not available in 32-bit builds.
Codecs (+raw frame formats) supported by the CPU software implementation:
| Codec | Encode | Decode |
|---|---|---|
| MPEG2 | 8 bit | |
| 4:2:0 only | ||
| AVC/H.264 | 8 bit (OpenH264) | |
| 8/10 bit (x264) | 8/10 bit | |
| 4:2:0 only | 4:2:0 only | |
| HEVC/H.265 | 8/10 bit | 8/10 bit |
| 4:2:0 only | 4:2:0 only | |
| MJPEG | 8 bit | 8 bit |
| 4:2:0 only | 4:2:0 only | |
| AV1 | 8/10 bit | 8/10 bit |
| 4:2:0 only | 4:2:0 only |
Video processing (+raw frame formats) supported by the CPU software implementation:
| Operation | In formats | Out formats |
|---|---|---|
| Resize/Crop | I420, I010 | I420, I010 |
| BGRA | BGRA | |
| Colorspace | I420, I010 | I420, I010 |
| Conversion | BGRA | BGRA |
Note: I420 = 8 bit/420. I010=10 bit/420.
You can install oneVPL CPU implementation:
- from oneVPL home page as a part of Intel® oneAPI Base Toolkit or standalone.
See Installation from Sources for details.
If you install to standard system locations, applications can find the dispatcher library and the dispatcher's default search rules will find your CPU implementation.
Otherwise you need to set up the environment search paths. This is easiest to manage when the install location for oneVPL base is the same directory as used for the CPU implementation. In that case you can use the following steps:
For Linux:
source <vpl-install-location>/etc/vpl/vars.sh
For Windows:
<vpl-install-location>\etc\vpl\vars.bat
The oneVPL build that you installed as a prerequisite includes command line tools that use installed implementations. You can use these command line tools to process video from the command line using the CPU implementation.
All commands below assume test/content is the current directory.
-
Report implementation capabilities:
vpl-inspect -
Decode an an H.265 encoded video file:
sample-decode h265 -i cars_320x240.h265 -o out.i420 -sw -
Encode a raw video file to H.265:
sample-encode h265 -i cars_320x240.i420 -w 320 -h 240 -o out.h265
See CONTRIBUTING.md for more information.
This project is licensed under the MIT License. See the LICENSE file for details.
FFmpeg is an open source project licensed under LGPL and GPL. See https://www.ffmpeg.org/legal.html. You are solely responsible for determining if your use of FFmpeg requires any additional licenses. Intel is not responsible for obtaining any such licenses, nor liable for any licensing fees due, in connection with your use of FFmpeg.
See the Intel Security Center for information on how to report a potential security issue or vulnerability.