1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook MathML Module V1.1b1//EN"
"http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">
<refentry xml:base="" id="eglBindAPI">
<refentryinfo>
<copyright>
<year>2003-2014</year>
<holder>The Khronos Group Inc.</holder>
</copyright>
</refentryinfo>
<refmeta>
<refentrytitle>eglBindAPI</refentrytitle>
<manvolnum>3G</manvolnum>
</refmeta>
<refnamediv>
<refname>eglBindAPI</refname>
<refpurpose>Set the current rendering API</refpurpose>
</refnamediv>
<refsynopsisdiv><title>C Specification</title>
<funcsynopsis>
<funcprototype>
<funcdef>EGLBoolean <function>eglBindAPI</function></funcdef>
<paramdef>EGLenum <parameter>api</parameter></paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="parameters"><title>Parameters</title>
<variablelist>
<varlistentry>
<term><parameter>api</parameter></term>
<listitem>
<para>
Specifies the client API to bind, one of
<constant>EGL_OPENGL_API</constant>,
<constant>EGL_OPENGL_ES_API</constant>, or
<constant>EGL_OPENVG_API</constant>.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 id="description"><title>Description</title>
<para>
<function>eglBindAPI</function> defines the current
rendering API for EGL in the thread it is called from. The
current rendering API is one of the client rendering APIs
supported by the EGL implementation, and affects the
behavior of other EGL commands including
<function>eglCreateContext</function>,
<function>eglGetCurrentContext</function>,
<function>eglGetCurrentDisplay</function>,
<function>eglGetCurrentSurface</function>,
<function>eglMakeCurrent</function>,
<function>eglWaitClient</function>, and
<function>eglWaitNative</function>.
</para>
<para>
If <parameter>api</parameter> is
<constant>EGL_OPENGL_API</constant>, the current rendering
API is set to the OpenGL API.
</para>
<para>
If <parameter>api</parameter> is
<constant>EGL_OPENGL_ES_API</constant>, the current
rendering API is set to the OpenGL ES API.
</para>
<para>
If <parameter>api</parameter> is
<constant>EGL_OPENVG_API</constant>, the current rendering
API is set to the OpenVG API.
</para>
<para>
If an error occurs, the current rendering API is unchanged.
</para>
</refsect1>
<refsect1 id="notes"><title>Notes</title>
<para>
<function>eglBindAPI</function> and the corresponding
<constant>EGL_OPENGL_ES_API</constant> and
<constant>EGL_OPENVG_API</constant>
<parameter>api</parameter> parameters are supported only if
the EGL version is 1.2 or greater. The
<constant>EGL_OPENGL_API</constant> parameter is supported
only if the EGL version is 1.4 or greater.
</para>
<para>
The initial value of the current rendering API is
<constant>EGL_OPENGL_ES_API</constant> unless OpenGL ES is
not supported by an implementation, in which case the
initial value is <constant>EGL_NONE</constant> (however,
<constant>EGL_NONE</constant> is not a valid
<parameter>api</parameter> parameter to
<function>eglBindAPI</function>).
</para>
<para>
The current rendering API can be queried by calling
<function>eglQueryAPI</function>.
</para>
</refsect1>
<refsect1 id="errors"><title>Errors</title>
<para>
<constant>EGL_FALSE</constant> is returned on failure.
</para>
<para>
<constant>EGL_BAD_PARAMETER</constant> is generated if
<parameter>api</parameter> is not one of the accepted
tokens, or if the specified client API is not supported by
the EGL implementation.
</para>
</refsect1>
<refsect1 id="seealso"><title>See Also</title>
<para>
<citerefentry><refentrytitle>eglCreateContext</refentrytitle></citerefentry>,
<citerefentry><refentrytitle>eglGetCurrentContext</refentrytitle></citerefentry>,
<citerefentry><refentrytitle>eglGetCurrentDisplay</refentrytitle></citerefentry>,
<citerefentry><refentrytitle>eglGetCurrentSurface</refentrytitle></citerefentry>,
<citerefentry><refentrytitle>eglMakeCurrent</refentrytitle></citerefentry>,
<citerefentry><refentrytitle>eglQueryAPI</refentrytitle></citerefentry>,
<citerefentry><refentrytitle>eglWaitClient</refentrytitle></citerefentry>,
<citerefentry><refentrytitle>eglWaitNative</refentrytitle></citerefentry>
</para>
</refsect1>
<refsect3 id="Copyright"><title></title>
<!-- Content included from copyright.inc.xsl -->
<imageobject>
<imagedata fileref="KhronosLogo.jpg" format="jpg" />
</imageobject>
<para />
</refsect3>
</refentry>
|
