xref: /aosp_15_r20/external/angle/extensions/ANGLE_explicit_context_gles1.txt (revision 8975f5c5ed3d1c378011245431ada316dfb6f244)
1*8975f5c5SAndroid Build Coastguard WorkerName
2*8975f5c5SAndroid Build Coastguard Worker
3*8975f5c5SAndroid Build Coastguard Worker    ANGLE_explicit_context_gles1
4*8975f5c5SAndroid Build Coastguard Worker
5*8975f5c5SAndroid Build Coastguard WorkerName Strings
6*8975f5c5SAndroid Build Coastguard Worker
7*8975f5c5SAndroid Build Coastguard Worker    GL_ANGLE_explicit_context_gles1
8*8975f5c5SAndroid Build Coastguard Worker
9*8975f5c5SAndroid Build Coastguard WorkerContributors
10*8975f5c5SAndroid Build Coastguard Worker
11*8975f5c5SAndroid Build Coastguard Worker    Brandon Jones, Intel
12*8975f5c5SAndroid Build Coastguard Worker
13*8975f5c5SAndroid Build Coastguard WorkerContacts
14*8975f5c5SAndroid Build Coastguard Worker
15*8975f5c5SAndroid Build Coastguard Worker    Brandon Jones, Intel (brandon1.jones 'at' intel 'dot' com)
16*8975f5c5SAndroid Build Coastguard Worker
17*8975f5c5SAndroid Build Coastguard WorkerStatus
18*8975f5c5SAndroid Build Coastguard Worker
19*8975f5c5SAndroid Build Coastguard Worker    Complete.
20*8975f5c5SAndroid Build Coastguard Worker
21*8975f5c5SAndroid Build Coastguard WorkerVersion
22*8975f5c5SAndroid Build Coastguard Worker
23*8975f5c5SAndroid Build Coastguard Worker    Version 1, 2018-5-22
24*8975f5c5SAndroid Build Coastguard Worker
25*8975f5c5SAndroid Build Coastguard WorkerNumber
26*8975f5c5SAndroid Build Coastguard Worker
27*8975f5c5SAndroid Build Coastguard Worker    GL Extension XXX
28*8975f5c5SAndroid Build Coastguard Worker
29*8975f5c5SAndroid Build Coastguard WorkerDependencies
30*8975f5c5SAndroid Build Coastguard Worker
31*8975f5c5SAndroid Build Coastguard Worker    OpenGL ES 1.0 is required.
32*8975f5c5SAndroid Build Coastguard Worker
33*8975f5c5SAndroid Build Coastguard Worker    EGL_ANGLE_explicit_context is required.
34*8975f5c5SAndroid Build Coastguard Worker
35*8975f5c5SAndroid Build Coastguard WorkerOverview
36*8975f5c5SAndroid Build Coastguard Worker
37*8975f5c5SAndroid Build Coastguard Worker    This extension adds new OpenGL ES entry points that allow the user to pass the current EGL
38*8975f5c5SAndroid Build Coastguard Worker    context as a function parameter. This allows users to skip lookup of the thread's current
39*8975f5c5SAndroid Build Coastguard Worker    context upon entry.
40*8975f5c5SAndroid Build Coastguard Worker
41*8975f5c5SAndroid Build Coastguard WorkerNew Types
42*8975f5c5SAndroid Build Coastguard Worker
43*8975f5c5SAndroid Build Coastguard Worker    typedef void* GLeglContextANGLE
44*8975f5c5SAndroid Build Coastguard Worker
45*8975f5c5SAndroid Build Coastguard WorkerNew Procedures and Functions
46*8975f5c5SAndroid Build Coastguard Worker
47*8975f5c5SAndroid Build Coastguard Worker    For every OpenGL ES entry point available in OpenGL ES 1.0, an additional entry point is made
48*8975f5c5SAndroid Build Coastguard Worker    available. The entry points have the form of:
49*8975f5c5SAndroid Build Coastguard Worker
50*8975f5c5SAndroid Build Coastguard Worker    <return value> gl<entry point name>ContextANGLE(GLeglContextANGLE context, <entry point parameters>)
51*8975f5c5SAndroid Build Coastguard Worker
52*8975f5c5SAndroid Build Coastguard Worker    If a function already has an extension suffix, this form still applies.
53*8975f5c5SAndroid Build Coastguard Worker
54*8975f5c5SAndroid Build Coastguard WorkerNew Tokens
55*8975f5c5SAndroid Build Coastguard Worker
56*8975f5c5SAndroid Build Coastguard Worker    None.
57*8975f5c5SAndroid Build Coastguard Worker
58*8975f5c5SAndroid Build Coastguard WorkerAdditions to Chapter 2 of the OpenGL ES 1.0 Specification (OpenGL ES Operation)
59*8975f5c5SAndroid Build Coastguard Worker
60*8975f5c5SAndroid Build Coastguard Worker    The ContextANGLE entry points allow the user to pass the current EGL context as a function
61*8975f5c5SAndroid Build Coastguard Worker    parameter to provide better performance than looking up the current EGL context at every GL
62*8975f5c5SAndroid Build Coastguard Worker    entry point.
63*8975f5c5SAndroid Build Coastguard Worker
64*8975f5c5SAndroid Build Coastguard Worker    Calls made with an explicit context provide no additional validation for the passed context
65*8975f5c5SAndroid Build Coastguard Worker    parameter.
66*8975f5c5SAndroid Build Coastguard Worker
67*8975f5c5SAndroid Build Coastguard Worker    Calls made with an explicit context will generate errors under the same conditions as they
68*8975f5c5SAndroid Build Coastguard Worker    would without an explicit context. Any instances of undefined behaviour without specifying
69*8975f5c5SAndroid Build Coastguard Worker    an explicit context are still undefined when specifying an explicit context.
70*8975f5c5SAndroid Build Coastguard Worker
71*8975f5c5SAndroid Build Coastguard Worker    When an EGL context that is not current is explicitly passed, the resulting behavior is
72*8975f5c5SAndroid Build Coastguard Worker    undefined.
73*8975f5c5SAndroid Build Coastguard Worker
74*8975f5c5SAndroid Build Coastguard WorkerIssues
75*8975f5c5SAndroid Build Coastguard Worker
76*8975f5c5SAndroid Build Coastguard Worker    None.
77*8975f5c5SAndroid Build Coastguard Worker
78*8975f5c5SAndroid Build Coastguard WorkerRevision History
79*8975f5c5SAndroid Build Coastguard Worker
80*8975f5c5SAndroid Build Coastguard Worker    Version 1, 2018-5-22 (Brandon Jones)
81*8975f5c5SAndroid Build Coastguard Worker        - Initial draft