| commit | 3c37fb3a379e41f0b9f6e8903493e43a6f70bcc7 | [log] [tgz] |
|---|---|---|
| author | Tobin Ehlis <tobine@google.com> | Wed May 24 09:31:13 2017 -0600 |
| committer | Tobin Ehlis <tobine@google.com> | Wed May 24 11:21:40 2017 -0600 |
| tree | 7cd856dfbd5e14e208c4aed5b226a7917351336c | |
| parent | 828781af7e4e7bd0e852450c6531297709331e26 [diff] |
layers:Migrate to new validation error IDs Migrate valid usage IDs to new numbers based on the string IDs that are integrated into the spec build process. The formula for mapping the string ID to the new VALIDATION_ERROR enum value is in vuid_mapping.py script. The mapping between the old IDs and the new IDs is in the file "old_vuid_to_new_mapping.txt." The vk_validation_error_database.txt file has the new IDs as well as the string-based ID for each element and a column indicating if the valid usage is in the core spec or if it requires extension(s) and is therefore in the extension spec. The error messages were shortened and no longer include a section reference. Now the link goes directly to the line in the spec where the valid usage text occurs. The base of the spec link is the core spec unless the VU requires an extension in which case the spec with all extensions is used as the base.
- layers/buffer_validation.cpp[diff]
- layers/core_validation.cpp[diff]
- layers/descriptor_sets.cpp[diff]
- layers/object_tracker.cpp[diff]
- layers/old_vuid_to_new_mapping.txt[Added - diff]
- layers/parameter_validation.cpp[diff]
- layers/spec.py[diff]
- layers/swapchain.cpp[diff]
- layers/vk_validation_error_database.txt[diff]
- layers/vk_validation_error_messages.h[diff]
- layers/vk_validation_stats.py[diff]
- layers/vuid_mapping.py[diff]
- tests/layer_validation_tests.cpp[diff]
- build-android/
- cmake/
- common/
- external_revisions/
- include/
- layers/
- loader/
- scripts/
- tests/
- windowsRuntimeInstaller/
- .appveyor.yml
- .clang-format
- .gitignore
- .travis.yml
- BUILD.md
- build_windows_targets.bat
- CMakeLists.txt
- CONTRIBUTING.md
- COPYRIGHT.txt
- LICENSE.txt
- README.md
- update_external_sources.bat
- update_external_sources.sh
Vulkan Ecosystem Components
This project provides Khronos official ICD loader and validation layers for Vulkan developers on Windows and Linux.
CI Build Status
| Platform | Build Status |
|---|---|
| Linux/Android |  |
| Windows |
Introduction
Vulkan is an Explicit API, enabling direct control over how GPUs actually work. No (or very little) validation or error checking is done inside a Vulkan driver. Applications have full control and responsibility. Any errors in how Vulkan is used often result in a crash. This project provides standard validation layers that can be enabled to ease development by helping developers verify their applications correctly use the Vulkan API.
Vulkan supports multiple GPUs and multiple global contexts (VkInstance). The ICD loader is necessary to support multiple GPUs and the VkInstance level Vulkan commands. Additionally, the loader manages inserting Vulkan layer libraries, including validation layers between the application and the ICD.
The following components are available in this repository:
- Vulkan header files
- ICD Loader
- Validation Layers
- Demos and tests for the loader and validation layers
Contributing
If you intend to contribute, the preferred work flow is for you to develop your contribution in a fork of this repo in your GitHub account and then submit a pull request. Please see the CONTRIBUTING file in this repository for more details
How to Build and Run
BUILD.md includes directions for building all the components, running the validation tests and running the demo applications.
Information on how to enable the various Validation layers is in layers/README.md.
Architecture and interface information for the loader is in loader/LoaderAndLayerInterface.md.
NOTE: Update Nvidia Drivers
- A recent glslang change exposed a bug in the texel fetch behavior on Nvidia devices under certain situations.
- Previously, we reverted the glslang change which exposed it.
- Nvidia has since resolved the issue, and we are now removing the workaround.
- Driver installs with the fix are available on their download page, just look for:
- Linux Drivers starting with version 367.35
- Windows Drivers starting at version 372.54
License
This work is released as open source under a Apache-style license from Khronos including a Khronos copyright.
See COPYRIGHT.txt for a full list of licenses used in this repository.
Acknowledgements
While this project has been developed primarily by LunarG, Inc; there are many other companies and individuals making this possible: Valve Corporation, funding project development; Google providing significant contributions to the validation layers; Khronos providing oversight and hosting of the project.