- add sources.
[platform/framework/web/crosswalk.git] / src / gpu / GLES2 / extensions / CHROMIUM / CHROMIUM_sync_point.txt
1 Name
2
3     CHROMIUM_sync_point
4
5 Name Strings
6
7     GL_CHROMIUM_sync_point
8
9 Version
10
11     Last Modifed Date: February 25, 2013
12
13 Dependencies
14
15     OpenGL ES 2.0 is required.
16
17 Overview
18
19     This extension allows a client to order operations between contexts.
20
21     This extension implements a small subset of ARB_sync, with weaker
22     guarantees. In particular it doesn't ensure commands are actually executed
23     by the server, it only guarantees submission order.
24
25     It does however guarantee operation order with respect to
26     ConsumeTextureCHROMIUM and ProduceTextureCHROMIUM from
27     CHROMIUM_texture_mailbox, if present.
28
29 Issues
30
31     None
32
33 New Tokens
34
35     None
36
37 New Procedures and Functions
38
39     The command
40
41         uint InsertSyncPointCHROMIUM()
42
43     creates a sync point and inserts it into the stream of commands for the
44     current context.  The sync point acts as a fence, which is signaled when
45     previous commands have been submitted to the server, or when the context is
46     destroyed, whichever happens first. The sync point name is returned. The
47     sync point is implicitly deleted when it becomes signaled. The sync point
48     namespace is shared between all contexts on the same server, including other
49     context groups.
50
51
52     The command
53
54         void WaitSyncPointCHROMIUM(uint sync_point)
55
56     causes the current context to stop submitting commands until the specified
57     sync point becomes signaled. This is implemented as a server-side wait.
58     <sync_point> is the name of the sync point to wait for. If <sync_point>
59     isn't a valid sync point returned by InsertSyncPointCHROMIUM, or if the sync
60     point has already been deleted, the command is equivalent to a no-op and no
61     error is generated.
62
63 Errors
64
65     None.
66
67 New State
68
69     None.
70
71 Revision History
72
73     2/25/2013    Documented the extension