README.md

   1 # Explicit GL (XGL) Ecosystem Components\r
   2 *Version 0.4, 2 Dec 2014*\r
   3 \r
   4 This project provides *open source* components for the XGL Ecosystem.\r
   5 \r
   6 ## Introduction\r
   7 \r
   8 The components here are being shared with the Khronos community to provide\r
   9 early insights into the specification of XGL and to assists those doing\r
  10 prototyping at this point.\r
  11 \r
  12 The following components are available:\r
  13 - Proposed Reference [*ICD Loader*](https://github.com/KhronosGroup/GL-Next/tree/master/loader) (including [*Layer Management*](https://github.com/KhronosGroup/GL-Next/tree/master/layers/README.md))\r
  14 - Proposed Reference [*Validation Layers*](https://github.com/KhronosGroup/GL-Next/tree/master/layers/)\r
  15   - [Object Tracker](https://github.com/KhronosGroup/GL-Next/blob/master/layers/object_track.c)\r
  16   - [Draw State](https://github.com/KhronosGroup/GL-Next/blob/master/layers/draw_state.c)\r
  17   - [MemTracker](https://github.com/KhronosGroup/GL-Next/blob/master/layers/mem_tracker.c)\r
  18 - *GLAVE Debugger* \r
  19   - APIDump (generated)\r
  20   - APIDumpFile (generated)\r
  21 - [*Sample Drivers*](https://github.com/KhronosGroup/GL-Next/tree/master/icd)\r
  22   - [Common Infrastructure](https://github.com/KhronosGroup/GL-Next/tree/master/icd/common)\r
  23   - [Implementation for Intel GPUs](https://github.com/KhronosGroup/GL-Next/tree/master/icd/intel)\r
  24 \r
  25 ## New\r
  26 \r
  27 - Added mutex to APIDump, APIDumpFile and DrawState to prevent apparent threading issues using printf\r
  28 - Fix support for {Fill,Copy}Memory\r
  29 - MemTracker can report issues to application via debug callback\r
  30 - Update test infrastructure to improve ease of writing new tests. Add image comparison feature for regression testing. Requires ImageMagick library.\r
  31 - Misc. fixes to demos, layers and Intel sample driver\r
  32 \r
  33 ## How to Build and Run\r
  34 \r
  35 [BUILD.md](https://github.com/KhronosGroup/GL-Next/tree/master/BUILD.md)\r
  36 includes directions for building all the components, running the validation tests and running the demo applications.\r
  37 \r
  38 Information on how to enable the various Debug and Validation layers is in\r
  39 [layers/README.md](https://github.com/KhronosGroup/GL-Next/tree/master/layers/README.md).\r
  40 \r
  41 ## References\r
  42 This version of the components are written based on the following preliminary specs and proposals:\r
  43 - [**XGL Programers Reference**, 1 Jul 2014](https://cvs.khronos.org/svn/repos/oglc/trunk/nextgen/proposals/AMD/Explicit%20GL%20Programming%20Guide%20and%20API%20Reference.pdf)\r
  44 - [**BIL**, version 1.0, revision 18](https://cvs.khronos.org/svn/repos/oglc/trunk/nextgen/proposals/BIL/Specification/BIL.html)\r
  45 - [**IMG's Fixed Function Proposal**, 13 Nov 2014](https://cvs.khronos.org/svn/repos/oglc/trunk/nextgen/XGL/accepted/xgl_fixed_function_vertex_fetch_proposal.txt)\r
  46 - [**Valve's Loader Proposal**, 7 Oct 2014](https://cvs.khronos.org/svn/repos/oglc/trunk/nextgen/proposals/Valve/xglLayers.pptx)\r
  47 \r
  48 ## License\r
  49 This work is intended to be released as open source under a BSD-style\r
  50 license once the XGL specification is public. Until that time, this work\r
  51 is covered by the Khronos NDA governing the details of the XGL API.\r
  52 \r
  53 ## Acknowledgements\r
  54 While this project is being developed by LunarG, Inc; there are many other\r
  55 companies and individuals making this possible: Valve Software, funding\r
  56 project development; Intel Corporation, providing full hardware specifications\r
  57 and valuable technical feedback; AMD, providing XGL spec editor contributions;\r
  58 ARM, contributing a Chairman for this working group within Khronos; Nvidia,\r
  59 providing an initial co-editor for the spec; Qualcomm for picking up the\r
  60 co-editor's chair; and Khronos, for providing hosting within GitHub.\r
  61 \r
  62 ## Contact\r
  63 If you have questions or comments about this driver; or you would like to contribute\r
  64 directly to this effort, please contact us at XGL@LunarG.com; or if you prefer, via\r
  65 the GL Common mailing list: gl_common@khronos.org\r