xref: /aosp_15_r20/external/angle/extensions/EGL_ANGLE_swap_with_frame_token.txt (revision 8975f5c5ed3d1c378011245431ada316dfb6f244)
1Name
2
3    ANGLE_swap_with_frame_token
4
5Name Strings
6
7    EGL_ANGLE_swap_with_frame_token
8
9Contributors
10
11    Jamie Madill
12
13Contacts
14
15    Jamie Madill, Google Inc. (jmadill 'at' google.com)
16
17Status
18
19    Draft
20
21Version
22
23    Version 1, November 3, 2019
24
25Number
26
27    EGL Extension #??
28
29Dependencies
30
31    This extension is written against the wording of the EGL 1.5
32    Specification.
33
34Overview
35
36    This extension allows an application that uses a Google Games
37    Platform surface to associate a Google Games Platform frame token
38    with an eglSwapBuffers operation.
39
40    It is based on the Vulkan extension VK_GGP_frame_token.
41
42New Types
43
44    This is a 64-bit unsigned type that represents a GGP frame token.
45
46    typedef khronos_uint64_t EGLFrameTokenANGLE;
47
48New Procedures and Functions
49
50    EGLBoolean eglSwapBuffersWithFrameTokenANGLE(
51        EGLDisplay dpy,
52        EGLSurface surface,
53        EGLFrameTokenANGLE frametoken);
54
55New Tokens
56
57    None
58
59Additions to the EGL 1.5 Specification
60
61    Add the following to section 3.10.1 "Posting to a Window":
62
63    A Google Games Platform frame token can be specified when posting a color
64    buffer to a window by calling
65
66        EGLBoolean eglSwapBuffersWithFrameTokenANGLE(
67            EGLDisplay dpy,
68            EGLSurface surface,
69            EGLFrameTokenANGLE frametoken);
70
71    The behaviour of eglSwapBuffersWithFrameTokenANGLE is identical to that
72    of eglSwapBuffers except that the behaviour is undefined when <frametoken>
73    is not a valid GgpFrameToken.
74
75Issues
76
77    None yet.
78
79Revision History
80
81    Rev.    Date         Author     Changes
82    ----  -------------  ---------  ----------------------------------------
83      1   Nov 3, 2019    jmadill    Initial version
84