Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / vulkan-validation-layers / 8e9cb3b194c9ee26bf6efa5c22021c58bf9e616e
commit8e9cb3b194c9ee26bf6efa5c22021c58bf9e616e[log] [tgz]
authorDavid Pinedo <david@lunarg.com>Tue Feb 10 15:02:08 2015 -0700
committerIan Elliott <ian@LunarG.com>Wed Feb 18 15:46:31 2015 -0700
tree5dd6e7371951b3bb476097515573e4446cd51abc
parent91e681ed1590167ffe346470316e7620c89d8c7c [diff]
Win: Build Glave replay on Windows (REQUIRES NEW CMAKE COMMAND).

Starting with this commit, building XGL on Windows requires explicitly stating
whether a "Release" or "Debug" build is desired when doing the initial cmake
command.  This is documented in the "Build.md" file.

Linux trace of cube plays to completion on windows!

Changes to the null driver:
    advertise support for both WIN WSI and X11 WSI
    added support for xglCreateBufferView
    and added a logging capability (turned off by default)

Still have some issues:
    - x11 support emulation/replacement
    - Windows null driver creates a bad device queue
    - Need to copy libraries to dir containing the .exe

Glave ext libs are now put in same dir as glvreplay64.exe...

This change only affects Windows -- on Linux the libs and
the glave replay progs were already in the same dir.

Also added a line to BUILD.md regarding the need to have XGL.dll
in PATH.
11 files changed
tree: 5dd6e7371951b3bb476097515573e4446cd51abc
  1. cmake/
  2. demos/
  3. docs/
  4. icd/
  5. include/
  6. layers/
  7. loader/
  8. tests/
  9. tools/
  10. .gitignore
  11. BUILD.md
  12. CMakeLists.txt
  13. glave-generate.py
  14. README.md
  15. update_external_sources.sh
  16. xgl-generate.py
  17. xgl-layer-generate.py
  18. xgl-win-def-file-generate.py
  19. xgl.py
  20. xgl_helper.py
README.md

Explicit GL (XGL) Ecosystem Components

Version 0.8, 04 Feb 2015

This project provides open source tools for XGL Developers.

Introduction

XGL is an Explicit API, enabling direct control over how GPUs actually work. No validation, shader recompilation, memory management or synchronization is done inside an XGL driver. Applications have full control and responsibility. Any errors in how XGL is used are likely to result in a crash. This project provides layered utility libraries to ease development and help guide developers to proven safe patterns.

New with XGL in an extensible layered architecture that enables significant innovation in tools:

  • Cross IHV support enables tools vendors to plug into a common, extensible layer architecture
  • Layered tools during development enable validating, debugging and profiling without production performance impact
  • Modular validation architecture encourages many fine-grained layers--and new layers can be added easily
  • Encourages open community of tool developers: led by Valve, LunarG, Codeplay and others
  • Customized interactive debugging and validation layers will be available together with first drivers

The components here are being shared with the Khronos community to provide insights into the specification as we approach an alpha header, and to assists those doing demos for GDC.

The following components are available:

New

  • Updated loader, driver, demos, tests and many tools to use "alpha" xgl.h (~ version 47). Supports new resource binding model, memory allocation, pixel FORMATs and other updates. APIDump layer is working with these new API elements. Glave can trace and replay the cube and tri demos. Other layers in progress.
  • Warning: Recent versions of 14.10 have REMOVED DRI 3.
    Version: 2:2.99.914-1~exp1ubuntu4.1 is known to work.

Prior updates

  • XGL API trace and capture tools. See tools/glave/README.md for details.
  • Sample driver now supports multiple render targets. Added TriangleMRT to test that functionality.
  • Added XGL_SLOT_SHADER_TEXTURE_RESOURCE to xgl.h as a descriptor slot type to work around confusion in GLSL between textures and buffers as shader resources.
  • Misc. fixes for layers and Intel sample driver
  • Added mutex to APIDump, APIDumpFile and DrawState to prevent apparent threading issues using printf
  • Fix support for {Fill,Copy}Memory
  • MemTracker can report issues to application via debug callback
  • Update test infrastructure to improve ease of writing new tests. Add image comparison feature for regression testing. Requires ImageMagick library.
  • Misc. fixes to demos, layers and Intel sample driver
  • Added mutex to APIDump, APIDumpFile and DrawState to prevent apparent threading issues using printf
  • Fix support for {Fill,Copy}Memory
  • MemTracker can report issues to application via debug callback
  • Update test infrastructure to improve ease of writing new tests. Add image comparison feature for regression testing. Requires ImageMagick library.
  • Misc. fixes to demos, layers and Intel sample driver

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 Debug and Validation layers is in layers/README.md.

References

This version of the components are written based on the following preliminary specs and proposals:

License

This work is intended to be released as open source under a BSD-style license once the XGL specification is public. Until that time, this work is covered by the Khronos NDA governing the details of the XGL API.

Acknowledgements

While this project is being developed by LunarG, Inc; there are many other companies and individuals making this possible: Valve Software, funding project development; Intel Corporation, providing full hardware specifications and valuable technical feedback; AMD, providing XGL spec editor contributions; ARM, contributing a Chairman for this working group within Khronos; Nvidia, providing an initial co-editor for the spec; Qualcomm for picking up the co-editor's chair; and Khronos, for providing hosting within GitHub.

Contact

If you have questions or comments about this driver; or you would like to contribute directly to this effort, please contact us at XGL@LunarG.com; or if you prefer, via the GL Common mailing list: gl_common@khronos.org