opengles.html 2.26 KB
Newer Older
1 2 3 4 5 6 7
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en">
<head>
  <meta http-equiv="content-type" content="text/html; charset=utf-8">
  <title>OpenGL ES</title>
  <link rel="stylesheet" type="text/css" href="mesa.css">
</head>
8 9
<body>

Andreas Boll's avatar
Andreas Boll committed
10 11 12 13 14 15 16
<div class="header">
  <h1>The Mesa 3D Graphics Library</h1>
</div>

<iframe src="contents.html"></iframe>
<div class="content">

17
<h1>OpenGL ES</h1>
18

Nathan Kidd's avatar
Nathan Kidd committed
19
<p>Mesa implements OpenGL ES 1.1 and OpenGL ES 2.0.  More information about
20 21
OpenGL ES can be found at <a href="https://www.khronos.org/opengles/">
https://www.khronos.org/opengles/</a>.</p>
22

23 24
<p>OpenGL ES depends on a working EGL implementation.  Please refer to
<a href="egl.html">Mesa EGL</a> for more information about EGL.</p>
25 26 27

<h2>Build the Libraries</h2>
<ol>
Chia-I Wu's avatar
Chia-I Wu committed
28
<li>Run <code>configure</code> with <code>--enable-gles1 --enable-gles2</code> and enable the Gallium driver for your hardware.</li>
29 30 31 32 33 34 35 36
<li>Build and install Mesa as usual.</li>
</ol>

Alternatively, if XCB-DRI2 is installed on the system, one can use
<code>egl_dri2</code> EGL driver with OpenGL|ES-enabled DRI drivers

<ol>
<li>Run <code>configure</code> with <code>--enable-gles1 --enable-gles2</code>.</li>
37 38 39
<li>Build and install Mesa as usual.</li>
</ol>

40 41 42
<p>Both methods will install libGLESv1_CM, libGLESv2, libEGL, and one or more
EGL drivers for your hardware.</p>

43 44
<h2>Run the Demos</h2>

45
<p>There are some demos in <code>mesa/demos</code> repository.</p>
46 47 48 49 50

<h2>Developers</h2>

<h3>Dispatch Table</h3>

Nathan Kidd's avatar
Nathan Kidd committed
51
<p>OpenGL ES has an additional indirection when dispatching functions</p>
52 53 54

<pre>
  Mesa:       glFoo() --&gt; _mesa_Foo()
55
  OpenGL ES:  glFoo() --&gt; _es_Foo() --&gt; _mesa_Foo()
56 57 58 59 60 61 62 63 64 65
</pre>

<p>The indirection serves several purposes</p>

<ul>
<li>When a function is in Mesa and the type matches, it checks the arguments and calls the Mesa function.</li>
<li>When a function is in Mesa but the type mismatches, it checks and converts the arguments before calling the Mesa function.</li>
<li>When a function is not available in Mesa, or accepts arguments that are not available in OpenGL, it provides its own implementation.</li>
</ul>

66
<p>Other than the last case, OpenGL ES uses <code>APIspec.xml</code> to generate functions to check and/or converts the arguments.</p>
67

Andreas Boll's avatar
Andreas Boll committed
68
</div>
69 70
</body>
</html>