← Back to branch summary

~mmach/netext73/webkit2gtk

« back to all changes in this revision

Viewing changes to Source/ThirdParty/ANGLE/extensions/EGL_ANGLE_device_cgl.txt

  • Committer: mmach
  • Date: 2023-06-16 17:21:37 UTC
  • Revision ID: netbit73@gmail.com-20230616172137-2rqx6yr96ga9g3kp
1

Show diffs side-by-side

added added

removed removed

Lines of Context:
Source/ThirdParty/ANGLE/extensions/EGL_ANGLE_device_cgl.txt
 
1
Name
 
2
 
 
3
    ANGLE_device_cgl
 
4
 
 
5
Name Strings
 
6
 
 
7
    EGL_ANGLE_device_cgl
 
8
 
 
9
Contributors
 
10
 
 
11
    Ken Russell   (kbr 'at' google.com)
 
12
    Geoff Lang    (geofflang 'at' google.com)
 
13
 
 
14
Contact
 
15
 
 
16
    Ken Russell   (kbr 'at' google.com)
 
17
 
 
18
Status
 
19
 
 
20
    Draft
 
21
 
 
22
Version
 
23
 
 
24
    Version 1, October 4, 2019
 
25
 
 
26
Number
 
27
 
 
28
    EGL Extension #XXX
 
29
 
 
30
Extension Type
 
31
 
 
32
    EGL device extension
 
33
 
 
34
Dependencies
 
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
 
 
41
Overview
 
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
 
 
48
IP Status
 
49
 
 
50
    No known claims.
 
51
 
 
52
New Types
 
53
 
 
54
    None.
 
55
 
 
56
New Procedures and Functions
 
57
 
 
58
    None.
 
59
 
 
60
New 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
 
 
67
Add 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
 
 
73
Changes 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
 
 
85
Issues
 
86
 
 
87
    None
 
88
 
 
89
Revision 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