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     flushes the stream of commands for the current context and creates and
  44     inserts a sync point. 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