Skip to content
This repository has been archived by the owner on Nov 13, 2024. It is now read-only.

Latest commit

 

History

History
158 lines (110 loc) · 5.98 KB

README.md

File metadata and controls

158 lines (110 loc) · 5.98 KB
Raw

DISCONTINUATION OF PROJECT

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.

oneAPI Video Processing Library CPU Implementation

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.

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

CPU Implementation Feature/Color Format Info

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.

Installation

You can install oneVPL CPU implementation:

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>/etc/vpl/vars.sh

For Windows:

<vpl-install-location>\etc\vpl\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_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

Contributing

See CONTRIBUTING.md for more information.

License

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.

Security

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