| [](https://waffle.io/intel/libva-utils) | |
| libva-utils | |
| Collection of tests to exercise VA-API as provided | |
| by the libva project. VA-API requires a driver implementation | |
| to operate. | |
| Copyright (C) 2009-2016 Intel Corporation | |
| License | |
| ------- | |
| Please read the COPYING file available in this package. | |
| Overview | |
| -------- | |
| libva-utils is a collection of tests to exercise VA-API in accordance | |
| with the libva project. A driver implementation is necessary to properly | |
| operate. | |
| Project is hosted on github: | |
| https://github.com/intel/libva-utils | |
| Codecs | |
| ------ | |
| H.264 D ILK+ | |
| H.264 E SNB+ | |
| MPEG-2 D CTG+ | |
| VC-1 D SNB+ | |
| JPEG D IVB+ | |
| JPEG E CHV+/BSW+ | |
| VP8 D BDW+ | |
| VP8 E CHV+/BSW+ | |
| HEVC D CHV+/BSW+ | |
| HEVC E SKL+ | |
| VP9 D BXT+ | |
| HEVC 10bit D BXT+ | |
| VP9 10bit D KBL+ | |
| Requirements | |
| ------------ | |
| libva API >= 0.39.4 | |
| Google Test Framework Integration | |
| --------------------------------- | |
| Google Test recommends it be custom compiled for each project that uses it. | |
| Therefore, the libva-utils project tracks a subset copy of the Google | |
| Test Framework source code at release 1.8.0 (initially) in a test/gtest/ | |
| subdirectory of the project source tree. The libva-utils copy of gtest | |
| will only be updated to new upstream releases (or critical upstream fixes) of | |
| gtest, only if it is necessary. As of this writing, the last release (1.8.0) | |
| was August 2016, about three years after its previous release. Thus, there | |
| should be minimal need to update or maintain gtest within the libva-utils | |
| project. | |
| Building Google Test Framework Library | |
| -------------------------------------- | |
| The Google Test Framework is compiled as a convenience library (libgtest.la) | |
| within the libva-utils source tree. The rules to build libgtest.la are | |
| maintained in a custom makefile in the libva-intel-driver project tree | |
| (see test/Makefile.am). The libgtest.la library will be automatically compiled | |
| if the tests are enabled by configuration. | |
| Building Driver Tests | |
| --------------------- | |
| The --enable-gtests=[yes|no] configuration option is defined in configure.ac to | |
| enable or disable compilation of libgtest.la and the test_va_api test executable. | |
| The default is disabled. When the tests are enabled during configuration, the | |
| make command will compile the VA-API gtests and link to libgtest.la and output/install | |
| a single test/test_va_api or ${prefix}/bin/test_va_api executable. Hence... | |
| "./autogen.sh --enable-gtests && make" | |
| ...is a minimal example of how one might build the driver and its tests. | |
| Since all this project contains only tests, it is configurable to compile the GTest | |
| framework and the corresponding tests. Notice the difference when enabling | |
| tests on other related projects, e.g. libva-intel-driver. | |
| On the summary section after configuration something like this should be seen | |
| libva-utils - ${LIBVA_UTILS_VERSION} | |
| Libva VA-API version ............. : ${LIBVA_API_VERSION} | |
| Installation prefix .............. : ${prefix} | |
| Default driver path .............. : ${exec_prefix}/lib/dri | |
| Extra window systems ............. : drm x11 | |
| Enable Gtests .................... : yes | |
| Reporting Bugs / Submit change patches | |
| -------------------------------------- | |
| See the contributing guide: | |
| https://github.com/intel/libva-utils/blob/master/CONTRIBUTING.md |