xref: /aosp_15_r20/external/angle/extensions/ANGLE_program_cache_control.txt (revision 8975f5c5ed3d1c378011245431ada316dfb6f244)
1*8975f5c5SAndroid Build Coastguard WorkerName
2*8975f5c5SAndroid Build Coastguard Worker
3*8975f5c5SAndroid Build Coastguard Worker    ANGLE_program_cache_control
4*8975f5c5SAndroid Build Coastguard Worker
5*8975f5c5SAndroid Build Coastguard WorkerName Strings
6*8975f5c5SAndroid Build Coastguard Worker
7*8975f5c5SAndroid Build Coastguard Worker    GL_ANGLE_program_cache_control
8*8975f5c5SAndroid Build Coastguard Worker
9*8975f5c5SAndroid Build Coastguard WorkerContributors
10*8975f5c5SAndroid Build Coastguard Worker
11*8975f5c5SAndroid Build Coastguard Worker    Jamie Madill, Google
12*8975f5c5SAndroid Build Coastguard Worker
13*8975f5c5SAndroid Build Coastguard WorkerContacts
14*8975f5c5SAndroid Build Coastguard Worker
15*8975f5c5SAndroid Build Coastguard Worker    Jamie Madill (jmadill 'at' google.com)
16*8975f5c5SAndroid Build Coastguard Worker
17*8975f5c5SAndroid Build Coastguard WorkerStatus
18*8975f5c5SAndroid Build Coastguard Worker
19*8975f5c5SAndroid Build Coastguard Worker    Draft
20*8975f5c5SAndroid Build Coastguard Worker
21*8975f5c5SAndroid Build Coastguard WorkerVersion
22*8975f5c5SAndroid Build Coastguard Worker
23*8975f5c5SAndroid Build Coastguard Worker    Version 1, June 29, 2017
24*8975f5c5SAndroid Build Coastguard Worker
25*8975f5c5SAndroid Build Coastguard WorkerNumber
26*8975f5c5SAndroid Build Coastguard Worker
27*8975f5c5SAndroid Build Coastguard Worker    OpenGL ES Extension #??
28*8975f5c5SAndroid Build Coastguard Worker
29*8975f5c5SAndroid Build Coastguard WorkerDependencies
30*8975f5c5SAndroid Build Coastguard Worker
31*8975f5c5SAndroid Build Coastguard Worker    OpenGL ES 3.0 is required.
32*8975f5c5SAndroid Build Coastguard Worker
33*8975f5c5SAndroid Build Coastguard Worker    This extension is written against the wording of the OpenGL ES
34*8975f5c5SAndroid Build Coastguard Worker    3.0 specification.
35*8975f5c5SAndroid Build Coastguard Worker
36*8975f5c5SAndroid Build Coastguard WorkerOverview
37*8975f5c5SAndroid Build Coastguard Worker
38*8975f5c5SAndroid Build Coastguard Worker    With the program cache enabled, created OpenGL ES contexts will use an
39*8975f5c5SAndroid Build Coastguard Worker    internal program binary cache to save linking time. The extension allows the
40*8975f5c5SAndroid Build Coastguard Worker    application to determine if a particular Context has this feature enabled.
41*8975f5c5SAndroid Build Coastguard Worker
42*8975f5c5SAndroid Build Coastguard WorkerNew Types
43*8975f5c5SAndroid Build Coastguard Worker
44*8975f5c5SAndroid Build Coastguard Worker    None
45*8975f5c5SAndroid Build Coastguard Worker
46*8975f5c5SAndroid Build Coastguard WorkerNew Procedures and Functions
47*8975f5c5SAndroid Build Coastguard Worker
48*8975f5c5SAndroid Build Coastguard Worker    None
49*8975f5c5SAndroid Build Coastguard Worker
50*8975f5c5SAndroid Build Coastguard WorkerNew Tokens
51*8975f5c5SAndroid Build Coastguard Worker
52*8975f5c5SAndroid Build Coastguard Worker    Accepted by the <cap> parameter to IsEnabled and the <pname> parameter to
53*8975f5c5SAndroid Build Coastguard Worker    GetBooleanv, GetIntegerv, GetFloatv, and GetInteger64v:
54*8975f5c5SAndroid Build Coastguard Worker
55*8975f5c5SAndroid Build Coastguard Worker    PROGRAM_CACHE_ENABLED_ANGLE           0x93AC
56*8975f5c5SAndroid Build Coastguard Worker
57*8975f5c5SAndroid Build Coastguard WorkerAdditions to the OpenGL ES Specification:
58*8975f5c5SAndroid Build Coastguard Worker
59*8975f5c5SAndroid Build Coastguard Worker    Add to section 2.12.3 (Program Objects), p. 52, after paragraph 4:
60*8975f5c5SAndroid Build Coastguard Worker
61*8975f5c5SAndroid Build Coastguard Worker    Contexts with PROGRAM_CACHE_ENABLED_ANGLE set to TRUE will query the
62*8975f5c5SAndroid Build Coastguard Worker    internal program cache on any LinkProgram call, and re-use program binaries
63*8975f5c5SAndroid Build Coastguard Worker    if matching values are found. LinkProgram will succeed in this case. If the
64*8975f5c5SAndroid Build Coastguard Worker    binary load fails for any reason, LinkProgram will fall back to linking
65*8975f5c5SAndroid Build Coastguard Worker    normally.
66*8975f5c5SAndroid Build Coastguard Worker
67*8975f5c5SAndroid Build Coastguard WorkerIssues
68*8975f5c5SAndroid Build Coastguard Worker
69*8975f5c5SAndroid Build Coastguard Worker    None
70*8975f5c5SAndroid Build Coastguard Worker
71*8975f5c5SAndroid Build Coastguard WorkerRevision History
72*8975f5c5SAndroid Build Coastguard Worker
73*8975f5c5SAndroid Build Coastguard Worker    Rev.    Date         Author     Changes
74*8975f5c5SAndroid Build Coastguard Worker    ----  -------------  ---------  -------------------------------------------
75*8975f5c5SAndroid Build Coastguard Worker      1   June 29, 2017  jmadill    Initial version
76