1dEQP README 2=========== 3 4This repository contains a GPU testing suite called dEQP (drawElements Quality Program). 5dEQP contains tests for several graphics APIs, including OpenGL ES, EGL, and Vulkan. 6 7Documentation 8------------- 9 10Up-to-date documentation for dEQP is available at: 11 12* [The VK-GL-CTS wiki for Khronos members](https://gitlab.khronos.org/Tracker/vk-gl-cts/wikis/home) 13* [The VK-GL-CTS wiki for non-Khronos members](https://github.com/KhronosGroup/VK-GL-CTS/wiki) 14 15The .qpa logs generated by the conformance tests may contain embedded PNG images of the results. 16These can be viewed with `scripts/qpa_image_viewer.html`, by opening the file 17with a web browser and following its instructions, or using the 18[Cherry](https://android.googlesource.com/platform/external/cherry/+/master) 19tool. 20 21Khronos Vulkan Conformance Tests 22-------------------------------- 23 24This repository includes Khronos Vulkan CTS under `external/vulkancts` directory. 25For more information see [Vulkan CTS README](external/vulkancts/README.md). 26 27Khronos OpenGL / OpenGL ES Conformance Tests 28-------------------------------- 29 30This repository includes Khronos OpenGL / OpenGL ES CTS under `external/openglcts` directory. 31For more information see [OpenGL / OpenGL ES CTS README](external/openglcts/README.md). 32 33ANGLE for Android 34-------------------------------- 35 36ANGLE can be built for Android by following the instructions 37[here](https://chromium.googlesource.com/angle/angle.git/+/HEAD/doc/DevSetup.md#building-angle-for-android). 38 39The resulting ANGLE shared object libraries can be linked against and embedded into `dEQP.apk` with 40the `--angle-path` option. This will cause `dEQP.apk` to use the ANGLE libraries for OpenGL ES 41calls, rather than the native drivers. 42 43An ABI must be specified and the directory structure containing the ANGLE shared objects must match 44it so the build system can find the correct `*.so` files. 45 46Assuming ANGLE shared objects are generated into `~/chromium/src/out/Release/` and `dEQP.apk` will 47be generated with `--abis arm64-v8a`, issue the following commands: 48 49 cd ~/chromium/src/out/Release/ 50 mkdir arm64-v8a && cd arm64-v8a 51 cp ../lib*_angle.so . 52 53The `--angle-path ~/chromium/src/out/Release/` option can then be used to link against and embed the 54ANGLE shared object files. The full command would be: 55 56 python scripts/android/build_apk.py --sdk <path to Android SDK> --ndk <path to Android NDK> --abis arm64-v8a --angle-path ~/chromium/src/out/Release/ 57