ajunlonglive / onevpl-cpu

oneAPI Video Processing Library (oneVPL) CPU implementation

Video Processing Library CPU Implementation

The oneAPI Video Processing Library (oneVPL) provides a single video processing API for encode, decode, and video processing that works across a wide range of accelerators.

This repository contains a CPU implementation of the specification.

---

NOTE Use of this implementation requires installation of the loader provided as part of the oneVPL base repository.

---

This project is part of the larger oneAPI project. See the oneAPI Specification and oneVPL Specification for more information.

CPU Implementation Feature/Color Format Info

This CPU implementation includes the following features:

• H.265/HEVC, H.264/AVC, and MJPEG decode (using libavcodec)
• AV1 decode (using libdav1d and libavcodec)
• MJPEG encode (using libavcodec)
• H.265/HEVC and AV1 encode (using SVT-HEVC, SVT-AV1, and libavcodec)
• H.264/AVC encode (using 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
AVC/H.264	8/10 bit +	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.

Installation

You can install oneVPL CPU implementation:

• from oneVPL home page as a part of Intel® oneAPI Base Toolkit or standalone.

Installation from Source

See Installation from Sources for details.

Usage

Configure the Environment

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>/share/oneVPL/env/vars.sh

For Windows:

<vpl-install-location>\share\oneVPL\env\vars.bat

Run the Command Line Tools

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_128x96.h265 -o out.i420 -sw
  

• Encode a raw video file to H.265:

  sample-encode h265 -i cars_128x96.i420 -w 128 -h 96 -o out.h265
  

Contributing

See CONTRIBUTING.md for more information.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Security

See the Intel Security Center for information on how to report a potential security issue or vulnerability.