1Name
2
3    ANGLE_device_cgl
4
5Name Strings
6
7    EGL_ANGLE_device_cgl
8
9Contributors
10
11    Ken Russell   (kbr 'at' google.com)
12    Geoff Lang    (geofflang 'at' google.com)
13
14Contact
15
16    Ken Russell   (kbr 'at' google.com)
17
18Status
19
20    Draft
21
22Version
23
24    Version 1, October 4, 2019
25
26Number
27
28    EGL Extension #XXX
29
30Extension Type
31
32    EGL device extension
33
34Dependencies
35
36    This extension is written against the language of EGL 1.5 as
37    modified by EGL_EXT_device_query.
38
39    EGL_EXT_device_query is required.
40
41Overview
42
43    ANGLE on macOS internally uses an OpenGL context allocated via CGL.
44    This extension defines a mapping from an EGL device to the underlying
45    CGLContextObj and its associated CGLPixelFormatObj, after it's been
46    queried from an EGL display.
47
48IP Status
49
50    No known claims.
51
52New Types
53
54    None.
55
56New Procedures and Functions
57
58    None.
59
60New Tokens
61
62    Accepted as a queried <attribute> in eglQueryDeviceAttribEXT:
63
64        EGL_CGL_CONTEXT_ANGLE           0x3485
65        EGL_CGL_PIXEL_FORMAT_ANGLE      0x3486
66
67Add a new section 2.1.3 (CGL Devices) after 2.1.2 (Devices)
68
69    On macOS the underlying CGLContextObj and CGLPixelFormatObj can be queried
70    from the EGL device. The intented purpose is to allow applications to create
71    new CGL contexts which share resources with this one.
72
73Changes to section 3.2 (Devices)
74
75    Replace the paragraph immediately following the prototype for
76    eglQueryDeviceAttribEXT:
77
78    <attribute> may be either EGL_CGLCONTEXT_DEVICE_ANGLE or
79    EGL_CGLPIXELFORMAT_DEVICE_ANGLE.  On success, EGL_TRUE is returned, and a
80    valid CGLContextObj or CGLPixelFormatObj corresponding to the EGL device is
81    returned in <value>. These objects are compatible with OpenGL and CGL API
82    functions. If the EGL device is not currently associated with a CGL context,
83    EGL_BAD_ATTRIBUTE is returned, and <value> is left unchanged.
84
85Issues
86
87    None
88
89Revision History
90
91    Version 1, October 4, 2019 (Ken Russell)
92        - Initial Draft
93    Version 2, October 8, 2019 (Ken Russell)
94        - Address feedback from Geoff Lang
95