1<?xml version="1.0" encoding="UTF-8"?> 2<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook MathML Module V1.1b1//EN" 3 "http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd"> 4<refentry xml:base="" id="eglWaitGL"> 5 <refentryinfo> 6 <copyright> 7 <year>2003-2014</year> 8 <holder>The Khronos Group Inc.</holder> 9 </copyright> 10 </refentryinfo> 11 <refmeta> 12 <refentrytitle>eglWaitGL</refentrytitle> 13 <manvolnum>3G</manvolnum> 14 </refmeta> 15 <refnamediv> 16 <refname>eglWaitGL</refname> 17 <refpurpose> 18 Complete GL execution prior to subsequent native rendering 19 calls 20 </refpurpose> 21 </refnamediv> 22 <refsynopsisdiv> 23 <title>C Specification</title> 24 <funcsynopsis> 25 <funcprototype> 26 <funcdef>EGLBoolean <function>eglWaitGL</function></funcdef> 27 <void/> 28 </funcprototype> 29 </funcsynopsis> 30 </refsynopsisdiv> 31 <refsect1 id="description"><title>Description</title> 32 <para> 33 All OpenGL ES rendering calls for the currently bound OpenGL 34 ES context made prior to <function>eglWaitGL</function> are 35 guaranteed to be executed before native rendering calls made 36 after <function>eglWaitGL</function>. The same result can be 37 achieved using 38 <citerefentry><refentrytitle>glFinish</refentrytitle></citerefentry>. 39 </para> 40 <para> 41 <function>eglWaitGL</function> is ignored if there is no 42 current EGL rendering context for OpenGL ES. 43 </para> 44 </refsect1> 45 <refsect1 id="notes"><title>Notes</title> 46 <para> 47 <function>eglWaitClient</function> is supported only if the 48 EGL version is 1.2 or greater. 49 </para> 50 <para> 51 <function>eglWaitClient</function> is a generalized version 52 of <function>eglWaitGL</function>, supporting multiple 53 client APIs. For backwards compatibility, 54 <function>eglWaitGL</function> continues to be supported and 55 is equivalent to the series of commands 56 </para> 57 <programlisting> 58 EGLenum api = <function>eglQueryAPI</function>(); 59 <function>eglBindAPI</function>(<constant>EGL_OPENGL_ES_API</constant>); 60 <function>eglWaitClient</function>(); 61 <function>eglBindAPI</function>(api); 62 </programlisting> 63 </refsect1> 64 <refsect1 id="errors"><title>Errors</title> 65 <para> 66 <constant>EGL_FALSE</constant> is returned if 67 <function>eglWaitGL</function> fails, 68 <constant>EGL_TRUE</constant> otherwise. 69 </para> 70 <para> 71 <constant>EGL_BAD_CURRENT_SURFACE</constant> is generated if 72 the surface associated with the current context has a native 73 window or pixmap, and that window or pixmap is no longer 74 valid. 75 </para> 76 </refsect1> 77 <refsect1 id="seealso"><title>See Also</title> 78 <para> 79 <citerefentry><refentrytitle>glFinish</refentrytitle></citerefentry>, 80 <citerefentry><refentrytitle>eglWaitClient</refentrytitle></citerefentry> 81 <citerefentry><refentrytitle>eglWaitNative</refentrytitle></citerefentry> 82 </para> 83 </refsect1> 84 <refsect3 id="Copyright"><title></title> 85 <!-- Content included from copyright.inc.xsl --> 86 <imageobject> 87 <imagedata fileref="KhronosLogo.jpg" format="jpg" /> 88 </imageobject> 89 <para /> 90 </refsect3> 91</refentry> 92
