| JensOwen | 786bcc6 | 2014-11-01 09:28:29 -0600 | [diff] [blame] | 1 | # Explicit GL (XGL) Ecosystem Components
|
| JensOwen | 95c6227 | 2014-11-01 13:05:43 -0600 | [diff] [blame] | 2 | *Version 0.2, Spinning Cube, 31 Oct 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)
|
| 17 | - *GLAVE Debugger* ([API Dump](https://github.com/KhronosGroup/GL-Next/blob/master/layers/api_dump.c) only)
|
| 18 | - [*Sample Driver*](https://github.com/KhronosGroup/GL-Next/tree/master/icd)
|
| 19 | - [Common Infrastructure](https://github.com/KhronosGroup/GL-Next/tree/master/icd/common)
|
| 20 | - [Implementation for Intel GPUs](https://github.com/KhronosGroup/GL-Next/tree/master/icd/intel)
|
| 21 |
|
| JensOwen | 95c6227 | 2014-11-01 13:05:43 -0600 | [diff] [blame] | 22 | ## How to Build and Run
|
| 23 |
|
| 24 | This release demonstrates a spinning textured cube as an example of the
|
| 25 | vertical slice of XGL functionality running on Ubuntu 14.10 with an Intel
|
| JensOwen | 3ceb475 | 2014-11-01 13:18:21 -0600 | [diff] [blame^] | 26 | GPU.
|
| 27 | [BUILD.md](https://github.com/KhronosGroup/GL-Next/tree/master/BUILD.md)
|
| 28 | 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] | 29 |
|
| 30 | Information on how to enable the API Dump and Validation layers is in
|
| 31 | [layers/README.md](https://github.com/KhronosGroup/GL-Next/tree/master/layers/README.md).
|
| 32 |
|
| 33 | ## References
|
| JensOwen | 786bcc6 | 2014-11-01 09:28:29 -0600 | [diff] [blame] | 34 | This version of the components are written based on the following preliminary specs and proposals:
|
| 35 | - [**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)
|
| 36 | - [**BIL**, version 1.0, revision 18](https://cvs.khronos.org/svn/repos/oglc/trunk/nextgen/proposals/BIL/Specification/BIL.html)
|
| 37 | - [**IMG's Fixed Function Proposal**, 28 Oct 2014](https://cvs.khronos.org/svn/repos/oglc/trunk/nextgen/proposals/IMG/xgl_vertex_input_description2_img.h)
|
| JensOwen | e342932 | 2014-11-01 09:39:46 -0600 | [diff] [blame] | 38 | - [**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] | 39 |
|
| JensOwen | 95c6227 | 2014-11-01 13:05:43 -0600 | [diff] [blame] | 40 | ## License
|
| Courtney Goeltzenleuchter | 21f8ea5 | 2014-09-01 17:18:57 -0600 | [diff] [blame] | 41 | This work is intended to be released as open source under a BSD-style
|
| 42 | license once the XGL specification is public. Until that time, this work
|
| 43 | is covered by the Khronos NDA governing the details of the XGL API.
|
| 44 |
|
| JensOwen | 95c6227 | 2014-11-01 13:05:43 -0600 | [diff] [blame] | 45 | ## Acknowledgements
|
| Courtney Goeltzenleuchter | 21f8ea5 | 2014-09-01 17:18:57 -0600 | [diff] [blame] | 46 | While this project is being developed by LunarG, Inc; there are many other
|
| 47 | companies and individuals making this possible: Valve Software, funding
|
| 48 | project development; Intel Corporation, providing full hardware specifications
|
| 49 | and valuable technical feedback; AMD, providing XGL spec editor contributions;
|
| 50 | ARM, contributing a Chairman for this working group within Khronos; Nvidia,
|
| 51 | providing an initial co-editor for the spec; Qualcomm for picking up the
|
| 52 | co-editor's chair; and Khronos, for providing hosting within GitHub.
|
| 53 |
|
| JensOwen | 95c6227 | 2014-11-01 13:05:43 -0600 | [diff] [blame] | 54 | ## Contact
|
| 55 | If you have questions or comments about this driver; or you would like to contribute
|
| 56 | directly to this effort, please contact us at XGL@LunarG.com; or if you prefer, via
|
| 57 | the GL Common mailing list: gl_common@khronos.org
|