chuanli1 / onevpl

oneAPI Video Processing Library (oneVPL) dispatcher, tools, and examples

Video Processing Library

The oneAPI Video Processing Library (oneVPL) is a programming interface for video decoding, encoding, and processing to build portable media pipelines on CPUs, GPUs, and other accelerators.

It provides device discovery and selection in media centric and video analytics workloads and API primitives for zero-copy buffer sharing. oneVPL is backwards and cross-architecture compatible to ensure optimal execution on current and next generation hardware without source code changes.

See the oneVPL Specification for additional information. This is part of the oneAPI specification.

This repository contains the following components of oneVPL:

• Copies of the oneVPL Specification API header files. The version of the oneVPL API is listed in the mfxdefs.h file.
• oneVPL dispatcher
• Examples demonstrating API usage
• oneVPL command line tools

To use oneVPL for video processing you need to install at least one implementation. Here is a list of current implementations.

• oneVPL-cpu for use on CPU
• oneVPL-intel-gpu for use on Intel Xe graphics and newer
• Media SDK for use on legacy Intel graphics

OneVPL Architecture

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;

Loading

As shown in this diagram, the dispatcher dispatches the application to use either the VPL CPU runtime, VPL GPU runtime, or the MediaSDK GPU Runtime. We may support more implementations in the future.

oneVPL dispatcher behavior when targeting Intel GPUs

Runtime loaded by oneVPL dispatcher:

GPU	Media SDK	oneVPL
Earlier platforms, back to BDW (Broadwell)	✔️
ICL (Ice Lake)	✔️
JSL (Jasper Lake)	✔️
EHL (Elkhart Lake)	✔️
SG1	✔️
TGL (Tiger Lake)		✔️
DG1 (Iris® Xe MAX)		✔️
RKL (Rocket Lake)		✔️
ADL-S (Alder Lake S)		✔️
ADL-P (Alder Lake P)		✔️
Future platforms...		✔️

Installation

You can install oneVPL:

• from oneVPL home page as a part of Intel® oneAPI Base Toolkit.
• from source code. See Installation from Sources for details.

For more details on installation options and procedures, see the Intel® oneAPI Video Processing Library Installation Guide.

Developer Usage

Configure the Environment

If you did not install to standard system locations, you need to set up the environment, so tools like CMake and pkg-config can find the library and headers.

For Linux:

source <vpl-install-location>/share/oneVPL/env/vars.sh

For Windows:

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

Link to oneVPL with CMake

Add the following code to your CMakeLists, assuming TARGET is defined as the component that wants to use oneVPL:

if(WIN32 AND CMAKE_SIZEOF_VOID_P EQUAL 4)
 set(CMAKE_LIBRARY_ARCHITECTURE x86)
endif()
find_package(VPL REQUIRED)
target_link_libraries(${TARGET} VPL::dispatcher)

Link to oneVPL from Bash with pkg-config

The following command line illustrates how to link a simple program to oneVPL using pkg-config.

gcc program.cpp `pkg-config --cflags --libs vpl`

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.