| JensOwen | 786bcc6 | 2014-11-01 09:28:29 -0600 | [diff] [blame] | 1 | # Explicit GL (XGL) Ecosystem Components
|
| Courtney Goeltzenleuchter | 76793e6 | 2014-11-26 09:56:28 -0700 | [diff] [blame^] | 2 | *Version 0.3, 26 Nov 2014*
|
| Courtney Goeltzenleuchter | 21f8ea5 | 2014-09-01 17:18:57 -0600 | [diff] [blame] | 3 |
|
| JensOwen | 95c6227 | 2014-11-01 13:05:43 -0600 | [diff] [blame] | 4 | This project provides *open source* components for the XGL Ecosystem.
|
| Courtney Goeltzenleuchter | 21f8ea5 | 2014-09-01 17:18:57 -0600 | [diff] [blame] | 5 |
|
| JensOwen | 95c6227 | 2014-11-01 13:05:43 -0600 | [diff] [blame] | 6 | ## Introduction
|
| 7 |
|
| 8 | The components here are being shared with the Khronos community to provide
|
| 9 | early insights into the specification of XGL and to assists those doing
|
| 10 | prototyping at this point.
|
| JensOwen | 786bcc6 | 2014-11-01 09:28:29 -0600 | [diff] [blame] | 11 |
|
| 12 | The following components are available:
|
| JensOwen | d7e99e7 | 2014-11-01 09:37:13 -0600 | [diff] [blame] | 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))
|
| JensOwen | 786bcc6 | 2014-11-01 09:28:29 -0600 | [diff] [blame] | 14 | - Proposed Reference [*Validation Layers*](https://github.com/KhronosGroup/GL-Next/tree/master/layers/)
|
| 15 | - [Object Tracker](https://github.com/KhronosGroup/GL-Next/blob/master/layers/object_track.c)
|
| 16 | - [Draw State](https://github.com/KhronosGroup/GL-Next/blob/master/layers/draw_state.c)
|
| Courtney Goeltzenleuchter | 76793e6 | 2014-11-26 09:56:28 -0700 | [diff] [blame^] | 17 | - [MemTracker](https://github.com/KhronosGroup/GL-Next/blob/master/layers/mem_tracker.c)
|
| 18 | - *GLAVE Debugger*
|
| 19 | - API Dump (generated)
|
| 20 | - APIDumpFile (generated)
|
| JensOwen | f629f22 | 2014-11-01 14:05:50 -0600 | [diff] [blame] | 21 | - [*Sample Drivers*](https://github.com/KhronosGroup/GL-Next/tree/master/icd)
|
| JensOwen | 786bcc6 | 2014-11-01 09:28:29 -0600 | [diff] [blame] | 22 | - [Common Infrastructure](https://github.com/KhronosGroup/GL-Next/tree/master/icd/common)
|
| 23 | - [Implementation for Intel GPUs](https://github.com/KhronosGroup/GL-Next/tree/master/icd/intel)
|
| 24 |
|
| Courtney Goeltzenleuchter | 76793e6 | 2014-11-26 09:56:28 -0700 | [diff] [blame^] | 25 | ## New
|
| 26 |
|
| 27 | - Added APIDumpFile to write APIDump directly to a file
|
| 28 | - Added MemTracker validation layer
|
| 29 | - Added various turn-on tests for variety of driver / compiler features
|
| 30 | - Fix to wsiPresent to avoid deadlock with X server
|
| 31 | - Misc. fixes to layers and Intel sample driver
|
| 32 |
|
| JensOwen | 95c6227 | 2014-11-01 13:05:43 -0600 | [diff] [blame] | 33 | ## How to Build and Run
|
| 34 |
|
| JensOwen | 3ceb475 | 2014-11-01 13:18:21 -0600 | [diff] [blame] | 35 | [BUILD.md](https://github.com/KhronosGroup/GL-Next/tree/master/BUILD.md)
|
| 36 | includes directions for building all the components, running the validation tests and running the demo applications.
|
| JensOwen | 95c6227 | 2014-11-01 13:05:43 -0600 | [diff] [blame] | 37 |
|
| Courtney Goeltzenleuchter | 76793e6 | 2014-11-26 09:56:28 -0700 | [diff] [blame^] | 38 | Information on how to enable the various Debug and Validation layers is in
|
| JensOwen | 95c6227 | 2014-11-01 13:05:43 -0600 | [diff] [blame] | 39 | [layers/README.md](https://github.com/KhronosGroup/GL-Next/tree/master/layers/README.md).
|
| 40 |
|
| 41 | ## References
|
| JensOwen | 786bcc6 | 2014-11-01 09:28:29 -0600 | [diff] [blame] | 42 | This version of the components are written based on the following preliminary specs and proposals:
|
| 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)
|
| 44 | - [**BIL**, version 1.0, revision 18](https://cvs.khronos.org/svn/repos/oglc/trunk/nextgen/proposals/BIL/Specification/BIL.html)
|
| Courtney Goeltzenleuchter | 76793e6 | 2014-11-26 09:56:28 -0700 | [diff] [blame^] | 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)
|
| JensOwen | e342932 | 2014-11-01 09:39:46 -0600 | [diff] [blame] | 46 | - [**Valve's Loader Proposal**, 7 Oct 2014](https://cvs.khronos.org/svn/repos/oglc/trunk/nextgen/proposals/Valve/xglLayers.pptx)
|
| Courtney Goeltzenleuchter | 21f8ea5 | 2014-09-01 17:18:57 -0600 | [diff] [blame] | 47 |
|
| JensOwen | 95c6227 | 2014-11-01 13:05:43 -0600 | [diff] [blame] | 48 | ## License
|
| Courtney Goeltzenleuchter | 21f8ea5 | 2014-09-01 17:18:57 -0600 | [diff] [blame] | 49 | This work is intended to be released as open source under a BSD-style
|
| 50 | license once the XGL specification is public. Until that time, this work
|
| 51 | is covered by the Khronos NDA governing the details of the XGL API.
|
| 52 |
|
| JensOwen | 95c6227 | 2014-11-01 13:05:43 -0600 | [diff] [blame] | 53 | ## Acknowledgements
|
| Courtney Goeltzenleuchter | 21f8ea5 | 2014-09-01 17:18:57 -0600 | [diff] [blame] | 54 | While this project is being developed by LunarG, Inc; there are many other
|
| 55 | companies and individuals making this possible: Valve Software, funding
|
| 56 | project development; Intel Corporation, providing full hardware specifications
|
| 57 | and valuable technical feedback; AMD, providing XGL spec editor contributions;
|
| 58 | ARM, contributing a Chairman for this working group within Khronos; Nvidia,
|
| 59 | providing an initial co-editor for the spec; Qualcomm for picking up the
|
| 60 | co-editor's chair; and Khronos, for providing hosting within GitHub.
|
| 61 |
|
| JensOwen | 95c6227 | 2014-11-01 13:05:43 -0600 | [diff] [blame] | 62 | ## Contact
|
| 63 | If you have questions or comments about this driver; or you would like to contribute
|
| 64 | directly to this effort, please contact us at XGL@LunarG.com; or if you prefer, via
|
| 65 | the GL Common mailing list: gl_common@khronos.org
|