Supplemental Linux® From Scratch - Version #d7d6

Chapter 12. Graphical Applications

libvpl-tools-1.5.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 utilities that can be used to test the API.

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.16.0, and Xorg Libraries

Optional

Gtkmm4, Wayland, and wayland-protocols

Installation of libvpl-tools

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

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