1<?xml version="1.0" encoding="UTF-8" standalone="no"?> 2<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml"> 3 <head> 4 <title xmlns:xlink="http://www.w3.org/1999/xlink">eglWaitGL - EGL Reference Pages</title> 5 <link rel="stylesheet" type="text/css" href="khronos-man.css"/> 6 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1"/> 7 </head> 8 <body> 9 <header/> 10 <div class="refentry" id="eglWaitGL"> 11 <div class="titlepage"/> 12 <div class="refnamediv"> 13 <h2>Name</h2> 14 <p>eglWaitGL — 15 Complete GL execution prior to subsequent native rendering 16 calls 17 </p> 18 </div> 19 <div class="refsynopsisdiv"> 20 <h2>C Specification</h2> 21 <div class="funcsynopsis"> 22 <table style="border: 0; cellspacing: 0; cellpadding: 0;" class="funcprototype-table"> 23 <tr> 24 <td> 25 <code class="funcdef">EGLBoolean <strong class="fsfunc">eglWaitGL</strong>(</code> 26 </td> 27 <td><code>void)</code>;</td> 28 <td> </td> 29 </tr> 30 </table> 31 <div class="funcprototype-spacer"> </div> 32 </div> 33 </div> 34 <div class="refsect1" id="description"> 35 <h2>Description</h2> 36 <p> 37 All OpenGL ES rendering calls for the currently bound OpenGL 38 ES context made prior to <code class="function">eglWaitGL</code> are 39 guaranteed to be executed before native rendering calls made 40 after <code class="function">eglWaitGL</code>. The same result can be 41 achieved using 42 <a class="citerefentry" href="glFinish.xhtml"><span class="citerefentry"><span class="refentrytitle">glFinish</span></span></a>. 43 </p> 44 <p> 45 <code class="function">eglWaitGL</code> is ignored if there is no 46 current EGL rendering context for OpenGL ES. 47 </p> 48 </div> 49 <div class="refsect1" id="notes"> 50 <h2>Notes</h2> 51 <p> 52 <code class="function">eglWaitClient</code> is supported only if the 53 EGL version is 1.2 or greater. 54 </p> 55 <p> 56 <code class="function">eglWaitClient</code> is a generalized version 57 of <code class="function">eglWaitGL</code>, supporting multiple 58 client APIs. For backwards compatibility, 59 <code class="function">eglWaitGL</code> continues to be supported and 60 is equivalent to the series of commands 61 </p> 62 <pre class="programlisting"> 63 EGLenum api = <code class="function">eglQueryAPI</code>(); 64 <code class="function">eglBindAPI</code>(<code class="constant">EGL_OPENGL_ES_API</code>); 65 <code class="function">eglWaitClient</code>(); 66 <code class="function">eglBindAPI</code>(api); 67 </pre> 68 </div> 69 <div class="refsect1" id="errors"> 70 <h2>Errors</h2> 71 <p> 72 <code class="constant">EGL_FALSE</code> is returned if 73 <code class="function">eglWaitGL</code> fails, 74 <code class="constant">EGL_TRUE</code> otherwise. 75 </p> 76 <p> 77 <code class="constant">EGL_BAD_CURRENT_SURFACE</code> is generated if 78 the surface associated with the current context has a native 79 window or pixmap, and that window or pixmap is no longer 80 valid. 81 </p> 82 </div> 83 <div class="refsect1" id="seealso"> 84 <h2>See Also</h2> 85 <p> 86 <a class="citerefentry" href="glFinish.xhtml"><span class="citerefentry"><span class="refentrytitle">glFinish</span></span></a>, 87 <a class="citerefentry" href="eglWaitClient.xhtml"><span class="citerefentry"><span class="refentrytitle">eglWaitClient</span></span></a> 88 <a class="citerefentry" href="eglWaitNative.xhtml"><span class="citerefentry"><span class="refentrytitle">eglWaitNative</span></span></a> 89 </p> 90 </div> 91 <p> 92 </p> 93 <div class="refsect3" id="copyright"> 94 <img src="KhronosLogo.jpg"/> 95 <p> 96 Copyright © 2003-2014 The Khronos Group Inc. 97 Permission is hereby granted, free of charge, to any person obtaining a 98 copy of this software and/or associated documentation files (the 99 "Materials"), to deal in the Materials without restriction, including 100 without limitation the rights to use, copy, modify, merge, publish, 101 distribute, sublicense, and/or sell copies of the Materials, and to 102 permit persons to whom the Materials are furnished to do so, subject to 103 the condition that this copyright notice and permission notice shall be included 104 in all copies or substantial portions of the Materials. 105 </p> 106 </div> 107 <p> 108</p> 109 </div> 110 <footer/> 111 </body> 112</html> 113
