layers: Strawman/dartboard new message logger

TODO: Rebase this on top of MikeS recent changes.

For your review/critique is a quick and dirty working protoptype of a
new message logger for the validation layers.  The goals were:

* No repetition of known data (i.e. types/VUIDs)
* No casts when constructing messages.
* Flexible formatting options.
* No formatting if message will not be emitted.
* A starting place for more brainstorming
* Quick and dirty

Missing:
    * even better automatic casting/overload.  (given further code
      generation)
    * detailed interface design (naming, and method vs. operator)

Messy:
    * Use of MACRO for msg generation (to compress flags and __LINE__)
    * add_x and add_h for hex and handle handling...
    * transitions between built-in type support (<< operations) and
      .add* method operations
    * Using << style formatting. (maybe not familiar to maintainers)

Pretty Cool:
    * Automatic object type detection
    * No-op output functions if messages are not enabled
    * Built-in sprintf conversions
    * Automatic update of "skip", and post to debug_log_msg in
      destructor
    * Automatic appending of validation_error_message (when avail)
    * No more PRI ...

Change-Id: I5ea8f5e95c9d765ab846038d6ceab60fc111d3d4
3 files changed
tree: b0bcfdf9185405e71801003917a6e18f5f90735f
  1. build-android/
  2. cmake/
  3. common/
  4. demos/
  5. external_revisions/
  6. icd/
  7. include/
  8. layers/
  9. libs/
  10. loader/
  11. scripts/
  12. tests/
  13. windowsRuntimeInstaller/
  14. .appveyor.yml
  15. .clang-format
  16. .gitattributes
  17. .gitignore
  18. .travis.yml
  19. BUILD.md
  20. build_windows_targets.bat
  21. CMakeLists.txt
  22. CONTRIBUTING.md
  23. COPYRIGHT.txt
  24. GOVERNANCE.md
  25. LICENSE.txt
  26. README.md
  27. update_external_sources.bat
  28. update_external_sources.sh
README.md

Vulkan Ecosystem Components

This project provides the Khronos official Vulkan ICD desktop loader and the Vulkan validation layers for Windows, Linux, Android, and MacOS.

CI Build Status

PlatformBuild Status
Linux/AndroidBuild Status
WindowsBuild status

Introduction

Vulkan is an Explicit API, enabling direct control over how GPUs actually work. By design, minimal error checking is done inside a Vulkan driver. Applications have full control and responsibility for correct operation. Any errors in how Vulkan is used can result in a crash. This project provides Vulkan validation layers that can be enabled to assist development by enabling developers to verify their applications correct use of the Vulkan API.

Vulkan supports multiple GPUs and multiple global contexts (VkInstance). The ICD loader is necessary to support multiple GPUs and VkInstance-level Vulkan commands. Additionally, the loader manages inserting Vulkan layer libraries such as validation layers between the application and the ICD.

The following components are available in this repository:

Contact Information

Information for Developing or Contributing:

Please see the CONTRIBUTING.md file in this repository for more details. Please see the GOVERNANCE.md file in this repository for repository management details.

How to Build and Run

BUILD.md Includes directions for building all components as well as running validation tests and 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.

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.