xref: /aosp_15_r20/external/angle/extensions/ANGLE_get_serialized_context_string.txt (revision 8975f5c5ed3d1c378011245431ada316dfb6f244)
1Name
2
3    ANGLE_get_serialized_context_string
4
5Name Strings
6
7    GL_ANGLE_get_serialized_context_string
8
9Contributors
10
11    Jamie Madill, Google
12
13Contact
14
15    Jamie Madill, Google (jmadill 'at' google.com)
16
17Status
18
19    Implemented in ANGLE.
20
21Version
22
23    Last Modified Date: April 2, 2021
24    Revision: #1
25
26Number
27
28    TBD
29
30Dependencies
31
32    OpenGL ES 2.0 is required.
33
34Overview
35
36    Adds a query for a serialized string representation of a context.
37    Useful for testing to easily compare two states.
38
39New Tokens
40
41    Accepted by the <name> parameter of glGetString:
42
43        SERIALIZED_CONTEXT_STRING_ANGLE   0x96B0
44
45Additions to Chapter 6 of the OpenGL ES 2.0 Specification (Querying GL State)
46
47    Update Section 6.1.5 "String Queries" to accept the new enum specified
48    above. The SERIALIZED_CONTEXT_STRING_ANGLE string is an implementation-
49    dependent representation of the current context state. Two contexts
50    with the same internal state are guaranteed to have the same value. Note
51    that the reverse is not true - two contexts with different states are
52    may also have the same serialized string.
53
54New State
55
56    None.
57
58Issues
59
60    1) Should two contexts with different states return different strings?
61
62    RESOLVED: We don't provide a guarantee that every state is serialized
63      into the string. This loose wording lets the extension provide
64      some additional extra validation without being overly strict and
65      making the implementation difficult. It also allow a no-op
66      implementation to satisfy the extension requirements.
67
68Revision History
69
70    2021/04/02  jmadill  Initial revision.
71
72