1[](https://waffle.io/intel/libva-utils) 2 libva-utils 3 Collection of tests to exercise VA-API as provided 4 by the libva project. VA-API requires a driver implementation 5 to operate. 6 7 Copyright (C) 2009-2016 Intel Corporation 8 9 10License 11------- 12 13Please read the COPYING file available in this package. 14 15 16Overview 17-------- 18 19libva-utils is a collection of tests to exercise VA-API in accordance 20with the libva project. A driver implementation is necessary to properly 21operate. 22 23 24Project is hosted on github: 25https://github.com/intel/libva-utils 26 27Codecs 28------ 29 30H.264 D ILK+ 31H.264 E SNB+ 32MPEG-2 D CTG+ 33VC-1 D SNB+ 34JPEG D IVB+ 35JPEG E CHV+/BSW+ 36VP8 D BDW+ 37VP8 E CHV+/BSW+ 38HEVC D CHV+/BSW+ 39HEVC E SKL+ 40VP9 D BXT+ 41HEVC 10bit D BXT+ 42VP9 10bit D KBL+ 43 44Requirements 45------------ 46 47libva API >= 0.39.4 48 49Google Test Framework Integration 50--------------------------------- 51 52Google Test recommends it be custom compiled for each project that uses it. 53Therefore, the libva-utils project tracks a subset copy of the Google 54Test Framework source code at release 1.8.0 (initially) in a test/gtest/ 55subdirectory of the project source tree. The libva-utils copy of gtest 56will only be updated to new upstream releases (or critical upstream fixes) of 57gtest, only if it is necessary. As of this writing, the last release (1.8.0) 58was August 2016, about three years after its previous release. Thus, there 59should be minimal need to update or maintain gtest within the libva-utils 60project. 61 62Building Google Test Framework Library 63-------------------------------------- 64 65The Google Test Framework is compiled as a convenience library (libgtest.la) 66within the libva-utils source tree. The rules to build libgtest.la are 67maintained in a custom makefile in the libva-intel-driver project tree 68(see test/Makefile.am). The libgtest.la library will be automatically compiled 69if the tests are enabled by configuration. 70 71 72Building Driver Tests 73--------------------- 74 75The --enable-gtests=[yes|no] configuration option is defined in configure.ac to 76enable or disable compilation of libgtest.la and the test_va_api test executable. 77The default is disabled. When the tests are enabled during configuration, the 78make command will compile the VA-API gtests and link to libgtest.la and output/install 79a single test/test_va_api or ${prefix}/bin/test_va_api executable. Hence... 80 81 "./autogen.sh --enable-gtests && make" 82 83...is a minimal example of how one might build the driver and its tests. 84 85Since all this project contains only tests, it is configurable to compile the GTest 86framework and the corresponding tests. Notice the difference when enabling 87tests on other related projects, e.g. libva-intel-driver. 88 89On the summary section after configuration something like this should be seen 90 91libva-utils - ${LIBVA_UTILS_VERSION} 92 93Libva VA-API version ............. : ${LIBVA_API_VERSION} 94Installation prefix .............. : ${prefix} 95Default driver path .............. : ${exec_prefix}/lib/dri 96Extra window systems ............. : drm x11 97Enable Gtests .................... : yes 98 99Reporting Bugs / Submit change patches 100-------------------------------------- 101 102See the contributing guide: 103 104https://github.com/intel/libva-utils/blob/master/CONTRIBUTING.md 105
){kind=link}