Supplemental Linux® From Scratch (System V Edition) - Version #d155

Chapter 11. Graphical Applications

libvpl-tools-1.4.0

Introduction to libvpl-tools

The libvpl-tools package provides a set of utilities useful for diagnosing problems with the Intel Video Processing API. In addition, it also provides sample utilties that can be used to test the API.

[Note]

Note

This may take a while to build. Feel free to do something else while this is building.

libvpl-tools Dependencies

Required

CMake, gmmlib, intel-media-driver, libdrm, libva, libvpl-2.15.0, and Xorg Libraries

Optional

Wayland and wayland-protocols

Installation of libvpl-tools

First, fix a build failure caused by GCC-15: 

sed -i '/sample_vpp_frc_adv.h/a #include <cstdint>' tools/legacy/sample_vpp/src/sample_vpp_frc_adv.cpp

Install libvpl-tools by running the following commands: 

mkdir build &&
cd    build &&

cmake -D CMAKE_INSTALL_PREFIX=/usr     \
      -D CMAKE_BUILD_TYPE=Release      \
      -D CMAKE_SKIP_INSTALL_RPATH=ON   \
      -D BUILD_TESTS=ON                \
      -W no-dev ..                     &&
make

To test the results, issue: ctest.

Now, as the root user: 

make install

Finally, clean up the installed programs by renaming some to more appropriate names as the root user: 

mv -v /usr/bin/metrics_monitor        /usr/bin/vpl-metrics-monitor         &&
mv -v /usr/bin/sample_decode          /usr/bin/vpl-sample-decode           &&
mv -v /usr/bin/sample_encode          /usr/bin/vpl-sample-encode           &&
mv -v /usr/bin/sample_multi_transcode /usr/bin/vpl-sample-multi_transcode  &&
mv -v /usr/bin/system_analyzer        /usr/bin/vpl-system-analyzer

Command Explanations

[Note]

Note

For a full list of options and values, make sure you are in a build directory, then run cmake -LAH ...

Contents

Installed Programs: val-surface-sharing, vpl-import-export, vpl-inspect, vpl-metrics-monitor, vpl-sample-decode, vpl-sample-encode, vpl-sample-multi-transcode, vpl-sample-vpp, and vpl-system-analyzer
Installed Libraries: None
Installed Directories: /usr/{lib,share}/libvpl-tools

Short Descriptions

val-surface-sharing

tests the Intel Video Processing API to ensure that surface sharing functionality is working correctly

vpl-import-export

tests the Intel Video Processing API to ensure that the encoding and decoding functionality is working correctly

vpl-inspect

prints information about the implementation of the Intel Video Processing API used on a given system

vpl-metrics-monitor

monitors GPU usage when running video encoding/decoding operations

vpl-sample-decode

performs basic decoding tasks to demonstrate how to use the Intel Video Processing API

vpl-sample-encode

performs basic encoding tasks to demonstrate how to use the Intel Video Processing API

vpl-sample-multi-transcode

performs basic transcoding tasks to multiple video files at a time to demonstrate how to use the Intel Video Processing API

vpl-sample-vpp

performs basic tasks using the video processing procedures, demonstrating how to configure pipeline operations depending on the difference between input and output formats

vpl-system-analyzer

outputs diagnostic information about whether an Intel GPU is supported by the Video Processing API, and which of the two backends will be used at runtime