xref: /aosp_15_r20/external/angle/extensions/ANGLE_webgl_compatibility.txt (revision 8975f5c5ed3d1c378011245431ada316dfb6f244)
1*8975f5c5SAndroid Build Coastguard WorkerName
2*8975f5c5SAndroid Build Coastguard Worker
3*8975f5c5SAndroid Build Coastguard Worker    ANGLE_webgl_compatibility
4*8975f5c5SAndroid Build Coastguard Worker
5*8975f5c5SAndroid Build Coastguard WorkerName Strings
6*8975f5c5SAndroid Build Coastguard Worker
7*8975f5c5SAndroid Build Coastguard Worker    GL_ANGLE_webgl_compatibility
8*8975f5c5SAndroid Build Coastguard Worker
9*8975f5c5SAndroid Build Coastguard WorkerContributors
10*8975f5c5SAndroid Build Coastguard Worker
11*8975f5c5SAndroid Build Coastguard Worker    Geoff Lang
12*8975f5c5SAndroid Build Coastguard Worker    James Darpinian
13*8975f5c5SAndroid Build Coastguard Worker
14*8975f5c5SAndroid Build Coastguard WorkerContact
15*8975f5c5SAndroid Build Coastguard Worker
16*8975f5c5SAndroid Build Coastguard Worker    Geoff Lang (geofflang 'at' google.com)
17*8975f5c5SAndroid Build Coastguard Worker
18*8975f5c5SAndroid Build Coastguard WorkerNotice
19*8975f5c5SAndroid Build Coastguard Worker
20*8975f5c5SAndroid Build Coastguard Worker    Copyright (c) 2016 The Khronos Group Inc. Copyright terms at
21*8975f5c5SAndroid Build Coastguard Worker        http://www.khronos.org/registry/speccopyright.html
22*8975f5c5SAndroid Build Coastguard Worker
23*8975f5c5SAndroid Build Coastguard WorkerStatus
24*8975f5c5SAndroid Build Coastguard Worker
25*8975f5c5SAndroid Build Coastguard Worker    Draft
26*8975f5c5SAndroid Build Coastguard Worker
27*8975f5c5SAndroid Build Coastguard WorkerVersion
28*8975f5c5SAndroid Build Coastguard Worker
29*8975f5c5SAndroid Build Coastguard Worker    Version 4, October 5, 2021
30*8975f5c5SAndroid Build Coastguard Worker
31*8975f5c5SAndroid Build Coastguard WorkerNumber
32*8975f5c5SAndroid Build Coastguard Worker
33*8975f5c5SAndroid Build Coastguard Worker    OpenGL ES Extension #??
34*8975f5c5SAndroid Build Coastguard Worker
35*8975f5c5SAndroid Build Coastguard WorkerDependencies
36*8975f5c5SAndroid Build Coastguard Worker
37*8975f5c5SAndroid Build Coastguard Worker    Requires OpenGL ES 2.0
38*8975f5c5SAndroid Build Coastguard Worker
39*8975f5c5SAndroid Build Coastguard Worker    Written against the OpenGL ES 2.0 specification.
40*8975f5c5SAndroid Build Coastguard Worker
41*8975f5c5SAndroid Build Coastguard Worker    Interacts with EGL_ANGLE_create_context_webgl_compatibility (or equivalent)
42*8975f5c5SAndroid Build Coastguard Worker    extension.
43*8975f5c5SAndroid Build Coastguard Worker
44*8975f5c5SAndroid Build Coastguard Worker    Interacts with the ARB_texture_rectangle/ANGLE_texture_rectangle extension.
45*8975f5c5SAndroid Build Coastguard Worker
46*8975f5c5SAndroid Build Coastguard WorkerOverview
47*8975f5c5SAndroid Build Coastguard Worker
48*8975f5c5SAndroid Build Coastguard Worker    With this extension enabled, the OpenGL ES context will have additional
49*8975f5c5SAndroid Build Coastguard Worker    features and validation to be compatible with the WebGL specification.
50*8975f5c5SAndroid Build Coastguard Worker
51*8975f5c5SAndroid Build Coastguard WorkerNew Procedures and Functions
52*8975f5c5SAndroid Build Coastguard Worker
53*8975f5c5SAndroid Build Coastguard Worker    None
54*8975f5c5SAndroid Build Coastguard Worker
55*8975f5c5SAndroid Build Coastguard Worker
56*8975f5c5SAndroid Build Coastguard WorkerNew Tokens
57*8975f5c5SAndroid Build Coastguard Worker
58*8975f5c5SAndroid Build Coastguard Worker    None
59*8975f5c5SAndroid Build Coastguard Worker
60*8975f5c5SAndroid Build Coastguard WorkerAdditions to the OpenGL ES Specification
61*8975f5c5SAndroid Build Coastguard Worker
62*8975f5c5SAndroid Build Coastguard Worker    Additional validation will be performed according to the the sections of
63*8975f5c5SAndroid Build Coastguard Worker    the WebGL specification entitled "Differences Between WebGL and OpenGL ES
64*8975f5c5SAndroid Build Coastguard Worker    2.0" and "Differences Between WebGL and OpenGL ES 3.0".
65*8975f5c5SAndroid Build Coastguard Worker
66*8975f5c5SAndroid Build Coastguard Worker    GLSL ES shaders targeting version 100 will be treated as though they were
67*8975f5c5SAndroid Build Coastguard Worker    targeting the WebGL 1 shader specification, and GLSL ES shaders targeting
68*8975f5c5SAndroid Build Coastguard Worker    version 300 as though they were targeting the WebGL 2 shader specification.
69*8975f5c5SAndroid Build Coastguard Worker
70*8975f5c5SAndroid Build Coastguard Worker    When the ANGLE_texture_rectangle extension is supported then Enable,
71*8975f5c5SAndroid Build Coastguard Worker    Disable, and IsEnabled accept the symbolic constant
72*8975f5c5SAndroid Build Coastguard Worker    TEXTURE_RECTANGLE_ANGLE, which controls whether ARB_texture_rectangle is
73*8975f5c5SAndroid Build Coastguard Worker    allowed to be used by shaders at compilation time. This is initially
74*8975f5c5SAndroid Build Coastguard Worker    enabled. WebGL implementations may want to use ARB_texture_rectangle when
75*8975f5c5SAndroid Build Coastguard Worker    compiling their own shaders but not expose the extension to WebGL user
76*8975f5c5SAndroid Build Coastguard Worker    shaders. This only affects shader compilation and not any other part of
77*8975f5c5SAndroid Build Coastguard Worker    the ANGLE_texture_rectangle extension, nor the behavior of already
78*8975f5c5SAndroid Build Coastguard Worker    compiled shaders.
79*8975f5c5SAndroid Build Coastguard Worker
80*8975f5c5SAndroid Build Coastguard WorkerNew State
81*8975f5c5SAndroid Build Coastguard Worker
82*8975f5c5SAndroid Build Coastguard Worker    None
83*8975f5c5SAndroid Build Coastguard Worker
84*8975f5c5SAndroid Build Coastguard WorkerConformance Tests
85*8975f5c5SAndroid Build Coastguard Worker
86*8975f5c5SAndroid Build Coastguard Worker    TBD
87*8975f5c5SAndroid Build Coastguard Worker
88*8975f5c5SAndroid Build Coastguard WorkerIssues
89*8975f5c5SAndroid Build Coastguard Worker
90*8975f5c5SAndroid Build Coastguard Worker    None
91*8975f5c5SAndroid Build Coastguard Worker
92*8975f5c5SAndroid Build Coastguard WorkerRevision History
93*8975f5c5SAndroid Build Coastguard Worker
94*8975f5c5SAndroid Build Coastguard Worker    Rev.    Date         Author     Changes
95*8975f5c5SAndroid Build Coastguard Worker    ----  -------------  ---------  ----------------------------------------
96*8975f5c5SAndroid Build Coastguard Worker      1   Sept 16, 2016  geofflang  Initial version
97*8975f5c5SAndroid Build Coastguard Worker      2    Nov 28, 2016  geofflang  Break the extension requests into a
98*8975f5c5SAndroid Build Coastguard Worker                                    separate extension.
99*8975f5c5SAndroid Build Coastguard Worker      3     Oct 3, 2019  jdarpinian Allow disabling ARB_texture_rectangle
100*8975f5c5SAndroid Build Coastguard Worker      4     Oct 5, 2021  jmadill    Add wording for shader specs.
101