Remove DE_NULL from the repo

This change replaces DE_NULL and (X *)DE_NULL with nullptr with the
following sed command:

git ls-files | grep -v -e framework/delibs/debase/deDefs.h \
                       -e framework/delibs/debase/deDefs_kc_cts.h \
             | xargs -P 8 -d '\n' sed -b -i 's|\<DE_NULL\>|nullptr|g;
                                      s|([^()]*)nullptr|nullptr|g'

The definition of DE_NULL in framework/delibs/debase/deDefs.h is kept
for now to avoid unnecessary pain when DE_NULL is reintroduced by
merges from branches.  Eventually this should be deleted with new
branches being based on this change and DE_NULL not getting copy-pasted
around all the time.

Exceptions:

* In modules/gles31/functional/es31fShaderImageLoadStoreTests.cpp, the
  casts of nullptr are retained due to a limitation with ?: and
  inherited types.
* In
  external/vulkancts/modules/vulkan/compute/vktComputeCooperativeMatrixTests.cpp,
  there is a cast of nullptr to resolve a function overload.
* In
  external/vulkancts/modules/vulkan/shaderrender/vktShaderRenderTextureFunctionTests.cpp
  and
  external/vulkancts/modules/vulkan/shaderrender/vktShaderRenderDerivateTests.cpp,
  there is a cast of nullptr to resolve a constructor overload.
* In external/vulkancts/modules/vulkan/util/vktExternalMemoryUtil.cpp,
  there is a cast to vk::pt::Win32LPCWSTR.

Components: Framework, Vulkan, OpenGL
VK-GL-CTS issue: 4652

Change-Id: Ia9f3ccc251b0dbf51ccd40f267cec144d4efca7a
1112 files changed
tree: 36b77509d5cbd76df8094bbcc6e0ba41c18e015e
  1. .github/
  2. android/
  3. data/
  4. doc/
  5. execserver/
  6. executor/
  7. external/
  8. framework/
  9. modules/
  10. scripts/
  11. targets/
  12. .clang-format
  13. .editorconfig
  14. .gitattributes
  15. .gitignore
  16. AndroidGen.bp
  17. AndroidKhronosCTSGen.bp
  18. CMakeLists.txt
  19. CODE_OF_CONDUCT.md
  20. deqp_binary.lds
  21. format_all.sh
  22. LICENSE
  23. METADATA
  24. MODULE_LICENSE_APACHE2
  25. NOTICE
  26. OWNERS
  27. README.md
README.md

VK-GL-CTS README

This repository contains Khronos Conformance Testing Suite called VK-GL-CTS which originated from dEQP (drawElements Quality Program). VK-GL-CTS contains tests for several graphics APIs, including OpenGL, OpenGL ES, EGL, Vulkan, and Vulkan SC.

Documentation

Up-to-date documentation for VK-GL-CTS is available at:

The .qpa logs generated by the conformance tests may contain embedded PNG images of the results. These can be viewed with scripts/qpa_image_viewer.html, by opening the file with a web browser and following its instructions, or using the Cherry tool.

Khronos Vulkan Conformance Tests

This repository includes Khronos Vulkan CTS under external/vulkancts directory. For more information see Vulkan CTS README.

Khronos OpenGL / OpenGL ES Conformance Tests

This repository includes Khronos OpenGL / OpenGL ES CTS under external/openglcts directory. For more information see OpenGL / OpenGL ES CTS README.

Selecting a subset of targets to build by default

When configuring the source code of VK-GL-CTS for running either Vulkan Conformance Tests or OpenGL(ES) Conformance Tests as described above, CMake will generate build files that, by default on desktop platforms, will build every possible project binary. This may be undesirable due the amount of time and disk space needed to perform the build.

One way of selecting only a subset of the targets to be built is using CMake's target selection mechanism. For example, the following command will only build deqp-vk, the main Vulkan Conformance Tests binary:

cmake --build BUILD_DIRECTORY --target deqp-vk

When building only a subset of targets is the preferred default behavior for a given working copy or build directory, there's a second target selection mechanism that can be used to avoid passing the --target option every time: the SELECTED_BUILD_TARGETS CMake option. If set to a non-empty value, only the targets listed in that configuration option, separated by spaces, will be built.

For example, passing -DSELECTED_BUILD_TARGETS="deqp-vk deqp-vksc" when configuring the project will make cmake --build BUILD_DIRECTORY act as if it had been passed --target deqp-vk --target deqp-vksc as additional arguments.

IMPORTANT: Target subset selection may not have been thoroughly tested in all enviroments and situations, and it does not replace the instructions given for the purposes of creating a conformance submission.

ANGLE for Android

ANGLE can be built for Android by following the instructions here.

The resulting ANGLE shared object libraries can be linked against and embedded into dEQP.apk with the --angle-path option. This will cause dEQP.apk to use the ANGLE libraries for OpenGL ES calls, rather than the native drivers.

An ABI must be specified and the directory structure containing the ANGLE shared objects must match it so the build system can find the correct *.so files.

Assuming ANGLE shared objects are generated into ~/chromium/src/out/Release/ and dEQP.apk will be generated with --abis arm64-v8a, issue the following commands:

cd ~/chromium/src/out/Release/
mkdir arm64-v8a && cd arm64-v8a
cp ../lib*_angle.so .

The --angle-path ~/chromium/src/out/Release/ option can then be used to link against and embed the ANGLE shared object files. The full command would be:

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/