102f4aeb0Sopenharmony_ci<?xml version="1.0" encoding="UTF-8" standalone="no"?> 202f4aeb0Sopenharmony_ci<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml"> 302f4aeb0Sopenharmony_ci <head> 402f4aeb0Sopenharmony_ci <title xmlns:xlink="http://www.w3.org/1999/xlink">eglBindAPI - EGL Reference Pages</title> 502f4aeb0Sopenharmony_ci <link rel="stylesheet" type="text/css" href="khronos-man.css"/> 602f4aeb0Sopenharmony_ci <meta name="generator" content="DocBook XSL Stylesheets V1.79.1"/> 702f4aeb0Sopenharmony_ci </head> 802f4aeb0Sopenharmony_ci <body> 902f4aeb0Sopenharmony_ci <header/> 1002f4aeb0Sopenharmony_ci <div class="refentry" id="eglBindAPI"> 1102f4aeb0Sopenharmony_ci <div class="titlepage"/> 1202f4aeb0Sopenharmony_ci <div class="refnamediv"> 1302f4aeb0Sopenharmony_ci <h2>Name</h2> 1402f4aeb0Sopenharmony_ci <p>eglBindAPI — Set the current rendering API</p> 1502f4aeb0Sopenharmony_ci </div> 1602f4aeb0Sopenharmony_ci <div class="refsynopsisdiv"> 1702f4aeb0Sopenharmony_ci <h2>C Specification</h2> 1802f4aeb0Sopenharmony_ci <div class="funcsynopsis"> 1902f4aeb0Sopenharmony_ci <table style="border: 0; cellspacing: 0; cellpadding: 0;" class="funcprototype-table"> 2002f4aeb0Sopenharmony_ci <tr> 2102f4aeb0Sopenharmony_ci <td> 2202f4aeb0Sopenharmony_ci <code class="funcdef">EGLBoolean <strong class="fsfunc">eglBindAPI</strong>(</code> 2302f4aeb0Sopenharmony_ci </td> 2402f4aeb0Sopenharmony_ci <td>EGLenum <var class="pdparam">api</var><code>)</code>;</td> 2502f4aeb0Sopenharmony_ci </tr> 2602f4aeb0Sopenharmony_ci </table> 2702f4aeb0Sopenharmony_ci <div class="funcprototype-spacer"> </div> 2802f4aeb0Sopenharmony_ci </div> 2902f4aeb0Sopenharmony_ci </div> 3002f4aeb0Sopenharmony_ci <div class="refsect1" id="parameters"> 3102f4aeb0Sopenharmony_ci <h2>Parameters</h2> 3202f4aeb0Sopenharmony_ci <div class="variablelist"> 3302f4aeb0Sopenharmony_ci <dl class="variablelist"> 3402f4aeb0Sopenharmony_ci <dt> 3502f4aeb0Sopenharmony_ci <span class="term"> 3602f4aeb0Sopenharmony_ci <em class="parameter"> 3702f4aeb0Sopenharmony_ci <code>api</code> 3802f4aeb0Sopenharmony_ci </em> 3902f4aeb0Sopenharmony_ci </span> 4002f4aeb0Sopenharmony_ci </dt> 4102f4aeb0Sopenharmony_ci <dd> 4202f4aeb0Sopenharmony_ci <p> 4302f4aeb0Sopenharmony_ci Specifies the client API to bind, one of 4402f4aeb0Sopenharmony_ci <code class="constant">EGL_OPENGL_API</code>, 4502f4aeb0Sopenharmony_ci <code class="constant">EGL_OPENGL_ES_API</code>, or 4602f4aeb0Sopenharmony_ci <code class="constant">EGL_OPENVG_API</code>. 4702f4aeb0Sopenharmony_ci </p> 4802f4aeb0Sopenharmony_ci </dd> 4902f4aeb0Sopenharmony_ci </dl> 5002f4aeb0Sopenharmony_ci </div> 5102f4aeb0Sopenharmony_ci </div> 5202f4aeb0Sopenharmony_ci <div class="refsect1" id="description"> 5302f4aeb0Sopenharmony_ci <h2>Description</h2> 5402f4aeb0Sopenharmony_ci <p> 5502f4aeb0Sopenharmony_ci <code class="function">eglBindAPI</code> defines the current 5602f4aeb0Sopenharmony_ci rendering API for EGL in the thread it is called from. The 5702f4aeb0Sopenharmony_ci current rendering API is one of the client rendering APIs 5802f4aeb0Sopenharmony_ci supported by the EGL implementation, and affects the 5902f4aeb0Sopenharmony_ci behavior of other EGL commands including 6002f4aeb0Sopenharmony_ci <code class="function">eglCreateContext</code>, 6102f4aeb0Sopenharmony_ci <code class="function">eglGetCurrentContext</code>, 6202f4aeb0Sopenharmony_ci <code class="function">eglGetCurrentDisplay</code>, 6302f4aeb0Sopenharmony_ci <code class="function">eglGetCurrentSurface</code>, 6402f4aeb0Sopenharmony_ci <code class="function">eglMakeCurrent</code>, 6502f4aeb0Sopenharmony_ci <code class="function">eglSwapInterval</code>, 6602f4aeb0Sopenharmony_ci <code class="function">eglWaitClient</code>, and 6702f4aeb0Sopenharmony_ci <code class="function">eglWaitNative</code>. 6802f4aeb0Sopenharmony_ci </p> 6902f4aeb0Sopenharmony_ci <p> 7002f4aeb0Sopenharmony_ci If <em class="parameter"><code>api</code></em> is 7102f4aeb0Sopenharmony_ci <code class="constant">EGL_OPENGL_API</code>, the current rendering 7202f4aeb0Sopenharmony_ci API is set to the OpenGL API. 7302f4aeb0Sopenharmony_ci </p> 7402f4aeb0Sopenharmony_ci <p> 7502f4aeb0Sopenharmony_ci If <em class="parameter"><code>api</code></em> is 7602f4aeb0Sopenharmony_ci <code class="constant">EGL_OPENGL_ES_API</code>, the current 7702f4aeb0Sopenharmony_ci rendering API is set to the OpenGL ES API. 7802f4aeb0Sopenharmony_ci </p> 7902f4aeb0Sopenharmony_ci <p> 8002f4aeb0Sopenharmony_ci If <em class="parameter"><code>api</code></em> is 8102f4aeb0Sopenharmony_ci <code class="constant">EGL_OPENVG_API</code>, the current rendering 8202f4aeb0Sopenharmony_ci API is set to the OpenVG API. 8302f4aeb0Sopenharmony_ci </p> 8402f4aeb0Sopenharmony_ci <p> 8502f4aeb0Sopenharmony_ci If an error occurs, the current rendering API is unchanged. 8602f4aeb0Sopenharmony_ci </p> 8702f4aeb0Sopenharmony_ci </div> 8802f4aeb0Sopenharmony_ci <div class="refsect1" id="notes"> 8902f4aeb0Sopenharmony_ci <h2>Notes</h2> 9002f4aeb0Sopenharmony_ci <p> 9102f4aeb0Sopenharmony_ci <code class="function">eglBindAPI</code> and the corresponding 9202f4aeb0Sopenharmony_ci <code class="constant">EGL_OPENGL_ES_API</code> and 9302f4aeb0Sopenharmony_ci <code class="constant">EGL_OPENVG_API</code> 9402f4aeb0Sopenharmony_ci <em class="parameter"><code>api</code></em> parameters are supported only if 9502f4aeb0Sopenharmony_ci the EGL version is 1.2 or greater. The 9602f4aeb0Sopenharmony_ci <code class="constant">EGL_OPENGL_API</code> parameter is supported 9702f4aeb0Sopenharmony_ci only if the EGL version is 1.4 or greater. 9802f4aeb0Sopenharmony_ci </p> 9902f4aeb0Sopenharmony_ci <p> 10002f4aeb0Sopenharmony_ci The initial value of the current rendering API is 10102f4aeb0Sopenharmony_ci <code class="constant">EGL_OPENGL_ES_API</code> unless OpenGL ES is 10202f4aeb0Sopenharmony_ci not supported by an implementation, in which case the 10302f4aeb0Sopenharmony_ci initial value is <code class="constant">EGL_NONE</code> (however, 10402f4aeb0Sopenharmony_ci <code class="constant">EGL_NONE</code> is not a valid 10502f4aeb0Sopenharmony_ci <em class="parameter"><code>api</code></em> parameter to 10602f4aeb0Sopenharmony_ci <code class="function">eglBindAPI</code>). 10702f4aeb0Sopenharmony_ci </p> 10802f4aeb0Sopenharmony_ci <p> 10902f4aeb0Sopenharmony_ci The current rendering API can be queried by calling 11002f4aeb0Sopenharmony_ci <code class="function">eglQueryAPI</code>. 11102f4aeb0Sopenharmony_ci </p> 11202f4aeb0Sopenharmony_ci </div> 11302f4aeb0Sopenharmony_ci <div class="refsect1" id="errors"> 11402f4aeb0Sopenharmony_ci <h2>Errors</h2> 11502f4aeb0Sopenharmony_ci <p> 11602f4aeb0Sopenharmony_ci <code class="constant">EGL_FALSE</code> is returned on failure. 11702f4aeb0Sopenharmony_ci </p> 11802f4aeb0Sopenharmony_ci <p> 11902f4aeb0Sopenharmony_ci <code class="constant">EGL_BAD_PARAMETER</code> is generated if 12002f4aeb0Sopenharmony_ci <em class="parameter"><code>api</code></em> is not one of the accepted 12102f4aeb0Sopenharmony_ci tokens, or if the specified client API is not supported by 12202f4aeb0Sopenharmony_ci the EGL implementation. 12302f4aeb0Sopenharmony_ci </p> 12402f4aeb0Sopenharmony_ci </div> 12502f4aeb0Sopenharmony_ci <div class="refsect1" id="seealso"> 12602f4aeb0Sopenharmony_ci <h2>See Also</h2> 12702f4aeb0Sopenharmony_ci <p> 12802f4aeb0Sopenharmony_ci <a class="citerefentry" href="eglCreateContext.xhtml"><span class="citerefentry"><span class="refentrytitle">eglCreateContext</span></span></a>, 12902f4aeb0Sopenharmony_ci <a class="citerefentry" href="eglGetCurrentContext.xhtml"><span class="citerefentry"><span class="refentrytitle">eglGetCurrentContext</span></span></a>, 13002f4aeb0Sopenharmony_ci <a class="citerefentry" href="eglGetCurrentDisplay.xhtml"><span class="citerefentry"><span class="refentrytitle">eglGetCurrentDisplay</span></span></a>, 13102f4aeb0Sopenharmony_ci <a class="citerefentry" href="eglGetCurrentSurface.xhtml"><span class="citerefentry"><span class="refentrytitle">eglGetCurrentSurface</span></span></a>, 13202f4aeb0Sopenharmony_ci <a class="citerefentry" href="eglMakeCurrent.xhtml"><span class="citerefentry"><span class="refentrytitle">eglMakeCurrent</span></span></a>, 13302f4aeb0Sopenharmony_ci <a class="citerefentry" href="eglQueryAPI.xhtml"><span class="citerefentry"><span class="refentrytitle">eglQueryAPI</span></span></a>, 13402f4aeb0Sopenharmony_ci <a class="citerefentry" href="eglSwapInterval.xhtml"><span class="citerefentry"><span class="refentrytitle">eglSwapInterval</span></span></a>, 13502f4aeb0Sopenharmony_ci <a class="citerefentry" href="eglWaitClient.xhtml"><span class="citerefentry"><span class="refentrytitle">eglWaitClient</span></span></a>, 13602f4aeb0Sopenharmony_ci <a class="citerefentry" href="eglWaitNative.xhtml"><span class="citerefentry"><span class="refentrytitle">eglWaitNative</span></span></a> 13702f4aeb0Sopenharmony_ci </p> 13802f4aeb0Sopenharmony_ci </div> 13902f4aeb0Sopenharmony_ci <p> 14002f4aeb0Sopenharmony_ci </p> 14102f4aeb0Sopenharmony_ci <div class="refsect3" id="copyright"> 14202f4aeb0Sopenharmony_ci <img src="KhronosLogo.jpg"/> 14302f4aeb0Sopenharmony_ci <p> 14402f4aeb0Sopenharmony_ci Copyright © 2003-2014 The Khronos Group Inc. 14502f4aeb0Sopenharmony_ci Permission is hereby granted, free of charge, to any person obtaining a 14602f4aeb0Sopenharmony_ci copy of this software and/or associated documentation files (the 14702f4aeb0Sopenharmony_ci "Materials"), to deal in the Materials without restriction, including 14802f4aeb0Sopenharmony_ci without limitation the rights to use, copy, modify, merge, publish, 14902f4aeb0Sopenharmony_ci distribute, sublicense, and/or sell copies of the Materials, and to 15002f4aeb0Sopenharmony_ci permit persons to whom the Materials are furnished to do so, subject to 15102f4aeb0Sopenharmony_ci the condition that this copyright notice and permission notice shall be included 15202f4aeb0Sopenharmony_ci in all copies or substantial portions of the Materials. 15302f4aeb0Sopenharmony_ci </p> 15402f4aeb0Sopenharmony_ci </div> 15502f4aeb0Sopenharmony_ci <p> 15602f4aeb0Sopenharmony_ci</p> 15702f4aeb0Sopenharmony_ci </div> 15802f4aeb0Sopenharmony_ci <footer/> 15902f4aeb0Sopenharmony_ci </body> 16002f4aeb0Sopenharmony_ci</html> 161
