Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / deqp-deps / amber / f2691ed3dd68cd1c8239fb3b378bbf4037fc94d7
commitf2691ed3dd68cd1c8239fb3b378bbf4037fc94d7[log] [tgz]
authordan sinclair <dj2@everburning.com>Wed Nov 21 18:24:07 2018 -0500
committerGitHub <noreply@github.com>Wed Nov 21 18:24:07 2018 -0500
tree8b206077927734af91035a8f938886ab6e33568e
parent966f714f69becddc3612912ec9b375ed3aaa8e17 [diff]
Match RelWithDebInfo for MSVC builds (#85)

Update build scripts to set the correct flags for the RelWithDebInfo build.
2 files changed
tree: 8b206077927734af91035a8f938886ab6e33568e
  1. docs/
  2. include/
  3. kokoro/
  4. samples/
  5. src/
  6. tests/
  7. third_party/
  8. tools/
  9. .clang-format
  10. .gitignore
  11. AUTHORS
  12. CMakeLists.txt
  13. CODE_OF_CONDUCT.md
  14. CONTRIBUTING.md
  15. DEPS
  16. LICENSE
  17. README.md
README.md

Amber

Amber is a multi-API shader test framework.

Amber lets you capture and communicate shader bugs with the fluidity and ease of a scripting flow:

  • No graphics API programming is required.
    • WIP: Supports Vulkan and Dawn graphics APIs.
  • A single text string (or file) maps to a single graphics API pipeline test case. The text includes:
    • Input data, including buffers and images.
    • Shaders.
    • Expectations for the result of running the pipeline.
  • Shaders can be expressed in binary form (as hex), in SPIR-V assembly, or in a higher level shader language.
  • After executing the pipeline, result buffers and images can be saved to output files.

Amber is influenced by Talvos and VkRunner. The VkScript syntax matches the format used by VkRunner.

This is not an officially supported Google product.

Requirements

  • Recommended: Configure at least one target graphics API. See below.
  • Git
  • CMake
  • Ninja (or other build tool)
  • Recommended: Python, for fetching dependencies

Building

git clone git@github.com:google/amber
cd amber
./tools/git-sync-deps
mkdir -p out/Debug
cd out/Debug
cmake -GNinja ../..
ninja

Build Bots

There are a number of build bots to verify Amber continues to compile and run on the various targets. Due to bot limitations, the integration tests are not being run on the bots, just the unit tests.

Backends

Amber is designed to run against different graphics APIs. Amber will build if no graphics API is found, but will only allow verifying the syntax of the amber script files.

Currently the Vulkan and Dawn graphics APIs are supported.

Using Vulkan as a backend

A Vulkan implementation is found by CMake in the following priority order:

  • First: If an enclosing CMake project includes the Vulkan-Headers CMake project, then headers will be picked up from there.

    In this case the CMake variable Vulkan_LIBRARIES can name the Vulkan library, or a default of vulkan will be used.

  • Second: If you have CMake 3.7 or later, then the Vulkan implementation will be found from a Vulkan SDK as published by LunarG.

    Environment variables:

    • VULKAN_SDK should point to the platform-specific SDK directory that contains the include and lib directories. Example: VULKAN_SDK=$HOME/vulkan-macos-1.1.85.0/macOS
    • VK_ICD_FILENAMES should point to the ICD JSON file. Example: VK_ICD_FILENAMES=$VULKAN_SDK/etc/vulkan/icd/MoltenVK_icd.json

Using Dawn as a backend

We assume you have built Dawn from source, and have access to both the source and build trees. To build a Dawn backend for Amber, set the following CMake variables when configuring Amber:

  • Dawn_INCLUDE_DIR: The directory containing dawn/dawn_export.h (in the source tree).
  • Dawn_GEN_INCLUDE_DIR: The directory containing generated header dawn/dawncpp.h (in the build output tree).
  • Dawn_LIBRARY_DIR: The directory containing the dawn_native library (in the build output tree).

Amber Sample

The build will generate an out/Debug/amber executable which can be used to run amber scripts. The script can be used as out/Debug/amber <path to amber file>. Where, currently, the amber file is in the VkScript format.

Contributing

Please see the CONTRIBUTING and CODE_OF_CONDUCT files on how to contribute to Amber.