Index: gpu/GLES2/extensions/CHROMIUM/EGL_CHROMIUM_get_sync_values.txt |
diff --git a/gpu/GLES2/extensions/CHROMIUM/EGL_CHROMIUM_get_sync_values.txt b/gpu/GLES2/extensions/CHROMIUM/EGL_CHROMIUM_get_sync_values.txt |
deleted file mode 100644 |
index d95b348c8450073c564ef10a9c83deffc9a6d061..0000000000000000000000000000000000000000 |
--- a/gpu/GLES2/extensions/CHROMIUM/EGL_CHROMIUM_get_sync_values.txt |
+++ /dev/null |
@@ -1,131 +0,0 @@ |
-Name |
- |
- CHROMIUM_get_sync_values |
- |
-Name Strings |
- |
- EGL_CHROMIUM_get_sync_values |
- |
-Contact |
- |
- Stéphane Marchesin, Google (marcheu 'at' google.com) |
- |
-Status |
- |
- Draft. |
- |
-Version |
- |
- Last Modified Date: N/A Revision: 1.0 |
- |
- Based on GLX_OML_sync_control Revision 6.0 |
- |
-Number |
- |
- ??? |
- |
-Dependencies |
- |
- The extension is written against the EGL 1.2 Specification, although it |
- should work on other versions of these specifications. This extension |
- also requires an operating system which supports CLOCK_MONOTONIC. |
- |
-Overview |
- |
- This extension provides counters which let applications know about the |
- timing of the last vertical retrace. By looking at the system clock, as |
- well as the refresh rate of the monitor, this should enable applications |
- to predict the position of future retraces so as to schedule an optimal |
- workload. |
- |
- This extension incorporates the use of three counters that provide |
- the necessary synchronization. The Unadjusted System Time (or UST) |
- is the 64-bit CLOCK_MONOTONIC clock; in particular this lets the |
- application schedule future vertical retraces by querying this clock. |
- The graphics Media Stream Counter (or graphics MSC) is a counter |
- that is unique to the graphics subsystem and increments for each |
- vertical retrace that occurs. The Swap Buffer Counter (SBC) is an |
- attribute of an EGLSurface and is incremented each time a swap |
- buffer action is performed on the associated surface. |
- |
- The use of these three counters allows the application to |
- synchronize graphics rendering to vertical retraces and/or swap |
- buffer actions. For example, by querying the synchronization values for |
- a given surface, the application can accurately predict the timing for |
- the next vertical retraces and schedule rendering accordingly. |
- |
-Issues |
- |
- None. |
- |
-IP Status |
- |
- No known issues. |
- |
-New Procedures and Functions |
- |
- Bool eglGetSyncValuesCHROMIUM(EGLDisplay dpy, |
- EGLSurface surface, |
- int64_t* ust, |
- int64_t* msc, |
- int64_t* sbc) |
- |
- |
-New Tokens |
- |
- None |
- |
-Additions to the EGL 1.3 Specification |
- |
- eglGetSyncValuesCHROMIUM returns the current UST/MSC/SBC triple. A UST |
- timestamp is obtained each time the graphics MSC is incremented. |
- If this value does not reflect the value of the UST at the time the |
- first scan line of the display begins passing through the video |
- output port, it will be adjusted by the graphics driver to do so |
- prior to being returned by any of the functions defined by this |
- extension. |
- |
- This UST timestamp, together with the current graphics MSC and the |
- current SBC, comprise the current UST/MSC/SBC triple. The UST, |
- graphics MSC, and SBC values are not part of the render context |
- state. These values cannot be pushed or popped. The graphics MSC |
- value is initialized to 0 when the graphics device is initialized. |
- The SBC is per-surface state and is initialized to 0 when the |
- EGLSurface data structure is initialized. |
- |
- The SBC value is incremented by the graphics driver at the completion |
- of each buffer swap (e.g., the pixel copy has been completed or the |
- hardware register that swaps memory banks has been written). For pixel |
- formats that do not contain a back buffer, the SBC will always be |
- returned as 0. |
- |
- The graphics MSC value is incremented once for each screen refresh. |
- For a non-interlaced display, this means that the graphics MSC value |
- is incremented for each frame. For an interlaced display, it means |
- that it will be incremented for each field. For a multi-monitor |
- system, the monitor used to determine MSC is the one where the surface |
- is located. If the surface spans multiple monitors, the monitor used |
- to determine MSC is the one with the biggest coverage in pixels. |
- |
- The function eglGetSyncValuesCHROMIUM will return TRUE if the function |
- completed successfully, FALSE otherwise. |
- |
- Each time eglSwapBuffer succeeds, the SBC will be increased within a |
- finite time period. |
- |
-Errors |
- |
- eglGetSyncValuesCHROMIUM will return FALSE if there is no current |
- EGLContext. |
- |
-New State |
- |
- Get Value Get Command Type Initial Value |
- --------- ----------- ---- ------------- |
- [UST] eglGetSyncValuesCHROMIUM Z unspecified |
- [MSC] eglGetSyncValuesCHROMIUM Z 0 |
- [SBC] eglGetSyncValuesCHROMIUM Z 0 |
- |
-New Implementation Dependent State |
- |
- None |