Debian Codegraph @

doc/gauche-gl-refe.html

raw
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
2 <html>
3 <!-- Created on August 9, 2014 by texi2html 1.82
4 texi2html was written by:
5 Lionel Cons <[email protected]> (original author)
6 Karl Berry <[email protected]>
7 Olaf Bachmann <[email protected]>
8 and many others.
9 Maintained by: Many creative people.
10 Send bugs and suggestions to <[email protected]>
11 -->
12 <head>
13 <title>Gauche-gl : OpenGL binding for Gauche</title>
14
15 <meta name="description" content="Gauche-gl : OpenGL binding for Gauche">
16 <meta name="keywords" content="Gauche-gl : OpenGL binding for Gauche">
17 <meta name="resource-type" content="document">
18 <meta name="distribution" content="global">
19 <meta name="Generator" content="texi2html 1.82">
20 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
21 <style type="text/css">
22 <!--
23 a.summary-letter {text-decoration: none}
24 blockquote.smallquotation {font-size: smaller}
25 pre.display {font-family: serif}
26 pre.format {font-family: serif}
27 pre.menu-comment {font-family: serif}
28 pre.menu-preformatted {font-family: serif}
29 pre.smalldisplay {font-family: serif; font-size: smaller}
30 pre.smallexample {font-size: smaller}
31 pre.smallformat {font-family: serif; font-size: smaller}
32 pre.smalllisp {font-size: smaller}
33 span.roman {font-family:serif; font-weight:normal;}
34 span.sansserif {font-family:sans-serif; font-weight:normal;}
35 ul.toc {list-style: none}
36 -->
37 </style>
38
39
40 </head>
41
42 <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
43
44 <a name="Top"></a>
45 <table cellpadding="1" cellspacing="1" border="0">
46 <tr><td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
47 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
48 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
49 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
50 </tr></table>
51 <h1 class="settitle">Gauche-gl : OpenGL binding for Gauche</h1>
52
53 <p>This is a reference manual of Gauche-gl, an OpenGL binding for the
54 Gauche Scheme implementation.
55 This manual is for version 0.6.
56 </p>
57 <table class="menu" border="0" cellspacing="0">
58 <tr><td align="left" valign="top"><a href="#Introduction">1. Introduction</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
59 </td></tr>
60 <tr><td align="left" valign="top"><a href="#Installation">2. Installation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
61 </td></tr>
62 <tr><td align="left" valign="top"><a href="#Getting-Started">3. Getting Started</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
63 </td></tr>
64 <tr><td align="left" valign="top"><a href="#OpenGL-API">4. OpenGL API</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
65 </td></tr>
66 <tr><td align="left" valign="top"><a href="#GLUT-API">5. GLUT API</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
67 </td></tr>
68 <tr><td align="left" valign="top"><a href="#Vectors-and-matrices">6. Vectors and matrices</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
69 </td></tr>
70 <tr><td align="left" valign="top"><a href="#Simple-utilities">7. Simple utilities</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
71 </td></tr>
72 <tr><td align="left" valign="top"><a href="#Indices">A. Indices</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
73 </td></tr>
74 </table>
75
76 <hr size="1">
77 <a name="Introduction"></a>
78 <table cellpadding="1" cellspacing="1" border="0">
79 <tr><td valign="middle" align="left">[<a href="#Top" title="Previous section in reading order"> &lt; </a>]</td>
80 <td valign="middle" align="left">[<a href="#Installation" title="Next section in reading order"> &gt; </a>]</td>
81 <td valign="middle" align="left"> &nbsp; </td>
82 <td valign="middle" align="left">[ &lt;&lt; ]</td>
83 <td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
84 <td valign="middle" align="left">[<a href="#Installation" title="Next chapter"> &gt;&gt; </a>]</td>
85 <td valign="middle" align="left"> &nbsp; </td>
86 <td valign="middle" align="left"> &nbsp; </td>
87 <td valign="middle" align="left"> &nbsp; </td>
88 <td valign="middle" align="left"> &nbsp; </td>
89 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
90 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
91 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
92 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
93 </tr></table>
94 <a name="Introduction-1"></a>
95 <h1 class="chapter">1. Introduction</h1>
96
97 <p>Gauche-gl is an extension module of Gauche Scheme implementation.
98 It provides the following modules:
99 </p>
100 <dl compact="compact">
101 <dt> <code>gl</code></dt>
102 <dd><p>This module provides bindings to OpenGL API.
103 It covers most functions in OpenGL 1.0 through 2.0,
104 and GLU. The functions are described in <a href="#OpenGL-API">OpenGL API</a>.
105 </p></dd>
106 <dt> <code>gl.glut</code></dt>
107 <dd><p>This module provides bindings to most functions in GLUT.
108 The functions are described in <a href="#GLUT-API">GLUT API</a>.
109 </p></dd>
110 <dt> <code>gl.math3d</code></dt>
111 <dd><p>This module provides vector and matrix calculations
112 optimized for 3D homogeneous coordinates.
113 The vector and matrix objects here can be directly passed to
114 Gauche-gl functions.
115 The functions are descrbied in <a href="#Vectors-and-matrices">Vectors and matrices</a>.
116 </p></dd>
117 <dt> <code>gl.simple.*</code></dt>
118 <dd><p>These modules provide simple APIs for programmers to
119 hack up a very simple OpenGL application. They are by no
120 means intended for general application development, but
121 would be handy for throwaway script.
122 See <a href="#Simple-utilities">Simple utilities</a> for the details.
123 </p></dd>
124 </dl>
125
126 <hr size="6">
127 <a name="Installation"></a>
128 <table cellpadding="1" cellspacing="1" border="0">
129 <tr><td valign="middle" align="left">[<a href="#Introduction" title="Previous section in reading order"> &lt; </a>]</td>
130 <td valign="middle" align="left">[<a href="#Getting-Started" title="Next section in reading order"> &gt; </a>]</td>
131 <td valign="middle" align="left"> &nbsp; </td>
132 <td valign="middle" align="left">[<a href="#Introduction" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
133 <td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
134 <td valign="middle" align="left">[<a href="#Getting-Started" title="Next chapter"> &gt;&gt; </a>]</td>
135 <td valign="middle" align="left"> &nbsp; </td>
136 <td valign="middle" align="left"> &nbsp; </td>
137 <td valign="middle" align="left"> &nbsp; </td>
138 <td valign="middle" align="left"> &nbsp; </td>
139 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
140 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
141 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
142 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
143 </tr></table>
144 <a name="Installation-1"></a>
145 <h1 class="chapter">2. Installation</h1>
146
147 <p>Installing Gauche-gl is usually straightforward on Unix variants.
148 </p>
149 <p>You have to have the following programs installed on your machine.
150 </p><ul>
151 <li>
152 Gauche 0.8.5 or later
153 </li><li>
154 OpenGL 1.1 equivalent library; the auther checked with Mesa 3.4
155 and NVidia&rsquo;s GLX driver.
156 </li><li>
157 GLUT 3.7 or later.
158 </li></ul>
159
160 <p>The standard way to compile and install Gauche-gl is as follows:
161 </p><table><tr><td>&nbsp;</td><td><pre class="example">% gzcat Gauche-gl-0.6.tgz | tar xf -
162 % cd Gauche-gl-0.6
163 % ./configure
164 % make
165 % make test
166 % make install
167 </pre></td></tr></table>
168
169 <p>Or you can use &lsquo;<tt>gauche-package</tt>&rsquo; command:
170 </p><table><tr><td>&nbsp;</td><td><pre class="example">% gauche-package install -C=&lt;configure-option&gt; Gauche-gl-0.6.tgz
171 </pre></td></tr></table>
172
173
174 <p>The confiugre script figures out the location Gauche is installed,
175 and install Gauche-gl in the same place.
176 </p>
177 <p>If you have GLUT installed in non-standard place, you have to
178 tell the configure script where it is.
179 </p><table><tr><td>&nbsp;</td><td><pre class="example">% ./configure --with-glut=DIR
180 </pre></td></tr></table>
181
182 <p>Since version 0.4, Gauche-gl can be configured to include bindings
183 to NVidia&rsquo;s Cg Toolkit. The binding code is contributed by Issac Trotts.
184 To enable Cg binding, give <code>--enable-cg</code> option to the configure
185 script.
186 </p><table><tr><td>&nbsp;</td><td><pre class="example">% ./configure --enable-cg
187 </pre></td></tr></table>
188
189
190 <p>It is reported that Mesa in FreeBSD ports is compiled with pthreads
191 enabled, and Gauche-gl can&rsquo;t be linked unless Gauche itself is
192 compiled with pthreads. The configure script of Gauche prints
193 warning if you specify pthreads, but it is safe as far as you
194 don&rsquo;t call make-thread in your program.
195 </p>
196 <p>There are various examples under &lsquo;<tt>examples/</tt>&rsquo; directory.
197 If you want to run the examples before installing Gauche-gl,
198 you have to tell the location of the library to <code>gosh</code>
199 command, e.g. <code>gosh -I../src -I../lib gears.scm</code>.
200 Some demos under subdirectories have a shell script that invokes
201 <code>gosh</code> with proper command-line options.
202 </p>
203 <dl compact="compact">
204 <dt> &lsquo;<tt>gears.scm</tt>&rsquo;</dt>
205 <dd><p>Brian Paul&rsquo;s 3D gear wheels.
206 </p></dd>
207 <dt> &lsquo;<tt>mandelbrot.scm</tt>&rsquo;</dt>
208 <dd><p>Simple calculated texture.
209 </p></dd>
210 <dt> &lsquo;<tt>glbook/</tt>&rsquo;</dt>
211 <dd><p>This subdirectory contains examples found in &quot;OpenGL Programming Guide&quot;,
212 a.k.a. Redbook.
213 </p></dd>
214 <dt> &lsquo;<tt>slbook/</tt>&rsquo;</dt>
215 <dd><p>This subdirectory contains examples found in &quot;OpenGL Shading Language&quot;.
216 Each demo is under its own subdirectories. You need to have
217 proper driver/hardware that supports GLSL to run these demos.
218 </p></dd>
219 </dl>
220
221
222 <hr size="6">
223 <a name="Getting-Started"></a>
224 <table cellpadding="1" cellspacing="1" border="0">
225 <tr><td valign="middle" align="left">[<a href="#Installation" title="Previous section in reading order"> &lt; </a>]</td>
226 <td valign="middle" align="left">[<a href="#GL-calls-in-Scheme" title="Next section in reading order"> &gt; </a>]</td>
227 <td valign="middle" align="left"> &nbsp; </td>
228 <td valign="middle" align="left">[<a href="#Installation" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
229 <td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
230 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Next chapter"> &gt;&gt; </a>]</td>
231 <td valign="middle" align="left"> &nbsp; </td>
232 <td valign="middle" align="left"> &nbsp; </td>
233 <td valign="middle" align="left"> &nbsp; </td>
234 <td valign="middle" align="left"> &nbsp; </td>
235 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
236 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
237 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
238 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
239 </tr></table>
240 <a name="Getting-Started-1"></a>
241 <h1 class="chapter">3. Getting Started</h1>
242
243 <table class="menu" border="0" cellspacing="0">
244 <tr><td align="left" valign="top"><a href="#GL-calls-in-Scheme">3.1 GL calls in Scheme</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
245 </td></tr>
246 <tr><td align="left" valign="top"><a href="#Advanced-GL-features">3.2 Advanced GL features</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
247 </td></tr>
248 <tr><td align="left" valign="top"><a href="#Using-GLUT">3.3 Using GLUT</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
249 </td></tr>
250 <tr><td align="left" valign="top"><a href="#Performance-tips">3.4 Performance tips</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
251 </td></tr>
252 </table>
253
254 <hr size="6">
255 <a name="GL-calls-in-Scheme"></a>
256 <table cellpadding="1" cellspacing="1" border="0">
257 <tr><td valign="middle" align="left">[<a href="#Getting-Started" title="Previous section in reading order"> &lt; </a>]</td>
258 <td valign="middle" align="left">[<a href="#Advanced-GL-features" title="Next section in reading order"> &gt; </a>]</td>
259 <td valign="middle" align="left"> &nbsp; </td>
260 <td valign="middle" align="left">[<a href="#Getting-Started" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
261 <td valign="middle" align="left">[<a href="#Getting-Started" title="Up section"> Up </a>]</td>
262 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Next chapter"> &gt;&gt; </a>]</td>
263 <td valign="middle" align="left"> &nbsp; </td>
264 <td valign="middle" align="left"> &nbsp; </td>
265 <td valign="middle" align="left"> &nbsp; </td>
266 <td valign="middle" align="left"> &nbsp; </td>
267 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
268 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
269 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
270 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
271 </tr></table>
272 <a name="GL-calls-in-Scheme-1"></a>
273 <h2 class="section">3.1 GL calls in Scheme</h2>
274
275 <p>I assume you have basic knowledge of OpenGL API.
276 Gauche-gl maps OpenGL calls to Scheme procedures
277 pretty straightforwardly. For example, the very first
278 example of &quot;OpenGL Programming Guide&quot;, the pseudo code
279 of OpenGL application, can be written in Gauche-gl like
280 this:
281 </p>
282 <table><tr><td>&nbsp;</td><td><pre class="example">(use gl)
283
284 (define (main args)
285 (<i>initialize-a-window-please</i>)
286
287 (gl-clear-color 0.0 0.0 0.0 0.0)
288 (gl-clear GL_COLOR_BUFFER_BIT)
289 (gl-color 1.0 1.0 1.0)
290 (gl-ortho 0.0 1.0 0.0 1.0 -1.0 1.0)
291 (gl-begin* GL_POLYGON
292 (gl-vertex 0.25 0.25 0.0)
293 (gl-vertex 0.75 0.25 0.0)
294 (gl-vertex 0.75 0.75 0.0)
295 (gl-vertex 0.25 0.75 0.0)
296 )
297 (gl-flush)
298 (<i>update-the-window-and-check-for-events</i>)
299 0)
300 </pre></td></tr></table>
301
302 <p>Note that <i>initialize-a-window-please</i> and
303 <i>update-the-window-and-check-for-events</i> are function calls
304 dependent on the windowing system. Gauche-gl comes with GLUT
305 binding and you can use it to do basic stuff. In the separate
306 package Gauche-gtk, a binding to GtkGLExt is provided, which allows
307 you to do GL rendering inside Gtk widgets.
308 </p>
309 <p>For the time being, let&rsquo;s focus on the pure GL part.
310 </p>
311 <p>The mapping of GL call name is straightforward.
312 The mixed case names in OpenGL C API is expanded to hyphenated name,
313 e.g. <code>glClearColor</code> &rArr; <code>gl-clear-color</code>.
314 OpenGL enums are mapped as is, e.g.
315 <code>GL_POLYGON</code>. (Note that Gauche is case-sensitive by default.
316 Also note the underscore, not hyphen, in constants).
317 </p>
318 <p>A few convenience macros, such as <code>gl-begin*</code>, is defined.
319 There are straight bindings of <code>gl-begin</code> and <code>gl-end</code>,
320 so you can write the drawing part in the same way as in C:
321 </p><table><tr><td>&nbsp;</td><td><pre class="example"> (gl-begin GL_POLYGON)
322 (gl-vertex 0.25 0.25 0.0)
323 (gl-vertex 0.75 0.25 0.0)
324 (gl-vertex 0.75 0.75 0.0)
325 (gl-vertex 0.25 0.75 0.0)
326 (gl-end)
327 </pre></td></tr></table>
328
329 <p>Actually <code>gl-begin*</code> macro expands into the above calls.
330 It&rsquo;s a matter of taste, but the macro version guarantees
331 begin and end match, and the syntax-aware editor can indent
332 internal calls accordingly.
333 </p>
334 <p>You might have noticed that the type suffix in C API
335 is not in Gauche binding. The Scheme function figures out the
336 type of passed arguments and calls appropriate C API.
337 SRFI-4 uniform numeric vectors are used to represent
338 arrays of numbers.
339 </p>
340 <table><tr><td>&nbsp;</td><td><pre class="example"> (gl-vertex 1.0 2.0 3.0) &rArr; glVertex3d
341 (gl-vertex '#f32(1.0 2.0)) &rArr; glVertex2fv
342 (gl-vertex '#s32(3 2 5)) &rArr; glVertex3iv
343 </pre></td></tr></table>
344
345 <p>Generally, passing uniform vectors is much more efficient than
346 giving individual numbers, for the former can eliminate
347 the cost of type checking and unboxing.
348 </p>
349 <p>Some GL calls can also take <code>gl.math3d</code> primitive objects
350 such as <code>vector4f</code>, <code>point4f</code> or <code>matrix4f</code>
351 (See section <a href="#Vectors-and-matrices">Vectors and matrices</a>). For example, you can pass
352 <code>point4f</code> object to <code>gl-vertex</code>, <code>vector4f</code> to
353 <code>gl-normal</code>, and <code>matrix4f</code> to <code>gl-mult-matrix</code>.
354 They are efficient since calculations on those types are
355 defined natively in <code>gl.math3d</code>, and passing it to GL call
356 doesn&rsquo;t cost unboxing.
357 </p>
358 <hr size="6">
359 <a name="Advanced-GL-features"></a>
360 <table cellpadding="1" cellspacing="1" border="0">
361 <tr><td valign="middle" align="left">[<a href="#GL-calls-in-Scheme" title="Previous section in reading order"> &lt; </a>]</td>
362 <td valign="middle" align="left">[<a href="#Using-GLUT" title="Next section in reading order"> &gt; </a>]</td>
363 <td valign="middle" align="left"> &nbsp; </td>
364 <td valign="middle" align="left">[<a href="#Getting-Started" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
365 <td valign="middle" align="left">[<a href="#Getting-Started" title="Up section"> Up </a>]</td>
366 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Next chapter"> &gt;&gt; </a>]</td>
367 <td valign="middle" align="left"> &nbsp; </td>
368 <td valign="middle" align="left"> &nbsp; </td>
369 <td valign="middle" align="left"> &nbsp; </td>
370 <td valign="middle" align="left"> &nbsp; </td>
371 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
372 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
373 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
374 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
375 </tr></table>
376 <a name="Advanced-GL-features-1"></a>
377 <h2 class="section">3.2 Advanced GL features</h2>
378
379 <p>Although Gauche-gl supports up to OpenGL 2.0, all functionalities
380 may not be available on the target machine&rsquo;s driver/hardware.
381 The application needs to check the availability of the extension
382 and/or GL version before using the features that are only supported
383 by the extension/version.
384 </p>
385 <p>Gauche-gl provides a couple of utility procedures to check the
386 feature sets at runtime.
387 For example, you can switch behavior depending on OpenGL 1.3 feature
388 availability:
389 </p>
390 <table><tr><td>&nbsp;</td><td><pre class="example">(if (gl-version&gt;=? &quot;1.3&quot;)
391 (code-using-features-available-in-OpenGL-1.3-and-later ...)
392 (alternative-code ...))
393 </pre></td></tr></table>
394
395 <p>Or you can check the availability of extensions:
396 </p>
397 <table><tr><td>&nbsp;</td><td><pre class="example">(unless (gl-extension-supported? 'GL_ARB_shader_objects
398 'GL_ARB_fragment_shader
399 'GL_ARB_vertex_shader
400 'GL_ARB_shading_language_100)
401 (error &quot;OpenGL Shading Language extensions not available&quot;))
402 </pre></td></tr></table>
403
404 <p>See <a href="#GL-feature-checking">GL feature checking</a> for the details.
405 </p>
406 <p>If the client program calls a GL API that are not supported on
407 the platform, an error is signalled.
408 </p>
409
410 <hr size="6">
411 <a name="Using-GLUT"></a>
412 <table cellpadding="1" cellspacing="1" border="0">
413 <tr><td valign="middle" align="left">[<a href="#Advanced-GL-features" title="Previous section in reading order"> &lt; </a>]</td>
414 <td valign="middle" align="left">[<a href="#Performance-tips" title="Next section in reading order"> &gt; </a>]</td>
415 <td valign="middle" align="left"> &nbsp; </td>
416 <td valign="middle" align="left">[<a href="#Getting-Started" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
417 <td valign="middle" align="left">[<a href="#Getting-Started" title="Up section"> Up </a>]</td>
418 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Next chapter"> &gt;&gt; </a>]</td>
419 <td valign="middle" align="left"> &nbsp; </td>
420 <td valign="middle" align="left"> &nbsp; </td>
421 <td valign="middle" align="left"> &nbsp; </td>
422 <td valign="middle" align="left"> &nbsp; </td>
423 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
424 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
425 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
426 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
427 </tr></table>
428 <a name="Using-GLUT-1"></a>
429 <h2 class="section">3.3 Using GLUT</h2>
430
431 <p>In order to make a runnable script, you need to use some
432 windowing system interface. GLUT binding provides a simple
433 way for it.
434 </p>
435 <p>Here is a complete runnable Scheme script, ported from
436 Example 1-2 in &quot;OpenGL Programming Guide&quot;:
437 </p>
438 <table><tr><td>&nbsp;</td><td><pre class="example">(use gl)
439 (use gl.glut)
440
441 (define (disp)
442 (gl-clear GL_COLOR_BUFFER_BIT)
443 (gl-color '#f32(1.0 1.0 1.0))
444 (gl-begin* GL_POLYGON
445 (gl-vertex '#f32(0.25 0.25 0.0))
446 (gl-vertex '#f32(0.75 0.25 0.0))
447 (gl-vertex '#f32(0.75 0.75 0.0))
448 (gl-vertex '#f32(0.25 0.75 0.0))
449 )
450 (gl-flush)
451 )
452
453 (define (init)
454 (gl-clear-color 0.0 0.0 0.0 0.0)
455 (gl-matrix-mode GL_PROJECTION)
456 (gl-load-identity)
457 (gl-ortho 0.0 1.0 0.0 1.0 -1.0 1.0)
458 )
459
460 (define (keyboard key x y)
461 (cond
462 ((= key 27) (exit 0))
463 ))
464
465 (define (main args)
466 (glut-init args)
467 (glut-init-display-mode (logior GLUT_SINGLE GLUT_RGB))
468 (glut-init-window-size 250 250)
469 (glut-init-window-position 100 100)
470 (glut-create-window &quot;hello&quot;)
471 (init)
472 (glut-display-func disp)
473 (glut-keyboard-func keyboard)
474 (glut-main-loop)
475 0)
476 </pre></td></tr></table>
477
478 <p>The <code>(use gl.glut)</code> form loads GLUT binding.
479 The name mapping is the same as GL&rsquo;s: mixed case names to
480 hyphenated names.
481 </p>
482 <p>In order to handle various events, you can pass a closure
483 to <code>glut-display-func</code> etc. In the keyboard and mouse
484 event callback, all arguments are integers.
485 </p>
486 <p>There are more examples under the &lsquo;<tt>examples/</tt>&rsquo; directory
487 which uses GLUT.
488 </p>
489 <hr size="6">
490 <a name="Performance-tips"></a>
491 <table cellpadding="1" cellspacing="1" border="0">
492 <tr><td valign="middle" align="left">[<a href="#Using-GLUT" title="Previous section in reading order"> &lt; </a>]</td>
493 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Next section in reading order"> &gt; </a>]</td>
494 <td valign="middle" align="left"> &nbsp; </td>
495 <td valign="middle" align="left">[<a href="#Getting-Started" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
496 <td valign="middle" align="left">[<a href="#Getting-Started" title="Up section"> Up </a>]</td>
497 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Next chapter"> &gt;&gt; </a>]</td>
498 <td valign="middle" align="left"> &nbsp; </td>
499 <td valign="middle" align="left"> &nbsp; </td>
500 <td valign="middle" align="left"> &nbsp; </td>
501 <td valign="middle" align="left"> &nbsp; </td>
502 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
503 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
504 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
505 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
506 </tr></table>
507 <a name="Performance-tips-1"></a>
508 <h2 class="section">3.4 Performance tips</h2>
509
510 <p>If you want to display millions of polygons in 30 fps,
511 Gauche-gl is not for you. Consider using implementations
512 that compiles into native code. The purpose of Gauche-gl
513 is to provide reasonable performance for interactive development
514 and experiment.
515 </p>
516 <p>However, if you know some tips, actually you can go quite far,
517 especially with recent processors and graphics chips.
518 </p>
519 <dl compact="compact">
520 <dt> <em>Avoid alocation within the inner loop.</em></dt>
521 <dd><p>The functional (non-destructive) operations tend to return
522 newly-allocated objects.
523 Use linear-update (destructive) versions instead,
524 such as <code>matrix-mul!</code>, <code>u8vector-add!</code>, etc,
525 whenever possible.
526 Pre-allocating temporary vectors is also effective.
527 </p>
528 </dd>
529 <dt> <em>Reduce the number of calls within the inner loop.</em></dt>
530 <dd><p>Vertex arrays are much better than calling <code>gl-vertex</code>
531 over and over. Also consider using display lists if
532 you&rsquo;re displaying rigid objects.
533 </p>
534 </dd>
535 <dt> <em>Keep numbers within a uniform vector.</em></dt>
536 <dd><p>Every time you take a number out of a uniform vector
537 (or <code>&lt;vector4f&gt;</code> etc.), Gauche has to wrap the
538 number by a tag (boxing). Also when you store a number
539 into a uniform vector, Gauche has to check the type
540 of the object, then strip a tag (unboxing).
541 Those are all overhead you wouldn&rsquo;t have if
542 you operate directly on uniform vectors (or <code>&lt;vector4f&gt;</code> etc).
543 </p>
544 </dd>
545 <dt> <em>Write extensions to accelerate.</em></dt>
546 <dd><p>If the above strategies are not enough, consider writing
547 computation-intensive part in C as an extension.
548 The easier way is to make C routines operate on uniform vectors,
549 which is essentially a pointer to an array of numbers from C,
550 and let Scheme handle higher-level data structures.
551 (It could be viewed like relations between a coprocessor and
552 a processor; the former does simple, iterative calculations
553 fast, and the latter handles complicated logic).
554 </p></dd>
555 </dl>
556
557 <hr size="6">
558 <a name="OpenGL-API"></a>
559 <table cellpadding="1" cellspacing="1" border="0">
560 <tr><td valign="middle" align="left">[<a href="#Performance-tips" title="Previous section in reading order"> &lt; </a>]</td>
561 <td valign="middle" align="left">[<a href="#GL-data-types" title="Next section in reading order"> &gt; </a>]</td>
562 <td valign="middle" align="left"> &nbsp; </td>
563 <td valign="middle" align="left">[<a href="#Getting-Started" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
564 <td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
565 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
566 <td valign="middle" align="left"> &nbsp; </td>
567 <td valign="middle" align="left"> &nbsp; </td>
568 <td valign="middle" align="left"> &nbsp; </td>
569 <td valign="middle" align="left"> &nbsp; </td>
570 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
571 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
572 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
573 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
574 </tr></table>
575 <a name="OpenGL-API-1"></a>
576 <h1 class="chapter">4. OpenGL API</h1>
577
578 <p>In this chapter we list a GL and GLU procedures accessible from
579 Gauche-gl, with brief descriptions to help programmers
580 to remind what the functions are. We don&rsquo;t intend to make
581 this an OpenGL reference, though; you should look at the OpenGL book
582 for the details of what each API do.
583 </p>
584 <table class="menu" border="0" cellspacing="0">
585 <tr><td align="left" valign="top"><a href="#GL-data-types">4.1 GL data types</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
586 </td></tr>
587 <tr><td align="left" valign="top"><a href="#GL-feature-checking">4.2 GL feature checking</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
588 </td></tr>
589 <tr><td align="left" valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
590 </td></tr>
591 <tr><td align="left" valign="top"><a href="#GL-state-control">4.4 GL state control</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
592 </td></tr>
593 <tr><td align="left" valign="top"><a href="#GL-states-for-drawing">4.5 GL states for drawing</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
594 </td></tr>
595 <tr><td align="left" valign="top"><a href="#Transformation">4.6 Transformation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
596 </td></tr>
597 <tr><td align="left" valign="top"><a href="#Display-lists">4.7 Display lists</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
598 </td></tr>
599 <tr><td align="left" valign="top"><a href="#Vertex-arrays">4.8 Vertex arrays</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
600 </td></tr>
601 <tr><td align="left" valign="top"><a href="#Lighting">4.9 Lighting</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
602 </td></tr>
603 <tr><td align="left" valign="top"><a href="#Pixels">4.10 Pixels, bitmaps and images</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
604 </td></tr>
605 <tr><td align="left" valign="top"><a href="#Texture-mapping">4.11 Texture mapping</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
606 </td></tr>
607 <tr><td align="left" valign="top"><a href="#Framebuffers">4.12 Framebuffers</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
608 </td></tr>
609 <tr><td align="left" valign="top"><a href="#Selection-and-feedback">4.13 Selection and feedback</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
610 </td></tr>
611 <tr><td align="left" valign="top"><a href="#Projection">4.14 Projection</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
612 </td></tr>
613 <tr><td align="left" valign="top"><a href="#Quadrics">4.15 Quadrics</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
614 </td></tr>
615 <tr><td align="left" valign="top"><a href="#Nurbs">4.16 Nurbs</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
616 </td></tr>
617 <tr><td align="left" valign="top"><a href="#Polygon-tesselation">4.17 Polygon tesselation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
618 </td></tr>
619 <tr><td align="left" valign="top"><a href="#Programmable-shaders">4.18 Programmable shaders</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
620 </td></tr>
621 </table>
622
623 <hr size="6">
624 <a name="GL-data-types"></a>
625 <table cellpadding="1" cellspacing="1" border="0">
626 <tr><td valign="middle" align="left">[<a href="#OpenGL-API" title="Previous section in reading order"> &lt; </a>]</td>
627 <td valign="middle" align="left">[<a href="#GL-feature-checking" title="Next section in reading order"> &gt; </a>]</td>
628 <td valign="middle" align="left"> &nbsp; </td>
629 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
630 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
631 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
632 <td valign="middle" align="left"> &nbsp; </td>
633 <td valign="middle" align="left"> &nbsp; </td>
634 <td valign="middle" align="left"> &nbsp; </td>
635 <td valign="middle" align="left"> &nbsp; </td>
636 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
637 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
638 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
639 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
640 </tr></table>
641 <a name="GL-data-types-1"></a>
642 <h2 class="section">4.1 GL data types</h2>
643
644 <p>GL doesn&rsquo;t define many data structures: some scalar primitives (e.g.
645 <code>GLint</code>) and arrays of them.
646 </p>
647 <p>For scalar values, Gauche-gl has natural mappings:
648 </p><dl compact="compact">
649 <dt> <code>GLboolean</code></dt>
650 <dd><p>Scheme booleans.
651 </p></dd>
652 <dt> <code>GLbyte, GLubyte, GLshort, GLushort, GLint, GLuint, GLenum, GLbitfield</code></dt>
653 <dd><p>Scheme exact integers.
654 </p></dd>
655 <dt> <code>GLfloat, GLdouble, GLclampf, GLclampd</code></dt>
656 <dd><p>Scheme real numbers.
657 </p></dd>
658 </dl>
659
660
661 <p>For arrays, Gauche-gl uses uniform (srfi-4) vector whenever possible.
662 For float arrays, however, Gauche-gl allows more structured types,
663 such as points or matrices, when they are relevant. Such types are provided
664 in <code>gl.math3d</code> module (see <a href="#Vectors-and-matrices">Vectors and matrices</a>),
665 which also provides common arithmetics between those types.
666 Another exception is an array of GLboolean&mdash;it doesn&rsquo;t have corresponding
667 uniform vector representation. Gauche-gl defines a new type,
668 <code>&lt;gl-boolean-vector&gt;</code>, to represent an array of GLboolean.
669 See below for operations provided on it.
670 </p>
671 <dl compact="compact">
672 <dt> <code>GLbyte[]</code></dt>
673 <dd><p><code>&lt;s8vector&gt;</code>
674 </p></dd>
675 <dt> <code>GLubyte[]</code></dt>
676 <dd><p><code>&lt;u8vector&gt;</code>
677 </p></dd>
678 <dt> <code>GLshort[]</code></dt>
679 <dd><p><code>&lt;s16vector&gt;</code>
680 </p></dd>
681 <dt> <code>GLushort[]</code></dt>
682 <dd><p><code>&lt;u16vector&gt;</code>
683 </p></dd>
684 <dt> <code>GLint[]</code></dt>
685 <dd><p><code>&lt;s32vector&gt;</code>
686 </p></dd>
687 <dt> <code>GLuint[]</code></dt>
688 <dd><p><code>&lt;u32vector&gt;</code>
689 </p></dd>
690 <dt> <code>GLfloat[], GLclampf[]</code></dt>
691 <dd><p><code>&lt;f32vector&gt;</code>, <code>&lt;point4f&gt;</code>, <code>&lt;vector-4f&gt;</code>,
692 <code>&lt;point4f-array&gt;</code>, <code>&lt;vector4f-array&gt;</code>,
693 <code>&lt;matrix4f&gt;</code>, <code>&lt;quatf&gt;</code>.
694 </p></dd>
695 <dt> <code>GLdouble[], GLclampd[]</code></dt>
696 <dd><p><code>&lt;f64vector&gt;</code>
697 </p></dd>
698 <dt> <code>GLboolean[]</code></dt>
699 <dd><p><code>&lt;gl-boolean-vector&gt;</code>
700 </p></dd>
701 </dl>
702
703 <a name="GL-boolean-vectors"></a>
704 <h3 class="subheading">GL boolean vectors</h3>
705
706 <dl>
707 <dt><a name="index-_003cgl_002dboolean_002dvector_003e"></a><u>Class:</u> <b>&lt;gl-boolean-vector&gt;</b></dt>
708 <dd><p>A class for an array of boolean values. You can pass its instance
709 to the GL APIs that expect an array of GLbooleans. Its internal
710 representation is bitwise compatible to GLbooean array, so passing
711 it is quite efficient.
712 </p>
713 <p>This class inherits <code>&lt;sequence&gt;</code>, so you can use generic
714 sequence operations on it.
715 </p>
716 <p>The external representation of GL boolean vector uses srfi-10
717 notation, and can be read back. For example, a GL boolean vector
718 of length 5 may be written something like this:
719 </p><table><tr><td>&nbsp;</td><td><pre class="example">#,(gl-boolean-vector #t #f #t #f #t)
720 </pre></td></tr></table>
721 </dd></dl>
722
723 <dl>
724 <dt><a name="index-make_002dgl_002dboolean_002dvector"></a><u>Function:</u> <b>make-gl-boolean-vector</b><i> size &amp;optional init</i></dt>
725 <dd><p>Returns a GL boolean vector of <var>size</var> elements. Elements are
726 initialized by either <code>#f</code> or <code>#t</code>, according to <var>init</var>.
727 </p>
728 <table><tr><td>&nbsp;</td><td><pre class="example">(make-gl-boolean-vector 3 #t) &rArr; #,(gl-boolean-vector #t #t #t)
729 </pre></td></tr></table>
730 </dd></dl>
731
732 <dl>
733 <dt><a name="index-gl_002dboolean_002dvector"></a><u>Function:</u> <b>gl-boolean-vector</b><i> bool &hellip;</i></dt>
734 <dd><p>Returns a GL boolean vector, whose elements are <var>bool</var> &hellip;.
735 </p>
736 <table><tr><td>&nbsp;</td><td><pre class="example">(gl-boolean-vector #f #t #t) &rArr; #,(gl-boolean-vector #f #t #t)
737 </pre></td></tr></table>
738 </dd></dl>
739
740 <dl>
741 <dt><a name="index-gl_002dboolean_002dvector_003f"></a><u>Function:</u> <b>gl-boolean-vector?</b><i> obj</i></dt>
742 <dd><p>Returns <code>#t</code> if <var>obj</var> is a GL boolean vector, <code>#f</code> otherwise.
743 </p></dd></dl>
744
745 <dl>
746 <dt><a name="index-gl_002dboolean_002dvector_002dlength"></a><u>Function:</u> <b>gl-boolean-vector-length</b><i> v</i></dt>
747 <dd><p>Returns length of a GL boolean vector <var>v</var>.
748 You can also use the sequence generic function <code>size-of</code>.
749 </p></dd></dl>
750
751 <dl>
752 <dt><a name="index-gl_002dboolean_002dvector_002dfill_0021"></a><u>Function:</u> <b>gl-boolean-vector-fill!</b><i> v bool</i></dt>
753 <dd><p>Fills a GL boolean vector <var>v</var> with a boolean value <var>bool</var>.
754 </p></dd></dl>
755
756 <dl>
757 <dt><a name="index-list_002d_003egl_002dboolean_002dvector"></a><u>Function:</u> <b>list-&gt;gl-boolean-vector</b><i> bools</i></dt>
758 <dd><p>Coerce list of boolean values to a GL boolean vector.
759 </p>
760 <p>You can also use the <code>coerce-to</code> generic function to convert
761 between GL boolean vectors and other sequences.
762 </p></dd></dl>
763
764 <dl>
765 <dt><a name="index-gl_002dboolean_002dvector_002dref"></a><u>Function:</u> <b>gl-boolean-vector-ref</b><i> v k &amp;optional fallback</i></dt>
766 <dd><p>Returns <var>k</var>-th element of a GL boolean vector <var>v</var>.
767 If <var>k</var> is out of range and <var>fallback</var> is provided,
768 it is returned. If <var>k</var> is out of range and <var>fallback</var> is
769 omitted, an error is signalled.
770 </p>
771 <p>You can also use generic function <code>ref</code> to access a
772 GL boolean vector.
773 </p></dd></dl>
774
775 <dl>
776 <dt><a name="index-gl_002dboolean_002dvector_002dset_0021"></a><u>Function:</u> <b>gl-boolean-vector-set!</b><i> v k bool</i></dt>
777 <dd><p>Sets <var>k</var>-th element of a GL boolean vector <var>v</var>
778 by a boolean value <var>bool</var>.
779 </p>
780 <p>You can also use generic function <code>(setter ref)</code> to modify a
781 GL boolean vector.
782 </p></dd></dl>
783
784 <dl>
785 <dt><a name="index-gl_002dboolean_002dvector_002dcopy"></a><u>Function:</u> <b>gl-boolean-vector-copy</b><i> v</i></dt>
786 <dd><p>Returns a copy of a GL boolean vector <var>v</var>.
787 </p></dd></dl>
788
789
790 <hr size="6">
791 <a name="GL-feature-checking"></a>
792 <table cellpadding="1" cellspacing="1" border="0">
793 <tr><td valign="middle" align="left">[<a href="#GL-data-types" title="Previous section in reading order"> &lt; </a>]</td>
794 <td valign="middle" align="left">[<a href="#Drawing-functions" title="Next section in reading order"> &gt; </a>]</td>
795 <td valign="middle" align="left"> &nbsp; </td>
796 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
797 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
798 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
799 <td valign="middle" align="left"> &nbsp; </td>
800 <td valign="middle" align="left"> &nbsp; </td>
801 <td valign="middle" align="left"> &nbsp; </td>
802 <td valign="middle" align="left"> &nbsp; </td>
803 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
804 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
805 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
806 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
807 </tr></table>
808 <a name="GL-feature-checking-1"></a>
809 <h2 class="section">4.2 GL feature checking</h2>
810
811 <p>If you want to use a feature that are in OpenGL 1.2 or later, or
812 in a GL extension, you have to check its availability before
813 actually calling the API function. You can use the following
814 utility procedures.
815 </p>
816 <p>Note that those functions may return <code>#f</code> if the connection
817 to the display subsystem isn&rsquo;t established yet. Usually you have
818 to initialize and open an window before checking the features.
819 </p>
820 <dl>
821 <dt><a name="index-gl_002dextension_002davailable_003f"></a><u>Function:</u> <b>gl-extension-available?</b><i> extension-name &hellip;</i></dt>
822 <dd><p>Returns <code>#t</code> if GL extensions listed in <var>extension-name</var> &hellip;
823 are all available. <var>Extension-name</var> can be a symbol or
824 a string (e.g. <code>GL_ARB_multisample</code>).
825 </p></dd></dl>
826
827 <dl>
828 <dt><a name="index-gl_002dversion_003c_003f"></a><u>Function:</u> <b>gl-version&lt;?</b><i> version</i></dt>
829 <dt><a name="index-gl_002dversion_003c_003d_003f"></a><u>Function:</u> <b>gl-version&lt;=?</b><i> version</i></dt>
830 <dt><a name="index-gl_002dversion_003e_003f"></a><u>Function:</u> <b>gl-version&gt;?</b><i> version</i></dt>
831 <dt><a name="index-gl_002dversion_003e_003d_003f"></a><u>Function:</u> <b>gl-version&gt;=?</b><i> version</i></dt>
832 <dt><a name="index-gl_002dversion_003d_003f"></a><u>Function:</u> <b>gl-version=?</b><i> version</i></dt>
833 <dd><p>Returns <code>#t</code> if the runtime OpenGL version is less than,
834 less thanor equal to, greater than, greater than or equal to,
835 and equal to, the given <var>version</var>, respectively.
836 </p>
837 <p>Give <var>version</var> in a string, e.g. <code>&quot;1.3&quot;</code>.
838 </p></dd></dl>
839
840 <hr size="6">
841 <a name="Drawing-functions"></a>
842 <table cellpadding="1" cellspacing="1" border="0">
843 <tr><td valign="middle" align="left">[<a href="#GL-feature-checking" title="Previous section in reading order"> &lt; </a>]</td>
844 <td valign="middle" align="left">[<a href="#GL-state-control" title="Next section in reading order"> &gt; </a>]</td>
845 <td valign="middle" align="left"> &nbsp; </td>
846 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
847 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
848 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
849 <td valign="middle" align="left"> &nbsp; </td>
850 <td valign="middle" align="left"> &nbsp; </td>
851 <td valign="middle" align="left"> &nbsp; </td>
852 <td valign="middle" align="left"> &nbsp; </td>
853 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
854 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
855 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
856 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
857 </tr></table>
858 <a name="Drawing-functions-1"></a>
859 <h2 class="section">4.3 Drawing functions</h2>
860
861 <dl>
862 <dt><a name="index-gl_002dbegin_002a"></a><u>Macro:</u> <b>gl-begin*</b><i> mode gl-commands &hellip;</i></dt>
863 <dd><a name="index-GL_005fPOINTS"></a>
864 <a name="index-GL_005fLINES"></a>
865 <a name="index-GL_005fLINE_005fSTRIP"></a>
866 <a name="index-GL_005fLINE_005fLOOP"></a>
867 <a name="index-GL_005fTRIANGLES"></a>
868 <a name="index-GL_005fTRIANGLE_005fSTRIP"></a>
869 <a name="index-GL_005fTRIANGLE_005fFAN"></a>
870 <a name="index-GL_005fQUADS"></a>
871 <a name="index-GL_005fQUAD_005fSTRIP"></a>
872 <a name="index-GL_005fPOLYGON"></a>
873
874 <p>Executes <var>gl-commands</var> between <code>(gl-begin <var>mode</var>)</code> and
875 <code>(gl-end)</code>. <var>Mode</var> can be one of the following constants.
876 </p>
877 <dl compact="compact">
878 <dt> <code>GL_POINTS</code></dt>
879 <dd><p>Individual points.
880 </p></dd>
881 <dt> <code>GL_LINES</code></dt>
882 <dd><p>Pairs of vertices interpreted as individual line segments.
883 </p></dd>
884 <dt> <code>GL_LINE_STRIP</code></dt>
885 <dd><p>Series of connected line segments.
886 </p></dd>
887 <dt> <code>GL_LINE_LOOP</code></dt>
888 <dd><p>Same as above, with a segment added between last and first vertices.
889 </p></dd>
890 <dt> <code>GL_TRIANGLES</code></dt>
891 <dd><p>Triples of vertices interpreted as triangles.
892 </p></dd>
893 <dt> <code>GL_TRIANGLE_STRIP</code></dt>
894 <dd><p>Linked trip of triangles.
895 </p></dd>
896 <dt> <code>GL_TRIANGLE_FAN</code></dt>
897 <dd><p>Linked fan of triangles.
898 </p></dd>
899 <dt> <code>GL_QUADS</code></dt>
900 <dd><p>Quadruples of vertices interpreted as four-sided polygons.
901 </p></dd>
902 <dt> <code>GL_QUAD_STRIP</code></dt>
903 <dd><p>Linked strip of quadrilaterals.
904 </p></dd>
905 <dt> <code>GL_POLYGON</code></dt>
906 <dd><p>Boundary of a simple, convex polygon.
907 </p></dd>
908 </dl>
909
910 </dd></dl>
911
912 <dl>
913 <dt><a name="index-gl_002dbegin"></a><u>Function:</u> <b>gl-begin</b><i> mode</i></dt>
914 <dt><a name="index-gl_002dend"></a><u>Function:</u> <b>gl-end</b></dt>
915 <dd><p>Corresponds to <code>glBegin</code> and <code>glEnd</code>.
916 Use of <code>gl-begin*</code> macro is recommended, though.
917 </p></dd></dl>
918
919 <dl>
920 <dt><a name="index-gl_002dflush"></a><u>Function:</u> <b>gl-flush</b></dt>
921 <dd><p>Flush the GL command buffer.
922 </p></dd></dl>
923
924 <dl>
925 <dt><a name="index-gl_002dfinish"></a><u>Function:</u> <b>gl-finish</b></dt>
926 <dd><p>Make sure all previously issued GL commands are completed.
927 </p></dd></dl>
928
929 <dl>
930 <dt><a name="index-gl_002drect"></a><u>Function:</u> <b>gl-rect</b><i> point1 point2</i></dt>
931 <dt><a name="index-gl_002drect-1"></a><u>Function:</u> <b>gl-rect</b><i> x1 y1 x2 y2</i></dt>
932 <dd><p>Draws a rectangle. In the first form,
933 <var>point1</var> and <var>point2</var> can be either
934 <code>&lt;point4f&gt;</code>, or f32, f64, s32, or s16vector of
935 length 2. Types of both args should match.
936 In the second form, all args should be a real numbers (<code>glRectd</code> is used).
937 </p></dd></dl>
938
939 <dl>
940 <dt><a name="index-gl_002dvertex"></a><u>Function:</u> <b>gl-vertex</b><i> point</i></dt>
941 <dt><a name="index-gl_002dvertex-1"></a><u>Function:</u> <b>gl-vertex</b><i> x y &amp;optional z w</i></dt>
942 <dd><p>Specify vertices. In the first form, <var>point</var> can be
943 either <code>&lt;point4f&gt;</code>, or f32, f64, s32 or s16vector
944 of length 2, 3 or 4.
945 In the second form, all args should be a real numbers.
946 </p></dd></dl>
947
948 <dl>
949 <dt><a name="index-gl_002dnormal"></a><u>Function:</u> <b>gl-normal</b><i> vector</i></dt>
950 <dt><a name="index-gl_002dnormal-1"></a><u>Function:</u> <b>gl-normal</b><i> x y z</i></dt>
951 <dd><p>Sets vertex normal vector. In the first form, <var>vector</var> can be
952 either <code>&lt;vector4f&gt;</code> (the fourth element is ignored),
953 or f32, f64, s32 ro s16vector of length 3.
954 In the second form, all args should be a real numbers.
955 </p></dd></dl>
956
957 <dl>
958 <dt><a name="index-gl_002dcolor"></a><u>Function:</u> <b>gl-color</b><i> color</i></dt>
959 <dt><a name="index-gl_002dcolor-1"></a><u>Function:</u> <b>gl-color</b><i> r g b &amp;optional a</i></dt>
960 <dd><p>Sets the current color. In the first form, <var>color</var> can be
961 either f32, f64, u8, u16, u32, s8, s16, or s32vector of length 3 or 4.
962 In the second form, all args should be a real numbers.
963 </p></dd></dl>
964
965 <dl>
966 <dt><a name="index-gl_002dtex_002dcoord"></a><u>Function:</u> <b>gl-tex-coord</b><i> coord</i></dt>
967 <dt><a name="index-gl_002dtex_002dcoord-1"></a><u>Function:</u> <b>gl-tex-coord</b><i> u v &amp;optional s t</i></dt>
968 <dd><p>Sets the current texture coordinates. In the first form,
969 <var>coord</var> can be either f32, f64, s32 or s16vector of length
970 1, 2, 3, or 4. In the second form, all args should be a real numbers.
971 </p></dd></dl>
972
973 <dl>
974 <dt><a name="index-gl_002draster_002dpos"></a><u>Function:</u> <b>gl-raster-pos</b><i> pos</i></dt>
975 <dt><a name="index-gl_002draster_002dpos-1"></a><u>Function:</u> <b>gl-raster-pos</b><i> x y &amp;optional z w</i></dt>
976 <dd><p>Sets the current raster position. In the first form,
977 <var>pos</var> can be eitehr f32, f64, s32 or s16vector. In the
978 second form, all args should be a real numbers.
979 </p></dd></dl>
980
981 <hr size="6">
982 <a name="GL-state-control"></a>
983 <table cellpadding="1" cellspacing="1" border="0">
984 <tr><td valign="middle" align="left">[<a href="#Drawing-functions" title="Previous section in reading order"> &lt; </a>]</td>
985 <td valign="middle" align="left">[<a href="#GL-states-for-drawing" title="Next section in reading order"> &gt; </a>]</td>
986 <td valign="middle" align="left"> &nbsp; </td>
987 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
988 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
989 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
990 <td valign="middle" align="left"> &nbsp; </td>
991 <td valign="middle" align="left"> &nbsp; </td>
992 <td valign="middle" align="left"> &nbsp; </td>
993 <td valign="middle" align="left"> &nbsp; </td>
994 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
995 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
996 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
997 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
998 </tr></table>
999 <a name="GL-state-control-1"></a>
1000 <h2 class="section">4.4 GL state control</h2>
1001
1002 <a name="Capabilities"></a>
1003 <h4 class="subsubheading">Capabilities</h4>
1004
1005 <dl>
1006 <dt><a name="index-gl_002denable"></a><u>Function:</u> <b>gl-enable</b><i> cap</i></dt>
1007 <dt><a name="index-gl_002ddisable"></a><u>Function:</u> <b>gl-disable</b><i> cap</i></dt>
1008 <dd><p>Turns on and off a capability <var>cap</var>. Check out OpenGL reference
1009 for the list of capabilities.
1010 </p></dd></dl>
1011
1012 <dl>
1013 <dt><a name="index-gl_002dis_002denabled"></a><u>Function:</u> <b>gl-is-enabled</b><i> cap</i></dt>
1014 <dd><p>Returns <code>#t</code> of <code>#f</code> depending on <var>cap</var> is enabled or not.
1015 </p></dd></dl>
1016
1017 <dl>
1018 <dt><a name="index-gl_002denable_002dclient_002dstate"></a><u>Function:</u> <b>gl-enable-client-state</b><i> array</i></dt>
1019 <dt><a name="index-gl_002ddisable_002dclient_002dstate"></a><u>Function:</u> <b>gl-disable-client-state</b><i> array</i></dt>
1020 <dd><p>Enable/disable a client-side array (e.g. vertex array) specified by
1021 <var>array</var>. <var>Array</var> can be one of the following constants.
1022 </p>
1023 <dl compact="compact">
1024 <dt> <code>GL_VERTEX_ARRAY</code></dt>
1025 <dt> <code>GL_COLOR_ARRAY</code></dt>
1026 <dt> <code>GL_INDEX_ARRAY</code></dt>
1027 <dt> <code>GL_NORMAL_ARRAY</code></dt>
1028 <dt> <code>GL_TEXTURE_COORD_ARRAY</code></dt>
1029 <dt> <code>GL_EDGE_FLAG_ARRAY</code></dt>
1030 </dl>
1031
1032 </dd></dl>
1033
1034 <a name="State-values"></a>
1035 <h4 class="subsubheading">State values</h4>
1036
1037 <p>Gauche has two variations for each type of OpenGL <code>glGetTYPE</code> APIs;
1038 nondestructive version and destructive versions. Nondestructive versions
1039 such as <code>gl-get-boolean</code> allocates and returns the vector of
1040 appropriate type for the state. For destructive versions such as
1041 <code>gl-get-boolean!</code>, you need to pass a vector to be filled in.
1042 </p>
1043 <p>The destructive version is non-allocating operation, so it is suitable
1044 if you call it within the drawing loop.
1045 </p>
1046 <p>If the state has a scalar value, the non-destructive version of
1047 query function returns a scalar value, but you need to pass a
1048 (uniform) vector of length 1 for the destructive version.
1049 </p>
1050 <dl>
1051 <dt><a name="index-gl_002dstate_002dvector_002dsize"></a><u>Function:</u> <b>gl-state-vector-size</b><i> state</i></dt>
1052 <dd><p>[Gauche specific]
1053 Returns the required size of the vector to retrieve GL state <var>state</var>.
1054 It is useful to prepare the vector to pass to the destructive version
1055 of <code>glGetTYPE</code> API.
1056 </p></dd></dl>
1057
1058 <dl>
1059 <dt><a name="index-gl_002dget_002dboolean"></a><u>Function:</u> <b>gl-get-boolean</b><i> state</i></dt>
1060 <dt><a name="index-gl_002dget_002dboolean_0021"></a><u>Function:</u> <b>gl-get-boolean!</b><i> gl-boolean-vector state</i></dt>
1061 <dd><p>Get (a) boolean state value(s).
1062 </p></dd></dl>
1063
1064 <dl>
1065 <dt><a name="index-gl_002dget_002dinteger"></a><u>Function:</u> <b>gl-get-integer</b><i> state</i></dt>
1066 <dt><a name="index-gl_002dget_002dinteger_0021"></a><u>Function:</u> <b>gl-get-integer!</b><i> s32vector state</i></dt>
1067 <dd><p>Get (an) integer state value(s).
1068 </p></dd></dl>
1069
1070 <dl>
1071 <dt><a name="index-gl_002dget_002dfloat"></a><u>Function:</u> <b>gl-get-float</b><i> state</i></dt>
1072 <dt><a name="index-gl_002dget_002dfloat_0021"></a><u>Function:</u> <b>gl-get-float!</b><i> f32vector state</i></dt>
1073 <dd><p>Get (a) single-precision floating-point state value(s).
1074 </p></dd></dl>
1075
1076 <dl>
1077 <dt><a name="index-gl_002dget_002ddouble"></a><u>Function:</u> <b>gl-get-double</b><i> state</i></dt>
1078 <dt><a name="index-gl_002dget_002ddouble_0021"></a><u>Function:</u> <b>gl-get-double!</b><i> f64vector state</i></dt>
1079 <dd><p>Get (a) double-precision floating-point state value(s).
1080 </p></dd></dl>
1081
1082 <a name="Push_002fpop-attributes"></a>
1083 <h4 class="subsubheading">Push/pop attributes</h4>
1084
1085 <dl>
1086 <dt><a name="index-gl_002dpush_002dattrib"></a><u>Function:</u> <b>gl-push-attrib</b><i> mask</i></dt>
1087 <dt><a name="index-gl_002dpop_002dattrib"></a><u>Function:</u> <b>gl-pop-attrib</b></dt>
1088 <dd><p>Push/pop attributes indicated by <var>mask</var>.
1089 Valid <var>mask</var> can be <code>logior</code> of the following bits
1090 (GLL_ALL_ATTRIB_BITS is <code>logior</code> of all the bits).
1091 </p>
1092 <dl compact="compact">
1093 <dt> <code>GL_ACCUM_BUFFER_BIT</code></dt>
1094 <dt> <code>GL_COLOR_BUFFER_BIT</code></dt>
1095 <dt> <code>GL_CURRENT_BIT</code></dt>
1096 <dt> <code>GL_DEPTH_BUFFER_BIT</code></dt>
1097 <dt> <code>GL_ENABLE_BIT</code></dt>
1098 <dt> <code>GL_EVAL_BIT</code></dt>
1099 <dt> <code>GL_FOG_BIT</code></dt>
1100 <dt> <code>GL_HINT_BIT</code></dt>
1101 <dt> <code>GL_LIGHTING_BIT</code></dt>
1102 <dt> <code>GL_LINE_BIT</code></dt>
1103 <dt> <code>GL_LIST_BIT</code></dt>
1104 <dt> <code>GL_PIXEL_MODE_BIT</code></dt>
1105 <dt> <code>GL_POINT_BIT</code></dt>
1106 <dt> <code>GL_POLYGON_BIT</code></dt>
1107 <dt> <code>GL_POLYGON_STIPPLE_BIT</code></dt>
1108 <dt> <code>GL_SCISSOR_BIT</code></dt>
1109 <dt> <code>GL_STENCIL_BUFFER_BIT</code></dt>
1110 <dt> <code>GL_TEXTURE_BIT</code></dt>
1111 <dt> <code>GL_TRANSFORM_BIT</code></dt>
1112 <dt> <code>GL_VIEWPORT_BIT</code></dt>
1113 <dt> <code>GL_ALL_ATTRIB_BITS</code></dt>
1114 <dd><p>All of the above.
1115 </p></dd>
1116 </dl>
1117 </dd></dl>
1118
1119 <dl>
1120 <dt><a name="index-gl_002dpush_002dclient_002dattrib"></a><u>Function:</u> <b>gl-push-client-attrib</b><i> mask</i></dt>
1121 <dt><a name="index-gl_002dpop_002dclient_002dattrib"></a><u>Function:</u> <b>gl-pop-client-attrib</b></dt>
1122 <dd><p>Push/pop client attributes. Valid <var>mask</var> can be
1123 <code>logior</code> of the following
1124 </p>
1125 <dl compact="compact">
1126 <dt> <code>GL_CLIENT_PIXEL_STORE_BIT</code></dt>
1127 <dt> <code>GL_CLIENT_VERTEX_ARRAY_BIT</code></dt>
1128 <dt> <code>GL_ALL_CLIENT_ATTRIB_BITS</code></dt>
1129 <dd><p>All of the above.
1130 </p></dd>
1131 </dl>
1132 </dd></dl>
1133
1134 <a name="Other-queries"></a>
1135 <h4 class="subsubheading">Other queries</h4>
1136
1137 <dl>
1138 <dt><a name="index-gl_002dget_002derror"></a><u>Function:</u> <b>gl-get-error</b></dt>
1139 <dd><p>Returns the value of the error flag. Returned an integer value.
1140 Check out the OpenGL documentation for the possible error values.
1141 </p>
1142 <p>This function resets the error flag to <code>GL_NO_ERROR</code>.
1143 </p></dd></dl>
1144
1145 <dl>
1146 <dt><a name="index-glu_002derror_002dstring"></a><u>Function:</u> <b>glu-error-string</b><i> error-code</i></dt>
1147 <dd><p>Returns a descriptive string for <var>error-code</var> returned by
1148 <code>gl-get-error</code>.
1149 </p></dd></dl>
1150
1151 <dl>
1152 <dt><a name="index-gl_002dget_002dstring"></a><u>Function:</u> <b>gl-get-string</b><i> name</i></dt>
1153 <dd><p>Returns informative string about <var>name</var> of the GL library.
1154 <var>Name</var> can be one of the following.
1155 </p>
1156 <dl compact="compact">
1157 <dt> <code>GL_VENDOR</code></dt>
1158 <dt> <code>GL_RENDERER</code></dt>
1159 <dt> <code>GL_VERSION</code></dt>
1160 <dt> <code>GL_EXTENSIONS</code></dt>
1161 </dl>
1162
1163 <p>To check a specific version or extension, you can also use
1164 the utility procedure <code>gl-version&gt;?</code> etc. See
1165 <a href="#GL-feature-checking">GL feature checking</a>.
1166 </p></dd></dl>
1167
1168 <dl>
1169 <dt><a name="index-glu_002dget_002dstring"></a><u>Function:</u> <b>glu-get-string</b><i> name</i></dt>
1170 <dd><p>Returns informative string about <var>name</var> of the GLU library.
1171 <var>Name</var> can be one of the following.
1172 </p>
1173 <dl compact="compact">
1174 <dt> <code>GLU_VERSION</code></dt>
1175 <dt> <code>GLU_EXTENSIONS</code></dt>
1176 </dl>
1177 </dd></dl>
1178
1179 <a name="Hints"></a>
1180 <h4 class="subsubheading">Hints</h4>
1181
1182 <dl>
1183 <dt><a name="index-gl_002dhint"></a><u>Function:</u> <b>gl-hint</b><i> target hint</i></dt>
1184 <dd><p>Controls quality of <var>target</var> by <var>hint</var>.
1185 <var>Target</var> can be one of the following:
1186 </p>
1187 <dl compact="compact">
1188 <dt> <code>GL_POINT_SMOOTH_HINT</code></dt>
1189 <dt> <code>GL_LINE_SMOOTH_HINT</code></dt>
1190 <dt> <code>GL_POLYGON_SMOOTH_HINT</code></dt>
1191 <dt> <code>GL_FOG_HINT</code></dt>
1192 <dt> <code>GL_PERSPECTIVE_CORRECTION_HINT</code></dt>
1193 </dl>
1194
1195 <p>And <var>hint</var> can be one of the following:
1196 </p><dl compact="compact">
1197 <dt> <code>GL_FASTEST</code></dt>
1198 <dt> <code>GL_NICEST</code></dt>
1199 <dt> <code>GL_DONT_CARE</code></dt>
1200 </dl>
1201 </dd></dl>
1202
1203
1204 <hr size="6">
1205 <a name="GL-states-for-drawing"></a>
1206 <table cellpadding="1" cellspacing="1" border="0">
1207 <tr><td valign="middle" align="left">[<a href="#GL-state-control" title="Previous section in reading order"> &lt; </a>]</td>
1208 <td valign="middle" align="left">[<a href="#Transformation" title="Next section in reading order"> &gt; </a>]</td>
1209 <td valign="middle" align="left"> &nbsp; </td>
1210 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
1211 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
1212 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
1213 <td valign="middle" align="left"> &nbsp; </td>
1214 <td valign="middle" align="left"> &nbsp; </td>
1215 <td valign="middle" align="left"> &nbsp; </td>
1216 <td valign="middle" align="left"> &nbsp; </td>
1217 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
1218 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
1219 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
1220 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
1221 </tr></table>
1222 <a name="GL-states-for-drawing-1"></a>
1223 <h2 class="section">4.5 GL states for drawing</h2>
1224
1225 <dl>
1226 <dt><a name="index-gl_002dpoint_002dsize"></a><u>Function:</u> <b>gl-point-size</b><i> size</i></dt>
1227 <dd><p>Sets the width in pixels for rendered points.
1228 The possible range of <var>size</var> on the running GL implementation
1229 can be obtained by passing either <code>GL_ALIASED_POINT_SIZE_RANGE</code> or
1230 <code>GL_SMOOTH_POINT_SIZE_RANGE</code> to <code>gl-get-float</code>.
1231 </p></dd></dl>
1232
1233 <dl>
1234 <dt><a name="index-gl_002dline_002dwidth"></a><u>Function:</u> <b>gl-line-width</b><i> width</i></dt>
1235 <dd><p>Sets the width in pixels for rendered lines.
1236 The possible range of <var>width</var> on the running GL implementation
1237 can be obtained by passing either <code>GL_ALIASED_LINE_WIDTH_RANGE</code> or
1238 <code>GL_SMOOTH_LINE_WIDTH_RANGE</code> to <code>gl-get-float</code>.
1239 </p></dd></dl>
1240
1241 <dl>
1242 <dt><a name="index-gl_002dline_002dstipple"></a><u>Function:</u> <b>gl-line-stipple</b><i> factor pat</i></dt>
1243 <dd><p>Sets the current stippling pattern for lines.
1244 <code>pat</code> must be an exact integer, and its lower 16 bits are used
1245 to specify the stipple pattern. <var>Factor</var> is an integer factor
1246 to specify how many pixels corresponds to one bit in <var>pat</var>.
1247 </p>
1248 <p>You have to enable <var>GL_LINE_STIPPLE</var> to use face culling.
1249 </p></dd></dl>
1250
1251 <dl>
1252 <dt><a name="index-gl_002dpolygon_002dmode"></a><u>Function:</u> <b>gl-polygon-mode</b><i> face mode</i></dt>
1253 <dd><p>Specifies the drawing mode for a polygon&rsquo;s front and back faces.
1254 <var>Face</var> can be one of the followings:
1255 </p><dl compact="compact">
1256 <dt> <code>GL_FRONT_AND_BACK</code></dt>
1257 <dt> <code>GL_FRONT</code></dt>
1258 <dt> <code>GL_BACK</code></dt>
1259 </dl>
1260
1261 <p><var>Mode</var> can be one of the followings:
1262 </p><dl compact="compact">
1263 <dt> <code>GL_POINT</code></dt>
1264 <dt> <code>GL_LINE</code></dt>
1265 <dt> <code>GL_FILL</code></dt>
1266 </dl>
1267 </dd></dl>
1268
1269 <dl>
1270 <dt><a name="index-gl_002dfront_002dface"></a><u>Function:</u> <b>gl-front-face</b><i> mode</i></dt>
1271 <dd><p>Controls how OpenGL determine front face of a polygon
1272 <var>Mode</var> can be one of the followings:
1273 </p><dl compact="compact">
1274 <dt> <code>GL_CCW</code></dt>
1275 <dd><p>Front face is where ordered vertices appear in a counterclockwise orientation
1276 (default).
1277 </p></dd>
1278 <dt> <code>GL_CW</code></dt>
1279 <dd><p>Front face is where ordered vertices appear in a clockwise orientation.
1280 </p></dd>
1281 </dl>
1282 </dd></dl>
1283
1284 <dl>
1285 <dt><a name="index-gl_002dcull_002dface"></a><u>Function:</u> <b>gl-cull-face</b><i> mode</i></dt>
1286 <dd><p>Indicates which face of polygons should be culled.
1287 <var>Mode</var> can be one of the followings:
1288 </p><dl compact="compact">
1289 <dt> <code>GL_FRONT</code></dt>
1290 <dt> <code>GL_BACK</code></dt>
1291 <dt> <code>GL_FRONT_AND_BACK</code></dt>
1292 </dl>
1293
1294 <p>You have to enable <var>GL_CULL_FACE</var> to use face culling.
1295 </p></dd></dl>
1296
1297 <dl>
1298 <dt><a name="index-gl_002dpolygon_002dstipple"></a><u>Function:</u> <b>gl-polygon-stipple</b><i> mask</i></dt>
1299 <dd><p>Defines the current stipple pattern for filled polygons.
1300 <var>Mask</var> has to be a u8vector of length 128, specifying a 32x32
1301 bitmap pattern.
1302 You have to enable <var>GL_POLYGON_STIPPLE</var> to use this feature.
1303 </p></dd></dl>
1304
1305
1306 <dl>
1307 <dt><a name="index-gl_002dedge_002dflag"></a><u>Function:</u> <b>gl-edge-flag</b><i> flag</i></dt>
1308 <dd><p>Sets the edge flag(s) of vertices. When <var>flag</var> is
1309 a GL boolean vector, <code>glEdgeFlagv</code> is called.
1310 Otherwise <var>flag</var> is used as a single boolean value
1311 for <code>glEdgeFlag</code>.
1312 </p></dd></dl>
1313
1314 <dl>
1315 <dt><a name="index-gl_002dblend_002dfunc"></a><u>Function:</u> <b>gl-blend-func</b><i> sfactor dfactor</i></dt>
1316 <dd><p>Controls how color values in the fragment being processed (the source)
1317 are combined with the ones in the framebuffer (the destination).
1318 </p>
1319 <p>Possible values for the <var>sfactor</var> and <var>dfactor</var> arguments
1320 are as follows.
1321 </p><dl compact="compact">
1322 <dt> <code>GL_ZERO</code></dt>
1323 <dt> <code>GL_ONE</code></dt>
1324 <dt> <code>GL_DST_COLOR</code></dt>
1325 <dt> <code>GL_SRC_COLOR</code></dt>
1326 <dt> <code>GL_ONE_MINUS_DST_COLOR</code></dt>
1327 <dt> <code>GL_ONE_MINUS_SRC_COLOR</code></dt>
1328 <dt> <code>GL_SRC_ALPHA</code></dt>
1329 <dt> <code>GL_ONE_MINUS_SRC_ALPHA</code></dt>
1330 <dt> <code>GL_DST_ALPHA</code></dt>
1331 <dt> <code>GL_ONE_MINUS_DST_ALPHA</code></dt>
1332 <dt> <code>GL_SRC_ALPHA_SATURATE</code></dt>
1333 <dt> <code>GL_CONSTANT_COLOR</code></dt>
1334 <dt> <code>GL_ONE_MINUS_CONSTANT_COLOR</code></dt>
1335 <dt> <code>GL_CONSTANT_ALPHA</code></dt>
1336 <dt> <code>GL_ONE_MINUS_CONSTANT_ALPHA</code></dt>
1337 </dl>
1338 </dd></dl>
1339
1340 <dl>
1341 <dt><a name="index-gl_002dblend_002dequation"></a><u>Function:</u> <b>gl-blend-equation</b><i> mode</i></dt>
1342 <dd><p>[GL_ARB_imaging]
1343 By default, the source and destination colors are added after
1344 processed as specified by <var>gl-blend-func</var>. With this extension API
1345 you can change the function. <var>Mode</var> can be one of the
1346 following values:
1347 </p><dl compact="compact">
1348 <dt> <code>GL_FUNC_ADD</code></dt>
1349 <dt> <code>GL_FUNC_SUBTRACT</code></dt>
1350 <dt> <code>GL_FUNC_REVERSE_SUBTRACT</code></dt>
1351 <dt> <code>GL_MIN</code></dt>
1352 <dt> <code>GL_MAX</code></dt>
1353 </dl>
1354 </dd></dl>
1355
1356 <dl>
1357 <dt><a name="index-gl_002dblend_002dcolor"></a><u>Function:</u> <b>gl-blend-color</b><i> red green blue alpha</i></dt>
1358 <dd><p>[GL_ARB_imaging]
1359 Sets the constant color used in the blending function.
1360 </p></dd></dl>
1361
1362 <dl>
1363 <dt><a name="index-gl_002dpolygon_002doffset"></a><u>Function:</u> <b>gl-polygon-offset</b><i> factor units</i></dt>
1364 <dd><p>[GL1.1]
1365 Offset the depth value of each fragment. Useful to avoid
1366 artifacts when you draw polygon edges over its surfaces,
1367 for example.
1368 </p></dd></dl>
1369
1370 <dl>
1371 <dt><a name="index-gl_002dclip_002dplane"></a><u>Function:</u> <b>gl-clip-plane</b><i> plane equation</i></dt>
1372 <dd><p>Defines a clipping plane. <var>Plane</var> specifies which clipping
1373 plane you&rsquo;re defining. Use <code>GL_MAX_CLIP_PLANES</code> to
1374 <code>gl-get-integer</code> to obtain the number of clipping planes
1375 you can use. You have to enable the specific clipping plane
1376 (e.g. <code>(gl-enable GL_CLIP_PLANE0)</code>) to use the clipping plane.
1377 </p>
1378 <p><var>Equation</var> must be an f64vector of size 4, specifying four
1379 coefficients of the plane equation, <code>Ax + By + Cz + D = 0</code>.
1380 </p></dd></dl>
1381
1382 <dl>
1383 <dt><a name="index-gl_002dget_002dclip_002dplane"></a><u>Function:</u> <b>gl-get-clip-plane</b><i> plane</i></dt>
1384 <dd><p>Returns the four coefficients of the equation of clipping plane
1385 <var>plane</var>, in f64vector.
1386 </p></dd></dl>
1387
1388 <dl>
1389 <dt><a name="index-gl_002dfog"></a><u>Function:</u> <b>gl-fog</b><i> pname param</i></dt>
1390 <dd><p>Sets the parameters and function for the fog effect.
1391 Possible values for <var>pname</var> and accepted <var>param</var> for each
1392 <var>pname</var> are shown below.
1393 </p>
1394 <dl compact="compact">
1395 <dt> <code>GL_FOG_MODE</code></dt>
1396 <dd><p>Either <code>GL_EXP</code>, <code>GL_EXP2</code>, <code>GL_LINEAR</code> to select
1397 the fog factors.
1398 </p></dd>
1399 <dt> <code>GL_FOG_DENSITY</code></dt>
1400 <dt> <code>GL_FOG_START</code></dt>
1401 <dt> <code>GL_FO_END</code></dt>
1402 <dd><p>A real number to specify those parametes.
1403 </p></dd>
1404 <dt> <code>GL_FOG_COLOR</code></dt>
1405 <dd><p>An f32vector of size 4 to specify the color.
1406 </p></dd>
1407 </dl>
1408 </dd></dl>
1409
1410 <hr size="6">
1411 <a name="Transformation"></a>
1412 <table cellpadding="1" cellspacing="1" border="0">
1413 <tr><td valign="middle" align="left">[<a href="#GL-states-for-drawing" title="Previous section in reading order"> &lt; </a>]</td>
1414 <td valign="middle" align="left">[<a href="#Display-lists" title="Next section in reading order"> &gt; </a>]</td>
1415 <td valign="middle" align="left"> &nbsp; </td>
1416 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
1417 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
1418 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
1419 <td valign="middle" align="left"> &nbsp; </td>
1420 <td valign="middle" align="left"> &nbsp; </td>
1421 <td valign="middle" align="left"> &nbsp; </td>
1422 <td valign="middle" align="left"> &nbsp; </td>
1423 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
1424 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
1425 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
1426 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
1427 </tr></table>
1428 <a name="Transformation-1"></a>
1429 <h2 class="section">4.6 Transformation</h2>
1430
1431 <dl>
1432 <dt><a name="index-gl_002dmatrix_002dmode"></a><u>Function:</u> <b>gl-matrix-mode</b><i> mode</i></dt>
1433 <dd><p>Speficies whether the modelview, projection, or texture matrix
1434 will be modified. <var>Mode</var> can be one of the followings:
1435 </p>
1436 <dl compact="compact">
1437 <dt> <code>GL_MODELVIEW</code></dt>
1438 <dt> <code>GL_PROJECTION</code></dt>
1439 <dt> <code>GL_TEXTURE</code></dt>
1440 </dl>
1441 </dd></dl>
1442
1443 <dl>
1444 <dt><a name="index-gl_002dload_002didentity"></a><u>Function:</u> <b>gl-load-identity</b></dt>
1445 <dd><p>Loads an identity matrix to the current modifiable matrix.
1446 </p></dd></dl>
1447
1448 <dl>
1449 <dt><a name="index-gl_002dload_002dmatrix"></a><u>Function:</u> <b>gl-load-matrix</b><i> mat</i></dt>
1450 <dd><p>Loads the matrix <var>mat</var> to the current modifiable matrix.
1451 <var>Mat</var> can be a <code>&lt;matrix4f&gt;</code> instance, or
1452 f32 or f64vector of length 16.
1453 </p></dd></dl>
1454
1455 <dl>
1456 <dt><a name="index-gl_002dmult_002dmatrix"></a><u>Function:</u> <b>gl-mult-matrix</b><i> mat</i></dt>
1457 <dd><p>Multiplies the matrix <var>mat</var> to the current modifiable matrix.
1458 <var>Mat</var> can be a <code>&lt;matrix4f&gt;</code> instance, or
1459 f32 or f64vector of length 16.
1460 </p></dd></dl>
1461
1462 <dl>
1463 <dt><a name="index-gl_002dtranslate"></a><u>Function:</u> <b>gl-translate</b><i> x y z</i></dt>
1464 <dd><p>Multiplies the current matrix by a matrix taht translates
1465 an object by (<var>x</var>, <var>y</var>, <var>z</var>).
1466 Internally, <code>glTranslated</code> is called.
1467 </p></dd></dl>
1468
1469 <dl>
1470 <dt><a name="index-gl_002drotate"></a><u>Function:</u> <b>gl-rotate</b><i> angle x y z</i></dt>
1471 <dd><p>Multiplies the current matrix by a matrix that rotates
1472 an object in a counterclockwise direction about the ray
1473 from the origin through the point (<var>x</var>, <var>y</var>, <var>z</var>)
1474 by <var>angle</var> degrees.
1475 Internally, <code>glRotated</code> is called.
1476 </p></dd></dl>
1477
1478 <dl>
1479 <dt><a name="index-gl_002dscale"></a><u>Function:</u> <b>gl-scale</b><i> x y z</i></dt>
1480 <dd><p>Multiplies the current matrix by a matrix that scales
1481 an object by (<var>x</var>, <var>y</var>, <var>z</var>).
1482 Internally, <code>glScaled</code> is called.
1483 </p></dd></dl>
1484
1485 <dl>
1486 <dt><a name="index-glu_002dlook_002dat"></a><u>Function:</u> <b>glu-look-at</b><i> eyex eyey eyez ctrx ctry ctrz upx upy upz</i></dt>
1487 <dd><p>Defines a viewing matrix and multiplies it to the right of
1488 the current matrix.
1489 </p></dd></dl>
1490
1491 <dl>
1492 <dt><a name="index-gl_002dfrustum"></a><u>Function:</u> <b>gl-frustum</b><i> left right bottom top nearv farv</i></dt>
1493 <dd><p>Creates a matrix for a perspective-view frustum and
1494 multiplies the current matrix by it.
1495 </p></dd></dl>
1496
1497 <dl>
1498 <dt><a name="index-glu_002dperspective"></a><u>Function:</u> <b>glu-perspective</b><i> fovy aspect znear zfar</i></dt>
1499 <dd><p>Creates a matrix for a symmetrix perspective-view frustum and
1500 multiplies the current matrix by it.
1501 </p></dd></dl>
1502
1503 <dl>
1504 <dt><a name="index-gl_002dortho"></a><u>Function:</u> <b>gl-ortho</b><i> left right bottom top nearv farv</i></dt>
1505 <dd><p>Creates a matrix for an orthographic parallel viewing volume nand
1506 multiplies the current matrix by it.
1507 </p></dd></dl>
1508
1509 <dl>
1510 <dt><a name="index-glu_002dortho_002d2d"></a><u>Function:</u> <b>glu-ortho-2d</b><i> left right bottom top</i></dt>
1511 <dd><p>Convenience procedure for 2D drawing; it is the same as <code>gl-ortho</code>
1512 except nearv and farv are fixed (along Z axis) to -1.0 and 1.0, respectively.
1513 </p></dd></dl>
1514
1515 <dl>
1516 <dt><a name="index-gl_002dviewport"></a><u>Function:</u> <b>gl-viewport</b><i> x y width height</i></dt>
1517 <dd><p>Defines a pixel rectangle in the window into which the final image
1518 is mapped.
1519 </p></dd></dl>
1520
1521 <dl>
1522 <dt><a name="index-gl_002dpush_002dmatrix"></a><u>Function:</u> <b>gl-push-matrix</b></dt>
1523 <dt><a name="index-gl_002dpop_002dmatrix"></a><u>Function:</u> <b>gl-pop-matrix</b></dt>
1524 <dd><p>Pushes/pops the current matrix.
1525 </p></dd></dl>
1526
1527 <dl>
1528 <dt><a name="index-gl_002dpush_002dmatrix_002a"></a><u>Macro:</u> <b>gl-push-matrix*</b><i> expr &hellip;</i></dt>
1529 <dd><p>A convenience macro. Pushes the current matrix,
1530 executes <var>expr</var>s, then pop the current matrix.
1531 </p></dd></dl>
1532
1533
1534 <hr size="6">
1535 <a name="Display-lists"></a>
1536 <table cellpadding="1" cellspacing="1" border="0">
1537 <tr><td valign="middle" align="left">[<a href="#Transformation" title="Previous section in reading order"> &lt; </a>]</td>
1538 <td valign="middle" align="left">[<a href="#Vertex-arrays" title="Next section in reading order"> &gt; </a>]</td>
1539 <td valign="middle" align="left"> &nbsp; </td>
1540 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
1541 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
1542 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
1543 <td valign="middle" align="left"> &nbsp; </td>
1544 <td valign="middle" align="left"> &nbsp; </td>
1545 <td valign="middle" align="left"> &nbsp; </td>
1546 <td valign="middle" align="left"> &nbsp; </td>
1547 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
1548 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
1549 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
1550 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
1551 </tr></table>
1552 <a name="Display-lists-1"></a>
1553 <h2 class="section">4.7 Display lists</h2>
1554
1555 <dl>
1556 <dt><a name="index-gl_002dgen_002dlists"></a><u>Function:</u> <b>gl-gen-lists</b><i> range</i></dt>
1557 <dd><p>Allocates <var>range</var> number of contiguous display list indices.
1558 Returns an integer which is the smallest display list index you
1559 can use.
1560 </p></dd></dl>
1561
1562 <dl>
1563 <dt><a name="index-gl_002dnew_002dlist"></a><u>Function:</u> <b>gl-new-list</b><i> list-no mode</i></dt>
1564 <dd><p>Starts a display list construction. <var>Mode</var> may be
1565 one of the constants <code>GL_COMPILE</code> or <code>GL_COMPILE_AND_EXECUTE</code>.
1566 </p></dd></dl>
1567
1568 <dl>
1569 <dt><a name="index-gl_002dend_002dlist"></a><u>Function:</u> <b>gl-end-list</b></dt>
1570 <dd><p>Ends a display list construction.
1571 </p></dd></dl>
1572
1573 <dl>
1574 <dt><a name="index-gl_002dcall_002dlist"></a><u>Function:</u> <b>gl-call-list</b><i> list-no</i></dt>
1575 <dd><p>Calls a display list.
1576 </p></dd></dl>
1577
1578 <dl>
1579 <dt><a name="index-gl_002dis_002dlist"></a><u>Function:</u> <b>gl-is-list</b><i> list-no</i></dt>
1580 <dd><p>Returns <code>#t</code> if <var>list-no</var> is an already used display list number,
1581 <code>#f</code> otherwise.
1582 </p></dd></dl>
1583
1584 <dl>
1585 <dt><a name="index-gl_002ddelete_002dlists"></a><u>Function:</u> <b>gl-delete-lists</b><i> list-no-start range</i></dt>
1586 <dd><p>Deletes <var>range</var> display list, beginning from <var>list-no-start</var>.
1587 </p></dd></dl>
1588
1589 <dl>
1590 <dt><a name="index-gl_002dlist_002dbase"></a><u>Function:</u> <b>gl-list-base</b><i> base</i></dt>
1591 <dd><p>Specifies the offset that&rsquo;s added to the display list indices in
1592 <code>gl-call-list</code>.
1593 </p></dd></dl>
1594
1595 <dl>
1596 <dt><a name="index-gl_002dcall_002dlists"></a><u>Function:</u> <b>gl-call-lists</b><i> size type lists</i></dt>
1597 <dt><a name="index-gl_002dcall_002dlists-1"></a><u>Function:</u> <b>gl-call-lists</b><i> size lists</i></dt>
1598 <dt><a name="index-gl_002dcall_002dlists-2"></a><u>Function:</u> <b>gl-call-lists</b><i> lists</i></dt>
1599 <dd><p>Executes <var>size</var> display list, whose indices are contained in <var>lists</var>.
1600 You can pass a u8, s8, u16, s16, u32, s32 or f32vector, or a string,
1601 as <var>lists</var>. If it is a string, each byte consists of the string
1602 is interpreted as an unsigned integer specifying a display list.
1603 It is useful for the technique to display character strings by
1604 creating display lists for each ASCII characters. But be aware that
1605 it doesn&rsquo;t work for multibyte characters.
1606 </p>
1607 <p>Usually you can use the simplest form (the third form) and Gauche-gl
1608 infers the <var>size</var> and <var>type</var> from the passed <var>lists</var>.
1609 You can explicitly specify <var>size</var> if you want to use just a
1610 beginning portion of <var>lists</var>. An error is signalled if you
1611 specify <var>size</var> that is larger than the size of <var>lists</var>.
1612 </p>
1613 <p>Specifying <var>type</var> is useful only if <var>lists</var> is a u8vector,
1614 and you want to use one of three special types allowed to <code>glCallLists</code>,
1615 namely <code>GL_2_BYTES</code>, <code>GL_3_BYTES</code>, and <code>GL_4_BYTES</code>.
1616 </p></dd></dl>
1617
1618 <hr size="6">
1619 <a name="Vertex-arrays"></a>
1620 <table cellpadding="1" cellspacing="1" border="0">
1621 <tr><td valign="middle" align="left">[<a href="#Display-lists" title="Previous section in reading order"> &lt; </a>]</td>
1622 <td valign="middle" align="left">[<a href="#Lighting" title="Next section in reading order"> &gt; </a>]</td>
1623 <td valign="middle" align="left"> &nbsp; </td>
1624 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
1625 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
1626 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
1627 <td valign="middle" align="left"> &nbsp; </td>
1628 <td valign="middle" align="left"> &nbsp; </td>
1629 <td valign="middle" align="left"> &nbsp; </td>
1630 <td valign="middle" align="left"> &nbsp; </td>
1631 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
1632 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
1633 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
1634 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
1635 </tr></table>
1636 <a name="Vertex-arrays-1"></a>
1637 <h2 class="section">4.8 Vertex arrays</h2>
1638
1639 <p>Scheme version of APIs doesn&rsquo;t have <var>GLenum type</var> argument
1640 in C API, since Gauche-gl can figure out the type by passed
1641 vectors.
1642 </p>
1643 <p>Scheme API of <code>gl-*-array</code> has <var>offset</var> optional argument,
1644 by which you can pass the GL the values beginning from the <var>offset</var>-th
1645 element of the passed uniform vector. This isn&rsquo;t in GL C API,
1646 since you can just offset the pointer in C.
1647 </p>
1648 <p>NOTE: it is caller&rsquo;s responsibility to guarantee the passed vector
1649 has enough length. GL doesn&rsquo;t have an interface to specify the boundary,
1650 so Gauche can&rsquo;t detect an invalid length vector.
1651 </p>
1652
1653 <dl>
1654 <dt><a name="index-gl_002dvertex_002dpointer"></a><u>Function:</u> <b>gl-vertex-pointer</b><i> size vec &amp;optional stride offset</i></dt>
1655 <dd><p>Sets the vertex array. <var>Size</var> specifies the number of
1656 scalar values per vertex (2, 3, or 4), and <var>vec</var> provides
1657 the actual value in either f32, f64, s32 or s16vector.
1658 <code>Stride</code> and <var>offset</var> can be used to tell GL to
1659 access <var>vec</var> sparsely.
1660 </p></dd></dl>
1661
1662 <dl>
1663 <dt><a name="index-gl_002dnormal_002dpointer"></a><u>Function:</u> <b>gl-normal-pointer</b><i> vec &amp;optional stride offset</i></dt>
1664 <dd><p>Sets the normal array. <var>Vec</var> should be either
1665 a f32, f64, s32 or s16vector, where each consecutive triplet
1666 specifies a normal vector.
1667 <code>Stride</code> and <var>offset</var> can be used to tell GL to
1668 access <var>vec</var> sparsely.
1669 </p></dd></dl>
1670
1671 <dl>
1672 <dt><a name="index-gl_002dcolor_002dpointer"></a><u>Function:</u> <b>gl-color-pointer</b><i> size vec &amp;optional stride offset</i></dt>
1673 <dd><p>Sets the color array. <var>Size</var> specifies the number of
1674 scalar values per color (3 or 4), and <var>vec</var> provides
1675 the actual values in either f32, f64, u32, u16, u8, s32, s16, or s8vector.
1676 <code>Stride</code> and <var>offset</var> can be used to tell GL to
1677 access <var>vec</var> sparsely.
1678 </p></dd></dl>
1679
1680 <dl>
1681 <dt><a name="index-gl_002dindex_002dpointer"></a><u>Function:</u> <b>gl-index-pointer</b><i> vec &amp;optional stride offset</i></dt>
1682 <dd><p>Sets the index array. <var>Vec</var> can be either s32, s16, u8, f32, or
1683 f64vector.
1684 <code>Stride</code> and <var>offset</var> can be used to tell GL to
1685 access <var>vec</var> sparsely.
1686 </p></dd></dl>
1687
1688 <dl>
1689 <dt><a name="index-gl_002dtex_002dcoord_002dpointer"></a><u>Function:</u> <b>gl-tex-coord-pointer</b><i> size vec &amp;optional stride offset</i></dt>
1690 <dd><p>Sets the texture coordinate array. <var>Size</var> specifies the
1691 number of scalar values per texture coordinate (1, 2, 3 or 4),
1692 and <var>vec</var> provides the actual values in either f32, f64, s32 or
1693 s16vector.
1694 <code>Stride</code> and <var>offset</var> can be used to tell GL to
1695 access <var>vec</var> sparsely.
1696 </p></dd></dl>
1697
1698 <dl>
1699 <dt><a name="index-gl_002dedge_002dflag_002dpointer"></a><u>Function:</u> <b>gl-edge-flag-pointer</b><i> vec &amp;optional stride offset</i></dt>
1700 <dd><p>Sets the edge flag array. <var>Vec</var> must be a GL boolean vector.
1701 <code>Stride</code> and <var>offset</var> can be used to tell GL to
1702 access <var>vec</var> sparsely.
1703 </p></dd></dl>
1704
1705 <dl>
1706 <dt><a name="index-gl_002darray_002delement"></a><u>Function:</u> <b>gl-array-element</b><i> ith</i></dt>
1707 <dd><p>Dereference <var>ith</var> vertex information of the currently enabled arrays.
1708 </p></dd></dl>
1709
1710 <dl>
1711 <dt><a name="index-gl_002ddraw_002delements"></a><u>Function:</u> <b>gl-draw-elements</b><i> mode indices</i></dt>
1712 <dd><p>Issues geometric primitive calls consists of the vertex information
1713 of the currently enabled arrays, each of which is specified
1714 by <var>indices</var>, which should be either a u8, u16 or u32vector.
1715 </p>
1716 <p><var>Mode</var> is the same as of <code>gl-begin</code>.
1717 </p></dd></dl>
1718
1719 <dl>
1720 <dt><a name="index-gl_002ddraw_002drange_002delements"></a><u>Function:</u> <b>gl-draw-range-elements</b><i> mode start end indices</i></dt>
1721 <dd><p>[GL1.2] Like <code>gl-draw-elements</code>, but limits the range of indices
1722 between <var>start</var> and <var>end</var>, inclusive. GL driver may take
1723 advantage of the information for better performance.
1724 </p></dd></dl>
1725
1726 <dl>
1727 <dt><a name="index-gl_002ddraw_002darrays"></a><u>Function:</u> <b>gl-draw-arrays</b><i> mode first count</i></dt>
1728 <dd><p>This is more straightforward. Starting from <var>first</var> index,
1729 <var>count</var> vertices is wrtten in the drawing mode <var>mode</var>
1730 (same as of <code>gl-begin</code>), taken from the current enabled arrays.
1731 </p></dd></dl>
1732
1733 <dl>
1734 <dt><a name="index-gl_002dinterleaved_002darrays"></a><u>Function:</u> <b>gl-interleaved-arrays</b><i> format vec &amp;optional stride offset</i></dt>
1735 <dd><p><var>Vec</var> must be a f32vector. It contains various information
1736 (e.g. vertex position, color and texture coordinate) interleaved,
1737 in the way specified by <var>format</var>.
1738 </p>
1739 <p>In Scheme API, we only allow uniform vector as <var>vec</var>, so
1740 you can&rsquo;t use the format that mixes float and integer, such as
1741 <code>GL_C4UB_V2F</code>.
1742 </p></dd></dl>
1743
1744 <hr size="6">
1745 <a name="Lighting"></a>
1746 <table cellpadding="1" cellspacing="1" border="0">
1747 <tr><td valign="middle" align="left">[<a href="#Vertex-arrays" title="Previous section in reading order"> &lt; </a>]</td>
1748 <td valign="middle" align="left">[<a href="#Pixels" title="Next section in reading order"> &gt; </a>]</td>
1749 <td valign="middle" align="left"> &nbsp; </td>
1750 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
1751 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
1752 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
1753 <td valign="middle" align="left"> &nbsp; </td>
1754 <td valign="middle" align="left"> &nbsp; </td>
1755 <td valign="middle" align="left"> &nbsp; </td>
1756 <td valign="middle" align="left"> &nbsp; </td>
1757 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
1758 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
1759 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
1760 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
1761 </tr></table>
1762 <a name="Lighting-1"></a>
1763 <h2 class="section">4.9 Lighting</h2>
1764
1765 <dl>
1766 <dt><a name="index-gl_002dshade_002dmodel"></a><u>Function:</u> <b>gl-shade-model</b><i> mode</i></dt>
1767 <dd><p>Sets the shading model, either <code>GL_SMOOTH</code> or <code>GL_FLAT</code>.
1768 </p></dd></dl>
1769
1770 <dl>
1771 <dt><a name="index-gl_002dlight"></a><u>Function:</u> <b>gl-light</b><i> light pname param</i></dt>
1772 <dd><p>Creates a light specified by <var>light</var>, which is
1773 one of <code>GL_LIGHT0</code>, &hellip;, <code>GL_LIGHT7</code>,
1774 and sets a characteristics named by <var>pname</var> with the value <var>param</var>.
1775 </p>
1776 <p>Possible values as <var>pname</var> and acceptable types of <var>param</var> are
1777 as follows.
1778 </p><dl compact="compact">
1779 <dt> <code>GL_AMBIENT</code>, <code>GL_DIFFUSE</code>, <code>GL_SPECULAR</code>, <code>GL_POSITION</code></dt>
1780 <dd><p>Accepts an f32 or s32vector of size 4.
1781 </p></dd>
1782 <dt> <code>GL_SPOT_DIRECTION</code></dt>
1783 <dd><p>Accepts an f32 or s32vector of size 3.
1784 </p></dd>
1785 <dt> <code>GL_SPOT_EXPONENT</code>, <code>GL_SPOT_CUTOFF</code>, <code>GL_CONSTNAT_ATTENUATION</code>, <code>GL_LINEAR_ATTENUATION</code>, <code>GL_QUADRATIC_ATTENUATION</code></dt>
1786 <dd><p>Accepts a real number (<code>glLightf</code> is used).
1787 </p></dd>
1788 </dl>
1789 </dd></dl>
1790
1791 <dl>
1792 <dt><a name="index-gl_002dget_002dlight"></a><u>Function:</u> <b>gl-get-light</b><i> light pname</i></dt>
1793 <dd><p>Returns the value of the property <var>pname</var> of the light <var>light</var>.
1794 Returned value can be f32vector or a real number.
1795 </p></dd></dl>
1796
1797 <dl>
1798 <dt><a name="index-gl_002dlight_002dmodel"></a><u>Function:</u> <b>gl-light-model</b><i> pname param</i></dt>
1799 <dd><p>Sets the value of the property <var>pname</var> of the lighting model.
1800 Possible <var>pname</var> and its allowed <var>param</var> is as follows.
1801 </p><dl compact="compact">
1802 <dt> <code>GL_LIGHT_MODEL_AMBIENT</code></dt>
1803 <dd><p>Accepts f32 or s32vector of size 4.
1804 </p></dd>
1805 <dt> <code>GL_LIGHT_MODEL_LOCAL_VIEWER</code>, <code>GL_LIGHT_MODEL_TWO_SIDE</code></dt>
1806 <dd><p>Accepts any Scheme value, which is interpreted as a boolean value.
1807 (That is, you have to pass <code>#f</code> to turn off these properties,
1808 and any other value to turn on.
1809 </p></dd>
1810 <dt> <code>GL_LIGHT_MODEL_COLOR_CONTROL</code></dt>
1811 <dd><p>Accepts an enum value either <code>GL_SINGLE_COLOR</code> or
1812 <code>GL_SEPARATE_SPECULAR_COLOR</code>.
1813 </p></dd>
1814 </dl>
1815 </dd></dl>
1816
1817 <dl>
1818 <dt><a name="index-gl_002dmaterial"></a><u>Function:</u> <b>gl-material</b><i> face pname param</i></dt>
1819 <dd><p>Sets the current material property. <var>Face</var> may be either
1820 <code>GL_FRONT</code>, <code>GL_BACK</code>, or <code>GL_FRONT_AND_BACK</code>.
1821 Possible values of <var>pname</var> and acceptable <var>param</var> types are
1822 as follows.
1823 </p><dl compact="compact">
1824 <dt> <code>GL_AMBIENT</code>, <code>GL_DIFFUSE</code>, <code>GL_AMBIENT_AND_DIFFUSE</code>, <code>GL_SPECULAR</code>, <code>GL_EMISSION</code></dt>
1825 <dd><p>Accepts f32 or s32vector of size 4.
1826 </p></dd>
1827 <dt> <code>GL_SHININESS</code></dt>
1828 <dd><p>Accepts a single real number (<code>glMaterialf</code> is called).
1829 </p></dd>
1830 <dt> <code>GL_COLOR_INDEXES</code></dt>
1831 <dd><p>Accepts f32 or s32vector of size 3.
1832 </p></dd>
1833 </dl>
1834 </dd></dl>
1835
1836 <dl>
1837 <dt><a name="index-gl_002dget_002dmaterial"></a><u>Function:</u> <b>gl-get-material</b><i> face pname</i></dt>
1838 <dd><p>Returns the current material property of <var>face</var> and <var>pname</var>.
1839 The type of returned value may be f32vector, s32vector (only for
1840 <code>GL_COLOR_INDEXES</code>), or a real number.
1841 </p></dd></dl>
1842
1843 <dl>
1844 <dt><a name="index-gl_002dcolor_002dmaterial"></a><u>Function:</u> <b>gl-color-material</b><i> face mode</i></dt>
1845 <dd><p>Makes the material property <var>mode</var> (e.g. <code>GL_AMBIENT</code> etc.)
1846 of the face <var>face</var> follow the current color set by <code>gl-color</code>.
1847 </p></dd></dl>
1848
1849 <hr size="6">
1850 <a name="Pixels"></a>
1851 <table cellpadding="1" cellspacing="1" border="0">
1852 <tr><td valign="middle" align="left">[<a href="#Lighting" title="Previous section in reading order"> &lt; </a>]</td>
1853 <td valign="middle" align="left">[<a href="#Texture-mapping" title="Next section in reading order"> &gt; </a>]</td>
1854 <td valign="middle" align="left"> &nbsp; </td>
1855 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
1856 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
1857 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
1858 <td valign="middle" align="left"> &nbsp; </td>
1859 <td valign="middle" align="left"> &nbsp; </td>
1860 <td valign="middle" align="left"> &nbsp; </td>
1861 <td valign="middle" align="left"> &nbsp; </td>
1862 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
1863 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
1864 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
1865 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
1866 </tr></table>
1867 <a name="Pixels_002c-bitmaps-and-images"></a>
1868 <h2 class="section">4.10 Pixels, bitmaps and images</h2>
1869
1870 <a name="Pixel-operations"></a>
1871 <h3 class="subheading">Pixel operations</h3>
1872
1873 <dl>
1874 <dt><a name="index-gl_002dbitmap"></a><u>Function:</u> <b>gl-bitmap</b><i> width height xbo ybo xbi ybi bitmap</i></dt>
1875 <dd><p>Draws a bitmap. <var>Width</var> and <var>height</var> gives the dimension
1876 of the bitmap. <var>Xbo</var>, <var>ybo</var>, <var>xbi</var>, and <var>ybi</var>
1877 specifies the origin and increment of the current raster position.
1878 <var>Bitmap</var> is the actual bitmap data, packed in a u8vector.
1879 </p></dd></dl>
1880
1881 <dl>
1882 <dt><a name="index-gl_002dread_002dpixels"></a><u>Function:</u> <b>gl-read-pixels</b><i> x y width height format type</i></dt>
1883 <dd><p>Reads pixel data from the framebuffer. Returns the pixel data
1884 in a uniform vector of the type determined by <var>format</var> and
1885 <var>type</var> (check out OpenGL doc to find out the actual data format).
1886 </p></dd></dl>
1887
1888 <dl>
1889 <dt><a name="index-gl_002ddraw_002dpixels"></a><u>Function:</u> <b>gl-draw-pixels</b><i> width height format type pixels</i></dt>
1890 <dd><p>Draws a pixel data <var>pixels</var> at the current raster position.
1891 <var>Pixels</var> must be a uniform vector compatible to the specified
1892 <var>format</var> and <var>type</var> values.
1893 </p></dd></dl>
1894
1895 <dl>
1896 <dt><a name="index-gl_002dcopy_002dpixels"></a><u>Function:</u> <b>gl-copy-pixels</b><i> x y width height buffer</i></dt>
1897 <dd><p>Copies pixel data in a rectangle area of the framebuffer,
1898 specified by lower-left corner (<var>x</var>, <var>y</var>) and dimensions
1899 (<var>width</var>, <var>height</var>). <var>Buffer</var> specifies which buffer
1900 is used, and should be one of <code>GL_COLOR</code>, <code>GL_STENCIL</code>
1901 or <code>GL_DEPTH</code>.
1902 </p></dd></dl>
1903
1904 <dl>
1905 <dt><a name="index-gl_002dpixel_002dstore"></a><u>Function:</u> <b>gl-pixel-store</b><i> pname param</i></dt>
1906 <dd><p>Sets the pixel stroage models. Check out the OpenGL doc for
1907 the possible <var>pname</var> and <var>param</var> values.
1908 </p></dd></dl>
1909
1910 <dl>
1911 <dt><a name="index-gl_002dpixel_002dtransfer"></a><u>Function:</u> <b>gl-pixel-transfer</b><i> pname param</i></dt>
1912 <dd><p>Sets the pixel transfer modes. Check out the OpenGL doc for
1913 the possible <var>pname</var> and <var>param</var> values.
1914 </p></dd></dl>
1915
1916 <dl>
1917 <dt><a name="index-gl_002dpixel_002dmap"></a><u>Function:</u> <b>gl-pixel-map</b><i> map values</i></dt>
1918 <dd><p>Sets the pixel map table <var>map</var> with <var>values</var>,
1919 which must be either u16, u32 or f32vecotor.
1920 Check out the OpenGL doc for the possible <var>map</var> values.
1921 </p></dd></dl>
1922
1923 <dl>
1924 <dt><a name="index-gl_002dpixel_002dzoom"></a><u>Function:</u> <b>gl-pixel-zoom</b><i> xfactor yfactor</i></dt>
1925 <dd><p>Sets the magnification/reduction factors for pixel-write operations.
1926 </p></dd></dl>
1927
1928 <dl>
1929 <dt><a name="index-gl_002dget_002dpixel_002dmap"></a><u>Function:</u> <b>gl-get-pixel-map</b><i> map &amp;optional type</i></dt>
1930 <dd><p>Returns the current pixel map table as an uniform vector specified
1931 by <var>type</var>, which must be either a class <code>&lt;u32vector&gt;</code> (default),
1932 <code>&lt;u16vector&gt;</code>, or <code>&lt;f32vector&gt;</code>.
1933 </p></dd></dl>
1934
1935 <dl>
1936 <dt><a name="index-gl_002dget_002dpixel_002dmap_0021"></a><u>Function:</u> <b>gl-get-pixel-map!</b><i> map values</i></dt>
1937 <dd><p>Like <code>gl-get-pixel-map</code>, but instead of allocating a new vector,
1938 it stores the result to a uniform vector passed to <var>values</var>.
1939 It is a caller&rsquo;s responsibility to ensure <var>values</var> has enough size.
1940 </p></dd></dl>
1941
1942 <a name="Color-tables"></a>
1943 <h3 class="subheading">Color tables</h3>
1944
1945 <dl>
1946 <dt><a name="index-gl_002dcolor_002dtable"></a><u>Function:</u> <b>gl-color-table</b><i> target internal-format width format type data</i></dt>
1947 <dd><p>[GL_ARB_imaging]
1948 Specifies one of the color table <var>target</var>.
1949 <var>Data</var> should be a uniform vector compatible to the
1950 <var>format</var> and <var>type</var> parameters.
1951 </p></dd></dl>
1952
1953 <dl>
1954 <dt><a name="index-gl_002dcolor_002dtable_002dparameter"></a><u>Function:</u> <b>gl-color-table-parameter</b><i> target pname param</i></dt>
1955 <dd><p>[GL_ARB_imaging]
1956 Sets the color table parameter <var>pname</var>
1957 (either <code>GL_COLOR_TABLE_SCALE</code> or <code>GL_COLOR_TABLE_BIAS</code>),
1958 of the color table <var>target</var>. <var>Param</var> must be
1959 an f32 or s32vector of size 4.
1960 </p></dd></dl>
1961
1962 <dl>
1963 <dt><a name="index-gl_002dcopy_002dcolor_002dtable"></a><u>Function:</u> <b>gl-copy-color-table</b><i> target internal-format x y width</i></dt>
1964 <dd><p>[GL_ARB_imaging]
1965 Creates a color table <var>target</var> using framebuffer data.
1966 The pixels are
1967 read from the current buffer for read (specified by <code>glReadBuffer</code>).
1968 </p></dd></dl>
1969
1970 <dl>
1971 <dt><a name="index-gl_002dcolor_002dsub_002dtable"></a><u>Function:</u> <b>gl-color-sub-table</b><i> target start count format type data</i></dt>
1972 <dd><p>[GL_ARB_imaging]
1973 Replaces a part of color table <var>target</var>, starting <var>start</var>
1974 and <var>count</var> entries. Values are given in <var>data</var> as a
1975 uniform vector compatible to the <var>format</var> and <var>type</var> arguments.
1976 </p></dd></dl>
1977
1978 <dl>
1979 <dt><a name="index-gl_002dcopy_002dcolor_002dsub_002dtable"></a><u>Function:</u> <b>gl-copy-color-sub-table</b><i> target start x y width</i></dt>
1980 <dd><p>[GL_ARB_imaging] Replaces a part of color table entries using framebuffer data.
1981 </p></dd></dl>
1982
1983 <dl>
1984 <dt><a name="index-gl_002dget_002dcolor_002dtable_0021"></a><u>Function:</u> <b>gl-get-color-table!</b><i> target format type data</i></dt>
1985 <dd><p>[GL_ARB_imaging]
1986 Reads the color table <var>target</var> and store it in <var>data</var>,
1987 in the format specified by <var>format</var> and <var>type</var>.
1988 <var>Data</var> must be a uniform vector compatible to the
1989 <var>format</var> and <var>type</var> arguments. The caller must ensure
1990 that <var>data</var> has enough size to contain the result.
1991 </p></dd></dl>
1992
1993 <a name="Convolutions"></a>
1994 <h3 class="subheading">Convolutions</h3>
1995
1996 <dl>
1997 <dt><a name="index-gl_002dconvolution_002dfilter_002d2d"></a><u>Function:</u> <b>gl-convolution-filter-2d</b><i> target internal-format width height format type data</i></dt>
1998 <dd><p>[GL_ARB_imaging]
1999 Defines a 2D convolution filter. <var>Target</var> must be GL_CONVOLUTION_2D.
2000 <code>Data</code> must be a uniform vector
2001 compatible to the <var>format</var> and <var>type</var> arguments, and must have
2002 enough size.
2003 </p></dd></dl>
2004
2005 <dl>
2006 <dt><a name="index-gl_002dcopy_002dconvolution_002dfilter_002d2d"></a><u>Function:</u> <b>gl-copy-convolution-filter-2d</b><i> target internal-format x y width height</i></dt>
2007 <dd><p>[GL_ARB_imaging]
2008 Defines a 2D convolution filter,
2009 taking the convolution filter data from the current color buffer to read.
2010 </p></dd></dl>
2011
2012 <dl>
2013 <dt><a name="index-gl_002dseparable_002dfiletr_002d2d"></a><u>Function:</u> <b>gl-separable-filetr-2d</b><i> target internal-format width height format type row column</i></dt>
2014 <dd><p>[GL_ARB_imaging]
2015 Defines a 2D convolution filter by a product of a 1D row vector and
2016 1D column vector. <var>Target</var> must be GL_SEPARABLE_2D.
2017 Both <var>row</var> and <var>column</var> must be a uniform
2018 vector, compatible with the <var>format</var> and <var>type</var> arguments,
2019 and must have enough size.
2020 </p></dd></dl>
2021
2022 <dl>
2023 <dt><a name="index-gl_002dconvolution_002dfilter_002d1d"></a><u>Function:</u> <b>gl-convolution-filter-1d</b><i> target internal-format width format type data</i></dt>
2024 <dd><p>[GL_ARB_imaging]
2025 Defines 1D convolution filter. <var>Target</var> must be GL_CONVOLUTION_1D.
2026 <code>Data</code> must be a uniform vector
2027 compatible to the <var>format</var> and <var>type</var> arguments, and must have
2028 enough size.
2029 </p></dd></dl>
2030
2031 <dl>
2032 <dt><a name="index-gl_002dcopy_002dconvolution_002dfilter_002d1d"></a><u>Function:</u> <b>gl-copy-convolution-filter-1d</b><i> target internal-format x y width</i></dt>
2033 <dd><p>[GL_ARB_imaging]
2034 Defines 1D convolution filter, taking the convolution filter data
2035 from the current color buffer to read.
2036 </p></dd></dl>
2037
2038 <dl>
2039 <dt><a name="index-gl_002dconvolution_002dparameter"></a><u>Function:</u> <b>gl-convolution-parameter</b><i> target pname param</i></dt>
2040 <dd><p>[GL_ARB_imaging]
2041 Sets a parameter for a convolution filter <var>target</var>, which can
2042 be either <code>GL_CONVOLUTION_2D</code>, <code>GL_SEPARABLE_2D</code>,
2043 or <code>GL_CONVOLUTION_1D</code>. Possible values of <var>pname</var> and
2044 their acceptable <var>param</var> are as follows.
2045 </p><dl compact="compact">
2046 <dt> <code>GL_CONVOLUTION_BORDER_MODE</code></dt>
2047 <dd><p>Either one of the constants: <code>GL_REDUCE</code>, <code>GL_CONSTNAT_BORDER</code>,
2048 <code>GL_REPLICATE_BORDER</code>
2049 </p></dd>
2050 <dt> <code>GL_CONVOLUTION_FILTER_SCALE</code>, <code>GL_CONVOLUTION_FILTER_BIAS</code></dt>
2051 <dd><p>An s32 or f32vector of size 4, specifying color values.
2052 </p></dd>
2053 </dl>
2054 </dd></dl>
2055
2056
2057 <a name="Histogram"></a>
2058 <h3 class="subheading">Histogram</h3>
2059
2060 <dl>
2061 <dt><a name="index-gl_002dhistogram"></a><u>Function:</u> <b>gl-histogram</b><i> target width internal-format sink</i></dt>
2062 <dd><p>[GL_ARB_imaging]
2063 Specifies the way the histogram data is stored.
2064 <var>Target</var> must be either <code>GL_HISTOGRAM</code> or <code>GL_PROXY_HISTOGRAM</code>.
2065 <var>Width</var> is the number of entires of the histogram, and has to be
2066 a power of 2.
2067 <var>Sink</var> is a boolean value to indicate whether pixels should be
2068 discarded or sent down further to the pipeline.
2069 </p></dd></dl>
2070
2071 <dl>
2072 <dt><a name="index-gl_002dreset_002dhistogram"></a><u>Function:</u> <b>gl-reset-histogram</b><i> target</i></dt>
2073 <dd><p>[GL_ARB_imaging]
2074 Resets the histogram counters. <var>Target</var> must be <code>GL_HISTOGRAM</code>.
2075 </p></dd></dl>
2076
2077 <dl>
2078 <dt><a name="index-gl_002dget_002dhistogram"></a><u>Function:</u> <b>gl-get-histogram</b><i> target reset format type</i></dt>
2079 <dd><p>[GL_ARB_imaging]
2080 Returns histogram data in a uniform vector, whose type and size
2081 are determined by <var>format</var> and <var>type</var>.
2082 A boolean value <var>reset</var> specifies whether the histogram should
2083 be reset or not.
2084 </p></dd></dl>
2085
2086 <dl>
2087 <dt><a name="index-gl_002dget_002dhistogram_002dparameter"></a><u>Function:</u> <b>gl-get-histogram-parameter</b><i> target pname</i></dt>
2088 <dd><p>[GL_ARB_imaging]
2089 Returns the parameter value of the histogram.
2090 <var>Pname</var> can be either one of <code>GL_HISTOGRAM_WIDTH</code>,
2091 <code>GL_HISTOGRAM_FORMAT</code>, <code>GL_HISTOGRAM_RED_SIZE</code>,
2092 <code>GL_HISTOGRAM_GREEN_SIZE</code>, <code>GL_HISTOGRAM_BLUE_SIZE</code>,
2093 <code>GL_HISTOGRAM_ALPHA_SIZE</code>, <code>GL_HISTOGRAM_LUMINANCE_SIZE</code>,
2094 or <code>GL_HISTOGRAM_SINK</code>. The returned value is an integer,
2095 except the case of <code>GL_HISTOGRAM_SINK</code>, which returns a boolean value.
2096 </p></dd></dl>
2097
2098
2099 <a name="Minmax"></a>
2100 <h3 class="subheading">Minmax</h3>
2101
2102 <dl>
2103 <dt><a name="index-gl_002dminmax"></a><u>Function:</u> <b>gl-minmax</b><i> target internal-format sink</i></dt>
2104 <dd><p>[GL_ARB_imaging]
2105 Computes the minimum and maximum pixel values for an image.
2106 <var>Target</var> must be <code>GL_MINMAX</code>.
2107 <var>Sink</var> is a boolean value to indicate whether pixels should be
2108 discarded or sent down further to the pipeline.
2109 </p></dd></dl>
2110
2111 <dl>
2112 <dt><a name="index-gl_002dget_002dminmax"></a><u>Function:</u> <b>gl-get-minmax</b><i> target reset format type</i></dt>
2113 <dd><p>[GL_ARB_imaging]
2114 Returns the results of the minmax operation in a uniform vector,
2115 whose type and size are determined by the <var>format</var> and
2116 <var>type</var> arguments.
2117 A boolean value <var>reset</var> specifies whether the histogram should
2118 be reset or not.
2119 </p></dd></dl>
2120
2121 <dl>
2122 <dt><a name="index-gl_002dreset_002dminmax"></a><u>Function:</u> <b>gl-reset-minmax</b><i> target</i></dt>
2123 <dd><p>[GL_ARB_imaging]
2124 Resets the minmax counter.
2125 </p></dd></dl>
2126
2127 <dl>
2128 <dt><a name="index-gl_002dget_002dminmax_002dparameter"></a><u>Function:</u> <b>gl-get-minmax-parameter</b><i> target pname</i></dt>
2129 <dd><p>[GL_ARB_imaging]
2130 Returns the parameter value of the histogram.
2131 <var>Pname</var> can be either <code>GL_MINMAX_SINK</code> (returns
2132 a boolean value) or <code>GL_MINMAX_FORMAT</code> (returns an integer).
2133 </p></dd></dl>
2134
2135 <hr size="6">
2136 <a name="Texture-mapping"></a>
2137 <table cellpadding="1" cellspacing="1" border="0">
2138 <tr><td valign="middle" align="left">[<a href="#Pixels" title="Previous section in reading order"> &lt; </a>]</td>
2139 <td valign="middle" align="left">[<a href="#Framebuffers" title="Next section in reading order"> &gt; </a>]</td>
2140 <td valign="middle" align="left"> &nbsp; </td>
2141 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
2142 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
2143 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
2144 <td valign="middle" align="left"> &nbsp; </td>
2145 <td valign="middle" align="left"> &nbsp; </td>
2146 <td valign="middle" align="left"> &nbsp; </td>
2147 <td valign="middle" align="left"> &nbsp; </td>
2148 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
2149 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
2150 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
2151 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
2152 </tr></table>
2153 <a name="Texture-mapping-1"></a>
2154 <h2 class="section">4.11 Texture mapping</h2>
2155
2156 <a name="Defining-textures"></a>
2157 <h3 class="subheading">Defining textures</h3>
2158
2159 <dl>
2160 <dt><a name="index-gl_002dtex_002dimage_002d1d"></a><u>Function:</u> <b>gl-tex-image-1d</b><i> target level internalformat width border format type texels</i></dt>
2161 <dt><a name="index-gl_002dtex_002dimage_002d2d"></a><u>Function:</u> <b>gl-tex-image-2d</b><i> target level internalformat width height border format type texels</i></dt>
2162 <dt><a name="index-gl_002dtex_002dimage_002d3d"></a><u>Function:</u> <b>gl-tex-image-3d</b><i> target level internalformat width height depth border format type texels</i></dt>
2163 <dd><p>Defines an 1D, 2D or 3D texture. 3D texture is available only
2164 if the GL version is 1.2 or later.
2165 The <var>target</var> parameter can be <code>GL_TEXTURE_1D</code> or
2166 <code>GL_PROXY_TEXTURE_1D</code> for <code>gl-tex-image-1d</code>, etc.
2167 The <var>level</var> parameter can be used for multiresolution textures; if
2168 this is a single resolution texture, pass 0.
2169 </p>
2170 <p><var>Width</var>, <var>height</var>, and <var>depth</var> specify
2171 the dimensions of the texture.
2172 <var>Border</var> can be 0 or 1, specifying the border.
2173 </p>
2174 <p>The actual texture data is passed to the <var>texels</var> argument in
2175 a uniform vector, which should be compatible with the <var>format</var>
2176 and <var>type</var> parameters and match the size calculated by <var>width</var>,
2177 <var>height</var> and <var>depth</var> (and possibly the pixel store setting).
2178 </p></dd></dl>
2179
2180 <dl>
2181 <dt><a name="index-gl_002dcopy_002dtex_002dimage_002d1d"></a><u>Function:</u> <b>gl-copy-tex-image-1d</b><i> target level internal-format x y width border</i></dt>
2182 <dt><a name="index-gl_002dcopy_002dtex_002dimage_002d2d"></a><u>Function:</u> <b>gl-copy-tex-image-2d</b><i> target level internal-format x y width height border</i></dt>
2183 <dd><p>Cerates a 1D or 2D texture from the framebuffer data.
2184 </p></dd></dl>
2185
2186 <dl>
2187 <dt><a name="index-gl_002dtex_002dsub_002dimage_002d1d"></a><u>Function:</u> <b>gl-tex-sub-image-1d</b><i> target level xoffset width format type texels</i></dt>
2188 <dt><a name="index-gl_002dtex_002dsub_002dimage_002d2d"></a><u>Function:</u> <b>gl-tex-sub-image-2d</b><i> target level xoffset yoffset width height format type texels</i></dt>
2189 <dt><a name="index-gl_002dtex_002dsub_002dimage_002d3d"></a><u>Function:</u> <b>gl-tex-sub-image-3d</b><i> target level xoffset yoffset zoffset width height depth format type texels</i></dt>
2190 <dd><p>Replaces a part of the current 1D, 2D or 3D texture image by <var>texels</var>.
2191 3D texture is available only
2192 if the GL version is 1.2 or later.
2193 </p></dd></dl>
2194
2195 <dl>
2196 <dt><a name="index-gl_002dcopy_002dtex_002dsub_002dimage_002d1d"></a><u>Function:</u> <b>gl-copy-tex-sub-image-1d</b><i> target level xoffset x y width</i></dt>
2197 <dt><a name="index-gl_002dcopy_002dtex_002dsub_002dimage_002d2d"></a><u>Function:</u> <b>gl-copy-tex-sub-image-2d</b><i> target level xoffset yoffset x y width height</i></dt>
2198 <dt><a name="index-gl_002dcopy_002dtex_002dsub_002dimage_002d3d"></a><u>Function:</u> <b>gl-copy-tex-sub-image-3d</b><i> target level xoffset yoffset zoffset x y width height</i></dt>
2199 <dd><p>Replaces a part of the current 1D, 2D or 3D texture image by
2200 the data from the framebuffer. 3D texture is available only
2201 if the GL version is 1.2 or later.
2202 </p></dd></dl>
2203
2204 <a name="Texture-parameters"></a>
2205 <h3 class="subheading">Texture parameters</h3>
2206
2207 <dl>
2208 <dt><a name="index-gl_002dtex_002dparameter"></a><u>Function:</u> <b>gl-tex-parameter</b><i> target pname param</i></dt>
2209 <dd><p>Sets parameters for the current texture.
2210 <var>Target</var> can be either <var>GL_TEXTURE_1D</var>, <code>GL_TEXTURE_2D</code> or
2211 <var>GL_TEXTURE_3D</var>. Possible values for <var>pname</var>, and accepted
2212 type of <var>param</var> for each <var>pname</var>, are shown below.
2213 </p>
2214 <dl compact="compact">
2215 <dt> <code>GL_TEXTURE_WRAP_S</code></dt>
2216 <dt> <code>GL_TEXTURE_WRAP_T</code></dt>
2217 <dt> <code>GL_TEXTURE_WRAP_R</code></dt>
2218 <dt> <code>GL_TEXTURE_BASE_LEVEL</code></dt>
2219 <dt> <code>GL_TEXTURE_MAX_LEVEL</code></dt>
2220 <dt> <code>GL_TEXTURE_MAG_FILTER</code></dt>
2221 <dt> <code>GL_TEXTURE_MIN_FILTER</code></dt>
2222 <dd><p><var>Param</var> must be an integer.
2223 </p></dd>
2224 <dt> <code>GL_TEXTURE_PRIORITY</code></dt>
2225 <dt> <code>GL_TEXTURE_MIN_LOD</code></dt>
2226 <dt> <code>GL_TEXTURE_MAX_LOD</code></dt>
2227 <dd><p><var>Param</var> must be a real number.
2228 </p></dd>
2229 <dt> <code>GL_TEXTURE_BORDER_COLOR</code></dt>
2230 <dd><p><var>Param</var> must be an f32vector of size 4, representing a color.
2231 </p></dd>
2232 </dl>
2233 </dd></dl>
2234
2235 <dl>
2236 <dt><a name="index-gl_002dget_002dtex_002dparameter"></a><u>Function:</u> <b>gl-get-tex-parameter</b><i> target pname</i></dt>
2237 <dd><p>Obtains the parameter of the current texture, set by <code>gl-tex-parameter</code>.
2238 </p></dd></dl>
2239
2240 <dl>
2241 <dt><a name="index-gl_002dget_002dtex_002dlevel_002dparameter"></a><u>Function:</u> <b>gl-get-tex-level-parameter</b><i> target level pname</i></dt>
2242 <dd><p>Obtains the parameter of the level <var>level</var>
2243 of the current texture specified by <var>target</var>,
2244 which can be either <code>GL_TEXTURE_1D</code>, <code>GL_TEXTURE_2D</code>,
2245 <code>GL_TEXTURE_3D</code>, <code>GL_PROXY_TEXTURE_1D</code>,
2246 <code>GL_PROXY_TEXTURE_2D</code>, or <code>GL_PROXY_TEXTURE_3D</code>.
2247 </p>
2248 <p>Possible values for <var>pname</var> is either one of the
2249 following constants: <code>GL_TEXTURE_WIDTH</code>, <code>GL_TEXTURE_HEIGHT</code>,
2250 <code>GL_TEXTURE_DEPTH</code>, <code>GL_TEXTURE_BORDER</code>,
2251 <code>GL_TEXTURE_INTERNAL_FORMAT</code>, <code>GL_TEXTURE_RED_SIZE</code>,
2252 <code>GL_TEXTURE_GREEN_SIZE</code>, <code>GL_TEXTURE_BLUE_SIZE</code>,
2253 <code>GL_TEXTURE_ALPHA_SIZE</code>, <code>GL_TEXTURE_LUMINANCE_SIZE</code>, or
2254 <code>GL_TEXTURE_INTENSITY_SIZE</code>. This procedure returns an integer.
2255 </p></dd></dl>
2256
2257 <a name="Mipmaps"></a>
2258 <h3 class="subheading">Mipmaps</h3>
2259
2260 <dl>
2261 <dt><a name="index-glu_002dbuild_002d1d_002dmipmaps"></a><u>Function:</u> <b>glu-build-1d-mipmaps</b><i> target internal-format width format type texels</i></dt>
2262 <dt><a name="index-glu_002dbuild_002d2d_002dmipmaps"></a><u>Function:</u> <b>glu-build-2d-mipmaps</b><i> target internal-format width height format type texels</i></dt>
2263 <dt><a name="index-glu_002dbuild_002d3d_002dmipmaps"></a><u>Function:</u> <b>glu-build-3d-mipmaps</b><i> target internal-format width height depth format type texels</i></dt>
2264 <dd><p>Constructs a serids of mipmaps and calls <code>gl-tex-image-*d</code> to load
2265 the images. Returns 0 on success, or a GLU error code on failure.
2266 <var>Texels</var> is a uniform vector, that must be compatible with
2267 <var>format</var> and <var>type</var> arguments, and must have the enough length
2268 as specified by <var>width</var>, <var>height</var> and <var>depth</var> parameters.
2269 </p></dd></dl>
2270
2271 <dl>
2272 <dt><a name="index-glu_002dbuild_002d1d_002dmipmap_002dlevels"></a><u>Function:</u> <b>glu-build-1d-mipmap-levels</b><i> target internal-format width format type level base max texels</i></dt>
2273 <dt><a name="index-glu_002dbuild_002d2d_002dmipmap_002dlevels"></a><u>Function:</u> <b>glu-build-2d-mipmap-levels</b><i> target internal-format width height format type level base max texels</i></dt>
2274 <dt><a name="index-glu_002dbuild_002d3d_002dmipmap_002dlevels"></a><u>Function:</u> <b>glu-build-3d-mipmap-levels</b><i> target internal-format width height depth format type level base max texels</i></dt>
2275 <dd><p>Like <code>glu-build-*d-mipmaps</code>, but you can specify the level of
2276 <var>texels</var>, and the range of levels to be generated
2277 by the <var>base</var> and <var>max</var> parameters. It is used to generate
2278 a subset of mipmaps.
2279 </p>
2280 <p>Returns 0 on success, or a GLU error code on failure.
2281 <var>Texels</var> is a uniform vector, that must be compatible with
2282 <var>format</var> and <var>type</var> arguments, and must have the enough length
2283 as specified by <var>width</var>, <var>height</var> and <var>depth</var> parameters.
2284 </p></dd></dl>
2285
2286 <a name="Texture-objects"></a>
2287 <h3 class="subheading">Texture objects</h3>
2288
2289 <dl>
2290 <dt><a name="index-gl_002dgen_002dtextures"></a><u>Function:</u> <b>gl-gen-textures</b><i> size</i></dt>
2291 <dd><p>Returns <var>size</var> new names for texture objects in a u32vector.
2292 </p></dd></dl>
2293
2294 <dl>
2295 <dt><a name="index-gl_002dis_002dtexture"></a><u>Function:</u> <b>gl-is-texture</b><i> name</i></dt>
2296 <dd><p>Returns <code>#t</code> if an integer <var>name</var> is the name of a texture
2297 that has been bound and not deleted yet, <code>#f</code> otherwise.
2298 </p></dd></dl>
2299
2300 <dl>
2301 <dt><a name="index-gl_002dbind_002dtexture"></a><u>Function:</u> <b>gl-bind-texture</b><i> target name</i></dt>
2302 <dd><p>Bind the current texture (specified by <var>target</var>,
2303 e.g. <code>GL_TEXTURE_2D</code>) to the integer <var>name</var>.
2304 If there&rsquo;s already a texture bound to <var>name</var>, it becomes current.
2305 Otherwise a new texture object is created and made current.
2306 </p></dd></dl>
2307
2308 <dl>
2309 <dt><a name="index-gl_002ddelete_002dtextures"></a><u>Function:</u> <b>gl-delete-textures</b><i> names</i></dt>
2310 <dd><p>Delets textures. <var>Names</var> must be a u32vector contains integer names
2311 of the texture objects to be deleted.
2312 </p></dd></dl>
2313
2314 <dl>
2315 <dt><a name="index-gl_002dare_002dtextures_002dresident_0021"></a><u>Function:</u> <b>gl-are-textures-resident!</b><i> names residences</i></dt>
2316 <dd><p><var>Names</var> must be a u32vector contains integer names
2317 of the texture objects, and <var>residences</var> must be a GL boolean vector
2318 of the same length as <var>names</var>. If all textures named in <var>names</var>
2319 are resident, <code>#t</code> is returned and <var>residences</var> is not
2320 modified. Othewise, <code>#f</code> is returned and
2321 <var>residences</var> is modified to contain <code>#t</code> if the corresponding
2322 texture in <var>names</var> is resident, <code>#f</code> othewise.
2323 </p></dd></dl>
2324
2325 <dl>
2326 <dt><a name="index-gl_002dprioritize_002dtextures"></a><u>Function:</u> <b>gl-prioritize-textures</b><i> names priorities</i></dt>
2327 <dd><p>Sets the prioridies of texture objects named by <var>names</var> to
2328 the corresponding entry of <var>priorities</var>
2329 <var>Names</var> must be a u32vectore and <var>priorities</var> must be an f32vector,
2330 and the lengths of both vectors must match.
2331 </p></dd></dl>
2332
2333 <a name="Texture-environment-and-coordinates"></a>
2334 <h3 class="subheading">Texture environment and coordinates</h3>
2335
2336 <dl>
2337 <dt><a name="index-gl_002dtex_002denv"></a><u>Function:</u> <b>gl-tex-env</b><i> target pname param</i></dt>
2338 <dd><p>Sets the current texturing function. <var>Target</var> must be
2339 <code>GL_TEXTURE_ENV</code>. Possible values of <var>pname</var> and accepted
2340 <var>param</var> for each value is as follows.
2341 </p>
2342 <dl compact="compact">
2343 <dt> <code>GL_TEXTURE_ENV_MODE</code></dt>
2344 <dd><p>One of <code>GL_DECAL</code>, <code>GL_REPLACE</code>, <code>GL_MODULATE</code> or
2345 <code>GL_BLEND</code>.
2346 </p></dd>
2347 <dt> <code>GL_TEXTURE_ENV_COLOR</code></dt>
2348 <dd><p>f32vector of size 4 to specify the color.
2349 </p></dd>
2350 </dl>
2351 </dd></dl>
2352
2353 <dl>
2354 <dt><a name="index-gl_002dtex_002dgen"></a><u>Function:</u> <b>gl-tex-gen</b><i> coord pname param</i></dt>
2355 <dd><p>Specifies the functions for automatic texture coordinate generation.
2356 <var>Coord</var> specifies the coordinates, either one of <code>GL_S</code>,
2357 <code>GL_T</code>, <code>GL_R</code> or <code>GL_Q</code>.
2358 Possible values of <var>pname</var> and accepted
2359 <var>param</var> for each value is as follows.
2360 </p><dl compact="compact">
2361 <dt> <code>GL_TEXTURE_GEN_MODE</code></dt>
2362 <dd><p>Either <code>GL_OBJECT_LINEAR</code>, <code>GL_EYE_LINEAR</code> or
2363 <code>GL_SPHERE_MAP</code>.
2364 </p></dd>
2365 <dt> <code>GL_OBJECT_PLANE</code></dt>
2366 <dt> <code>GL_EYE_PLANE</code></dt>
2367 <dd><p>An s32, f32 or f64vector of size 4 to specify the plane.
2368 </p></dd>
2369 </dl>
2370 </dd></dl>
2371
2372 <a name="Multitexturing"></a>
2373 <h3 class="subheading">Multitexturing</h3>
2374
2375 <dl>
2376 <dt><a name="index-gl_002dactive_002dtexture_002darb"></a><u>Function:</u> <b>gl-active-texture-arb</b><i> texunit</i></dt>
2377 <dd><p>[GL_ARB_multitexture]
2378 Selects the texture unit that is currently modified by
2379 texturing routines. <var>Texunit</var> is a constant
2380 <code>GL_TEXTUREi_ARB</code>, where <var>i</var> is 0 to the maximum
2381 number of the supported texture units.
2382 </p></dd></dl>
2383
2384 <dl>
2385 <dt><a name="index-gl_002dmulti_002dtex_002dcoord_002darb"></a><u>Function:</u> <b>gl-multi-tex-coord-arb</b><i> texunit coords</i></dt>
2386 <dt><a name="index-gl_002dmulti_002dtex_002dcoord_002darb-1"></a><u>Function:</u> <b>gl-multi-tex-coord-arb</b><i> texunit s &amp;optional t r q</i></dt>
2387 <dd><p>[GL_ARB_multitexture]
2388 Specifies the texture coordinate of the texture unit <var>texunit</var>.
2389 In the first form, you can pass either an f32, f64, s32, or s16vector
2390 of length 1 to 4. In the second form, <var>s</var>, <var>t</var>, <var>r</var>
2391 and <var>q</var> must be real numbers.
2392 </p></dd></dl>
2393
2394 <dl>
2395 <dt><a name="index-gl_002dclient_002dactive_002dtexture_002darb"></a><u>Function:</u> <b>gl-client-active-texture-arb</b><i> texunit</i></dt>
2396 <dd><p>Selects the current texture unit for specifying texutre-coordinate
2397 data with vertex arrays.
2398 </p></dd></dl>
2399
2400 <hr size="6">
2401 <a name="Framebuffers"></a>
2402 <table cellpadding="1" cellspacing="1" border="0">
2403 <tr><td valign="middle" align="left">[<a href="#Texture-mapping" title="Previous section in reading order"> &lt; </a>]</td>
2404 <td valign="middle" align="left">[<a href="#Selection-and-feedback" title="Next section in reading order"> &gt; </a>]</td>
2405 <td valign="middle" align="left"> &nbsp; </td>
2406 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
2407 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
2408 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
2409 <td valign="middle" align="left"> &nbsp; </td>
2410 <td valign="middle" align="left"> &nbsp; </td>
2411 <td valign="middle" align="left"> &nbsp; </td>
2412 <td valign="middle" align="left"> &nbsp; </td>
2413 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
2414 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
2415 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
2416 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
2417 </tr></table>
2418 <a name="Framebuffers-1"></a>
2419 <h2 class="section">4.12 Framebuffers</h2>
2420
2421 <a name="Clearing-buffers"></a>
2422 <h3 class="subheading">Clearing buffers</h3>
2423
2424 <dl>
2425 <dt><a name="index-gl_002dclear_002dcolor"></a><u>Function:</u> <b>gl-clear-color</b><i> r g b a</i></dt>
2426 <dd><p>Sets the current clearing color.
2427 Each color value sould be a real number, and is clamped to
2428 <code>[0.0,1.0]</code>.
2429 </p></dd></dl>
2430
2431 <dl>
2432 <dt><a name="index-gl_002dclear_002dindex"></a><u>Function:</u> <b>gl-clear-index</b><i> c</i></dt>
2433 <dd><p>Sets the current clearing color (in color index mode).
2434 <var>c</var> must be a real number.
2435 </p></dd></dl>
2436
2437 <dl>
2438 <dt><a name="index-gl_002dclear_002ddepth"></a><u>Function:</u> <b>gl-clear-depth</b><i> depth</i></dt>
2439 <dd><p>Sets the current clearing depth value.
2440 <var>Depth</var> must be a real number and clamped to <code>[0.0,1.0]</code>.
2441 </p></dd></dl>
2442
2443 <dl>
2444 <dt><a name="index-gl_002dclear_002dstencil"></a><u>Function:</u> <b>gl-clear-stencil</b><i> s</i></dt>
2445 <dd><p>Sets the current clearing value of the stencil buffer.
2446 </p></dd></dl>
2447
2448 <dl>
2449 <dt><a name="index-gl_002dclear_002daccum"></a><u>Function:</u> <b>gl-clear-accum</b><i> r g b a</i></dt>
2450 <dd><p>Sets the current clearing value of accumulation buffer.
2451 </p></dd></dl>
2452
2453 <dl>
2454 <dt><a name="index-gl_002dclear"></a><u>Function:</u> <b>gl-clear</b><i> mask</i></dt>
2455 <dd><p>Clears the specified buffer. <var>Mask</var> is a logical-or of
2456 the following constants.
2457 </p>
2458 <dl compact="compact">
2459 <dt> <code>GL_COLOR_BUFFER_BIT</code></dt>
2460 <dt> <code>GL_DEPTH_BUFFER_BIT</code></dt>
2461 <dt> <code>GL_ACCUM_BUFFER_BIT</code></dt>
2462 <dt> <code>GL_STENCIL_BUFFER_BIT</code></dt>
2463 </dl>
2464
2465 </dd></dl>
2466
2467 <a name="Selecting-color-buffers"></a>
2468 <h3 class="subheading">Selecting color buffers</h3>
2469
2470 <dl>
2471 <dt><a name="index-gl_002ddraw_002dbuffer"></a><u>Function:</u> <b>gl-draw-buffer</b><i> mode</i></dt>
2472 <dd><p>Selects (a) buffer(s) to which the image is rendered.
2473 Possible <var>mode</var> values are: <code>GL_FRONT</code>,
2474 <code>GL_FRONT_LEFT</code>, <code>GL_FRONT_RIGHT</code>,
2475 <code>GL_BACK</code>, <var>GL_BACK_LEFT</var>, <var>GL_BACK_RIGHT</var>,
2476 <code>GL_LEFT</code>, <code>GL_RIGHT</code>, <code>GL_AUXi</code>,
2477 <code>GL_FRONT_AND_BACK</code>, and <code>GL_NONE</code>.
2478 </p></dd></dl>
2479
2480 <dl>
2481 <dt><a name="index-gl_002dread_002dbuffer"></a><u>Function:</u> <b>gl-read-buffer</b><i> mode</i></dt>
2482 <dd><p>Selects a color buffer as the source for reading pixels.
2483 Possible <var>mode</var> values are the same as <code>gl-draw-buffer</code>
2484 except <code>GL_FRONT_AND_BACK</code> and <code>GL_NONE</code>.
2485 </p></dd></dl>
2486
2487 <a name="Masking-buffers"></a>
2488 <h3 class="subheading">Masking buffers</h3>
2489
2490 <dl>
2491 <dt><a name="index-gl_002dindex_002dmask"></a><u>Function:</u> <b>gl-index-mask</b><i> mask</i></dt>
2492 <dd><p>In color index mode, sets the mask of the color-index buffer.
2493 <var>Mask</var> is an exact integer.
2494 </p></dd></dl>
2495
2496 <dl>
2497 <dt><a name="index-gl_002dcolor_002dmask"></a><u>Function:</u> <b>gl-color-mask</b><i> r g b a</i></dt>
2498 <dd><p><var>R</var>, <var>g</var>, <var>b</var> and <var>a</var> are boolean values to
2499 specify whether the corresponding color channel should be written
2500 to the color buffer or not.
2501 </p></dd></dl>
2502
2503 <dl>
2504 <dt><a name="index-gl_002ddepth_002dmask"></a><u>Function:</u> <b>gl-depth-mask</b><i> flag</i></dt>
2505 <dd><p><var>Flag</var> is a boolean value specifies whether depth buffer should
2506 be written or not.
2507 </p></dd></dl>
2508
2509 <dl>
2510 <dt><a name="index-gl_002dstencil_002dmask"></a><u>Function:</u> <b>gl-stencil-mask</b><i> mask</i></dt>
2511 <dd><p>Sets the mask bit pattern for the stencil buffer. <var>Mask</var> is
2512 an exact integer.
2513 </p></dd></dl>
2514
2515
2516 <a name="Testing-and-operating-on-fragments"></a>
2517 <h3 class="subheading">Testing and operating on fragments</h3>
2518
2519 <dl>
2520 <dt><a name="index-gl_002dscissor"></a><u>Function:</u> <b>gl-scissor</b><i> x y width height</i></dt>
2521 <dd><p>Sets the scissor rectangle. If the scissor test is enabled
2522 (use <code>(gl-enable GL_SCISSOR_TEST)</code>), only the pixels that lie inside
2523 the rectangle are written.
2524 </p></dd></dl>
2525
2526 <dl>
2527 <dt><a name="index-gl_002dalpha_002dfunc"></a><u>Function:</u> <b>gl-alpha-func</b><i> func ref</i></dt>
2528 <dd><p>Sets the reference value and comparison function for the alpha test.
2529 <var>Func</var> may be either one of <code>GL_NEVER</code>, <code>GL_ALWAYS</code>,
2530 <code>GL_LESS</code>, <code>GL_LEQUAL</code>, <code>GL_EQUAL</code>, <code>GL_GEQUAL</code>,
2531 <code>GL_GREATER</code>, or <code>GL_NOTEQUAL</code>. <var>Ref</var> sets the reference
2532 value, a real number clamped to be between 0.0 and 1.0.
2533 </p></dd></dl>
2534
2535 <dl>
2536 <dt><a name="index-gl_002dstencil_002dfunc"></a><u>Function:</u> <b>gl-stencil-func</b><i> func ref mask</i></dt>
2537 <dd><p>Sets the comparison function, the reference value, and a mask for
2538 stencil test. <var>Func</var> specifies the funciton, and its possible
2539 value is the same as <code>gl-alpha-func</code>&rsquo;s. <var>Ref</var> is an integer
2540 reference value, and <var>mask</var> is an integer specifying bitwise mask.
2541 Before the comparison, the reference value and the fragment value are
2542 taken bitwise AND by <var>mask</var>.
2543 </p></dd></dl>
2544
2545 <dl>
2546 <dt><a name="index-gl_002dstencil_002dop"></a><u>Function:</u> <b>gl-stencil-op</b><i> func zfail zpass</i></dt>
2547 <dd><p>Speficies how the stencil buffer should be modified by the result of
2548 the stencil test. Each three parameter can take one of the following
2549 values independently: <code>GL_KEEP</code>, <code>GL_ZERO</code>, <code>GL_REPLACE</code>,
2550 <code>GL_INCR</code>, <code>GL_DECR</code>, or <code>GL_INVERT</code>.
2551 </p></dd></dl>
2552
2553
2554 <dl>
2555 <dt><a name="index-gl_002ddepth_002dfunc"></a><u>Function:</u> <b>gl-depth-func</b><i> func</i></dt>
2556 <dd><p>Sets the comparison function for the depth test. <var>Func</var> may
2557 be one of the following constant value: <code>GL_NEVER</code>,
2558 <code>GL_ALWAYS</code>, <code>GL_LESS</code>, <code>GL_LEQUAL</code>, <code>GL_EQUAL</code>,
2559 <code>GL_GEQUAL</code>, <code>GL_GREATER</code>, or <code>GL_NOTEQUAL</code>.
2560 </p></dd></dl>
2561
2562 <dl>
2563 <dt><a name="index-gl_002ddepth_002drange"></a><u>Function:</u> <b>gl-depth-range</b><i> nearv farv</i></dt>
2564 <dd><p>Defines an encoding for z-coordinates. <var>Nearv</var> and <var>farv</var>
2565 define the minimum and maximum values that can be stored in the
2566 depth buffer. By default, they&rsquo;re 0.0 and 1.0, respectively.
2567 </p></dd></dl>
2568
2569 <dl>
2570 <dt><a name="index-gl_002dlogic_002dop"></a><u>Function:</u> <b>gl-logic-op</b><i> opcode</i></dt>
2571 <dd><p>Selects the logical operation to be performed, given an incoming
2572 (source) fragment and the pixel currently in the color buffer
2573 (destination). <var>Opcode</var> may be one of the following values:
2574 <code>GL_CLEAR</code>, <code>GL_COPY</code>, <code>GL_NOOP</code>, <code>GL_SET</code>,
2575 <code>GL_COPY_INVERTED</code>, <code>GL_INVERT</code>, <code>GL_AND_REVERSE</code>,
2576 <code>GL_OR_REVERSE</code>, <code>GL_AND</code>, <code>GL_OR</code>, <code>GL_NAND</code>,
2577 <code>GL_NOR</code>, <code>GL_XOR</code>, <code>GL_EQUIV</code>, <code>GL_AND_INVERTED</code>
2578 or <code>GL_OR_INVERTED</code>.
2579 </p></dd></dl>
2580
2581 <dl>
2582 <dt><a name="index-gl_002daccum"></a><u>Function:</u> <b>gl-accum</b><i> op value</i></dt>
2583 <dd><p>Sets the accumulation buffer operation mode. <var>Op</var> may be
2584 one of the following values:
2585 </p><dl compact="compact">
2586 <dt> <code>GL_ACCUM</code></dt>
2587 <dd><p>Reads each pixel from the current selected buffer to read
2588 (by <code>gl-read-buffer</code>), multiplies its values by <var>value</var>,
2589 and adds the result into the accumulation buffer.
2590 </p></dd>
2591 <dt> <code>GL_LOAD</code></dt>
2592 <dd><p>Same as <code>GL_ACCUM</code> but replacing the accumulation buffer by
2593 the result of multiplication, instead of adding it.
2594 </p></dd>
2595 <dt> <code>GL_RETURN</code></dt>
2596 <dd><p>Takes the values from accumulation buffer, multiplies them with <var>value</var>,
2597 then write it to the current color buffer to write (by <code>gl-draw-buffer</code>).
2598 </p></dd>
2599 <dt> <code>GL_ADD</code></dt>
2600 <dd><p>Adds <var>value</var> to each pixel in the accumulation buffer and write
2601 it back.
2602 </p></dd>
2603 <dt> <code>GL_MULT</code></dt>
2604 <dd><p>Multiplies <var>value</var> to each pixel in the accumulation buffer and write
2605 it back. The result value is clamped to [-1.0, 1.0].
2606 </p></dd>
2607 </dl>
2608 </dd></dl>
2609
2610
2611 <hr size="6">
2612 <a name="Selection-and-feedback"></a>
2613 <table cellpadding="1" cellspacing="1" border="0">
2614 <tr><td valign="middle" align="left">[<a href="#Framebuffers" title="Previous section in reading order"> &lt; </a>]</td>
2615 <td valign="middle" align="left">[<a href="#Projection" title="Next section in reading order"> &gt; </a>]</td>
2616 <td valign="middle" align="left"> &nbsp; </td>
2617 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
2618 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
2619 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
2620 <td valign="middle" align="left"> &nbsp; </td>
2621 <td valign="middle" align="left"> &nbsp; </td>
2622 <td valign="middle" align="left"> &nbsp; </td>
2623 <td valign="middle" align="left"> &nbsp; </td>
2624 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
2625 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
2626 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
2627 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
2628 </tr></table>
2629 <a name="Selection-and-feedback-1"></a>
2630 <h2 class="section">4.13 Selection and feedback</h2>
2631
2632 <dl>
2633 <dt><a name="index-gl_002dfeedback_002dbuffer"></a><u>Function:</u> <b>gl-feedback-buffer</b><i> type buffer</i></dt>
2634 </dl>
2635
2636 <dl>
2637 <dt><a name="index-gl_002dselect_002dbuffer"></a><u>Function:</u> <b>gl-select-buffer</b><i> buffer</i></dt>
2638 </dl>
2639
2640 <dl>
2641 <dt><a name="index-gl_002drender_002dmode"></a><u>Function:</u> <b>gl-render-mode</b><i> mode</i></dt>
2642 </dl>
2643
2644 <dl>
2645 <dt><a name="index-gl_002dpass_002dthrough"></a><u>Function:</u> <b>gl-pass-through</b><i> token</i></dt>
2646 </dl>
2647
2648 <dl>
2649 <dt><a name="index-gl_002dinit_002dnames"></a><u>Function:</u> <b>gl-init-names</b></dt>
2650 </dl>
2651
2652 <dl>
2653 <dt><a name="index-gl_002dload_002dname"></a><u>Function:</u> <b>gl-load-name</b><i> name</i></dt>
2654 </dl>
2655
2656 <dl>
2657 <dt><a name="index-gl_002dpush_002dname"></a><u>Function:</u> <b>gl-push-name</b><i> name</i></dt>
2658 </dl>
2659
2660 <dl>
2661 <dt><a name="index-gl_002dpop_002dname"></a><u>Function:</u> <b>gl-pop-name</b></dt>
2662 </dl>
2663
2664
2665
2666 <hr size="6">
2667 <a name="Projection"></a>
2668 <table cellpadding="1" cellspacing="1" border="0">
2669 <tr><td valign="middle" align="left">[<a href="#Selection-and-feedback" title="Previous section in reading order"> &lt; </a>]</td>
2670 <td valign="middle" align="left">[<a href="#Quadrics" title="Next section in reading order"> &gt; </a>]</td>
2671 <td valign="middle" align="left"> &nbsp; </td>
2672 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
2673 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
2674 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
2675 <td valign="middle" align="left"> &nbsp; </td>
2676 <td valign="middle" align="left"> &nbsp; </td>
2677 <td valign="middle" align="left"> &nbsp; </td>
2678 <td valign="middle" align="left"> &nbsp; </td>
2679 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
2680 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
2681 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
2682 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
2683 </tr></table>
2684 <a name="Projection-1"></a>
2685 <h2 class="section">4.14 Projection</h2>
2686
2687 <dl>
2688 <dt><a name="index-glu_002dpick_002dmatrix"></a><u>Function:</u> <b>glu-pick-matrix</b><i> x y w h vp</i></dt>
2689 </dl>
2690
2691 <dl>
2692 <dt><a name="index-glu_002dproject"></a><u>Function:</u> <b>glu-project</b><i> objx objy objz model-mat proj-mat vp</i></dt>
2693 </dl>
2694
2695 <dl>
2696 <dt><a name="index-glu_002dun_002dproject"></a><u>Function:</u> <b>glu-un-project</b><i> winx winy winz model-mat proj-mat vp</i></dt>
2697 </dl>
2698
2699 <dl>
2700 <dt><a name="index-glu_002dproject_0021"></a><u>Function:</u> <b>glu-project!</b><i> win obj model-mat proj-mat vp</i></dt>
2701 </dl>
2702
2703 <dl>
2704 <dt><a name="index-glu_002dun_002dproject_0021"></a><u>Function:</u> <b>glu-un-project!</b><i> obj win model-map proj-mat vp</i></dt>
2705 </dl>
2706
2707 <hr size="6">
2708 <a name="Quadrics"></a>
2709 <table cellpadding="1" cellspacing="1" border="0">
2710 <tr><td valign="middle" align="left">[<a href="#Projection" title="Previous section in reading order"> &lt; </a>]</td>
2711 <td valign="middle" align="left">[<a href="#Nurbs" title="Next section in reading order"> &gt; </a>]</td>
2712 <td valign="middle" align="left"> &nbsp; </td>
2713 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
2714 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
2715 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
2716 <td valign="middle" align="left"> &nbsp; </td>
2717 <td valign="middle" align="left"> &nbsp; </td>
2718 <td valign="middle" align="left"> &nbsp; </td>
2719 <td valign="middle" align="left"> &nbsp; </td>
2720 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
2721 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
2722 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
2723 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
2724 </tr></table>
2725 <a name="Quadrics-1"></a>
2726 <h2 class="section">4.15 Quadrics</h2>
2727
2728 <dl>
2729 <dt><a name="index-_003cglu_002dquadric_003e"></a><u>Class:</u> <b>&lt;glu-quadric&gt;</b></dt>
2730 </dl>
2731
2732 <dl>
2733 <dt><a name="index-glu_002dquadric_002ddraw_002dstyle"></a><u>Function:</u> <b>glu-quadric-draw-style</b><i> quad style</i></dt>
2734 <dd>
2735 <dl>
2736 <dt><a name="index-GLU_005fPOINT"></a><u>Constant:</u> <b>GLU_POINT</b></dt>
2737 <dt><a name="index-GLU_005fLINE"></a><u>Constant:</u> <b>GLU_LINE</b></dt>
2738 <dt><a name="index-GLU_005fFILL"></a><u>Constant:</u> <b>GLU_FILL</b></dt>
2739 <dt><a name="index-GLU_005fSILHUETTE"></a><u>Constant:</u> <b>GLU_SILHUETTE</b></dt>
2740 </dl>
2741
2742 </dd></dl>
2743
2744 <dl>
2745 <dt><a name="index-glu_002dquadric_002dorientation"></a><u>Function:</u> <b>glu-quadric-orientation</b><i> quad orientation</i></dt>
2746 <dd>
2747 <dl>
2748 <dt><a name="index-GLU_005fOUTSIDE"></a><u>Constant:</u> <b>GLU_OUTSIDE</b></dt>
2749 <dt><a name="index-GLU_005fINSIDE"></a><u>Constant:</u> <b>GLU_INSIDE</b></dt>
2750 </dl>
2751
2752 </dd></dl>
2753
2754 <dl>
2755 <dt><a name="index-glu_002dquadric_002dnormals"></a><u>Function:</u> <b>glu-quadric-normals</b><i> quad normals</i></dt>
2756 <dd>
2757 <dl>
2758 <dt><a name="index-GLU_005fSMOOTH"></a><u>Constant:</u> <b>GLU_SMOOTH</b></dt>
2759 <dt><a name="index-GLU_005fFLAT"></a><u>Constant:</u> <b>GLU_FLAT</b></dt>
2760 <dt><a name="index-GLU_005fNONE"></a><u>Constant:</u> <b>GLU_NONE</b></dt>
2761 </dl>
2762
2763 </dd></dl>
2764
2765 <dl>
2766 <dt><a name="index-glu_002dquadric_002dtexture"></a><u>Function:</u> <b>glu-quadric-texture</b><i> quad texcoords</i></dt>
2767 </dl>
2768
2769 <dl>
2770 <dt><a name="index-glu_002dcylinder"></a><u>Function:</u> <b>glu-cylinder</b><i> quad base-radius top-radius height slices stacks</i></dt>
2771 </dl>
2772
2773 <dl>
2774 <dt><a name="index-glu_002dsphere"></a><u>Function:</u> <b>glu-sphere</b><i> quad radius slices stacks</i></dt>
2775 </dl>
2776
2777 <dl>
2778 <dt><a name="index-glu_002ddisk"></a><u>Function:</u> <b>glu-disk</b><i> quad inner-radius outer-radius slices loops</i></dt>
2779 </dl>
2780
2781 <dl>
2782 <dt><a name="index-glu_002dpartial_002ddisk"></a><u>Function:</u> <b>glu-partial-disk</b><i> quad inner-radius outer-radius slices loops start-angle sweep-angle</i></dt>
2783 </dl>
2784
2785 <hr size="6">
2786 <a name="Nurbs"></a>
2787 <table cellpadding="1" cellspacing="1" border="0">
2788 <tr><td valign="middle" align="left">[<a href="#Quadrics" title="Previous section in reading order"> &lt; </a>]</td>
2789 <td valign="middle" align="left">[<a href="#Polygon-tesselation" title="Next section in reading order"> &gt; </a>]</td>
2790 <td valign="middle" align="left"> &nbsp; </td>
2791 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
2792 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
2793 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
2794 <td valign="middle" align="left"> &nbsp; </td>
2795 <td valign="middle" align="left"> &nbsp; </td>
2796 <td valign="middle" align="left"> &nbsp; </td>
2797 <td valign="middle" align="left"> &nbsp; </td>
2798 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
2799 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
2800 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
2801 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
2802 </tr></table>
2803 <a name="Nurbs-1"></a>
2804 <h2 class="section">4.16 Nurbs</h2>
2805
2806 <dl>
2807 <dt><a name="index-_003cglu_002dnurbs_003e"></a><u>Class:</u> <b>&lt;glu-nurbs&gt;</b></dt>
2808 </dl>
2809
2810 <dl>
2811 <dt><a name="index-glu_002dload_002dsampling_002dmatrices"></a><u>Function:</u> <b>glu-load-sampling-matrices</b><i> nurbs model-matrix proj-matrix viewport</i></dt>
2812 </dl>
2813
2814 <dl>
2815 <dt><a name="index-glu_002dnurbs_002dproperty"></a><u>Function:</u> <b>glu-nurbs-property</b><i> nurbs property value</i></dt>
2816 </dl>
2817
2818 <dl>
2819 <dt><a name="index-glu_002dget_002dnurbs_002dproperty"></a><u>Function:</u> <b>glu-get-nurbs-property</b><i> nurbs property</i></dt>
2820 </dl>
2821
2822 <dl>
2823 <dt><a name="index-glu_002dbegin_002dcurve"></a><u>Function:</u> <b>glu-begin-curve</b><i> nurbs</i></dt>
2824 </dl>
2825
2826 <dl>
2827 <dt><a name="index-glu_002dend_002dcurve"></a><u>Function:</u> <b>glu-end-curve</b><i> nurbs</i></dt>
2828 </dl>
2829
2830 <dl>
2831 <dt><a name="index-glu_002dnurbs_002dcurve"></a><u>Function:</u> <b>glu-nurbs-curve</b><i> nurbs knot stride ctlarray order type</i></dt>
2832 </dl>
2833
2834 <dl>
2835 <dt><a name="index-glu_002dbegin_002dsurface"></a><u>Function:</u> <b>glu-begin-surface</b><i> nurbs</i></dt>
2836 </dl>
2837
2838 <dl>
2839 <dt><a name="index-glu_002dend_002dsurface"></a><u>Function:</u> <b>glu-end-surface</b><i> nurbs</i></dt>
2840 </dl>
2841
2842
2843 <hr size="6">
2844 <a name="Polygon-tesselation"></a>
2845 <table cellpadding="1" cellspacing="1" border="0">
2846 <tr><td valign="middle" align="left">[<a href="#Nurbs" title="Previous section in reading order"> &lt; </a>]</td>
2847 <td valign="middle" align="left">[<a href="#Programmable-shaders" title="Next section in reading order"> &gt; </a>]</td>
2848 <td valign="middle" align="left"> &nbsp; </td>
2849 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
2850 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
2851 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
2852 <td valign="middle" align="left"> &nbsp; </td>
2853 <td valign="middle" align="left"> &nbsp; </td>
2854 <td valign="middle" align="left"> &nbsp; </td>
2855 <td valign="middle" align="left"> &nbsp; </td>
2856 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
2857 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
2858 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
2859 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
2860 </tr></table>
2861 <a name="Polygon-tesselation-1"></a>
2862 <h2 class="section">4.17 Polygon tesselation</h2>
2863
2864 <dl>
2865 <dt><a name="index-_003cglu_002dtesselator_003e"></a><u>Class:</u> <b>&lt;glu-tesselator&gt;</b></dt>
2866 </dl>
2867
2868 <hr size="6">
2869 <a name="Programmable-shaders"></a>
2870 <table cellpadding="1" cellspacing="1" border="0">
2871 <tr><td valign="middle" align="left">[<a href="#Polygon-tesselation" title="Previous section in reading order"> &lt; </a>]</td>
2872 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next section in reading order"> &gt; </a>]</td>
2873 <td valign="middle" align="left"> &nbsp; </td>
2874 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
2875 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
2876 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
2877 <td valign="middle" align="left"> &nbsp; </td>
2878 <td valign="middle" align="left"> &nbsp; </td>
2879 <td valign="middle" align="left"> &nbsp; </td>
2880 <td valign="middle" align="left"> &nbsp; </td>
2881 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
2882 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
2883 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
2884 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
2885 </tr></table>
2886 <a name="Programmable-shaders-1"></a>
2887 <h2 class="section">4.18 Programmable shaders</h2>
2888
2889 <a name="Shader-objects"></a>
2890 <h3 class="subheading">Shader objects</h3>
2891
2892 <dl>
2893 <dt><a name="index-gl_002dcreate_002dshader_002dobject_002darb"></a><u>Function:</u> <b>gl-create-shader-object-arb</b><i> type</i></dt>
2894 <dd><p>[GL_ARB_shader_objects]
2895 Creates a new shader object and returns its handle.
2896 <var>Type</var> can be either <code>GL_VERTEX_SHADER_ARB</code> or
2897 <code>GL_FRAGMENT_SHADER_ARB</code>.
2898 </p></dd></dl>
2899
2900 <dl>
2901 <dt><a name="index-gl_002dshader_002dsource_002darb"></a><u>Function:</u> <b>gl-shader-source-arb</b><i> shader strings</i></dt>
2902 <dd><p>[GL_ARB_shader_objects]
2903 Sets the source code of the shader, whose handle is <var>shader</var>.
2904 You can give the source code as a list of strings to <var>strings</var>.
2905 All strings are concatenated internally in the OpenGL driver.
2906 </p></dd></dl>
2907
2908 <dl>
2909 <dt><a name="index-gl_002dcompile_002dshader_002darb"></a><u>Function:</u> <b>gl-compile-shader-arb</b><i> shader</i></dt>
2910 <dd><p>[GL_ARB_shader_objects]
2911 Compile the source code attached to the shader, whose handle is <var>shader</var>.
2912 You can query the result of the compilation by passing
2913 <code>GL_OBJECT_COMPILE_STATUS_ARB</code> to <code>gl-get-object-parameter-arb</code>;
2914 it returns <code>#t</code> if the compilation succeeded, or <code>#f</code> if failed.
2915 The information about the compilation can be obtained by
2916 <code>gl-get-info-log-arb</code>.
2917 </p></dd></dl>
2918
2919 <dl>
2920 <dt><a name="index-gl_002dcreate_002dprogram_002dobject_002darb"></a><u>Function:</u> <b>gl-create-program-object-arb</b></dt>
2921 <dd><p>[GL_ARB_shader_objects]
2922 Creates a new program object and returns its handle.
2923 </p></dd></dl>
2924
2925 <dl>
2926 <dt><a name="index-gl_002dattach_002dobject_002darb"></a><u>Function:</u> <b>gl-attach-object-arb</b><i> program shader</i></dt>
2927 <dd><p>[GL_ARB_shader_objects]
2928 Attach a shader whose handle is <var>shader</var> to the program whose handle
2929 is <var>program</var>.
2930 </p></dd></dl>
2931
2932 <dl>
2933 <dt><a name="index-gl_002ddetach_002dobject_002darb"></a><u>Function:</u> <b>gl-detach-object-arb</b><i> program shader</i></dt>
2934 <dd><p>[GL_ARB_shader_objects]
2935 Detach a shader from a program.
2936 </p></dd></dl>
2937
2938 <dl>
2939 <dt><a name="index-gl_002dlink_002dprogram_002darb"></a><u>Function:</u> <b>gl-link-program-arb</b><i> program</i></dt>
2940 <dd><p>[GL_ARB_shader_objects]
2941 Link the program object. The result of linking can be queried
2942 by passing <code>GL_OBJECT_LINK_STATUS_ARB</code> to
2943 <code>gl-get-object-parameter-arb</code>.
2944 </p></dd></dl>
2945
2946 <dl>
2947 <dt><a name="index-gl_002duse_002dprogram_002dobject_002darb"></a><u>Function:</u> <b>gl-use-program-object-arb</b><i> program</i></dt>
2948 <dd><p>[GL_ARB_shader_objects]
2949 Installs the program to the current rendering state.
2950 </p></dd></dl>
2951
2952 <dl>
2953 <dt><a name="index-gl_002ddelete_002dobject_002darb"></a><u>Function:</u> <b>gl-delete-object-arb</b><i> handle</i></dt>
2954 <dd><p>[GL_ARB_shader_objects]
2955 Deletes either a shader object or a program object specified by
2956 <var>handle</var>.
2957 </p></dd></dl>
2958
2959 <dl>
2960 <dt><a name="index-gl_002dget_002dobject_002dparameter_002darb"></a><u>Function:</u> <b>gl-get-object-parameter-arb</b><i> object pname</i></dt>
2961 <dd><p>[GL_ARB_shader_objects]
2962 Queries the value of <var>pname</var> of the shader or the program
2963 specified by <var>object</var>. The following values are accepted
2964 as <var>pname</var>: <code>GL_OBJECT_TYPE_ARB</code>,
2965 <code>GL_OBJECT_SUBTYPE_ARB</code>,
2966 <code>GL_OBJECT_DELETE_STATUS_ARB</code>,
2967 <code>GL_OBJECT_COMPILE_STATUS_ARB</code>,
2968 <code>GL_OBJECT_LINK_STATUS_ARB</code>,
2969 <code>GL_OBJECT_VALIDATE_STATUS_ARB</code>,
2970 <code>GL_OBJECT_INFO_LOG_LENGTH_ARB</code>,
2971 <code>GL_OBJECT_ATTACHED_OBJECTS_ARB</code>,
2972 <code>GL_OBJECT_ACTIVE_ATTRIBUTES_ARB</code>,
2973 <code>GL_OBJECT_ACTIVE_ATTRIBUTE_MAX_LENGTH_ARB</code>,
2974 <code>GL_OBJECT_ACTIVE_UNIFORMS_ARB</code>,
2975 <code>GL_OBJECT_ACTIVE_UNIFORM_MAX_LENGTH_ARB</code>, and
2976 <code>GL_OBJECT_SHADER_SOURCE_LENGTH_ARB</code>.
2977 The procedure returns an integer value.
2978 </p></dd></dl>
2979
2980 <dl>
2981 <dt><a name="index-gl_002dget_002dshader_002dsource_002darb"></a><u>Function:</u> <b>gl-get-shader-source-arb</b><i> shader</i></dt>
2982 <dd><p>[GL_ARB_shader_objects]
2983 Returns the shader source code of a shader object <var>shader</var>
2984 in a string.
2985 </p></dd></dl>
2986
2987 <dl>
2988 <dt><a name="index-gl_002dget_002dinfo_002dlog_002darb"></a><u>Function:</u> <b>gl-get-info-log-arb</b><i> handle</i></dt>
2989 <dd><p>[GL_ARB_shader_objects]
2990 Returns the information log of an object pointed by <var>handle</var>.
2991 </p></dd></dl>
2992
2993 <dl>
2994 <dt><a name="index-gl_002dget_002dhandle_002darb"></a><u>Function:</u> <b>gl-get-handle-arb</b><i> pname</i></dt>
2995 <dd><p>[GL_ARB_shader_objects]
2996 Returns the handle to an object that is used in the current state.
2997 The only argument accepted currently as <var>pname</var> is
2998 <code>GL_PROGRAM_OBJECT_ARB</code>, which returns the handle to the current
2999 program object.
3000 </p></dd></dl>
3001
3002 <dl>
3003 <dt><a name="index-gl_002dget_002dattached_002dobjects_002darb"></a><u>Function:</u> <b>gl-get-attached-objects-arb</b><i> program</i></dt>
3004 <dd><p>[GL_ARB_shader_objects]
3005 Rethrns a vector of GL object handles that are attached to the <var>program</var>.
3006 </p></dd></dl>
3007
3008 <dl>
3009 <dt><a name="index-gl_002dvalidate_002dprogram_002darb"></a><u>Function:</u> <b>gl-validate-program-arb</b><i> program</i></dt>
3010 <dd><p>[GL_ARB_shader_objects]
3011 Checks whether the <var>program</var> can execute in the current GL state.
3012 The result is stored in <var>program</var>&rsquo;s log.
3013 </p></dd></dl>
3014
3015 <a name="Specifying-vertex-attributes"></a>
3016 <h3 class="subheading">Specifying vertex attributes</h3>
3017
3018 <dl>
3019 <dt><a name="index-gl_002dvertex_002dattrib_002darb"></a><u>Function:</u> <b>gl-vertex-attrib-arb</b><i> index values</i></dt>
3020 <dt><a name="index-gl_002dvertex_002dattrib_002darb-1"></a><u>Function:</u> <b>gl-vertex-attrib-arb</b><i> index v0 &amp;rest v1 v2 v3</i></dt>
3021 <dd><p>[GL_ARB_vertex_program]
3022 Sets the generic vertex attribute specified by <var>index</var>.
3023 In the first form, you can pass f32, f64, or s16vector of size
3024 1 to 4, or u8, s8, u16, s32, or u32vector of size 4.
3025 In the second form, you can pass 1 to 4 real numbers (they
3026 are interpreted as C doubles and <code>glVertexAttrib4dARB</code> is called).
3027 </p></dd></dl>
3028
3029 <dl>
3030 <dt><a name="index-gl_002dvertex_002dattrib_002d4n_002darb"></a><u>Function:</u> <b>gl-vertex-attrib-4n-arb</b><i> index values</i></dt>
3031 <dt><a name="index-gl_002dvertex_002dattrib_002d4n_002darb-1"></a><u>Function:</u> <b>gl-vertex-attrib-4n-arb</b><i> index v0 v1 v2 v3</i></dt>
3032 <dd><p>[GL_ARB_vertex_program]
3033 These variations can be used to pass normalized values.
3034 The first form accepts s8, u8, s16, u16, s32, u32, f32 and f64vector
3035 of size 4. The second value takes four integers, whose lower 8bits
3036 are taken as unsigned byte and passed to <code>glVertexAttrib4NubARB</code>.
3037 </p></dd></dl>
3038
3039 <dl>
3040 <dt><a name="index-gl_002dvertex_002dattrib_002dpointer_002darb"></a><u>Function:</u> <b>gl-vertex-attrib-pointer-arb</b><i> index size vec &amp;optional normalized stride offset</i></dt>
3041 <dd><p>[GL_ARB_vertex_program]
3042 This is the generic version of vertex arrays. <var>Index</var> names
3043 the attribute, <var>size</var> specifies the number of components (1, 2, 3 or 4),
3044 and <var>vec</var> is a uniform vector that contains the array of values.
3045 </p>
3046 <p>The optional boolean <var>normalized</var> argument tells whether the
3047 passed integer values should be mapped to normalized range (<code>#t</code> or
3048 taken as are <code>#f</code>, default). The optional <var>stride</var> argument
3049 specifies the gap between each set of values within <var>vec</var>.
3050 The optional <var>offset</var> argument tells GL to take values beginning
3051 from the <var>offset</var>-th element of <var>vec</var>.
3052 </p></dd></dl>
3053
3054 <dl>
3055 <dt><a name="index-gl_002denable_002dvertex_002dattrib_002darray_002darb"></a><u>Function:</u> <b>gl-enable-vertex-attrib-array-arb</b><i> index</i></dt>
3056 <dt><a name="index-gl_002ddisable_002dvertex_002dattrib_002darray_002darb"></a><u>Function:</u> <b>gl-disable-vertex-attrib-array-arb</b><i> index</i></dt>
3057 <dd><p>[GL_ARB_vertex_program]
3058 Enable or disable a vertex attribute array specified by <var>index</var>.
3059 </p></dd></dl>
3060
3061 <dl>
3062 <dt><a name="index-gl_002dbind_002dattrib_002dlocation_002darb"></a><u>Function:</u> <b>gl-bind-attrib-location-arb</b><i> program index name</i></dt>
3063 <dd><p>[GL_ARB_vertex_shader]
3064 Associates a user-defined attribute variable in the program object
3065 <var>program</var> with an <var>index</var>-th generic vertex attribute.
3066 <var>Name</var> is a string of the name of user-defined attribute as appears
3067 in the shader program.
3068 </p></dd></dl>
3069
3070 <dl>
3071 <dt><a name="index-gl_002dget_002dattrib_002dlocation_002darb"></a><u>Function:</u> <b>gl-get-attrib-location-arb</b><i> program name</i></dt>
3072 <dd><p>[GL_ARB_vertex_shader]
3073 Returns an integer index of the user-defined attribute <var>name</var>
3074 in the <var>program</var>. Must be called after <var>program</var> is linked.
3075 </p></dd></dl>
3076
3077 <dl>
3078 <dt><a name="index-gl_002dget_002dactive_002dattrib_002darb"></a><u>Function:</u> <b>gl-get-active-attrib-arb</b><i> program index</i></dt>
3079 <dd><p>[GL_ARB_vertex_shader]
3080 Obtains information about the <var>index</var>-th user-defined attribute
3081 in the <var>program</var>. Must be called after <var>program</var> is linked.
3082 </p>
3083 <p>It returns three values: the size of the attribute (1, 2, 3 or 4),
3084 the type of the attribute (an integer that matches one of the following
3085 constants: <code>GL_FLOAT</code>, <code>GL_FLOAT_VEC2_ARB</code>,
3086 <code>GL_FLOAT_VEC3_ARB</code>, <code>GL_FLOAT_VEC4_ARB</code>,
3087 <code>GL_FLOAT_MAT2_ARB</code>, <code>GL_FLOAT_MAT3_ARB</code>, or
3088 <code>GL_FLOAT_MAT4_ARB</code>.), and
3089 the name of the attribute.
3090 </p></dd></dl>
3091
3092 <a name="Specifying-uniform-variables"></a>
3093 <h3 class="subheading">Specifying uniform variables</h3>
3094
3095 <dl>
3096 <dt><a name="index-gl_002dget_002duniform_002dlocation_002darb"></a><u>Function:</u> <b>gl-get-uniform-location-arb</b><i> program name</i></dt>
3097 <dd><p>[GL_ARB_shader_objects]
3098 Returns an integer location of the uniform variable <var>name</var>
3099 of the program <var>program</var>.
3100 </p></dd></dl>
3101
3102 <dl>
3103 <dt><a name="index-gl_002duniform1_002darb"></a><u>Function:</u> <b>gl-uniform1-arb</b><i> location vec</i></dt>
3104 <dt><a name="index-gl_002duniform1_002darb-1"></a><u>Function:</u> <b>gl-uniform1-arb</b><i> location v0</i></dt>
3105 <dt><a name="index-gl_002duniform2_002darb"></a><u>Function:</u> <b>gl-uniform2-arb</b><i> location vec</i></dt>
3106 <dt><a name="index-gl_002duniform2_002darb-1"></a><u>Function:</u> <b>gl-uniform2-arb</b><i> location v0 v1</i></dt>
3107 <dt><a name="index-gl_002duniform3_002darb"></a><u>Function:</u> <b>gl-uniform3-arb</b><i> location vec</i></dt>
3108 <dt><a name="index-gl_002duniform3_002darb-1"></a><u>Function:</u> <b>gl-uniform3-arb</b><i> location v0 v1 v2</i></dt>
3109 <dt><a name="index-gl_002duniform4_002darb"></a><u>Function:</u> <b>gl-uniform4-arb</b><i> location vec</i></dt>
3110 <dt><a name="index-gl_002duniform4_002darb-1"></a><u>Function:</u> <b>gl-uniform4-arb</b><i> location v0 v1 v1 v3</i></dt>
3111 <dd><p>[GL_ARB_shader_objects]
3112 Sets a value of the uniform variable specified by <var>location</var>.
3113 <var>gl-uniform1-arb</var> sets a single component value (e.g. <code>float</code>)
3114 <var>gl-uniform2-arb</var> sets a double component value
3115 (e.g. <code>vec2</code>) etc.
3116 </p>
3117 <p>The first form of each function takes either an s32vector or f32vector.
3118 It can have a size multiple of the number of components to
3119 set an array uniform variable (e.g. you can pass an f32vector of
3120 size 8 to fill <code>vec2[2]</code>).
3121 </p>
3122 <p>The second form just sets the component(s) of a single uniform variable.
3123 The arguments <var>v0</var> to <var>v3</var> must be real numbers, and
3124 coerced to C <code>float</code> (i.e. <code>glUniform*fARB</code> is used).
3125 </p></dd></dl>
3126
3127
3128 <dl>
3129 <dt><a name="index-gl_002duniform_002dmatrix2_002darb"></a><u>Function:</u> <b>gl-uniform-matrix2-arb</b><i> location transpose v</i></dt>
3130 <dt><a name="index-gl_002duniform_002dmatrix3_002darb"></a><u>Function:</u> <b>gl-uniform-matrix3-arb</b><i> location transpose v</i></dt>
3131 <dt><a name="index-gl_002duniform_002dmatrix4_002darb"></a><u>Function:</u> <b>gl-uniform-matrix4-arb</b><i> location transpose v</i></dt>
3132 <dd><p>[GL_ARB_shader_objects]
3133 Sets a matrix uniform variable (or an array of matrix uniform variables)
3134 specified by <var>location</var>.
3135 A boolean flag <var>transpose</var> specifies whether the matrix should be
3136 transposed.
3137 The <var>v</var> argument must be a f32vector of size multiple of 4, 9, or
3138 16, respectively.
3139 </p></dd></dl>
3140
3141 <dl>
3142 <dt><a name="index-gl_002dget_002dactive_002duniform_002darb"></a><u>Function:</u> <b>gl-get-active-uniform-arb</b><i> program index</i></dt>
3143 <dd><p>[GL_ARB_shader_objects]
3144 Returns informaton about the <var>index</var>-th uniform variable of
3145 <var>program</var>.
3146 </p>
3147 <p>Returns three values. The first one is the size, either 1, 2, 3 or 4.
3148 The second value is the type, which is an integer that matches
3149 one of the following constants: <code>GL_FLOAT</code>,
3150 <code>GL_FLOAT_VEC(1|2|3|4)_ARB</code>, <code>GL_INT</code>,
3151 <code>GL_INT_VEC(1|2|3|4)_ARB</code>, <code>GL_BOOL</code>,
3152 <code>GL_BOOL_VEC(1|2|3|4)_ARB</code>, <code>GL_FLOAT_MAT(2|3|4)_ARB</code>.
3153 And the third value is the name of the uniform variable.
3154 </p></dd></dl>
3155
3156 <a name="Vertex-and-fragment-programs"></a>
3157 <h3 class="subheading">Vertex and fragment programs</h3>
3158
3159 <p>These APIs are for low-level vertex/fragment pipeline programming.
3160 </p>
3161 <dl>
3162 <dt><a name="index-gl_002dgen_002dprograms_002darb"></a><u>Function:</u> <b>gl-gen-programs-arb</b><i> n</i></dt>
3163 <dd><p>[GL_ARB_vertex_program]
3164 Generates <var>N</var> names (integers) for the new programs and
3165 returns them in an s32vector.
3166 </p></dd></dl>
3167
3168 <dl>
3169 <dt><a name="index-gl_002ddelete_002dprograms_002darb"></a><u>Function:</u> <b>gl-delete-programs-arb</b><i> programs</i></dt>
3170 <dd><p>[GL_ARB_vertex_program]
3171 Deletes programs whose names are specified by an s32vector <var>programs</var>.
3172 </p></dd></dl>
3173
3174 <dl>
3175 <dt><a name="index-gl_002dis_002dprogram_002darb"></a><u>Function:</u> <b>gl-is-program-arb</b><i> prog-id</i></dt>
3176 <dd><p>[GL_ARB_vertex_program]
3177 Returns <code>#t</code> if an integer <var>prog-id</var> refers to a valid program.
3178 </p></dd></dl>
3179
3180 <dl>
3181 <dt><a name="index-gl_002dbind_002dprogram_002darb"></a><u>Function:</u> <b>gl-bind-program-arb</b><i> target prog-id</i></dt>
3182 <dd><p>[GL_ARB_vertex_program]
3183 Binds a program specified by <var>prog-id</var> to a <var>target</var>,
3184 which is either <code>GL_VERTEX_PROGRAM_ARB</code> or
3185 <var>GL_FRAGMENT_PROGRAM_ARB</var>.
3186 </p></dd></dl>
3187
3188 <dl>
3189 <dt><a name="index-gl_002dprogram_002dstring_002darb"></a><u>Function:</u> <b>gl-program-string-arb</b><i> target format text</i></dt>
3190 <dd><p>[GL_ARB_vertex_program]
3191 Sets the source code of the program currently bound to the
3192 <var>target</var> (<code>GL_VERTEX_PROGRAM_ARB</code> or
3193 <var>GL_FRAGMENT_PROGRAM_ARB</var>).
3194 </p>
3195 <p><var>Format</var> must be <code>GL_PROGRAM_FORMAT_ASCII_ARB</code>.
3196 <var>Text</var> is a string for the program source.
3197 </p></dd></dl>
3198
3199 <dl>
3200 <dt><a name="index-gl_002dprogram_002denv_002dparameter_002darb"></a><u>Function:</u> <b>gl-program-env-parameter-arb</b><i> target param-id args</i></dt>
3201 <dt><a name="index-gl_002dprogram_002denv_002dparameter_002darb-1"></a><u>Function:</u> <b>gl-program-env-parameter-arb</b><i> target param-id arg0 arg1 arg2 arg3</i></dt>
3202 <dt><a name="index-gl_002dprogram_002dlocal_002dparameter_002darb"></a><u>Function:</u> <b>gl-program-local-parameter-arb</b><i> target param-id args</i></dt>
3203 <dt><a name="index-gl_002dprogram_002dlocal_002dparameter_002darb-1"></a><u>Function:</u> <b>gl-program-local-parameter-arb</b><i> target param-id arg0 arg1 arg2 arg3</i></dt>
3204 <dd><p>[GL_ARB_vertex_program]
3205 Sets the value of the environment and local parameter
3206 specified by <var>param-id</var> of the program currently bount to the <var>target</var>.
3207 In the first form of each, <var>args</var> must be either f32 or
3208 f64vector of size 4 or <code>&lt;vector4f&gt;</code> object.
3209 </p></dd></dl>
3210
3211
3212 <hr size="6">
3213 <a name="GLUT-API"></a>
3214 <table cellpadding="1" cellspacing="1" border="0">
3215 <tr><td valign="middle" align="left">[<a href="#Programmable-shaders" title="Previous section in reading order"> &lt; </a>]</td>
3216 <td valign="middle" align="left">[<a href="#GLUT-window-manipulation" title="Next section in reading order"> &gt; </a>]</td>
3217 <td valign="middle" align="left"> &nbsp; </td>
3218 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3219 <td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
3220 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3221 <td valign="middle" align="left"> &nbsp; </td>
3222 <td valign="middle" align="left"> &nbsp; </td>
3223 <td valign="middle" align="left"> &nbsp; </td>
3224 <td valign="middle" align="left"> &nbsp; </td>
3225 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3226 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3227 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
3228 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3229 </tr></table>
3230 <a name="GLUT-API-1"></a>
3231 <h1 class="chapter">5. GLUT API</h1>
3232
3233 <table class="menu" border="0" cellspacing="0">
3234 <tr><td align="left" valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
3235 </td></tr>
3236 <tr><td align="left" valign="top"><a href="#GLUT-overlay">5.2 GLUT overlay</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
3237 </td></tr>
3238 <tr><td align="left" valign="top"><a href="#GLUT-menu-API">5.3 GLUT menu API</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
3239 </td></tr>
3240 <tr><td align="left" valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
3241 </td></tr>
3242 <tr><td align="left" valign="top"><a href="#GLUT-colormap">5.5 GLUT colormap</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
3243 </td></tr>
3244 <tr><td align="left" valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
3245 </td></tr>
3246 <tr><td align="left" valign="top"><a href="#GLUT-font">5.7 GLUT font</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
3247 </td></tr>
3248 <tr><td align="left" valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
3249 </td></tr>
3250 </table>
3251
3252 <hr size="6">
3253 <a name="GLUT-window-manipulation"></a>
3254 <table cellpadding="1" cellspacing="1" border="0">
3255 <tr><td valign="middle" align="left">[<a href="#GLUT-API" title="Previous section in reading order"> &lt; </a>]</td>
3256 <td valign="middle" align="left">[<a href="#GLUT-overlay" title="Next section in reading order"> &gt; </a>]</td>
3257 <td valign="middle" align="left"> &nbsp; </td>
3258 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3259 <td valign="middle" align="left">[<a href="#GLUT-API" title="Up section"> Up </a>]</td>
3260 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3261 <td valign="middle" align="left"> &nbsp; </td>
3262 <td valign="middle" align="left"> &nbsp; </td>
3263 <td valign="middle" align="left"> &nbsp; </td>
3264 <td valign="middle" align="left"> &nbsp; </td>
3265 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3266 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3267 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
3268 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3269 </tr></table>
3270 <a name="GLUT-window-manipulation-1"></a>
3271 <h2 class="section">5.1 GLUT window manipulation</h2>
3272
3273 <dl>
3274 <dt><a name="index-glut_002dinit"></a><u>Function:</u> <b>glut-init</b><i> args</i></dt>
3275 </dl>
3276
3277 <dl>
3278 <dt><a name="index-glut_002dinit_002ddisplay_002dmode"></a><u>Function:</u> <b>glut-init-display-mode</b><i> mode</i></dt>
3279 </dl>
3280
3281 <dl>
3282 <dt><a name="index-GLUT_005fRGB"></a><u>Constant:</u> <b>GLUT_RGB</b></dt>
3283 <dt><a name="index-GLUT_005fRGBA"></a><u>Constant:</u> <b>GLUT_RGBA</b></dt>
3284 <dt><a name="index-GLUT_005fINDEX"></a><u>Constant:</u> <b>GLUT_INDEX</b></dt>
3285 <dt><a name="index-GLUT_005fSINGLE"></a><u>Constant:</u> <b>GLUT_SINGLE</b></dt>
3286 <dt><a name="index-GLUT_005fDOUBLE"></a><u>Constant:</u> <b>GLUT_DOUBLE</b></dt>
3287 <dt><a name="index-GLUT_005fACCUM"></a><u>Constant:</u> <b>GLUT_ACCUM</b></dt>
3288 <dt><a name="index-GLUT_005fALPHA"></a><u>Constant:</u> <b>GLUT_ALPHA</b></dt>
3289 <dt><a name="index-GLUT_005fDEPTH"></a><u>Constant:</u> <b>GLUT_DEPTH</b></dt>
3290 <dt><a name="index-GLUT_005fSTENCIL"></a><u>Constant:</u> <b>GLUT_STENCIL</b></dt>
3291 <dt><a name="index-GLUT_005fMULTISAMPLE"></a><u>Constant:</u> <b>GLUT_MULTISAMPLE</b></dt>
3292 <dt><a name="index-GLUT_005fSTEREO"></a><u>Constant:</u> <b>GLUT_STEREO</b></dt>
3293 <dt><a name="index-GLUT_005fLUMINANCE"></a><u>Constant:</u> <b>GLUT_LUMINANCE</b></dt>
3294 </dl>
3295
3296 <dl>
3297 <dt><a name="index-glut_002dinit_002ddisplay_002dstring"></a><u>Function:</u> <b>glut-init-display-string</b><i> string</i></dt>
3298 </dl>
3299
3300 <dl>
3301 <dt><a name="index-glut_002dinit_002dwindow_002dsize"></a><u>Function:</u> <b>glut-init-window-size</b><i> width height</i></dt>
3302 </dl>
3303
3304 <dl>
3305 <dt><a name="index-glut_002dinit_002dwindow_002dposition"></a><u>Function:</u> <b>glut-init-window-position</b><i> x y</i></dt>
3306 </dl>
3307
3308 <dl>
3309 <dt><a name="index-glut_002dmain_002dloop"></a><u>Function:</u> <b>glut-main-loop</b></dt>
3310 </dl>
3311
3312 <dl>
3313 <dt><a name="index-glut_002dcreate_002dwidnow"></a><u>Function:</u> <b>glut-create-widnow</b><i> name</i></dt>
3314 </dl>
3315
3316 <dl>
3317 <dt><a name="index-glut_002dcreate_002dsub_002dwindow"></a><u>Function:</u> <b>glut-create-sub-window</b><i> win x y width height</i></dt>
3318 </dl>
3319
3320 <dl>
3321 <dt><a name="index-glut_002ddestroy_002dwindow"></a><u>Function:</u> <b>glut-destroy-window</b><i> win</i></dt>
3322 </dl>
3323
3324 <dl>
3325 <dt><a name="index-glut_002dpost_002dredisplay"></a><u>Function:</u> <b>glut-post-redisplay</b></dt>
3326 </dl>
3327
3328 <dl>
3329 <dt><a name="index-glut_002dpost_002dwindow_002dredisplay"></a><u>Function:</u> <b>glut-post-window-redisplay</b><i> win</i></dt>
3330 </dl>
3331
3332 <dl>
3333 <dt><a name="index-glut_002dswap_002dbuffers"></a><u>Function:</u> <b>glut-swap-buffers</b></dt>
3334 </dl>
3335
3336 <dl>
3337 <dt><a name="index-glut_002dget_002dwindow"></a><u>Function:</u> <b>glut-get-window</b></dt>
3338 </dl>
3339
3340 <dl>
3341 <dt><a name="index-glut_002dset_002dwindow"></a><u>Function:</u> <b>glut-set-window</b><i> win</i></dt>
3342 </dl>
3343
3344 <dl>
3345 <dt><a name="index-glut_002dset_002dwindow_002dtitle"></a><u>Function:</u> <b>glut-set-window-title</b><i> title</i></dt>
3346 </dl>
3347
3348 <dl>
3349 <dt><a name="index-glut_002dset_002dicon_002dtitle"></a><u>Function:</u> <b>glut-set-icon-title</b><i> title</i></dt>
3350 </dl>
3351
3352 <dl>
3353 <dt><a name="index-glut_002dposition_002dwindow"></a><u>Function:</u> <b>glut-position-window</b><i> x y</i></dt>
3354 </dl>
3355
3356 <dl>
3357 <dt><a name="index-glut_002dreshape_002dwindow"></a><u>Function:</u> <b>glut-reshape-window</b><i> width height</i></dt>
3358 </dl>
3359
3360 <dl>
3361 <dt><a name="index-glut_002dpush_002dwindow"></a><u>Function:</u> <b>glut-push-window</b></dt>
3362 <dt><a name="index-glut_002dpop_002dwindow"></a><u>Function:</u> <b>glut-pop-window</b></dt>
3363 </dl>
3364
3365 <dl>
3366 <dt><a name="index-glut_002diconify_002dwindow"></a><u>Function:</u> <b>glut-iconify-window</b></dt>
3367 </dl>
3368
3369 <dl>
3370 <dt><a name="index-glut_002dshow_002dwindow"></a><u>Function:</u> <b>glut-show-window</b></dt>
3371 <dt><a name="index-glut_002dhide_002dwindow"></a><u>Function:</u> <b>glut-hide-window</b></dt>
3372 </dl>
3373
3374 <dl>
3375 <dt><a name="index-glut_002dfull_002dscreen"></a><u>Function:</u> <b>glut-full-screen</b></dt>
3376 </dl>
3377
3378 <dl>
3379 <dt><a name="index-glut_002dset_002dcursor"></a><u>Function:</u> <b>glut-set-cursor</b><i> cursor</i></dt>
3380 </dl>
3381
3382 <dl>
3383 <dt><a name="index-GLUT_005fCURSOR_005fRIGHT_005fARROW"></a><u>Constant:</u> <b>GLUT_CURSOR_RIGHT_ARROW</b></dt>
3384 <dt><a name="index-GLUT_005fCURSOR_005fLEFT_005fARROW"></a><u>Constant:</u> <b>GLUT_CURSOR_LEFT_ARROW</b></dt>
3385 <dt><a name="index-GLUT_005fCURSOR_005fINFO"></a><u>Constant:</u> <b>GLUT_CURSOR_INFO</b></dt>
3386 <dt><a name="index-GLUT_005fCURSOR_005fDESTROY"></a><u>Constant:</u> <b>GLUT_CURSOR_DESTROY</b></dt>
3387 <dt><a name="index-GLUT_005fCURSOR_005fHELP"></a><u>Constant:</u> <b>GLUT_CURSOR_HELP</b></dt>
3388 <dt><a name="index-GLUT_005fCURSOR_005fCYCLE"></a><u>Constant:</u> <b>GLUT_CURSOR_CYCLE</b></dt>
3389 <dt><a name="index-GLUT_005fCURSOR_005fSPRAY"></a><u>Constant:</u> <b>GLUT_CURSOR_SPRAY</b></dt>
3390 <dt><a name="index-GLUT_005fCURSOR_005fWAIT"></a><u>Constant:</u> <b>GLUT_CURSOR_WAIT</b></dt>
3391 <dt><a name="index-GLUT_005fCURSOR_005fTEXT"></a><u>Constant:</u> <b>GLUT_CURSOR_TEXT</b></dt>
3392 <dt><a name="index-GLUT_005fCURSOR_005fCROSSHAIR"></a><u>Constant:</u> <b>GLUT_CURSOR_CROSSHAIR</b></dt>
3393 <dt><a name="index-GLUT_005fCURSOR_005fUP_005fDOWN"></a><u>Constant:</u> <b>GLUT_CURSOR_UP_DOWN</b></dt>
3394 <dt><a name="index-GLUT_005fCURSOR_005fLEFT_005fRIGHT"></a><u>Constant:</u> <b>GLUT_CURSOR_LEFT_RIGHT</b></dt>
3395 <dt><a name="index-GLUT_005fCURSOR_005fTOP_005fSIDE"></a><u>Constant:</u> <b>GLUT_CURSOR_TOP_SIDE</b></dt>
3396 <dt><a name="index-GLUT_005fCURSOR_005fBOTTOM_005fSIDE"></a><u>Constant:</u> <b>GLUT_CURSOR_BOTTOM_SIDE</b></dt>
3397 <dt><a name="index-GLUT_005fCURSOR_005fLEFT_005fSIDE"></a><u>Constant:</u> <b>GLUT_CURSOR_LEFT_SIDE</b></dt>
3398 <dt><a name="index-GLUT_005fCURSOR_005fRIGHT_005fSIDE"></a><u>Constant:</u> <b>GLUT_CURSOR_RIGHT_SIDE</b></dt>
3399 <dt><a name="index-GLUT_005fCURSOR_005fTOP_005fLEFT_005fCORNER"></a><u>Constant:</u> <b>GLUT_CURSOR_TOP_LEFT_CORNER</b></dt>
3400 <dt><a name="index-GLUT_005fCURSOR_005fTOP_005fRIGHT_005fCORNER"></a><u>Constant:</u> <b>GLUT_CURSOR_TOP_RIGHT_CORNER</b></dt>
3401 <dt><a name="index-GLUT_005fCURSOR_005fBOTTOM_005fRIGHT_005fCORNER"></a><u>Constant:</u> <b>GLUT_CURSOR_BOTTOM_RIGHT_CORNER</b></dt>
3402 <dt><a name="index-GLUT_005fCURSOR_005fBOTTOM_005fLEFT_005fCORNER"></a><u>Constant:</u> <b>GLUT_CURSOR_BOTTOM_LEFT_CORNER</b></dt>
3403 <dt><a name="index-GLUT_005fCURSOR_005fINHERIT"></a><u>Constant:</u> <b>GLUT_CURSOR_INHERIT</b></dt>
3404 <dt><a name="index-GLUT_005fCURSOR_005fNONE"></a><u>Constant:</u> <b>GLUT_CURSOR_NONE</b></dt>
3405 <dt><a name="index-GLUT_005fCURSOR_005fFULL_005fCROSSHAIR"></a><u>Constant:</u> <b>GLUT_CURSOR_FULL_CROSSHAIR</b></dt>
3406 </dl>
3407
3408
3409 <dl>
3410 <dt><a name="index-glut_002dwarp_002dpointer"></a><u>Function:</u> <b>glut-warp-pointer</b><i> x y</i></dt>
3411 </dl>
3412
3413 <hr size="6">
3414 <a name="GLUT-overlay"></a>
3415 <table cellpadding="1" cellspacing="1" border="0">
3416 <tr><td valign="middle" align="left">[<a href="#GLUT-window-manipulation" title="Previous section in reading order"> &lt; </a>]</td>
3417 <td valign="middle" align="left">[<a href="#GLUT-menu-API" title="Next section in reading order"> &gt; </a>]</td>
3418 <td valign="middle" align="left"> &nbsp; </td>
3419 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3420 <td valign="middle" align="left">[<a href="#GLUT-API" title="Up section"> Up </a>]</td>
3421 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3422 <td valign="middle" align="left"> &nbsp; </td>
3423 <td valign="middle" align="left"> &nbsp; </td>
3424 <td valign="middle" align="left"> &nbsp; </td>
3425 <td valign="middle" align="left"> &nbsp; </td>
3426 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3427 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3428 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
3429 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3430 </tr></table>
3431 <a name="GLUT-overlay-1"></a>
3432 <h2 class="section">5.2 GLUT overlay</h2>
3433
3434 <dl>
3435 <dt><a name="index-glut_002destablish_002doverlay"></a><u>Function:</u> <b>glut-establish-overlay</b></dt>
3436 </dl>
3437
3438 <dl>
3439 <dt><a name="index-glut_002dremove_002doverlay"></a><u>Function:</u> <b>glut-remove-overlay</b></dt>
3440 </dl>
3441
3442 <dl>
3443 <dt><a name="index-glut_002duse_002dlayer"></a><u>Function:</u> <b>glut-use-layer</b><i> layer</i></dt>
3444 </dl>
3445
3446 <dl>
3447 <dt><a name="index-glut_002dpost_002doverlay_002dredisplay"></a><u>Function:</u> <b>glut-post-overlay-redisplay</b></dt>
3448 </dl>
3449
3450 <dl>
3451 <dt><a name="index-glut_002dpost_002dwindow_002doverlay_002dredisplay"></a><u>Function:</u> <b>glut-post-window-overlay-redisplay</b><i> win</i></dt>
3452 </dl>
3453
3454 <dl>
3455 <dt><a name="index-glut_002dshow_002doverlay"></a><u>Function:</u> <b>glut-show-overlay</b></dt>
3456 </dl>
3457
3458 <dl>
3459 <dt><a name="index-glut_002dhide_002doverlay"></a><u>Function:</u> <b>glut-hide-overlay</b></dt>
3460 </dl>
3461
3462 <hr size="6">
3463 <a name="GLUT-menu-API"></a>
3464 <table cellpadding="1" cellspacing="1" border="0">
3465 <tr><td valign="middle" align="left">[<a href="#GLUT-overlay" title="Previous section in reading order"> &lt; </a>]</td>
3466 <td valign="middle" align="left">[<a href="#GLUT-callbacks" title="Next section in reading order"> &gt; </a>]</td>
3467 <td valign="middle" align="left"> &nbsp; </td>
3468 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3469 <td valign="middle" align="left">[<a href="#GLUT-API" title="Up section"> Up </a>]</td>
3470 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3471 <td valign="middle" align="left"> &nbsp; </td>
3472 <td valign="middle" align="left"> &nbsp; </td>
3473 <td valign="middle" align="left"> &nbsp; </td>
3474 <td valign="middle" align="left"> &nbsp; </td>
3475 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3476 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3477 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
3478 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3479 </tr></table>
3480 <a name="GLUT-menu-API-1"></a>
3481 <h2 class="section">5.3 GLUT menu API</h2>
3482
3483 <dl>
3484 <dt><a name="index-glut_002dcreate_002dmenu"></a><u>Function:</u> <b>glut-create-menu</b><i> callback</i></dt>
3485 </dl>
3486
3487 <dl>
3488 <dt><a name="index-glut_002ddestroy_002dmenu"></a><u>Function:</u> <b>glut-destroy-menu</b><i> menu</i></dt>
3489 </dl>
3490
3491 <dl>
3492 <dt><a name="index-glut_002dget_002demnu"></a><u>Function:</u> <b>glut-get-emnu</b></dt>
3493 </dl>
3494
3495 <dl>
3496 <dt><a name="index-glut_002dset_002dmenu"></a><u>Function:</u> <b>glut-set-menu</b><i> menu</i></dt>
3497 </dl>
3498
3499 <dl>
3500 <dt><a name="index-glut_002dadd_002dmenu_002dentry"></a><u>Function:</u> <b>glut-add-menu-entry</b><i> label value</i></dt>
3501 </dl>
3502
3503 <dl>
3504 <dt><a name="index-glut_002dadd_002dsub_002dmenu"></a><u>Function:</u> <b>glut-add-sub-menu</b><i> label submenu</i></dt>
3505 </dl>
3506
3507 <dl>
3508 <dt><a name="index-glut_002dchange_002dto_002dmenu_002dentry"></a><u>Function:</u> <b>glut-change-to-menu-entry</b><i> item label value</i></dt>
3509 </dl>
3510
3511 <dl>
3512 <dt><a name="index-glut_002dchange_002dto_002dsub_002dmenu"></a><u>Function:</u> <b>glut-change-to-sub-menu</b><i> item label submenu</i></dt>
3513 </dl>
3514
3515 <dl>
3516 <dt><a name="index-glut_002dremove_002dmenu_002ditem"></a><u>Function:</u> <b>glut-remove-menu-item</b><i> item</i></dt>
3517 </dl>
3518
3519 <dl>
3520 <dt><a name="index-gult_002dattach_002dmenu"></a><u>Function:</u> <b>gult-attach-menu</b><i> button</i></dt>
3521 </dl>
3522
3523 <dl>
3524 <dt><a name="index-glut_002ddetach_002dmenu"></a><u>Function:</u> <b>glut-detach-menu</b><i> button</i></dt>
3525 </dl>
3526
3527 <hr size="6">
3528 <a name="GLUT-callbacks"></a>
3529 <table cellpadding="1" cellspacing="1" border="0">
3530 <tr><td valign="middle" align="left">[<a href="#GLUT-menu-API" title="Previous section in reading order"> &lt; </a>]</td>
3531 <td valign="middle" align="left">[<a href="#GLUT-colormap" title="Next section in reading order"> &gt; </a>]</td>
3532 <td valign="middle" align="left"> &nbsp; </td>
3533 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3534 <td valign="middle" align="left">[<a href="#GLUT-API" title="Up section"> Up </a>]</td>
3535 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3536 <td valign="middle" align="left"> &nbsp; </td>
3537 <td valign="middle" align="left"> &nbsp; </td>
3538 <td valign="middle" align="left"> &nbsp; </td>
3539 <td valign="middle" align="left"> &nbsp; </td>
3540 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3541 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3542 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
3543 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3544 </tr></table>
3545 <a name="GLUT-callbacks-1"></a>
3546 <h2 class="section">5.4 GLUT callbacks</h2>
3547
3548 <dl>
3549 <dt><a name="index-glut_002ddisplay_002dfunc"></a><u>Function:</u> <b>glut-display-func</b><i> fn</i></dt>
3550 </dl>
3551
3552 <dl>
3553 <dt><a name="index-glut_002dreshape_002dfunc"></a><u>Function:</u> <b>glut-reshape-func</b><i> fn</i></dt>
3554 </dl>
3555
3556 <dl>
3557 <dt><a name="index-glut_002dkeyboard_002dfunc"></a><u>Function:</u> <b>glut-keyboard-func</b><i> fn</i></dt>
3558 </dl>
3559
3560 <dl>
3561 <dt><a name="index-GLUT_005fKEY_005fF1"></a><u>Constant:</u> <b>GLUT_KEY_F1</b></dt>
3562 <dt><a name="index-GLUT_005fKEY_005fF2"></a><u>Constant:</u> <b>GLUT_KEY_F2</b></dt>
3563 <dt><a name="index-GLUT_005fKEY_005fF3"></a><u>Constant:</u> <b>GLUT_KEY_F3</b></dt>
3564 <dt><a name="index-GLUT_005fKEY_005fF4"></a><u>Constant:</u> <b>GLUT_KEY_F4</b></dt>
3565 <dt><a name="index-GLUT_005fKEY_005fF5"></a><u>Constant:</u> <b>GLUT_KEY_F5</b></dt>
3566 <dt><a name="index-GLUT_005fKEY_005fF6"></a><u>Constant:</u> <b>GLUT_KEY_F6</b></dt>
3567 <dt><a name="index-GLUT_005fKEY_005fF7"></a><u>Constant:</u> <b>GLUT_KEY_F7</b></dt>
3568 <dt><a name="index-GLUT_005fKEY_005fF8"></a><u>Constant:</u> <b>GLUT_KEY_F8</b></dt>
3569 <dt><a name="index-GLUT_005fKEY_005fF9"></a><u>Constant:</u> <b>GLUT_KEY_F9</b></dt>
3570 <dt><a name="index-GLUT_005fKEY_005fF10"></a><u>Constant:</u> <b>GLUT_KEY_F10</b></dt>
3571 <dt><a name="index-GLUT_005fKEY_005fF11"></a><u>Constant:</u> <b>GLUT_KEY_F11</b></dt>
3572 <dt><a name="index-GLUT_005fKEY_005fF12"></a><u>Constant:</u> <b>GLUT_KEY_F12</b></dt>
3573 <dt><a name="index-GLUT_005fKEY_005fLEFT"></a><u>Constant:</u> <b>GLUT_KEY_LEFT</b></dt>
3574 <dt><a name="index-GLUT_005fKEY_005fUP"></a><u>Constant:</u> <b>GLUT_KEY_UP</b></dt>
3575 <dt><a name="index-GLUT_005fKEY_005fRIGHT"></a><u>Constant:</u> <b>GLUT_KEY_RIGHT</b></dt>
3576 <dt><a name="index-GLUT_005fKEY_005fDOWN"></a><u>Constant:</u> <b>GLUT_KEY_DOWN</b></dt>
3577 <dt><a name="index-GLUT_005fKEY_005fPAGE_005fUP"></a><u>Constant:</u> <b>GLUT_KEY_PAGE_UP</b></dt>
3578 <dt><a name="index-GLUT_005fKEY_005fPAGE_005fDOWN"></a><u>Constant:</u> <b>GLUT_KEY_PAGE_DOWN</b></dt>
3579 <dt><a name="index-GLUT_005fKEY_005fHOME"></a><u>Constant:</u> <b>GLUT_KEY_HOME</b></dt>
3580 <dt><a name="index-GLUT_005fKEY_005fEND"></a><u>Constant:</u> <b>GLUT_KEY_END</b></dt>
3581 <dt><a name="index-GLUT_005fKEY_005fINSERT"></a><u>Constant:</u> <b>GLUT_KEY_INSERT</b></dt>
3582 </dl>
3583
3584
3585 <dl>
3586 <dt><a name="index-glut_002dmouse_002dfunc"></a><u>Function:</u> <b>glut-mouse-func</b><i> fn</i></dt>
3587 </dl>
3588
3589 <dl>
3590 <dt><a name="index-GLUT_005fLEFT_005fBUTTON"></a><u>Constant:</u> <b>GLUT_LEFT_BUTTON</b></dt>
3591 <dt><a name="index-GLUT_005fMIDDLE_005fBUTTON"></a><u>Constant:</u> <b>GLUT_MIDDLE_BUTTON</b></dt>
3592 <dt><a name="index-GLUT_005fRIGHT_005fBUTTON"></a><u>Constant:</u> <b>GLUT_RIGHT_BUTTON</b></dt>
3593 <dt><a name="index-GLUT_005fDOWN"></a><u>Constant:</u> <b>GLUT_DOWN</b></dt>
3594 <dt><a name="index-GLUT_005fUP"></a><u>Constant:</u> <b>GLUT_UP</b></dt>
3595 </dl>
3596
3597 <dl>
3598 <dt><a name="index-glut_002dmotion_002dfunc"></a><u>Function:</u> <b>glut-motion-func</b><i> fn</i></dt>
3599 </dl>
3600
3601 <dl>
3602 <dt><a name="index-glut_002dpassive_002dmotion_002dfunc"></a><u>Function:</u> <b>glut-passive-motion-func</b><i> fn</i></dt>
3603 </dl>
3604
3605 <dl>
3606 <dt><a name="index-glut_002dentry_002dfunc"></a><u>Function:</u> <b>glut-entry-func</b><i> fn</i></dt>
3607 </dl>
3608
3609 <dl>
3610 <dt><a name="index-GLUT_005fLEFT"></a><u>Constant:</u> <b>GLUT_LEFT</b></dt>
3611 <dt><a name="index-GLUT_005fENTERED"></a><u>Constant:</u> <b>GLUT_ENTERED</b></dt>
3612 </dl>
3613
3614 <dl>
3615 <dt><a name="index-glut_002dvisibility_002dfunc"></a><u>Function:</u> <b>glut-visibility-func</b><i> fn</i></dt>
3616 </dl>
3617
3618 <dl>
3619 <dt><a name="index-GLUT_005fNOT_005fVISIBLE"></a><u>Constant:</u> <b>GLUT_NOT_VISIBLE</b></dt>
3620 <dt><a name="index-GLUT_005fVISIBLE"></a><u>Constant:</u> <b>GLUT_VISIBLE</b></dt>
3621 </dl>
3622
3623 <dl>
3624 <dt><a name="index-glut_002didle_002dfunc"></a><u>Function:</u> <b>glut-idle-func</b><i> fn</i></dt>
3625 </dl>
3626
3627 <dl>
3628 <dt><a name="index-glut_002dtimer_002dfunc"></a><u>Function:</u> <b>glut-timer-func</b><i> millis fn value</i></dt>
3629 </dl>
3630
3631 <dl>
3632 <dt><a name="index-glut_002dmenu_002dstate_002dfunc"></a><u>Function:</u> <b>glut-menu-state-func</b><i> fn</i></dt>
3633 </dl>
3634
3635 <dl>
3636 <dt><a name="index-glut_002dspecial_002dfunc"></a><u>Function:</u> <b>glut-special-func</b><i> fn</i></dt>
3637 </dl>
3638
3639 <dl>
3640 <dt><a name="index-glut_002dspaceball_002dmotion_002dfunc"></a><u>Function:</u> <b>glut-spaceball-motion-func</b><i> fn</i></dt>
3641 </dl>
3642
3643 <dl>
3644 <dt><a name="index-glut_002dspaceball_002drotate_002dfunc"></a><u>Function:</u> <b>glut-spaceball-rotate-func</b><i> fn</i></dt>
3645 </dl>
3646
3647 <dl>
3648 <dt><a name="index-glut_002dspaceball_002dbutton_002dfunc"></a><u>Function:</u> <b>glut-spaceball-button-func</b><i> fn</i></dt>
3649 </dl>
3650
3651 <dl>
3652 <dt><a name="index-glut_002dbutton_002dbox_002dfunc"></a><u>Function:</u> <b>glut-button-box-func</b><i> fn</i></dt>
3653 </dl>
3654
3655 <dl>
3656 <dt><a name="index-glut_002ddials_002dfunc"></a><u>Function:</u> <b>glut-dials-func</b><i> fn</i></dt>
3657 </dl>
3658
3659 <dl>
3660 <dt><a name="index-glut_002dtablet_002dmotion_002dfunc"></a><u>Function:</u> <b>glut-tablet-motion-func</b><i> fn</i></dt>
3661 </dl>
3662
3663 <dl>
3664 <dt><a name="index-glut_002dtablet_002dbutton_002dfunc"></a><u>Function:</u> <b>glut-tablet-button-func</b><i> fn</i></dt>
3665 </dl>
3666
3667 <dl>
3668 <dt><a name="index-glut_002dmenu_002dstatus_002dfunc"></a><u>Function:</u> <b>glut-menu-status-func</b><i> fn</i></dt>
3669 </dl>
3670
3671 <dl>
3672 <dt><a name="index-glut_002doverlay_002ddislay_002dfunc"></a><u>Function:</u> <b>glut-overlay-dislay-func</b><i> fn</i></dt>
3673 </dl>
3674
3675 <dl>
3676 <dt><a name="index-glut_002dwindow_002dstatus_002dfunc"></a><u>Function:</u> <b>glut-window-status-func</b><i> fn</i></dt>
3677 </dl>
3678
3679 <dl>
3680 <dt><a name="index-glut_002dkeyboard_002dup_002dfunc"></a><u>Function:</u> <b>glut-keyboard-up-func</b><i> fn</i></dt>
3681 </dl>
3682
3683 <dl>
3684 <dt><a name="index-glut_002dspecial_002dup_002dfunc"></a><u>Function:</u> <b>glut-special-up-func</b><i> fn</i></dt>
3685 </dl>
3686
3687 <dl>
3688 <dt><a name="index-glut_002djoystick_002dfunc"></a><u>Function:</u> <b>glut-joystick-func</b><i> fn interval</i></dt>
3689 </dl>
3690
3691 <hr size="6">
3692 <a name="GLUT-colormap"></a>
3693 <table cellpadding="1" cellspacing="1" border="0">
3694 <tr><td valign="middle" align="left">[<a href="#GLUT-callbacks" title="Previous section in reading order"> &lt; </a>]</td>
3695 <td valign="middle" align="left">[<a href="#GLUT-state-retrieval" title="Next section in reading order"> &gt; </a>]</td>
3696 <td valign="middle" align="left"> &nbsp; </td>
3697 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3698 <td valign="middle" align="left">[<a href="#GLUT-API" title="Up section"> Up </a>]</td>
3699 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3700 <td valign="middle" align="left"> &nbsp; </td>
3701 <td valign="middle" align="left"> &nbsp; </td>
3702 <td valign="middle" align="left"> &nbsp; </td>
3703 <td valign="middle" align="left"> &nbsp; </td>
3704 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3705 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3706 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
3707 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3708 </tr></table>
3709 <a name="GLUT-colormap-1"></a>
3710 <h2 class="section">5.5 GLUT colormap</h2>
3711
3712 <dl>
3713 <dt><a name="index-glut_002dset_002dcolor"></a><u>Function:</u> <b>glut-set-color</b><i> index r g b</i></dt>
3714 </dl>
3715
3716 <dl>
3717 <dt><a name="index-glut_002dget_002dcolor"></a><u>Function:</u> <b>glut-get-color</b><i> index component</i></dt>
3718 </dl>
3719
3720 <dl>
3721 <dt><a name="index-GLUT_005fRED"></a><u>Constant:</u> <b>GLUT_RED</b></dt>
3722 <dt><a name="index-GLUT_005fGREEN"></a><u>Constant:</u> <b>GLUT_GREEN</b></dt>
3723 <dt><a name="index-GLUT_005fBLUE"></a><u>Constant:</u> <b>GLUT_BLUE</b></dt>
3724 </dl>
3725
3726 <dl>
3727 <dt><a name="index-glut_002dcopy_002dcolormap"></a><u>Function:</u> <b>glut-copy-colormap</b><i> win</i></dt>
3728 </dl>
3729
3730 <hr size="6">
3731 <a name="GLUT-state-retrieval"></a>
3732 <table cellpadding="1" cellspacing="1" border="0">
3733 <tr><td valign="middle" align="left">[<a href="#GLUT-colormap" title="Previous section in reading order"> &lt; </a>]</td>
3734 <td valign="middle" align="left">[<a href="#GLUT-font" title="Next section in reading order"> &gt; </a>]</td>
3735 <td valign="middle" align="left"> &nbsp; </td>
3736 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3737 <td valign="middle" align="left">[<a href="#GLUT-API" title="Up section"> Up </a>]</td>
3738 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3739 <td valign="middle" align="left"> &nbsp; </td>
3740 <td valign="middle" align="left"> &nbsp; </td>
3741 <td valign="middle" align="left"> &nbsp; </td>
3742 <td valign="middle" align="left"> &nbsp; </td>
3743 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3744 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3745 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
3746 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3747 </tr></table>
3748 <a name="GLUT-state-retrieval-1"></a>
3749 <h2 class="section">5.6 GLUT state retrieval</h2>
3750
3751 <dl>
3752 <dt><a name="index-glut_002dget"></a><u>Function:</u> <b>glut-get</b><i> type</i></dt>
3753 </dl>
3754
3755 <dl>
3756 <dt><a name="index-GLUT_005fWINDOW_005fX"></a><u>Constant:</u> <b>GLUT_WINDOW_X</b></dt>
3757 <dt><a name="index-GLUT_005fWINDOW_005fY"></a><u>Constant:</u> <b>GLUT_WINDOW_Y</b></dt>
3758 <dt><a name="index-GLUT_005fWINDOW_005fWIDTH"></a><u>Constant:</u> <b>GLUT_WINDOW_WIDTH</b></dt>
3759 <dt><a name="index-GLUT_005fWINDOW_005fHEIGHT"></a><u>Constant:</u> <b>GLUT_WINDOW_HEIGHT</b></dt>
3760 <dt><a name="index-GLUT_005fWINDOW_005fBUFFER_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_BUFFER_SIZE</b></dt>
3761 <dt><a name="index-GLUT_005fWINDOW_005fSTENCIL_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_STENCIL_SIZE</b></dt>
3762 <dt><a name="index-GLUT_005fWINDOW_005fDEPTH_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_DEPTH_SIZE</b></dt>
3763 <dt><a name="index-GLUT_005fWINDOW_005fRED_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_RED_SIZE</b></dt>
3764 <dt><a name="index-GLUT_005fWINDOW_005fGREEN_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_GREEN_SIZE</b></dt>
3765 <dt><a name="index-GLUT_005fWINDOW_005fBLUE_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_BLUE_SIZE</b></dt>
3766 <dt><a name="index-GLUT_005fWINDOW_005fALPHA_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_ALPHA_SIZE</b></dt>
3767 <dt><a name="index-GLUT_005fWINDOW_005fACCUM_005fRED_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_ACCUM_RED_SIZE</b></dt>
3768 <dt><a name="index-GLUT_005fWINDOW_005fACCUM_005fGREEN_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_ACCUM_GREEN_SIZE</b></dt>
3769 <dt><a name="index-GLUT_005fWINDOW_005fACCUM_005fBLUE_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_ACCUM_BLUE_SIZE</b></dt>
3770 <dt><a name="index-GLUT_005fWINDOW_005fACCUM_005fALPHA_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_ACCUM_ALPHA_SIZE</b></dt>
3771 <dt><a name="index-GLUT_005fWINDOW_005fDOUBLEBUFFER"></a><u>Constant:</u> <b>GLUT_WINDOW_DOUBLEBUFFER</b></dt>
3772 <dt><a name="index-GLUT_005fWINDOW_005fRGBA"></a><u>Constant:</u> <b>GLUT_WINDOW_RGBA</b></dt>
3773 <dt><a name="index-GLUT_005fWINDOW_005fPARENT"></a><u>Constant:</u> <b>GLUT_WINDOW_PARENT</b></dt>
3774 <dt><a name="index-GLUT_005fWINDOW_005fNUM_005fCHILDREN"></a><u>Constant:</u> <b>GLUT_WINDOW_NUM_CHILDREN</b></dt>
3775 <dt><a name="index-GLUT_005fWINDOW_005fCOLORMAP_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_COLORMAP_SIZE</b></dt>
3776 <dt><a name="index-GLUT_005fWINDOW_005fNUM_005fSAMPLES"></a><u>Constant:</u> <b>GLUT_WINDOW_NUM_SAMPLES</b></dt>
3777 <dt><a name="index-GLUT_005fWINDOW_005fSTEREO"></a><u>Constant:</u> <b>GLUT_WINDOW_STEREO</b></dt>
3778 <dt><a name="index-GLUT_005fWINDOW_005fCURSOR"></a><u>Constant:</u> <b>GLUT_WINDOW_CURSOR</b></dt>
3779 <dt><a name="index-GLUT_005fSCREEN_005fWIDTH"></a><u>Constant:</u> <b>GLUT_SCREEN_WIDTH</b></dt>
3780 <dt><a name="index-GLUT_005fSCREEN_005fHEIGHT"></a><u>Constant:</u> <b>GLUT_SCREEN_HEIGHT</b></dt>
3781 <dt><a name="index-GLUT_005fSCREEN_005fWIDTH_005fMM"></a><u>Constant:</u> <b>GLUT_SCREEN_WIDTH_MM</b></dt>
3782 <dt><a name="index-GLUT_005fSCREEN_005fHEIGHT_005fMM"></a><u>Constant:</u> <b>GLUT_SCREEN_HEIGHT_MM</b></dt>
3783 <dt><a name="index-GLUT_005fMENU_005fNUM_005fITEMS"></a><u>Constant:</u> <b>GLUT_MENU_NUM_ITEMS</b></dt>
3784 <dt><a name="index-GLUT_005fDISPLAY_005fMODE_005fPOSSIBLE"></a><u>Constant:</u> <b>GLUT_DISPLAY_MODE_POSSIBLE</b></dt>
3785 <dt><a name="index-GLUT_005fINIT_005fWINDOW_005fX"></a><u>Constant:</u> <b>GLUT_INIT_WINDOW_X</b></dt>
3786 <dt><a name="index-GLUT_005fINIT_005fWINDOW_005fY"></a><u>Constant:</u> <b>GLUT_INIT_WINDOW_Y</b></dt>
3787 <dt><a name="index-GLUT_005fINIT_005fWINDOW_005fWIDTH"></a><u>Constant:</u> <b>GLUT_INIT_WINDOW_WIDTH</b></dt>
3788 <dt><a name="index-GLUT_005fINIT_005fWINDOW_005fHEIGHT"></a><u>Constant:</u> <b>GLUT_INIT_WINDOW_HEIGHT</b></dt>
3789 <dt><a name="index-GLUT_005fINIT_005fDISPLAY_005fMODE"></a><u>Constant:</u> <b>GLUT_INIT_DISPLAY_MODE</b></dt>
3790 <dt><a name="index-GLUT_005fELAPSED_005fTIME"></a><u>Constant:</u> <b>GLUT_ELAPSED_TIME</b></dt>
3791 <dt><a name="index-GLUT_005fWINDOW_005fFORMAT_005fID"></a><u>Constant:</u> <b>GLUT_WINDOW_FORMAT_ID</b></dt>
3792 </dl>
3793
3794 <dl>
3795 <dt><a name="index-glut_002ddevice_002dget"></a><u>Function:</u> <b>glut-device-get</b><i> type</i></dt>
3796 </dl>
3797
3798 <dl>
3799 <dt><a name="index-GLUT_005fHAS_005fKEYBOARD"></a><u>Constant:</u> <b>GLUT_HAS_KEYBOARD</b></dt>
3800 <dt><a name="index-GLUT_005fHAS_005fMOUSE"></a><u>Constant:</u> <b>GLUT_HAS_MOUSE</b></dt>
3801 <dt><a name="index-GLUT_005fHAS_005fSPACEBALL"></a><u>Constant:</u> <b>GLUT_HAS_SPACEBALL</b></dt>
3802 <dt><a name="index-GLUT_005fHAS_005fDIAL_005fAND_005fBUTTON_005fBOX"></a><u>Constant:</u> <b>GLUT_HAS_DIAL_AND_BUTTON_BOX</b></dt>
3803 <dt><a name="index-GLUT_005fHAS_005fTABLET"></a><u>Constant:</u> <b>GLUT_HAS_TABLET</b></dt>
3804 <dt><a name="index-GLUT_005fNUM_005fMOUSE_005fBUTTONS"></a><u>Constant:</u> <b>GLUT_NUM_MOUSE_BUTTONS</b></dt>
3805 <dt><a name="index-GLUT_005fNUM_005fSPACEBALL_005fBUTTONS"></a><u>Constant:</u> <b>GLUT_NUM_SPACEBALL_BUTTONS</b></dt>
3806 <dt><a name="index-GLUT_005fNUM_005fBUTTON_005fBOX_005fBUTTONS"></a><u>Constant:</u> <b>GLUT_NUM_BUTTON_BOX_BUTTONS</b></dt>
3807 <dt><a name="index-GLUT_005fNUM_005fDIALS"></a><u>Constant:</u> <b>GLUT_NUM_DIALS</b></dt>
3808 <dt><a name="index-GLUT_005fNUM_005fTABLET_005fBUTTONS"></a><u>Constant:</u> <b>GLUT_NUM_TABLET_BUTTONS</b></dt>
3809 <dt><a name="index-GLUT_005fDEVICE_005fIGNORE_005fKEY_005fREPEAT"></a><u>Constant:</u> <b>GLUT_DEVICE_IGNORE_KEY_REPEAT</b></dt>
3810 <dt><a name="index-GLUT_005fDEVICE_005fKEY_005fREPEAT"></a><u>Constant:</u> <b>GLUT_DEVICE_KEY_REPEAT</b></dt>
3811 <dt><a name="index-GLUT_005fHAS_005fJOYSTICK"></a><u>Constant:</u> <b>GLUT_HAS_JOYSTICK</b></dt>
3812 <dt><a name="index-GLUT_005fOWNS_005fJOYSTICK"></a><u>Constant:</u> <b>GLUT_OWNS_JOYSTICK</b></dt>
3813 <dt><a name="index-GLUT_005fJOYSTICK_005fBUTTONS"></a><u>Constant:</u> <b>GLUT_JOYSTICK_BUTTONS</b></dt>
3814 <dt><a name="index-GLUT_005fJOYSTICK_005fAXES"></a><u>Constant:</u> <b>GLUT_JOYSTICK_AXES</b></dt>
3815 <dt><a name="index-GLUT_005fJOYSTICK_005fPOLL_005fRATE"></a><u>Constant:</u> <b>GLUT_JOYSTICK_POLL_RATE</b></dt>
3816 </dl>
3817
3818 <dl>
3819 <dt><a name="index-glut_002dextension_002dsupported"></a><u>Function:</u> <b>glut-extension-supported</b><i> name</i></dt>
3820 </dl>
3821
3822 <dl>
3823 <dt><a name="index-glut_002dget_002dmodifiers"></a><u>Function:</u> <b>glut-get-modifiers</b></dt>
3824 </dl>
3825
3826 <dl>
3827 <dt><a name="index-GLUT_005fACTIVE_005fSHIFT"></a><u>Constant:</u> <b>GLUT_ACTIVE_SHIFT</b></dt>
3828 <dt><a name="index-GLUT_005fACTIVE_005fCTRL"></a><u>Constant:</u> <b>GLUT_ACTIVE_CTRL</b></dt>
3829 <dt><a name="index-GLUT_005fACTIVE_005fALT"></a><u>Constant:</u> <b>GLUT_ACTIVE_ALT</b></dt>
3830 </dl>
3831
3832 <dl>
3833 <dt><a name="index-glut_002dlayer_002dget"></a><u>Function:</u> <b>glut-layer-get</b><i> type</i></dt>
3834 </dl>
3835
3836 <dl>
3837 <dt><a name="index-GLUT_005fOVERLAY_005fPOSSIBLE"></a><u>Constant:</u> <b>GLUT_OVERLAY_POSSIBLE</b></dt>
3838 <dt><a name="index-GLUT_005fLAYER_005fIN_005fUSE"></a><u>Constant:</u> <b>GLUT_LAYER_IN_USE</b></dt>
3839 <dt><a name="index-GLUT_005fHAS_005fOVERLAY"></a><u>Constant:</u> <b>GLUT_HAS_OVERLAY</b></dt>
3840 <dt><a name="index-GLUT_005fTRANSPARENT_005fINDEX"></a><u>Constant:</u> <b>GLUT_TRANSPARENT_INDEX</b></dt>
3841 <dt><a name="index-GLUT_005fNORMAL_005fDAMAGED"></a><u>Constant:</u> <b>GLUT_NORMAL_DAMAGED</b></dt>
3842 <dt><a name="index-GLUT_005fOVERLAY_005fDAMAGED"></a><u>Constant:</u> <b>GLUT_OVERLAY_DAMAGED</b></dt>
3843 </dl>
3844
3845 <hr size="6">
3846 <a name="GLUT-font"></a>
3847 <table cellpadding="1" cellspacing="1" border="0">
3848 <tr><td valign="middle" align="left">[<a href="#GLUT-state-retrieval" title="Previous section in reading order"> &lt; </a>]</td>
3849 <td valign="middle" align="left">[<a href="#GLUT-pre_002dbuilt-models" title="Next section in reading order"> &gt; </a>]</td>
3850 <td valign="middle" align="left"> &nbsp; </td>
3851 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3852 <td valign="middle" align="left">[<a href="#GLUT-API" title="Up section"> Up </a>]</td>
3853 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3854 <td valign="middle" align="left"> &nbsp; </td>
3855 <td valign="middle" align="left"> &nbsp; </td>
3856 <td valign="middle" align="left"> &nbsp; </td>
3857 <td valign="middle" align="left"> &nbsp; </td>
3858 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3859 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3860 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
3861 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3862 </tr></table>
3863 <a name="GLUT-font-1"></a>
3864 <h2 class="section">5.7 GLUT font</h2>
3865
3866 <dl>
3867 <dt><a name="index-_003cglut_002dfont_003e"></a><u>Class:</u> <b>&lt;glut-font&gt;</b></dt>
3868 <dd><a name="index-glut_002dfont"></a>
3869 </dd></dl>
3870
3871 <dl>
3872 <dt><a name="index-glut_002dbitmap_002dcharacter"></a><u>Function:</u> <b>glut-bitmap-character</b><i> font character</i></dt>
3873 </dl>
3874
3875 <dl>
3876 <dt><a name="index-glut_002dbitmap_002dwidth"></a><u>Function:</u> <b>glut-bitmap-width</b><i> font character</i></dt>
3877 </dl>
3878
3879 <dl>
3880 <dt><a name="index-glut_002dstroke_002dcharacter"></a><u>Function:</u> <b>glut-stroke-character</b><i> font character</i></dt>
3881 </dl>
3882
3883 <dl>
3884 <dt><a name="index-glut_002dstroke_002dwidth"></a><u>Function:</u> <b>glut-stroke-width</b><i> font character</i></dt>
3885 </dl>
3886
3887 <dl>
3888 <dt><a name="index-glut_002dbitmap_002dlength"></a><u>Function:</u> <b>glut-bitmap-length</b><i> font string</i></dt>
3889 </dl>
3890
3891 <dl>
3892 <dt><a name="index-glut_002dstroke_002dlength"></a><u>Function:</u> <b>glut-stroke-length</b><i> font string</i></dt>
3893 </dl>
3894
3895 <hr size="6">
3896 <a name="GLUT-pre_002dbuilt-models"></a>
3897 <table cellpadding="1" cellspacing="1" border="0">
3898 <tr><td valign="middle" align="left">[<a href="#GLUT-font" title="Previous section in reading order"> &lt; </a>]</td>
3899 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next section in reading order"> &gt; </a>]</td>
3900 <td valign="middle" align="left"> &nbsp; </td>
3901 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3902 <td valign="middle" align="left">[<a href="#GLUT-API" title="Up section"> Up </a>]</td>
3903 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3904 <td valign="middle" align="left"> &nbsp; </td>
3905 <td valign="middle" align="left"> &nbsp; </td>
3906 <td valign="middle" align="left"> &nbsp; </td>
3907 <td valign="middle" align="left"> &nbsp; </td>
3908 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3909 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3910 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
3911 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3912 </tr></table>
3913 <a name="GLUT-pre_002dbuilt-models-1"></a>
3914 <h2 class="section">5.8 GLUT pre-built models</h2>
3915
3916 <dl>
3917 <dt><a name="index-glut_002dwire_002dsphere"></a><u>Function:</u> <b>glut-wire-sphere</b><i> radius slices stacks</i></dt>
3918 <dt><a name="index-glut_002dsolid_002dsphere"></a><u>Function:</u> <b>glut-solid-sphere</b><i> radius slices stacks</i></dt>
3919 </dl>
3920
3921 <dl>
3922 <dt><a name="index-glut_002dwire_002dcone"></a><u>Function:</u> <b>glut-wire-cone</b><i> radius height slices stacks</i></dt>
3923 <dt><a name="index-glut_002dsolid_002dcone"></a><u>Function:</u> <b>glut-solid-cone</b><i> radius height slices stacks</i></dt>
3924 </dl>
3925
3926 <dl>
3927 <dt><a name="index-glut_002dwire_002dcube"></a><u>Function:</u> <b>glut-wire-cube</b><i> size</i></dt>
3928 <dt><a name="index-glut_002dsolid_002dcube"></a><u>Function:</u> <b>glut-solid-cube</b><i> size</i></dt>
3929 </dl>
3930
3931 <dl>
3932 <dt><a name="index-glut_002dwire_002dtorus"></a><u>Function:</u> <b>glut-wire-torus</b><i> inner outer sides rings</i></dt>
3933 <dt><a name="index-glut_002dsolid_002dtorus"></a><u>Function:</u> <b>glut-solid-torus</b><i> inner outer sides rings</i></dt>
3934 </dl>
3935
3936 <dl>
3937 <dt><a name="index-glut_002dwire_002ddodecahedron"></a><u>Function:</u> <b>glut-wire-dodecahedron</b></dt>
3938 <dt><a name="index-glut_002dsolid_002ddodecahedron"></a><u>Function:</u> <b>glut-solid-dodecahedron</b></dt>
3939 </dl>
3940
3941 <dl>
3942 <dt><a name="index-glut_002dwire_002dteapot"></a><u>Function:</u> <b>glut-wire-teapot</b><i> size</i></dt>
3943 <dt><a name="index-glut_002dsoild_002dteapot"></a><u>Function:</u> <b>glut-soild-teapot</b><i> size</i></dt>
3944 </dl>
3945
3946 <dl>
3947 <dt><a name="index-glut_002dwire_002doctahedron"></a><u>Function:</u> <b>glut-wire-octahedron</b></dt>
3948 <dt><a name="index-glut_002dsolid_002doctahedron"></a><u>Function:</u> <b>glut-solid-octahedron</b></dt>
3949 </dl>
3950
3951 <dl>
3952 <dt><a name="index-glut_002dwire_002dtetrahedron"></a><u>Function:</u> <b>glut-wire-tetrahedron</b></dt>
3953 <dt><a name="index-glut_002dsolid_002dtetrahedron"></a><u>Function:</u> <b>glut-solid-tetrahedron</b></dt>
3954 </dl>
3955
3956 <dl>
3957 <dt><a name="index-glut_002dwire_002dicosahedron"></a><u>Function:</u> <b>glut-wire-icosahedron</b></dt>
3958 <dt><a name="index-glut_002dsolid_002dicosahedron"></a><u>Function:</u> <b>glut-solid-icosahedron</b></dt>
3959 </dl>
3960
3961
3962 <hr size="6">
3963 <a name="Vectors-and-matrices"></a>
3964 <table cellpadding="1" cellspacing="1" border="0">
3965 <tr><td valign="middle" align="left">[<a href="#GLUT-pre_002dbuilt-models" title="Previous section in reading order"> &lt; </a>]</td>
3966 <td valign="middle" align="left">[<a href="#Vectors-and-points" title="Next section in reading order"> &gt; </a>]</td>
3967 <td valign="middle" align="left"> &nbsp; </td>
3968 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3969 <td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
3970 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Next chapter"> &gt;&gt; </a>]</td>
3971 <td valign="middle" align="left"> &nbsp; </td>
3972 <td valign="middle" align="left"> &nbsp; </td>
3973 <td valign="middle" align="left"> &nbsp; </td>
3974 <td valign="middle" align="left"> &nbsp; </td>
3975 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3976 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3977 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
3978 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3979 </tr></table>
3980 <a name="Vectors-and-matrices-1"></a>
3981 <h1 class="chapter">6. Vectors and matrices</h1>
3982
3983 <dl>
3984 <dt><a name="index-gl_002emath3d"></a><u>Module:</u> <b>gl.math3d</b></dt>
3985 <dd><a name="index-gl_002emath3d-1"></a>
3986 <p>The module provides vector and matrix operations useful for
3987 3D computer graphics.
3988 </p>
3989 <p>Actually this module itself doesn&rsquo;t depend on GL; you can use
3990 this module alone to do matrix calculations. However, the structure
3991 of objects are designed so that they can be passed directly to
3992 Gauche-gl functions, reducing the overhead of type conversions.
3993 </p>
3994 <p>The purpose of this module is to provide reasonable performance.
3995 So the operations are fixed to 3D homogeneous coordinates,
3996 i.e. a vector is 4-element column vector, and a matrix is 4x4
3997 square matrix. If you want more flexibility, <code>&lt;array&gt;</code>
3998 class in <code>gauche.array</code> provides much more generic
3999 structures, trading performance.
4000 </p>
4001 <p>Elements of vectors and matrices are represented in <code>float</code>
4002 internally. When you retrieve each element individually,
4003 it is converted to <code>double</code>, so you might see some precision
4004 errors. There are lots of operations directly manipulate group of
4005 elements without retrieving each element to Scheme world, avoiding
4006 overhead of conversion.
4007 </p></dd></dl>
4008
4009 <table class="menu" border="0" cellspacing="0">
4010 <tr><td align="left" valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
4011 </td></tr>
4012 <tr><td align="left" valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
4013 </td></tr>
4014 <tr><td align="left" valign="top"><a href="#Matrices">6.3 Matrices</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
4015 </td></tr>
4016 <tr><td align="left" valign="top"><a href="#Quaternions">6.4 Quaternions</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
4017 </td></tr>
4018 </table>
4019
4020 <hr size="6">
4021 <a name="Vectors-and-points"></a>
4022 <table cellpadding="1" cellspacing="1" border="0">
4023 <tr><td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Previous section in reading order"> &lt; </a>]</td>
4024 <td valign="middle" align="left">[<a href="#Vector-arrays-and-point-arrays" title="Next section in reading order"> &gt; </a>]</td>
4025 <td valign="middle" align="left"> &nbsp; </td>
4026 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
4027 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Up section"> Up </a>]</td>
4028 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Next chapter"> &gt;&gt; </a>]</td>
4029 <td valign="middle" align="left"> &nbsp; </td>
4030 <td valign="middle" align="left"> &nbsp; </td>
4031 <td valign="middle" align="left"> &nbsp; </td>
4032 <td valign="middle" align="left"> &nbsp; </td>
4033 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
4034 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
4035 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
4036 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
4037 </tr></table>
4038 <a name="Vectors-and-points-1"></a>
4039 <h2 class="section">6.1 Vectors and points</h2>
4040
4041 <dl>
4042 <dt><a name="index-_003cvector4f_003e"></a><u>Class:</u> <b>&lt;vector4f&gt;</b></dt>
4043 <dt><a name="index-_003cpoint4f_003e"></a><u>Class:</u> <b>&lt;point4f&gt;</b></dt>
4044 <dd><a name="index-vector4f"></a>
4045 <a name="index-point4f"></a>
4046 <p>4x1 column vectors. <code>Vector4f</code> is intended to be used
4047 to represent a vector, and <code>point4f</code> is to a point,
4048 but as far as OpenGL concerns, both are just an array of four floats,
4049 <var>x</var>, <var>y</var>, <var>z</var> and <var>w</var>.
4050 </p>
4051 <p>These classes inherit <code>&lt;sequence&gt;</code> and <code>&lt;collection&gt;</code>
4052 classes. So if you import <code>gauche.sequence</code> module,
4053 you can use generic function such as <code>ref</code> and <code>(setter ref)</code>
4054 to get/set individual elements. The generic version of
4055 <code>map</code> and <code>for-each</code> can also be used on the vector4f and
4056 point4f instances.
4057 </p>
4058 <p>Aside from the type,
4059 the only difference is that the default value of <var>w</var> component&mdash;
4060 it&rsquo;s 0.0 for vectors, and 1.0 for points. So usual transformation
4061 produces expected results; for example point plus vector
4062 becomes point, vector plus vector becomes vector,
4063 and translating point changes its coordinates but
4064 translating vectors doesn&rsquo;t, and so on.
4065 However, you can set <var>w</var> component to other value to do
4066 nontrivial operations.
4067 </p></dd></dl>
4068
4069 <dl>
4070 <dt><a name="index-_0023_002c_0028vector4f-x-y-z-w_0029"></a><u>Reader syntax:</u> <b><code>#,(vector4f <var>x</var> <var>y</var> <var>z</var> <var>w</var>)</code></b></dt>
4071 <dt><a name="index-_0023_002c_0028point4f-x-y-z-w_0029"></a><u>Reader syntax:</u> <b><code>#,(point4f <var>x</var> <var>y</var> <var>z</var> <var>w</var>)</code></b></dt>
4072 <dd><p>These SRFI-10 syntax can be used to denote literal <code>&lt;vector4f&gt;</code>
4073 and <code>&lt;point4f&gt;</code> instance, respectively.
4074 </p>
4075 <p>The write methods are defined so that the instance is written out
4076 in this form, and can be read back later.
4077 </p></dd></dl>
4078
4079 <dl>
4080 <dt><a name="index-vector4f_003f"></a><u>Function:</u> <b>vector4f?</b><i> obj</i></dt>
4081 <dt><a name="index-point4f_003f"></a><u>Function:</u> <b>point4f?</b><i> obj</i></dt>
4082 <dd><p>Returns true iff <var>obj</var> is vector4f and point4f, respectively.
4083 </p></dd></dl>
4084
4085
4086 <dl>
4087 <dt><a name="index-vector4f-1"></a><u>Function:</u> <b>vector4f</b><i> x y z &amp;optional (w 0.0)</i></dt>
4088 <dt><a name="index-point4f-1"></a><u>Function:</u> <b>point4f</b><i> x y z &amp;optional (w 1.0)</i></dt>
4089 <dd><p>Creates a vector4f and point4f instance with given values, respectively.
4090 </p></dd></dl>
4091
4092 <dl>
4093 <dt><a name="index-make_002dvector4f"></a><u>Function:</u> <b>make-vector4f</b></dt>
4094 <dt><a name="index-make_002dpoint4f"></a><u>Function:</u> <b>make-point4f</b></dt>
4095 <dd><p>Another way to create a vector4f and a point4f.
4096 The first returns <code>#,(vector4f 0.0 0.0 0.0 0.0)</code>,
4097 and the latter returns <code>#,(point4f 0.0 0.0 0.0 1.0)</code>.
4098 </p></dd></dl>
4099
4100 <dl>
4101 <dt><a name="index-list_002d_003evector4f"></a><u>Function:</u> <b>list-&gt;vector4f</b><i> l</i></dt>
4102 <dt><a name="index-list_002d_003epoint4f"></a><u>Function:</u> <b>list-&gt;point4f</b><i> l</i></dt>
4103 <dd><p>Convert a list of three or four real numbers to a vector4f and a point4f,
4104 respectively.
4105 If <var>l</var> is not a list of three or four real numbers, an error is
4106 signalled.
4107 </p>
4108 <table><tr><td>&nbsp;</td><td><pre class="example">(list-&gt;vector4f l)
4109 &equiv; (apply vector4f l)
4110 &equiv; (coerce-to &lt;vector4f&gt; l)
4111 </pre></td></tr></table>
4112 </dd></dl>
4113
4114 <dl>
4115 <dt><a name="index-vector4f_002d_003elist"></a><u>Function:</u> <b>vector4f-&gt;list</b><i> v</i></dt>
4116 <dt><a name="index-point4f_002d_003elist"></a><u>Function:</u> <b>point4f-&gt;list</b><i> p</i></dt>
4117 <dd><p>Convert a vector4f and a point4f to a list of four real numbers,
4118 respectively.
4119 </p>
4120 <table><tr><td>&nbsp;</td><td><pre class="example">(vector4f-&gt;list v)
4121 &equiv; (coerce-to &lt;list&gt; v)
4122 &equiv; (map (cut ref v &lt;&gt;) (iota 4))
4123 </pre></td></tr></table>
4124 </dd></dl>
4125
4126 <dl>
4127 <dt><a name="index-f32vector_002d_003evector4f"></a><u>Function:</u> <b>f32vector-&gt;vector4f</b><i> v &amp;optional start</i></dt>
4128 <dt><a name="index-f32vector_002d_003epoint4f"></a><u>Function:</u> <b>f32vector-&gt;point4f</b><i> v &amp;optional start</i></dt>
4129 <dd><p>Creates a vector4f or a point4f, initializing by the elements of
4130 f32vector <var>v</var>. <var>V</var> must be at least 4 elements long, and the first
4131 four elements are used to initialize the created vector or point.
4132 </p>
4133 <p>If optional <var>start</var> argument is given, it specifies an index
4134 of <var>v</var> from which the initial values are taken; that is,
4135 <var>start</var>, <var>start+1</var>, <var>start+2</var> and <var>start+3</var>-th
4136 elements are used to create a vector or a point.
4137 This allows to create vectors from plain float array:
4138 </p><table><tr><td>&nbsp;</td><td><pre class="example">(map (lambda (off) (f32vector-&gt;vector4f vec (* off 4)))
4139 (iota (/ (size-of vec) 4)))
4140 </pre></td></tr></table>
4141
4142 <p>The conversion can be done using <code>coerce-to</code>, as well.
4143 </p><table><tr><td>&nbsp;</td><td><pre class="example">(f32vector-&gt;vector4f vec)
4144 &equiv; (coerce-to &lt;vector4f&gt; vec)
4145 </pre></td></tr></table>
4146 </dd></dl>
4147
4148 <dl>
4149 <dt><a name="index-vector4f_002d_003ef32vector"></a><u>Function:</u> <b>vector4f-&gt;f32vector</b><i> v</i></dt>
4150 <dt><a name="index-point4f_002d_003ef32vector"></a><u>Function:</u> <b>point4f-&gt;f32vector</b><i> p</i></dt>
4151 <dd><p>Convert a vector4f <var>v</var> or a point4f <var>p</var> to four-element
4152 f32vector.
4153 </p>
4154 <table><tr><td>&nbsp;</td><td><pre class="example">(vector4f-&gt;f32vector v)
4155 &equiv; (coerce-to &lt;f32vector&gt; v)
4156 </pre></td></tr></table>
4157 </dd></dl>
4158
4159 <dl>
4160 <dt><a name="index-vector4f_002dcopy"></a><u>Function:</u> <b>vector4f-copy</b><i> v</i></dt>
4161 <dt><a name="index-point4f_002dcopy"></a><u>Function:</u> <b>point4f-copy</b><i> p</i></dt>
4162 <dd><p>Returns a new copy of vector4f <var>v</var> or point4f <var>p</var>, respectively.
4163 </p></dd></dl>
4164
4165 <dl>
4166 <dt><a name="index-vector4f_002dcopy_0021"></a><u>Function:</u> <b>vector4f-copy!</b><i> dstv srcv</i></dt>
4167 <dt><a name="index-point4f_002dcopy_0021"></a><u>Function:</u> <b>point4f-copy!</b><i> dstp srcp</i></dt>
4168 <dd><p>Destructively sets the content of <var>srcv</var> or <var>srcp</var> to
4169 <var>dstv</var> or <var>dstp</var>, respectively.
4170 </p></dd></dl>
4171
4172 <dl>
4173 <dt><a name="index-vector4f_002dset_0021"></a><u>Function:</u> <b>vector4f-set!</b><i> v k value</i></dt>
4174 <dt><a name="index-point4f_002dset_0021"></a><u>Function:</u> <b>point4f-set!</b><i> p k value</i></dt>
4175 <dd><p>Sets a real number <var>value</var> to
4176 <var>k</var>-th element of a vector4f <var>v</var> or a point4f <var>p</var>.
4177 </p>
4178 <table><tr><td>&nbsp;</td><td><pre class="example">(vector4f-set! v k value)
4179 &equiv; (set! (ref v k) value)
4180 </pre></td></tr></table>
4181 </dd></dl>
4182
4183 <dl>
4184 <dt><a name="index-vector4f_002dref"></a><u>Function:</u> <b>vector4f-ref</b><i> v k &amp;optional fallback</i></dt>
4185 <dt><a name="index-point4f_002dref"></a><u>Function:</u> <b>point4f-ref</b><i> p k &amp;optional fallback</i></dt>
4186 <dd><p>Gets a value of <var>k</var>-th element of a vector4f <var>v</var> or
4187 a point4f <var>p</var>. If <var>k</var> is out of range,
4188 an error is signalled, unless <var>fallback</var> is provided,
4189 in such a case <var>fallback</var> is returned.
4190 </p>
4191 <table><tr><td>&nbsp;</td><td><pre class="example">(vector4f-ref v k)
4192 &equiv; (ref v k)
4193 </pre></td></tr></table>
4194 </dd></dl>
4195
4196 <dl>
4197 <dt><a name="index-vector4f_002ddot"></a><u>Function:</u> <b>vector4f-dot</b><i> x y</i></dt>
4198 <dd><p>Returns a dot product of two vector4fs, <var>x</var> and <var>y</var>.
4199 </p></dd></dl>
4200
4201 <dl>
4202 <dt><a name="index-vector4f_002dcross"></a><u>Function:</u> <b>vector4f-cross</b><i> x y</i></dt>
4203 <dd><p>Returns a cross product of two vector4fs, <var>x</var> and <var>y</var>.
4204 (<var>w</var> element is ignored).
4205 </p></dd></dl>
4206
4207 <dl>
4208 <dt><a name="index-vector4f_002dnorm"></a><u>Function:</u> <b>vector4f-norm</b><i> v</i></dt>
4209 <dd><p>Returns the norm (length) of the vector <var>v</var>.
4210 </p></dd></dl>
4211
4212 <dl>
4213 <dt><a name="index-vector4f_002dnormalize"></a><u>Function:</u> <b>vector4f-normalize</b><i> x</i></dt>
4214 <dt><a name="index-vector4f_002dnormalize_0021"></a><u>Function:</u> <b>vector4f-normalize!</b><i> x</i></dt>
4215 <dd><p>Returns a normalized vector of vector4f <var>x</var>.
4216 <code>Vector4f-normalize</code> allocates a new vector, while
4217 <code>vector4f-normalize!</code> modifies the original vector.
4218 </p>
4219 <p>As a special case,
4220 if <var>x</var> is a vector of length 0, a vector of length 0 is returned.
4221 </p></dd></dl>
4222
4223 <dl>
4224 <dt><a name="index-vector4f_002dadd"></a><u>Function:</u> <b>vector4f-add</b><i> x y</i></dt>
4225 <dt><a name="index-vector4f_002dsub"></a><u>Function:</u> <b>vector4f-sub</b><i> x y</i></dt>
4226 <dt><a name="index-vector4f_002dadd_0021"></a><u>Function:</u> <b>vector4f-add!</b><i> x y</i></dt>
4227 <dt><a name="index-vector4f_002dsub_0021"></a><u>Function:</u> <b>vector4f-sub!</b><i> x y</i></dt>
4228 <dd><p>Returns a sum of two vector4fs, <var>x</var> and <var>y</var>.
4229 The destructive version modifies <var>x</var>.
4230 </p></dd></dl>
4231
4232 <dl>
4233 <dt><a name="index-point4f_002dadd"></a><u>Function:</u> <b>point4f-add</b><i> x y</i></dt>
4234 <dt><a name="index-point4f_002dadd_0021"></a><u>Function:</u> <b>point4f-add!</b><i> x y</i></dt>
4235 <dd><p>Adds a point4f <var>x</var> and a vector4f <var>y</var>, and returns
4236 a translated point. The destructive version modifies <var>x</var>.
4237 </p></dd></dl>
4238
4239 <dl>
4240 <dt><a name="index-point4f_002dsub"></a><u>Function:</u> <b>point4f-sub</b><i> x y</i></dt>
4241 <dd><p>Subtracts either a vector4f or a point4f <var>y</var> from
4242 a point4f <var>x</var>. If <var>y</var> is a vector4f, returns
4243 a translated point. If <var>y</var> is a point4f, returns
4244 a vector4f from point <var>y</var> to point <var>x</var>.
4245 </p></dd></dl>
4246
4247 <hr size="6">
4248 <a name="Vector-arrays-and-point-arrays"></a>
4249 <table cellpadding="1" cellspacing="1" border="0">
4250 <tr><td valign="middle" align="left">[<a href="#Vectors-and-points" title="Previous section in reading order"> &lt; </a>]</td>
4251 <td valign="middle" align="left">[<a href="#Matrices" title="Next section in reading order"> &gt; </a>]</td>
4252 <td valign="middle" align="left"> &nbsp; </td>
4253 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
4254 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Up section"> Up </a>]</td>
4255 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Next chapter"> &gt;&gt; </a>]</td>
4256 <td valign="middle" align="left"> &nbsp; </td>
4257 <td valign="middle" align="left"> &nbsp; </td>
4258 <td valign="middle" align="left"> &nbsp; </td>
4259 <td valign="middle" align="left"> &nbsp; </td>
4260 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
4261 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
4262 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
4263 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
4264 </tr></table>
4265 <a name="Vector-arrays-and-point-arrays-1"></a>
4266 <h2 class="section">6.2 Vector arrays and point arrays</h2>
4267
4268 <dl>
4269 <dt><a name="index-_003cvector4f_002darray_003e"></a><u>Class:</u> <b>&lt;vector4f-array&gt;</b></dt>
4270 <dt><a name="index-_003cpoint4f_002darray_003e"></a><u>Class:</u> <b>&lt;point4f-array&gt;</b></dt>
4271 <dd><a name="index-vector4f_002darray"></a>
4272 <a name="index-point4f_002darray"></a>
4273 <p>Represents an array of vector4fs and point4fs.
4274 This is an efficient way to keep an array of vectors or points,
4275 for the elements are packed in a simple float array.
4276 They are especially useful to work with GL&rsquo;s vertex array feature.
4277 <code>gl-vertex-pointer</code> can take <code>&lt;point4f-array&gt;</code>,
4278 and <code>gl-normal-pointer</code> can take <code>&lt;vector4f-array&gt;</code>.
4279 </p>
4280 <p>It is also possible to &quot;view&quot; a plain f32vector as <code>&lt;vector4f-array&gt;</code>
4281 or <code>&lt;point4f-array&gt;</code> without copying its content, by
4282 <code>f32vector-&gt;vector4f-array/shared</code> and
4283 <code>f32vector-&gt;point4f-array/shared</code>. Combined to
4284 <code>read-block!</code>, you can do efficient binary I/O of
4285 vertex arrays, for example.
4286 </p>
4287 <p>Inherits <code>&lt;sequence&gt;</code> and <code>&lt;collection&gt;</code>.
4288 When viewed as a sequence or a collection, they behaves like
4289 sequence or collection of <code>vector4f</code> and <code>point4f</code> objects,
4290 respectively.
4291 </p></dd></dl>
4292
4293 <dl>
4294 <dt><a name="index-make_002dvector4f_002darray"></a><u>Function:</u> <b>make-vector4f-array</b><i> len &amp;optional init-vector</i></dt>
4295 <dt><a name="index-make_002dpoint4f_002darray"></a><u>Function:</u> <b>make-point4f-array</b><i> len &amp;optional init-point</i></dt>
4296 <dd><p>Creates a vector4f-array or point4f-array with <var>len</var> elements.
4297 Each element is initialized by a vector4f <var>init-vector</var> or
4298 a point4f <var>init-point</var> if provided.
4299 </p></dd></dl>
4300
4301 <dl>
4302 <dt><a name="index-vector4f_002darray_003f"></a><u>Function:</u> <b>vector4f-array?</b><i> obj</i></dt>
4303 <dt><a name="index-point4f_002darray_003f"></a><u>Function:</u> <b>point4f-array?</b><i> obj</i></dt>
4304 <dd><p>Returns true iff <var>obj</var> is a vector4f-array or a point4f-array,
4305 respectively.
4306 </p></dd></dl>
4307
4308 <dl>
4309 <dt><a name="index-vector4f_002darray_002dlength"></a><u>Function:</u> <b>vector4f-array-length</b><i> array</i></dt>
4310 <dt><a name="index-point4f_002darray_002dlength"></a><u>Function:</u> <b>point4f-array-length</b><i> array</i></dt>
4311 <dd><p>Returns length (number of vectors/points) in array <var>array</var>.
4312 </p></dd></dl>
4313
4314 <dl>
4315 <dt><a name="index-_0023_002c_0028vector4f_002darray-len-elt-_2026_0029"></a><u>Reader syntax:</u> <b><code>#,(vector4f-array <var>len</var> <var>elt</var> &hellip;)</code></b></dt>
4316 <dt><a name="index-_0023_002c_0028point4f_002darray-len-elt-_2026_0029"></a><u>Reader syntax:</u> <b><code>#,(point4f-array <var>len</var> <var>elt</var> &hellip;)</code></b></dt>
4317 <dd><p>Vector4f-array and point4f-array have external representation
4318 using this SRFI-10 syntax. <var>Len</var> is a length of array,
4319 and each <var>elt</var> is a list of four floats representing
4320 each element of the array.
4321 </p>
4322 <table><tr><td>&nbsp;</td><td><pre class="example">(f32vector-&gt;vector4f-array #f32(1 2 3 4 6 7 4 3))
4323 &rArr; #,(vector4f-array 2 (1 2 3 4) (6 7 4 3) )
4324 </pre></td></tr></table>
4325 </dd></dl>
4326
4327 <dl>
4328 <dt><a name="index-list_002d_003evector4f_002darray"></a><u>Function:</u> <b>list-&gt;vector4f-array</b><i> list</i></dt>
4329 <dt><a name="index-list_002d_003epoint4f_002darray"></a><u>Function:</u> <b>list-&gt;point4f-array</b><i> list</i></dt>
4330 <dd><p>From given list of vector4fs or point4fs, creates and returns
4331 a vector4f-array or point4f-array, respectively.
4332 </p></dd></dl>
4333
4334 <dl>
4335 <dt><a name="index-f32vector_002d_003evector4f_002darray"></a><u>Function:</u> <b>f32vector-&gt;vector4f-array</b><i> v</i></dt>
4336 <dt><a name="index-f32vector_002d_003epoint4f_002darray"></a><u>Function:</u> <b>f32vector-&gt;point4f-array</b><i> v</i></dt>
4337 <dd><p>Converts f32vector <var>v</var> to a vector4f-array or a point4f-array.
4338 The length of <var>v</var> must be multiple of four.
4339 The content of <var>v</var> is copied.
4340 </p>
4341 <table><tr><td>&nbsp;</td><td><pre class="example">(f32vector-&gt;vector4f-array v)
4342 &equiv; (coerce-to &lt;vector4f-array&gt; v)
4343 </pre></td></tr></table>
4344 </dd></dl>
4345
4346 <dl>
4347 <dt><a name="index-f32vector_002d_003evector4f_002darray_002fshared"></a><u>Function:</u> <b>f32vector-&gt;vector4f-array/shared</b><i> v</i></dt>
4348 <dt><a name="index-f32vector_002d_003epoint4f_002darray_002fshared"></a><u>Function:</u> <b>f32vector-&gt;point4f-array/shared</b><i> v</i></dt>
4349 <dd><p>Like above, but the content of <var>v</var> is shared by the result
4350 array, instead of being copied.
4351 So the modification of result array will be visible from original
4352 f32vector <var>v</var> and vice versa.
4353 It will allow efficient handling of large vertex arrays.
4354 </p></dd></dl>
4355
4356 <dl>
4357 <dt><a name="index-vector4f_002darray_002d_003ef32vector"></a><u>Function:</u> <b>vector4f-array-&gt;f32vector</b><i> array</i></dt>
4358 <dt><a name="index-point4f_002darray_002d_003ef32vector"></a><u>Function:</u> <b>point4f-array-&gt;f32vector</b><i> array</i></dt>
4359 <dd><p>Converts a vector4f-array or a point4f-array <var>array</var> to a f32vector.
4360 </p>
4361 <table><tr><td>&nbsp;</td><td><pre class="example">(vector4f-array-&gt;f32vector array)
4362 &equiv; (coerce-to &lt;f32vector&gt; array)
4363 </pre></td></tr></table>
4364 </dd></dl>
4365
4366 <dl>
4367 <dt><a name="index-vector4f_002darray_002dset_0021"></a><u>Function:</u> <b>vector4f-array-set!</b><i> array i vector</i></dt>
4368 <dt><a name="index-point4f_002darray_002dset_0021"></a><u>Function:</u> <b>point4f-array-set!</b><i> array i point</i></dt>
4369 <dd><p>Sets a vector4f <var>vector</var> or a point4f <var>point</var> to
4370 <var>i</var>-th element of vector4f-array or point4f-array <var>array</var>,
4371 respectively.
4372 </p>
4373 <table><tr><td>&nbsp;</td><td><pre class="example">(vector4f-array-set! array i vector)
4374 &equiv; (set! (ref array i) vector)
4375 </pre></td></tr></table>
4376 </dd></dl>
4377
4378 <dl>
4379 <dt><a name="index-vector4f_002darray_002dref"></a><u>Function:</u> <b>vector4f-array-ref</b><i> array i &amp;optional fallback</i></dt>
4380 <dt><a name="index-point4f_002darray_002dref"></a><u>Function:</u> <b>point4f-array-ref</b><i> array i &amp;optional fallback</i></dt>
4381 <dd><p>Returns a vector4f or a point4f which is the <var>i</var>-th element
4382 of array <var>array</var>, respectively.
4383 If <var>k</var> is out of range,
4384 an error is signalled, unless <var>fallback</var> is provided,
4385 in such a case <var>fallback</var> is returned.
4386 </p>
4387 <table><tr><td>&nbsp;</td><td><pre class="example">(vector4f-array-ref array i)
4388 &equiv; (ref array i)
4389
4390 (ref #,(vector4f-array 2 (1 2 3 4) (6 7 4 3)) 1)
4391 &rArr; #,(vector4f 6 7 4 3)
4392 </pre></td></tr></table>
4393 </dd></dl>
4394
4395 <dl>
4396 <dt><a name="index-vector4f_002darray_002dref_002fshared"></a><u>Function:</u> <b>vector4f-array-ref/shared</b><i> array i &amp;optional fallback</i></dt>
4397 <dt><a name="index-point4f_002darray_002dref_002fshared"></a><u>Function:</u> <b>point4f-array-ref/shared</b><i> array i &amp;optional fallback</i></dt>
4398 <dd><p>Like above, but the returned vector4f or point4f shares the storage
4399 with the original array. Thus the modification of the result
4400 vector or point will be visible from <var>array</var>, and vice versa.
4401 </p></dd></dl>
4402
4403 <hr size="6">
4404 <a name="Matrices"></a>
4405 <table cellpadding="1" cellspacing="1" border="0">
4406 <tr><td valign="middle" align="left">[<a href="#Vector-arrays-and-point-arrays" title="Previous section in reading order"> &lt; </a>]</td>
4407 <td valign="middle" align="left">[<a href="#Quaternions" title="Next section in reading order"> &gt; </a>]</td>
4408 <td valign="middle" align="left"> &nbsp; </td>
4409 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
4410 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Up section"> Up </a>]</td>
4411 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Next chapter"> &gt;&gt; </a>]</td>
4412 <td valign="middle" align="left"> &nbsp; </td>
4413 <td valign="middle" align="left"> &nbsp; </td>
4414 <td valign="middle" align="left"> &nbsp; </td>
4415 <td valign="middle" align="left"> &nbsp; </td>
4416 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
4417 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
4418 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
4419 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
4420 </tr></table>
4421 <a name="Matrices-1"></a>
4422 <h2 class="section">6.3 Matrices</h2>
4423
4424 <dl>
4425 <dt><a name="index-_003cmatrix4f_003e"></a><u>Class:</u> <b>&lt;matrix4f&gt;</b></dt>
4426 <dd><a name="index-matrix4f"></a>
4427 <p>4x4 matrix. Internally it is represented as an array of 16 floats,
4428 stored in column-major order.
4429 (It is the same order OpenGL uses, so it can be passed to OpenGL
4430 calls without overhead).
4431 </p>
4432 <p>Inherits <code>&lt;sequence&gt;</code> and <code>&lt;collection&gt;</code>.
4433 When a matrix4f is treated as a sequence, it works as if it is
4434 a single sequence of floats in column-major order.
4435 </p></dd></dl>
4436
4437 <dl>
4438 <dt><a name="index-make_002dmatrix4f"></a><u>Function:</u> <b>make-matrix4f</b><i> &amp;optional init</i></dt>
4439 <dd><p>Returns a new matrix4f instance. If <var>init</var> is omitted,
4440 the matrix is a unit matrix. Otherwise, <var>init</var> must be a f32vector
4441 of length 16, and the elements in the matrix is initialized by
4442 ones in f32vector.
4443 </p>
4444 <table><tr><td>&nbsp;</td><td><pre class="example">;; Creates a matrix like this:
4445 ;; 1 2 3 4
4446 ;; 0 1 0 5
4447 ;; 0 0 1 6
4448 ;; 0 0 0 1
4449
4450 (make-matrix4f '#f32vector(1 0 0 0
4451 2 1 0 0
4452 3 0 1 0
4453 4 5 6 1))
4454 </pre></td></tr></table>
4455 </dd></dl>
4456
4457 <dl>
4458 <dt><a name="index-matrix4f-1"></a><u>Function:</u> <b>matrix4f</b><i> m00 m10 m20 m30 m01 m11 m21 m31 m02 m12 m22 m32 m03 m13 m23 m33</i></dt>
4459 <dd><p>Creates a new matrix4f instance with give values.
4460 </p></dd></dl>
4461
4462 <dl>
4463 <dt><a name="index-matrix4f_003f"></a><u>Function:</u> <b>matrix4f?</b><i> obj</i></dt>
4464 <dd><p>Returns true iff <var>obj</var> is a matrix4f.
4465 </p></dd></dl>
4466
4467 <dl>
4468 <dt><a name="index-_0023_002c_0028matrix4f-elt-_2026_0029"></a><u>Reader syntax:</u> <b><code>#,(matrix4f <var>elt</var> &hellip;)</code></b></dt>
4469 <dd><p>A matrix4f is represented extrenally using SRFI-10 syntax.
4470 The elements are listed in column-major order.
4471 </p></dd></dl>
4472
4473 <dl>
4474 <dt><a name="index-list_002d_003ematrix4f"></a><u>Function:</u> <b>list-&gt;matrix4f</b><i> l</i></dt>
4475 <dt><a name="index-matrix4f_002d_003elist"></a><u>Function:</u> <b>matrix4f-&gt;list</b><i> m</i></dt>
4476 <dd><p>Converts between list of 16 real numbers and matrix4f.
4477 </p></dd></dl>
4478
4479 <dl>
4480 <dt><a name="index-f32vector_002d_003ematrix4f"></a><u>Function:</u> <b>f32vector-&gt;matrix4f</b><i> v &amp;optional start</i></dt>
4481 <dd><p>Creates a new matrix4f and initializes it with 16 elements in
4482 f32vector <var>v</var>. If optional <var>start</var> is given,
4483 it specifies the start offset in vector <var>v</var> to be used as
4484 initial values. The f32vector <var>v</var> must have enough length.
4485 </p></dd></dl>
4486
4487 <dl>
4488 <dt><a name="index-f32vector_002d_003ematrix4f_0021"></a><u>Function:</u> <b>f32vector-&gt;matrix4f!</b><i> m v &amp;optional (start 0)</i></dt>
4489 <dd><p>Extract 16 flonums in the f32vector <var>v</var> starting from the
4490 index <var>start</var>, and fill the matrix4f <var>m</var> with them.
4491 The f32vector <var>v</var> must have enough length.
4492 </p></dd></dl>
4493
4494 <dl>
4495 <dt><a name="index-matrix4f_002d_003ef32vector"></a><u>Function:</u> <b>matrix4f-&gt;f32vector</b><i> m</i></dt>
4496 <dd><p>Returns a new f32vector that has elements from matrix4f <var>m</var>.
4497 </p></dd></dl>
4498
4499 <dl>
4500 <dt><a name="index-matrix4f_002dcopy"></a><u>Function:</u> <b>matrix4f-copy</b><i> m</i></dt>
4501 <dd><p>Returns a new copy of <var>m</var>.
4502 </p></dd></dl>
4503
4504 <dl>
4505 <dt><a name="index-matrix4f_002dcopy_0021"></a><u>Function:</u> <b>matrix4f-copy!</b><i> dstm srcm</i></dt>
4506 <dd><p>Copies contents of <var>srcm</var> to <var>dstm</var>.
4507 </p></dd></dl>
4508
4509 <dl>
4510 <dt><a name="index-matrix4f_002dset_0021"></a><u>Function:</u> <b>matrix4f-set!</b><i> m i value</i></dt>
4511 <dd><p>Sets a real number <var>value</var> to <var>i</var>-th element of matrix <var>m</var>.
4512 Since the matrix is laid out in column-major order,
4513 the one-dimensional index <code>m{<var>i</var>}</code> and two-dimensional
4514 index <code>m(<var>i</var>,<var>j</var>)</code> corresponds as follows:
4515 </p><table><tr><td>&nbsp;</td><td><pre class="example"> m(0,0) = m{0} m(0,1) = m{4} m(0,2) = m{8} m(0,3) = m{12}
4516 m(1,0) = m{1} m(1,1) = m{5} m(1,2) = m{9} m(1,3) = m{13}
4517 m(2,0) = m{2} m(2,1) = m{6} m(2,2) = m{10} m(2,3) = m{14}
4518 m(3,0) = m{3} m(3,1) = m{7} m(3,2) = m{11} m(3,3) = m{15}
4519 </pre></td></tr></table>
4520 </dd></dl>
4521
4522 <dl>
4523 <dt><a name="index-matrix4f_002dref"></a><u>Function:</u> <b>matrix4f-ref</b><i> m i &amp;optional fallback</i></dt>
4524 <dd><p>Returns the <var>i</var>-th element of matrix <var>m</var>.
4525 If <var>i</var> is out of range, an error is signalled,
4526 unless <var>fallback</var> is provided, in such a case
4527 <var>fallback</var> is returned.
4528 </p></dd></dl>
4529
4530 <dl>
4531 <dt><a name="index-matrix4f_002dset2_0021"></a><u>Function:</u> <b>matrix4f-set2!</b><i> m i j value</i></dt>
4532 <dd><p>Sets <var>value</var> to <code>(<var>i</var>, <var>j</var>)</code> element of matrix <var>m</var>.
4533 </p></dd></dl>
4534
4535 <dl>
4536 <dt><a name="index-matrix4f_002dref2"></a><u>Function:</u> <b>matrix4f-ref2</b><i> m i j</i></dt>
4537 <dd><p>Returns the <code>(<var>i</var>, <var>j</var>)</code> element of matrix <var>m</var>.
4538 </p></dd></dl>
4539
4540 <dl>
4541 <dt><a name="index-matrix4f_002drow"></a><u>Function:</u> <b>matrix4f-row</b><i> m i</i></dt>
4542 <dt><a name="index-matrix4f_002dcolumn"></a><u>Function:</u> <b>matrix4f-column</b><i> m i</i></dt>
4543 <dt><a name="index-matrix4f_002dcolumn_002fshared"></a><u>Function:</u> <b>matrix4f-column/shared</b><i> m i</i></dt>
4544 <dd><p>Returns <var>i</var>-th row vector or <var>i</var>-th column vector
4545 of matrix <var>m</var>, as a vector4f instance.
4546 </p>
4547 <p>Furthermore, the returned vector from <code>matrix4f-column/shared</code>
4548 shares the storage with <code>m</code>.
4549 </p></dd></dl>
4550
4551 <dl>
4552 <dt><a name="index-matrix4f_002dmul"></a><u>Function:</u> <b>matrix4f-mul</b><i> m obj</i></dt>
4553 <dd><p><var>Obj</var> may be a scalar (real number), a vector4f, a point4f, or a matrix4f.
4554 Returns <var>m</var> x <var>obj</var>.
4555 </p></dd></dl>
4556
4557 <dl>
4558 <dt><a name="index-matrix4f_002dmul_0021"></a><u>Function:</u> <b>matrix4f-mul!</b><i> m obj</i></dt>
4559 <dd><p><var>Obj</var> may be a scalar or a matrix4f.
4560 Matrix <var>m</var> is multiplied by <var>obj</var>, and the result is
4561 set to <var>m</var> destructively.
4562 </p></dd></dl>
4563
4564 <dl>
4565 <dt><a name="index-matrix4f_002dtranspose"></a><u>Function:</u> <b>matrix4f-transpose</b><i> m</i></dt>
4566 <dt><a name="index-matrix4f_002dtranspose_0021"></a><u>Function:</u> <b>matrix4f-transpose!</b><i> m</i></dt>
4567 <dd><p>Returns a transposed matrix of <var>m</var>. The destructive version
4568 modifies <var>m</var>.
4569 </p></dd></dl>
4570
4571 <dl>
4572 <dt><a name="index-matrix4f_002ddeterminant"></a><u>Function:</u> <b>matrix4f-determinant</b><i> m</i></dt>
4573 <dd><p>Returns a determinant of <var>m</var>.
4574 </p></dd></dl>
4575
4576 <dl>
4577 <dt><a name="index-matrix4f_002dinverse"></a><u>Function:</u> <b>matrix4f-inverse</b><i> m &amp;optional (error-on-singular? #t)</i></dt>
4578 <dt><a name="index-matrix4f_002dinverse_0021"></a><u>Function:</u> <b>matrix4f-inverse!</b><i> m &amp;optional (error-on-singular? #t)</i></dt>
4579 <dd><p>Returns a inverse matrix of <var>m</var>. The destructive version
4580 modifies <var>m</var>. If given <var>m</var> is a singular matrix,
4581 an error is signalled by default. However, if <code>#f</code> is given
4582 to the optional <var>error-on-singular?</var> argument,
4583 <code>#f</code> is returned in such a case.
4584 </p></dd></dl>
4585
4586 <dl>
4587 <dt><a name="index-translation_002d_003ematrix4f"></a><u>Function:</u> <b>translation-&gt;matrix4f</b><i> translation-vector</i></dt>
4588 <dt><a name="index-translation_002d_003ematrix4f_0021"></a><u>Function:</u> <b>translation-&gt;matrix4f!</b><i> m translation-vector</i></dt>
4589 <dd><p>Returns a matrix which represents a translation by <var>translation-vector</var>,
4590 which must be either a vector4f, a point4f, or
4591 a f32vector of length 3 or 4. Only the first three elements
4592 in <var>translation-vector</var> is used.
4593 The destructive version updates <var>m</var>.
4594 </p></dd></dl>
4595
4596 <dl>
4597 <dt><a name="index-rotation_002d_003ematrix4f"></a><u>Function:</u> <b>rotation-&gt;matrix4f</b><i> axis angle</i></dt>
4598 <dt><a name="index-rotation_002d_003ematrix4f_0021"></a><u>Function:</u> <b>rotation-&gt;matrix4f!</b><i> m axis angle</i></dt>
4599 <dd><p>Returns a matrix which represents a rotation around
4600 <var>axis</var> by <var>angle</var> radian. <var>Axis</var> must be
4601 a vector4f or a f32vector of length 3 or 4, and must be normalized.
4602 The result is undefined if anormalized vector is passed as <var>axis</var>.
4603 The destructive version updates <var>m</var>.
4604 </p></dd></dl>
4605
4606 <dl>
4607 <dt><a name="index-scale_002d_003ematrix4f"></a><u>Function:</u> <b>scale-&gt;matrix4f</b><i> scale-vector</i></dt>
4608 <dt><a name="index-scale_002d_003ematrix4f_0021"></a><u>Function:</u> <b>scale-&gt;matrix4f!</b><i> m scale-vector</i></dt>
4609 <dd><p>Returns a matrix which represents a scale by <var>scale-vector</var>,
4610 which must be either a vector4f, a point4f, or
4611 a f32vector of length 3 or 4. Only the first three elements
4612 in <var>scale-vector</var> is used. Each element of <var>scale-vector</var>
4613 represents the scale factor along x, y, and z axis.
4614 The destructive version updates <var>m</var>.
4615 </p></dd></dl>
4616
4617 <dl>
4618 <dt><a name="index-trs_002d_003ematrix4f"></a><u>Function:</u> <b>trs-&gt;matrix4f</b><i> translation rotation-axis rotation-angle scale</i></dt>
4619 <dt><a name="index-trs_002d_003ematrix4f_0021"></a><u>Function:</u> <b>trs-&gt;matrix4f!</b><i> m translation rotation-axis rotation-angle scale</i></dt>
4620 <dd><p>This combines above three procedure.
4621 Returns a matrix that represents translation, rotation and
4622 scale, specified by <var>translation</var>, <var>rotation-axis</var>,
4623 <var>rotation-angle</var> and <var>scale</var>.
4624 The destructive version updates <var>m</var>.
4625 </p>
4626 <p>If <code><i>T</i></code>, <code><i>R</i></code> and <code><i>S</i></code>, are
4627 the matrices that represent translation, rotation and scale, respectively,
4628 then these procedures effectively calculates
4629 a matrix <code><i>TRS</i></code>.
4630 </p></dd></dl>
4631
4632 <dl>
4633 <dt><a name="index-tqs_002d_003ematrix4f"></a><u>Function:</u> <b>tqs-&gt;matrix4f</b><i> translation rotation-quat scale</i></dt>
4634 <dt><a name="index-tqs_002d_003ematrix4f_0021"></a><u>Function:</u> <b>tqs-&gt;matrix4f!</b><i> m translation rotation-quat scale</i></dt>
4635 <dd><p>A variation of <code>trs-&gt;matrix4f</code>. Instead of axis and angle,
4636 rotation is represented by a quaternion <var>rotation-quat</var>.
4637 See section <a href="#Quaternions">Quaternions</a>, for more details about quaternions.
4638 </p></dd></dl>
4639
4640 <dl>
4641 <dt><a name="index-euler_002dangle_002d_003ematrix4f"></a><u>Function:</u> <b>euler-angle-&gt;matrix4f</b><i> xangle yangle zangle &amp;optional order</i></dt>
4642 <dt><a name="index-euler_002dangle_002d_003ematrix4f_0021"></a><u>Function:</u> <b>euler-angle-&gt;matrix4f!</b><i> m xangle yangle zangle &amp;optional order</i></dt>
4643 <dd><p>Returns a matrix that represents rotation along x, y and z axis
4644 by <var>xangle</var>, <var>yangle</var>, and <var>zangle</var>, respectively.
4645 </p>
4646 <p>The order of rotation can be specified by the optional argument
4647 <var>order</var>, which may be one of the symbols <code>xyz</code>, <code>xzy</code>,
4648 <code>yzx</code>, <code>yxz</code>, <code>zxy</code>, or <code>zyx</code>. For example,
4649 symbol <code>xyz</code> means rotation around x-axis, then y-axis, then
4650 z-axis. Thus, if we write each rotation as <i>Rx</i>, <i>Ry</i>, and
4651 <i>Rz</i>, the returned matrix is <i>RzRyRx</i>.
4652 The default value of <var>order</var> is <code>xyz</code>.
4653 </p>
4654 <p>The desrtuctive version modifies <var>m</var>.
4655 </p></dd></dl>
4656
4657 <dl>
4658 <dt><a name="index-matrix4f_002ddecompose"></a><u>Function:</u> <b>matrix4f-decompose</b><i> m</i></dt>
4659 <dd><p>Matrix <var>m</var> is a composition of translation, rotation, shear and
4660 scale. Suppose transformation is applied in the reverse order.
4661 This procedure decompose <var>m</var> into each individual transformation.
4662 </p>
4663 <p>Returns five values.
4664 </p><ul>
4665 <li>
4666 A flag to indicate if <var>m</var> is non-singular.
4667 </li><li>
4668 A translation vector <var>t</var>, in vector4f. The first three elements
4669 of <var>t</var> are for x, y, and z translations.
4670 </li><li>
4671 A rotation matrix <var>r</var>, in matrix4f.
4672 This is an orthogonal matrix represents rotation component.
4673 </li><li>
4674 A shear vector <var>h</var>, in vector4f. The first three elements
4675 of <var>h</var> are for xy, xz and yz shear factors.
4676 </li><li>
4677 A scale vector <var>s</var>, in vector4f. The first three elements
4678 of <var>s</var> are fof x, y, and z scale factors.
4679 </li></ul>
4680
4681 <p>If <var>m</var> is singular, certain part of rotation matrix can&rsquo;t
4682 be recovered. In such a case, <var>r</var> becomes also singular matrix.
4683 </p>
4684 <p>If the original matrix has negative scale factor in any of
4685 x, y, or z scale, the decomposed scale factor will have all negative
4686 components. The signs of elements of <var>r</var> are adjusted accordingly.
4687 </p>
4688 <p>Due to the precision errors,
4689 you will see small values appear in shear component even <var>m</var> is
4690 pure TRS matrix.
4691 </p></dd></dl>
4692
4693 <dl>
4694 <dt><a name="index-matrix4f_002ddecompose_0021"></a><u>Function:</u> <b>matrix4f-decompose!</b><i> m t r h s</i></dt>
4695 <dd><p>Linear update version of <code>matrix4f-decompose</code>.
4696 The result vectors and matrices are stored in <var>t</var>, <var>r</var>, <var>h</var>
4697 and <var>s</var>. The return value is a boolean value indicates
4698 <var>m</var> is non-singular or not.
4699 </p></dd></dl>
4700
4701 <dl>
4702 <dt><a name="index-matrix4f_002d_003etranslation"></a><u>Function:</u> <b>matrix4f-&gt;translation</b><i> m</i></dt>
4703 <dd><p>Extract the translation component from the given TRS matrix <var>m</var>
4704 and returns it as a <code>&lt;vector4f&gt;</code>.
4705 </p></dd></dl>
4706
4707 <dl>
4708 <dt><a name="index-matrix4f_002d_003etranslation_0021"></a><u>Function:</u> <b>matrix4f-&gt;translation!</b><i> v m</i></dt>
4709 <dd><p>Extract the translation component from the given TRS matrix <var>m</var>
4710 and stores the result into a <code>&lt;vector4f&gt;</code> <var>v</var>.
4711 Returns <var>v</var>.
4712 </p></dd></dl>
4713
4714 <dl>
4715 <dt><a name="index-matrix4f_002d_003erotation"></a><u>Function:</u> <b>matrix4f-&gt;rotation</b><i> m</i></dt>
4716 <dd><p>From given orthogonal matrix <var>m</var>, extracts and returns
4717 and rotation axis and angle, as a vector4f and a real number.
4718 </p></dd></dl>
4719
4720 <dl>
4721 <dt><a name="index-matrix4f_002d_003erotation_0021"></a><u>Function:</u> <b>matrix4f-&gt;rotation!</b><i> v m</i></dt>
4722 <dd><p>Same as above, except the storage of vector4f <var>v</var> is reused
4723 to store the result axis.
4724 </p></dd></dl>
4725
4726 <hr size="6">
4727 <a name="Quaternions"></a>
4728 <table cellpadding="1" cellspacing="1" border="0">
4729 <tr><td valign="middle" align="left">[<a href="#Matrices" title="Previous section in reading order"> &lt; </a>]</td>
4730 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Next section in reading order"> &gt; </a>]</td>
4731 <td valign="middle" align="left"> &nbsp; </td>
4732 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
4733 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Up section"> Up </a>]</td>
4734 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Next chapter"> &gt;&gt; </a>]</td>
4735 <td valign="middle" align="left"> &nbsp; </td>
4736 <td valign="middle" align="left"> &nbsp; </td>
4737 <td valign="middle" align="left"> &nbsp; </td>
4738 <td valign="middle" align="left"> &nbsp; </td>
4739 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
4740 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
4741 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
4742 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
4743 </tr></table>
4744 <a name="Quaternions-1"></a>
4745 <h2 class="section">6.4 Quaternions</h2>
4746
4747 <dl>
4748 <dt><a name="index-_003cquatf_003e"></a><u>Class:</u> <b>&lt;quatf&gt;</b></dt>
4749 <dd><a name="index-quatf"></a>
4750 <p>Quaternions. Internally quaternions are represented as just
4751 an array of four floats; the first three are the vector component
4752 and the last is the scalar component.
4753 </p>
4754 <p>Inherits <code>&lt;sequence&gt;</code> and <code>&lt;collection&gt;</code>. When viewed
4755 as sequence, it is just like a vector of four floats.
4756 </p></dd></dl>
4757
4758 <dl>
4759 <dt><a name="index-quatf_003f"></a><u>Function:</u> <b>quatf?</b><i> obj</i></dt>
4760 <dd><p>Returns true iff <var>obj</var> is a quaternion.
4761 </p></dd></dl>
4762
4763 <dl>
4764 <dt><a name="index-_0023_002c_0028quatf-x-y-z-w_0029"></a><u>Reader syntax:</u> <b><code>#,(quatf <var>x</var> <var>y</var> <var>z</var> <var>w</var>)</code></b></dt>
4765 <dd><p>External representation of quaternion
4766 <i>x</i><b>i</b>+<i>y</i><b>j</b>+<i>z</i><b>k</b>+<i>w</i>.
4767 </p></dd></dl>
4768
4769 <dl>
4770 <dt><a name="index-make_002dquatf"></a><u>Function:</u> <b>make-quatf</b><i> &amp;optional axis (angle 0)</i></dt>
4771 <dd><p>Returns a new unit quaternion that represents a rotation
4772 around vector <var>axis</var> by <var>angle</var> radians.
4773 <var>Axis</var> can be a vector4f, a point4f or
4774 a f32vector (only first three component is used).
4775 <var>Axis</var> must be a unit vector; if <var>axis</var> is anormalized,
4776 the result is undefined.
4777 </p>
4778 <p>If both <var>axis</var> and <var>angle</var> is omitted,
4779 <code>#,(quatf 0 0 0 1)</code> is returned.
4780 </p></dd></dl>
4781
4782 <dl>
4783 <dt><a name="index-quatf-1"></a><u>Function:</u> <b>quatf</b><i> x y z w</i></dt>
4784 <dd><p>Returns a new quaternion whose elements are initialized by
4785 <var>x</var>, <var>y</var>, <var>z</var>, <var>w</var>.
4786 </p></dd></dl>
4787
4788 <dl>
4789 <dt><a name="index-list_002d_003equatf"></a><u>Function:</u> <b>list-&gt;quatf</b><i> l</i></dt>
4790 <dt><a name="index-quatf_002d_003elist"></a><u>Function:</u> <b>quatf-&gt;list</b><i> q</i></dt>
4791 <dd><p>Converts between a list of four real numbers and a quaternion.
4792 </p></dd></dl>
4793
4794 <dl>
4795 <dt><a name="index-f32vector_002d_003equatf"></a><u>Function:</u> <b>f32vector-&gt;quatf</b><i> x &amp;optional start</i></dt>
4796 <dd><p>Returns a new quaternion whose elements are initialized by
4797 the first four elements of f32vector <var>x</var>.
4798 If <var>start</var> is given, the initial value is taken
4799 starting from <var>start</var>-th index in <var>x</var>.
4800 </p></dd></dl>
4801
4802 <dl>
4803 <dt><a name="index-quatf_002d_003ef32vector"></a><u>Function:</u> <b>quatf-&gt;f32vector</b><i> q</i></dt>
4804 <dd><p>Returns a new f32vector whose contents is the same as a quaternion <var>q</var>.
4805 </p></dd></dl>
4806
4807 <dl>
4808 <dt><a name="index-quatf_002dcopy"></a><u>Function:</u> <b>quatf-copy</b><i> q</i></dt>
4809 <dd><p>Returns a fresh copy of a quaternion <var>q</var>.
4810 </p></dd></dl>
4811
4812 <dl>
4813 <dt><a name="index-quatf_002dcopy_0021"></a><u>Function:</u> <b>quatf-copy!</b><i> dstq srcq</i></dt>
4814 <dd><p>Copies contents of a quaternion <var>srcq</var> to a quaternion <var>dstq</var>.
4815 </p></dd></dl>
4816
4817 <dl>
4818 <dt><a name="index-rotation_002d_003equatf_0021"></a><u>Function:</u> <b>rotation-&gt;quatf!</b><i> quat axis angle</i></dt>
4819 <dd><p>Sets a quaternion <var>quat</var> so that it represents a rotation
4820 around a unit vector <var>axis</var> by angle <var>angle</var> radians.
4821 <var>Axis</var> can be a vector4f, a point4f or
4822 a f32vector (only first three component is used).
4823 </p></dd></dl>
4824
4825 <dl>
4826 <dt><a name="index-vectors_002d_003equatf"></a><u>Function:</u> <b>vectors-&gt;quatf</b><i> v w</i></dt>
4827 <dt><a name="index-vectors_002d_003equatf_0021"></a><u>Function:</u> <b>vectors-&gt;quatf!</b><i> q v w</i></dt>
4828 <dd><p>Given two unit vectors <var>v</var> and <var>w</var>, calculates and returns
4829 a quaternion that represents a rotation from <var>v</var> to <var>w</var>.
4830 The destructive version <code>vectors-&gt;quatf!</code> modifies <var>q</var>.
4831 </p></dd></dl>
4832
4833 <dl>
4834 <dt><a name="index-axes_002d_003equatf"></a><u>Function:</u> <b>axes-&gt;quatf</b><i> v1 v2 w1 w2</i></dt>
4835 <dt><a name="index-axes_002d_003equatf_0021"></a><u>Function:</u> <b>axes-&gt;quatf!</b><i> q v1 v2 w1 w2</i></dt>
4836 <dd><p>The arguments must be all unit vectors,
4837 <var>v1</var> and <var>v2</var> must be perpendicular,
4838 and also <var>w1</var> and <var>w2</var> must be perpendicular.
4839 </p>
4840 <p>Calculates and returns a quaternion that represents a rotation
4841 which transforms <var>v1</var> to <var>w1</var>, and <var>v2</var> to <var>w2</var>,
4842 respectively. The destructive version stores the result
4843 into <var>q</var>.
4844 </p></dd></dl>
4845
4846 <dl>
4847 <dt><a name="index-quatf_002dadd"></a><u>Function:</u> <b>quatf-add</b><i> p q</i></dt>
4848 <dt><a name="index-quatf_002dadd_0021"></a><u>Function:</u> <b>quatf-add!</b><i> p q</i></dt>
4849 <dt><a name="index-quatf_002dsub"></a><u>Function:</u> <b>quatf-sub</b><i> p q</i></dt>
4850 <dt><a name="index-quatf_002dsub_0021"></a><u>Function:</u> <b>quatf-sub!</b><i> p q</i></dt>
4851 <dd><p>Addition and subtraction of quaternions. The destructive version
4852 modifies the first argument.
4853 </p></dd></dl>
4854
4855 <dl>
4856 <dt><a name="index-quatf_002dscale"></a><u>Function:</u> <b>quatf-scale</b><i> q s</i></dt>
4857 <dt><a name="index-quatf_002dscale_0021"></a><u>Function:</u> <b>quatf-scale!</b><i> q s</i></dt>
4858 <dd><p>Multiplies a quaternion <var>q</var> by a scalar value <var>s</var>.
4859 The destructive version modifies <var>q</var>.
4860 </p></dd></dl>
4861
4862 <dl>
4863 <dt><a name="index-quatf_002dmul"></a><u>Function:</u> <b>quatf-mul</b><i> p q</i></dt>
4864 <dt><a name="index-quatf_002dmul_0021"></a><u>Function:</u> <b>quatf-mul!</b><i> p q</i></dt>
4865 <dd><p>Multiply two quaternions <var>p</var> and <var>q</var>.
4866 The destructive version modifies <var>p</var> as well.
4867 </p></dd></dl>
4868
4869 <dl>
4870 <dt><a name="index-quatf_002dconjugate"></a><u>Function:</u> <b>quatf-conjugate</b><i> p</i></dt>
4871 <dt><a name="index-quatf_002dconjugate_0021"></a><u>Function:</u> <b>quatf-conjugate!</b><i> q p</i></dt>
4872 <dd><p>Returns a conjugate of a quaternion <var>p</var>.
4873 The destructive version modifies <var>q</var> as well.
4874 </p></dd></dl>
4875
4876 <dl>
4877 <dt><a name="index-quatf_002dtransform"></a><u>Function:</u> <b>quatf-transform</b><i> q p</i></dt>
4878 <dd><p>Transforms a vector or a point <var>p</var> by quaternion <var>q</var>,
4879 that is, returns <var>qpq*</var>, where <var>q*</var> is a conjugate of <var>q</var>.
4880 </p>
4881 <p>This procedure assumes <var>q</var> is normalized.
4882 </p>
4883 <p><var>P</var> can be a vector4f, a point4f or a f32vector
4884 (only first three elements are used).
4885 Returns the same type of object as <var>p</var>.
4886 </p></dd></dl>
4887
4888 <dl>
4889 <dt><a name="index-quatf_002dnorm"></a><u>Function:</u> <b>quatf-norm</b><i> q</i></dt>
4890 <dd><p>Returns norm of <var>q</var>.
4891 </p></dd></dl>
4892
4893 <dl>
4894 <dt><a name="index-quatf_002dnormalize"></a><u>Function:</u> <b>quatf-normalize</b><i> q</i></dt>
4895 <dt><a name="index-quatf_002dnormalize_0021"></a><u>Function:</u> <b>quatf-normalize!</b><i> q</i></dt>
4896 <dd><p>Returns normalized quaternion of <var>q</var>.
4897 The destructive version modifies <var>q</var>.
4898 </p></dd></dl>
4899
4900 <dl>
4901 <dt><a name="index-quatf_002d_003ematrix4f"></a><u>Function:</u> <b>quatf-&gt;matrix4f</b><i> q</i></dt>
4902 <dt><a name="index-quatf_002d_003ematrix4f_0021"></a><u>Function:</u> <b>quatf-&gt;matrix4f!</b><i> m q</i></dt>
4903 <dd><p>Returns a matrix that represents a rotation specified by a unit
4904 quaternion <var>q</var>.
4905 The behavior is undefined if <var>q</var> is not normalized.
4906 The destructive version modifies <var>m</var>.
4907 </p></dd></dl>
4908
4909 <dl>
4910 <dt><a name="index-matrix4f_002d_003equatf"></a><u>Function:</u> <b>matrix4f-&gt;quatf</b><i> m</i></dt>
4911 <dt><a name="index-matrix4f_002d_003equatf_0021"></a><u>Function:</u> <b>matrix4f-&gt;quatf!</b><i> q m</i></dt>
4912 <dd><p>Extracts the rotation component of a matrix <var>m</var> and
4913 returns a quaterion that represents the rotation.
4914 <code>Matrix4f-&gt;quatf!</code> also uses <var>q</var> as the storage
4915 to store the result.
4916 </p></dd></dl>
4917
4918 <dl>
4919 <dt><a name="index-quatf_002dslerp"></a><u>Function:</u> <b>quatf-slerp</b><i> p q t</i></dt>
4920 <dt><a name="index-quatf_002dslerp_0021"></a><u>Function:</u> <b>quatf-slerp!</b><i> r p q t</i></dt>
4921 <dd><p>Returns a quaternion that interpolates between two
4922 unit quaternions <var>p</var> and <var>q</var>, by a scalar value <var>t</var>.
4923 The destructive version modifies <var>r</var>.
4924 </p></dd></dl>
4925
4926 <hr size="6">
4927 <a name="Simple-utilities"></a>
4928 <table cellpadding="1" cellspacing="1" border="0">
4929 <tr><td valign="middle" align="left">[<a href="#Quaternions" title="Previous section in reading order"> &lt; </a>]</td>
4930 <td valign="middle" align="left">[<a href="#Simple-image-handling" title="Next section in reading order"> &gt; </a>]</td>
4931 <td valign="middle" align="left"> &nbsp; </td>
4932 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
4933 <td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
4934 <td valign="middle" align="left">[<a href="#Indices" title="Next chapter"> &gt;&gt; </a>]</td>
4935 <td valign="middle" align="left"> &nbsp; </td>
4936 <td valign="middle" align="left"> &nbsp; </td>
4937 <td valign="middle" align="left"> &nbsp; </td>
4938 <td valign="middle" align="left"> &nbsp; </td>
4939 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
4940 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
4941 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
4942 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
4943 </tr></table>
4944 <a name="Simple-utilities-1"></a>
4945 <h1 class="chapter">7. Simple utilities</h1>
4946
4947 <p>This chapter covers <code>gl.simple.*</code> modules. They are
4948 provided for the convenience of those who wants quick experiment
4949 with Gauche-gl alone, without a hassle to install a bunch of
4950 other modules. Their features are pretty limited, but you
4951 may find them handy when you need to hack up some throwaway
4952 script that need to show some graphics on the screen.
4953 </p>
4954 <table class="menu" border="0" cellspacing="0">
4955 <tr><td align="left" valign="top"><a href="#Simple-image-handling">7.1 Simple image handling</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
4956 </td></tr>
4957 <tr><td align="left" valign="top"><a href="#Simple-viewer">7.2 Simple viewer</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
4958 </td></tr>
4959 </table>
4960
4961 <hr size="6">
4962 <a name="Simple-image-handling"></a>
4963 <table cellpadding="1" cellspacing="1" border="0">
4964 <tr><td valign="middle" align="left">[<a href="#Simple-utilities" title="Previous section in reading order"> &lt; </a>]</td>
4965 <td valign="middle" align="left">[<a href="#Simple-viewer" title="Next section in reading order"> &gt; </a>]</td>
4966 <td valign="middle" align="left"> &nbsp; </td>
4967 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
4968 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Up section"> Up </a>]</td>
4969 <td valign="middle" align="left">[<a href="#Indices" title="Next chapter"> &gt;&gt; </a>]</td>
4970 <td valign="middle" align="left"> &nbsp; </td>
4971 <td valign="middle" align="left"> &nbsp; </td>
4972 <td valign="middle" align="left"> &nbsp; </td>
4973 <td valign="middle" align="left"> &nbsp; </td>
4974 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
4975 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
4976 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
4977 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
4978 </tr></table>
4979 <a name="Simple-image-handling-1"></a>
4980 <h2 class="section">7.1 Simple image handling</h2>
4981
4982 <dl>
4983 <dt><a name="index-gl_002esimple_002eimage"></a><u>Module:</u> <b>gl.simple.image</b></dt>
4984 <dd><a name="index-gl_002esimple_002eimage-1"></a>
4985 <p>OpenGL doesn&rsquo;t provide any means of reading/writing image data, and
4986 it should be covered by other Gauche extensions. However,
4987 it is sometimes handy to have simple means to handle external
4988 image data, so that you can do some experiment with Gauche-gl alone.
4989 </p>
4990 <p>This module provides a minimal support to handle external image
4991 data, so that one can do some experiment in Gauche-gl alone.
4992 </p>
4993 <p>The functionality might be extended over time, but this is never
4994 intended to be a full featured image library. A separate Gauche
4995 extension should be a better place to have it.
4996 </p></dd></dl>
4997
4998 <p>Currently, only reading from 8bit SGI image file is supported.
4999 It is written in pure Scheme, so don&rsquo;t expect the performance.
5000 </p>
5001 <dl>
5002 <dt><a name="index-read_002dsgi_002dimage"></a><u>Function:</u> <b>read-sgi-image</b><i> filename</i></dt>
5003 <dt><a name="index-read_002dsgi_002dimage_002dfrom_002dport"></a><u>Function:</u> <b>read-sgi-image-from-port</b><i> port</i></dt>
5004 <dd><p>Reads an image data in SGI format from the named file or the input port,
5005 respectively.
5006 </p>
5007 <p>Only 8bit-per-channel, direct color mode is supported.
5008 </p>
5009 <p>Returns four values: the image&rsquo;s width in pixels, its height in pixels,
5010 number of channels (e.g. 1 for grayscale, 3 for RGB, 4 for RGBA),
5011 and the image data in u8vector. The pixel data is packed, i.e. there&rsquo;s
5012 no padding between each pixel nor each scanline.
5013 </p>
5014 <p>Warning: be careful to call this function interactively. The
5015 image data vector is usually huge, and you have to wait long
5016 for the REPL to display the entire result.
5017 </p></dd></dl>
5018
5019 <hr size="6">
5020 <a name="Simple-viewer"></a>
5021 <table cellpadding="1" cellspacing="1" border="0">
5022 <tr><td valign="middle" align="left">[<a href="#Simple-image-handling" title="Previous section in reading order"> &lt; </a>]</td>
5023 <td valign="middle" align="left">[<a href="#Indices" title="Next section in reading order"> &gt; </a>]</td>
5024 <td valign="middle" align="left"> &nbsp; </td>
5025 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
5026 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Up section"> Up </a>]</td>
5027 <td valign="middle" align="left">[<a href="#Indices" title="Next chapter"> &gt;&gt; </a>]</td>
5028 <td valign="middle" align="left"> &nbsp; </td>
5029 <td valign="middle" align="left"> &nbsp; </td>
5030 <td valign="middle" align="left"> &nbsp; </td>
5031 <td valign="middle" align="left"> &nbsp; </td>
5032 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
5033 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
5034 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
5035 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
5036 </tr></table>
5037 <a name="Simple-viewer-1"></a>
5038 <h2 class="section">7.2 Simple viewer</h2>
5039
5040 <dl>
5041 <dt><a name="index-gl_002esimple_002eviewer"></a><u>Module:</u> <b>gl.simple.viewer</b></dt>
5042 <dd><a name="index-gl_002esimple_002eviewer-1"></a>
5043 <p>This module packages common operations to allow users to
5044 view 3D objects, controlling the camera by the mouse,
5045 and have some interactions with the keyboard.
5046 </p>
5047 <p>A typical way of using the viewer is like the following:
5048 </p>
5049 <table><tr><td>&nbsp;</td><td><pre class="example">(use gl)
5050 (use gl.glut)
5051 (use gl.simple.viewer)
5052
5053 (define (main args)
5054 (glut-init args)
5055 (simple-viewer-display &lt;your-display-thunk&gt;)
5056 (simple-viewer-set-key! &lt;key&gt; &lt;handler&gt; ...)
5057 (simple-viewer-window &lt;name&gt; :title &lt;title&gt; ...)
5058 (simple-viewer-run) ; loop forever. type ESC to exit.
5059 0)
5060 </pre></td></tr></table>
5061
5062 <p>The viewer handles mouse drag (to move the camera),
5063 and also draws reference grid and axes by default for
5064 your convenience. You have to provide a thunk, which
5065 must draw your 3D object.
5066 </p>
5067 <p>For the keyboard events, you can use a convenient API
5068 to associate handler to the key (character for normal keys,
5069 and constants like <code>GL_LEFT_ARROW</code> for special keys).
5070 </p>
5071 <p>The reshape event is handled implicitly, though you can
5072 override it.
5073 </p>
5074 <p>If you call <code>simple-viewer-run</code>, it enters the event
5075 loop and never returns. If you wish to keep REPL and/or
5076 other parts of your application run concurrently,
5077 the convenient way is to run <code>simple-viewer-run</code>
5078 in a separate thread.
5079 </p>
5080 <table><tr><td>&nbsp;</td><td><pre class="example">(use gauche.threads)
5081
5082 (define (run-viewer)
5083 (thread-start! (make-thread simple-viewer-run #f)))
5084 </pre></td></tr></table>
5085
5086 <p>See also the code under &lsquo;<tt>examples/simple</tt>&rsquo; directory
5087 of the source tree for more examples.
5088 </p></dd></dl>
5089
5090 <dl>
5091 <dt><a name="index-simple_002dviewer_002dwindow"></a><u>Function:</u> <b>simple-viewer-window</b><i> name &amp;key title mode parent width height x y</i></dt>
5092 <dd><p>Creates a new GL window with <var>name</var>, which must be a symbol
5093 to identify the window later in the simple viewer framework.
5094 The window won&rsquo;t be shown until <code>simple-viewer-run</code> is called.
5095 </p>
5096 <p>Each window
5097 </p></dd></dl>
5098
5099
5100 <dl>
5101 <dt><a name="index-simple_002dviewer_002ddisplay"></a><u>Function:</u> <b>simple-viewer-display</b><i> &amp;optional display-thunk</i></dt>
5102 <dd><p>Gets/sets the display thunk, which is called every time
5103 the GL window is redrawn. You can change the display thunk
5104 any time, even while the viewer thread is running.
5105 </p>
5106 <p>If no argument is given, returns the current display thunk.
5107 It can be <code>#f</code> if no display thunk is set.
5108 </p>
5109 <p>When the display thunk is called, the matrix mode is
5110 <code>MODELVIEW</code> and the camera transformation is already applied.
5111 The grid and axes are also drawn, unless you&rsquo;ve customized them.
5112 </p>
5113 <p>In the display thunk you can just write your model in the
5114 world coordinate system. It is guaranteed that
5115 the current color is white and line width is 1.0, but
5116 the states of other GL contexts are undefined,
5117 so you have to set them explicitly.
5118 </p></dd></dl>
5119
5120 <dl>
5121 <dt><a name="index-simple_002dviewer_002dreshape"></a><u>Function:</u> <b>simple-viewer-reshape</b><i> &amp;optional reshape-proc</i></dt>
5122 <dd><p>Gets/sets the reshape procedure which is called every
5123 time the GL window configuration is changed. (It is
5124 also called when the GL window is shown first time.)
5125 You can change the reshape procedure any time,
5126 even while the viewer thread is running.
5127 </p>
5128 <p>If no argument is given, returns the current reshape proc.
5129 </p>
5130 <p>A reshape procedure is called with two arguments,
5131 the width and the height (in pixels) of the new GL
5132 window configuration. By default, <code>gl.simple.viewer</code>
5133 sets a procedure that changes viewport and
5134 projection matrix apopropriately; you need to change
5135 it only if you want a different behavior.
5136 </p></dd></dl>
5137
5138 <dl>
5139 <dt><a name="index-simple_002dviewer_002dgrid"></a><u>Function:</u> <b>simple-viewer-grid</b><i> &amp;optional grid-proc</i></dt>
5140 <dt><a name="index-simple_002dviewer_002daxis"></a><u>Function:</u> <b>simple-viewer-axis</b><i> &amp;optional axis-proc</i></dt>
5141 <dd><p>Gets/sets a procedure to draw a grid and axes.
5142 You can change these procedures
5143 any time, even while the viewer thread is running.
5144 </p>
5145 <p>The <var>grid-proc</var> and <var>axis-proc</var> are called with no arguments
5146 every time the GL window is redrawn, before the display thunk
5147 is invoked.
5148 The matrix mode is <code>MODELVIEW</code>, the camera transformation
5149 is already applied, and lighting is disabled.
5150 </p>
5151 <p>The default grid proc draws 10x10 grid
5152 on X-Z plane centered at the origin. The default axis proc
5153 draws a red line from origin to +X, a green line from origin to +Y,
5154 and a blue line from origin to +Z.
5155 </p>
5156 <p>You can pass <code>#f</code> to disable grid and/or axis display.
5157 </p>
5158 <p>If no argument is given, returns the current grid/axis proc,
5159 respectively.
5160 </p></dd></dl>
5161
5162 <dl>
5163 <dt><a name="index-simple_002dviewer_002dset_002dkey_0021"></a><u>Function:</u> <b>simple-viewer-set-key!</b><i> key handler &hellip;</i></dt>
5164 <dd><p>Even number of arguments must be given; the first of
5165 every two specifies the key, and the next one
5166 specifies the action when the key is pressed.
5167 </p></dd></dl>
5168
5169
5170
5171
5172
5173 <hr size="6">
5174 <a name="Indices"></a>
5175 <table cellpadding="1" cellspacing="1" border="0">
5176 <tr><td valign="middle" align="left">[<a href="#Simple-viewer" title="Previous section in reading order"> &lt; </a>]</td>
5177 <td valign="middle" align="left">[<a href="#Function-and-Syntax-Index" title="Next section in reading order"> &gt; </a>]</td>
5178 <td valign="middle" align="left"> &nbsp; </td>
5179 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
5180 <td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
5181 <td valign="middle" align="left">[ &gt;&gt; ]</td>
5182 <td valign="middle" align="left"> &nbsp; </td>
5183 <td valign="middle" align="left"> &nbsp; </td>
5184 <td valign="middle" align="left"> &nbsp; </td>
5185 <td valign="middle" align="left"> &nbsp; </td>
5186 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
5187 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
5188 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
5189 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
5190 </tr></table>
5191 <a name="Indices-1"></a>
5192 <h1 class="appendix">A. Indices</h1>
5193
5194 <table class="menu" border="0" cellspacing="0">
5195 <tr><td align="left" valign="top"><a href="#Function-and-Syntax-Index">A.1 Function and Syntax Index</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
5196 </td></tr>
5197 <tr><td align="left" valign="top"><a href="#Module-Index">A.2 Module Index</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
5198 </td></tr>
5199 <tr><td align="left" valign="top"><a href="#Class-Index">A.3 Class Index</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
5200 </td></tr>
5201 <tr><td align="left" valign="top"><a href="#Variable-Index">A.4 Variable Index</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
5202 </td></tr>
5203 </table>
5204
5205 <hr size="6">
5206 <a name="Function-and-Syntax-Index"></a>
5207 <table cellpadding="1" cellspacing="1" border="0">
5208 <tr><td valign="middle" align="left">[<a href="#Indices" title="Previous section in reading order"> &lt; </a>]</td>
5209 <td valign="middle" align="left">[<a href="#Module-Index" title="Next section in reading order"> &gt; </a>]</td>
5210 <td valign="middle" align="left"> &nbsp; </td>
5211 <td valign="middle" align="left">[<a href="#Indices" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
5212 <td valign="middle" align="left">[<a href="#Indices" title="Up section"> Up </a>]</td>
5213 <td valign="middle" align="left">[ &gt;&gt; ]</td>
5214 <td valign="middle" align="left"> &nbsp; </td>
5215 <td valign="middle" align="left"> &nbsp; </td>
5216 <td valign="middle" align="left"> &nbsp; </td>
5217 <td valign="middle" align="left"> &nbsp; </td>
5218 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
5219 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
5220 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
5221 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
5222 </tr></table>
5223 <a name="Function-and-Syntax-Index-1"></a>
5224 <h2 class="appendixsec">A.1 Function and Syntax Index</h2>
5225 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#Function-and-Syntax-Index-1_fn_letter-A" class="summary-letter"><b>A</b></a>
5226 &nbsp;
5227 <a href="#Function-and-Syntax-Index-1_fn_letter-E" class="summary-letter"><b>E</b></a>
5228 &nbsp;
5229 <a href="#Function-and-Syntax-Index-1_fn_letter-F" class="summary-letter"><b>F</b></a>
5230 &nbsp;
5231 <a href="#Function-and-Syntax-Index-1_fn_letter-G" class="summary-letter"><b>G</b></a>
5232 &nbsp;
5233 <a href="#Function-and-Syntax-Index-1_fn_letter-L" class="summary-letter"><b>L</b></a>
5234 &nbsp;
5235 <a href="#Function-and-Syntax-Index-1_fn_letter-M" class="summary-letter"><b>M</b></a>
5236 &nbsp;
5237 <a href="#Function-and-Syntax-Index-1_fn_letter-P" class="summary-letter"><b>P</b></a>
5238 &nbsp;
5239 <a href="#Function-and-Syntax-Index-1_fn_letter-Q" class="summary-letter"><b>Q</b></a>
5240 &nbsp;
5241 <a href="#Function-and-Syntax-Index-1_fn_letter-R" class="summary-letter"><b>R</b></a>
5242 &nbsp;
5243 <a href="#Function-and-Syntax-Index-1_fn_letter-S" class="summary-letter"><b>S</b></a>
5244 &nbsp;
5245 <a href="#Function-and-Syntax-Index-1_fn_letter-T" class="summary-letter"><b>T</b></a>
5246 &nbsp;
5247 <a href="#Function-and-Syntax-Index-1_fn_letter-V" class="summary-letter"><b>V</b></a>
5248 &nbsp;
5249 </td></tr></table>
5250 <table border="0" class="index-fn">
5251 <tr><td></td><th align="left">Index Entry</th><th align="left"> Section</th></tr>
5252 <tr><td colspan="3"> <hr></td></tr>
5253 <tr><th><a name="Function-and-Syntax-Index-1_fn_letter-A">A</a></th><td></td><td></td></tr>
5254 <tr><td></td><td valign="top"><a href="#index-axes_002d_003equatf"><code>axes-&gt;quatf</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5255 <tr><td></td><td valign="top"><a href="#index-axes_002d_003equatf_0021"><code>axes-&gt;quatf!</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5256 <tr><td colspan="3"> <hr></td></tr>
5257 <tr><th><a name="Function-and-Syntax-Index-1_fn_letter-E">E</a></th><td></td><td></td></tr>
5258 <tr><td></td><td valign="top"><a href="#index-euler_002dangle_002d_003ematrix4f"><code>euler-angle-&gt;matrix4f</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5259 <tr><td></td><td valign="top"><a href="#index-euler_002dangle_002d_003ematrix4f_0021"><code>euler-angle-&gt;matrix4f!</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5260 <tr><td colspan="3"> <hr></td></tr>
5261 <tr><th><a name="Function-and-Syntax-Index-1_fn_letter-F">F</a></th><td></td><td></td></tr>
5262 <tr><td></td><td valign="top"><a href="#index-f32vector_002d_003ematrix4f"><code>f32vector-&gt;matrix4f</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5263 <tr><td></td><td valign="top"><a href="#index-f32vector_002d_003ematrix4f_0021"><code>f32vector-&gt;matrix4f!</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5264 <tr><td></td><td valign="top"><a href="#index-f32vector_002d_003epoint4f"><code>f32vector-&gt;point4f</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5265 <tr><td></td><td valign="top"><a href="#index-f32vector_002d_003epoint4f_002darray"><code>f32vector-&gt;point4f-array</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5266 <tr><td></td><td valign="top"><a href="#index-f32vector_002d_003epoint4f_002darray_002fshared"><code>f32vector-&gt;point4f-array/shared</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5267 <tr><td></td><td valign="top"><a href="#index-f32vector_002d_003equatf"><code>f32vector-&gt;quatf</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5268 <tr><td></td><td valign="top"><a href="#index-f32vector_002d_003evector4f"><code>f32vector-&gt;vector4f</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5269 <tr><td></td><td valign="top"><a href="#index-f32vector_002d_003evector4f_002darray"><code>f32vector-&gt;vector4f-array</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5270 <tr><td></td><td valign="top"><a href="#index-f32vector_002d_003evector4f_002darray_002fshared"><code>f32vector-&gt;vector4f-array/shared</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5271 <tr><td colspan="3"> <hr></td></tr>
5272 <tr><th><a name="Function-and-Syntax-Index-1_fn_letter-G">G</a></th><td></td><td></td></tr>
5273 <tr><td></td><td valign="top"><a href="#index-gl_002daccum"><code>gl-accum</code></a></td><td valign="top"><a href="#Testing-and-operating-on-fragments">Testing and operating on fragments</a></td></tr>
5274 <tr><td></td><td valign="top"><a href="#index-gl_002dactive_002dtexture_002darb"><code>gl-active-texture-arb</code></a></td><td valign="top"><a href="#Multitexturing">Multitexturing</a></td></tr>
5275 <tr><td></td><td valign="top"><a href="#index-gl_002dalpha_002dfunc"><code>gl-alpha-func</code></a></td><td valign="top"><a href="#Testing-and-operating-on-fragments">Testing and operating on fragments</a></td></tr>
5276 <tr><td></td><td valign="top"><a href="#index-gl_002dare_002dtextures_002dresident_0021"><code>gl-are-textures-resident!</code></a></td><td valign="top"><a href="#Texture-objects">Texture objects</a></td></tr>
5277 <tr><td></td><td valign="top"><a href="#index-gl_002darray_002delement"><code>gl-array-element</code></a></td><td valign="top"><a href="#Vertex-arrays">4.8 Vertex arrays</a></td></tr>
5278 <tr><td></td><td valign="top"><a href="#index-gl_002dattach_002dobject_002darb"><code>gl-attach-object-arb</code></a></td><td valign="top"><a href="#Shader-objects">Shader objects</a></td></tr>
5279 <tr><td></td><td valign="top"><a href="#index-gl_002dbegin"><code>gl-begin</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
5280 <tr><td></td><td valign="top"><a href="#index-gl_002dbegin_002a"><code>gl-begin*</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
5281 <tr><td></td><td valign="top"><a href="#index-gl_002dbind_002dattrib_002dlocation_002darb"><code>gl-bind-attrib-location-arb</code></a></td><td valign="top"><a href="#Specifying-vertex-attributes">Specifying vertex attributes</a></td></tr>
5282 <tr><td></td><td valign="top"><a href="#index-gl_002dbind_002dprogram_002darb"><code>gl-bind-program-arb</code></a></td><td valign="top"><a href="#Vertex-and-fragment-programs">Vertex and fragment programs</a></td></tr>
5283 <tr><td></td><td valign="top"><a href="#index-gl_002dbind_002dtexture"><code>gl-bind-texture</code></a></td><td valign="top"><a href="#Texture-objects">Texture objects</a></td></tr>
5284 <tr><td></td><td valign="top"><a href="#index-gl_002dbitmap"><code>gl-bitmap</code></a></td><td valign="top"><a href="#Pixel-operations">Pixel operations</a></td></tr>
5285 <tr><td></td><td valign="top"><a href="#index-gl_002dblend_002dcolor"><code>gl-blend-color</code></a></td><td valign="top"><a href="#GL-states-for-drawing">4.5 GL states for drawing</a></td></tr>
5286 <tr><td></td><td valign="top"><a href="#index-gl_002dblend_002dequation"><code>gl-blend-equation</code></a></td><td valign="top"><a href="#GL-states-for-drawing">4.5 GL states for drawing</a></td></tr>
5287 <tr><td></td><td valign="top"><a href="#index-gl_002dblend_002dfunc"><code>gl-blend-func</code></a></td><td valign="top"><a href="#GL-states-for-drawing">4.5 GL states for drawing</a></td></tr>
5288 <tr><td></td><td valign="top"><a href="#index-gl_002dboolean_002dvector"><code>gl-boolean-vector</code></a></td><td valign="top"><a href="#GL-boolean-vectors">GL boolean vectors</a></td></tr>
5289 <tr><td></td><td valign="top"><a href="#index-gl_002dboolean_002dvector_002dcopy"><code>gl-boolean-vector-copy</code></a></td><td valign="top"><a href="#GL-boolean-vectors">GL boolean vectors</a></td></tr>
5290 <tr><td></td><td valign="top"><a href="#index-gl_002dboolean_002dvector_002dfill_0021"><code>gl-boolean-vector-fill!</code></a></td><td valign="top"><a href="#GL-boolean-vectors">GL boolean vectors</a></td></tr>
5291 <tr><td></td><td valign="top"><a href="#index-gl_002dboolean_002dvector_002dlength"><code>gl-boolean-vector-length</code></a></td><td valign="top"><a href="#GL-boolean-vectors">GL boolean vectors</a></td></tr>
5292 <tr><td></td><td valign="top"><a href="#index-gl_002dboolean_002dvector_002dref"><code>gl-boolean-vector-ref</code></a></td><td valign="top"><a href="#GL-boolean-vectors">GL boolean vectors</a></td></tr>
5293 <tr><td></td><td valign="top"><a href="#index-gl_002dboolean_002dvector_002dset_0021"><code>gl-boolean-vector-set!</code></a></td><td valign="top"><a href="#GL-boolean-vectors">GL boolean vectors</a></td></tr>
5294 <tr><td></td><td valign="top"><a href="#index-gl_002dboolean_002dvector_003f"><code>gl-boolean-vector?</code></a></td><td valign="top"><a href="#GL-boolean-vectors">GL boolean vectors</a></td></tr>
5295 <tr><td></td><td valign="top"><a href="#index-gl_002dcall_002dlist"><code>gl-call-list</code></a></td><td valign="top"><a href="#Display-lists">4.7 Display lists</a></td></tr>
5296 <tr><td></td><td valign="top"><a href="#index-gl_002dcall_002dlists"><code>gl-call-lists</code></a></td><td valign="top"><a href="#Display-lists">4.7 Display lists</a></td></tr>
5297 <tr><td></td><td valign="top"><a href="#index-gl_002dcall_002dlists-1"><code>gl-call-lists</code></a></td><td valign="top"><a href="#Display-lists">4.7 Display lists</a></td></tr>
5298 <tr><td></td><td valign="top"><a href="#index-gl_002dcall_002dlists-2"><code>gl-call-lists</code></a></td><td valign="top"><a href="#Display-lists">4.7 Display lists</a></td></tr>
5299 <tr><td></td><td valign="top"><a href="#index-gl_002dclear"><code>gl-clear</code></a></td><td valign="top"><a href="#Clearing-buffers">Clearing buffers</a></td></tr>
5300 <tr><td></td><td valign="top"><a href="#index-gl_002dclear_002daccum"><code>gl-clear-accum</code></a></td><td valign="top"><a href="#Clearing-buffers">Clearing buffers</a></td></tr>
5301 <tr><td></td><td valign="top"><a href="#index-gl_002dclear_002dcolor"><code>gl-clear-color</code></a></td><td valign="top"><a href="#Clearing-buffers">Clearing buffers</a></td></tr>
5302 <tr><td></td><td valign="top"><a href="#index-gl_002dclear_002ddepth"><code>gl-clear-depth</code></a></td><td valign="top"><a href="#Clearing-buffers">Clearing buffers</a></td></tr>
5303 <tr><td></td><td valign="top"><a href="#index-gl_002dclear_002dindex"><code>gl-clear-index</code></a></td><td valign="top"><a href="#Clearing-buffers">Clearing buffers</a></td></tr>
5304 <tr><td></td><td valign="top"><a href="#index-gl_002dclear_002dstencil"><code>gl-clear-stencil</code></a></td><td valign="top"><a href="#Clearing-buffers">Clearing buffers</a></td></tr>
5305 <tr><td></td><td valign="top"><a href="#index-gl_002dclient_002dactive_002dtexture_002darb"><code>gl-client-active-texture-arb</code></a></td><td valign="top"><a href="#Multitexturing">Multitexturing</a></td></tr>
5306 <tr><td></td><td valign="top"><a href="#index-gl_002dclip_002dplane"><code>gl-clip-plane</code></a></td><td valign="top"><a href="#GL-states-for-drawing">4.5 GL states for drawing</a></td></tr>
5307 <tr><td></td><td valign="top"><a href="#index-gl_002dcolor"><code>gl-color</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
5308 <tr><td></td><td valign="top"><a href="#index-gl_002dcolor-1"><code>gl-color</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
5309 <tr><td></td><td valign="top"><a href="#index-gl_002dcolor_002dmask"><code>gl-color-mask</code></a></td><td valign="top"><a href="#Masking-buffers">Masking buffers</a></td></tr>
5310 <tr><td></td><td valign="top"><a href="#index-gl_002dcolor_002dmaterial"><code>gl-color-material</code></a></td><td valign="top"><a href="#Lighting">4.9 Lighting</a></td></tr>
5311 <tr><td></td><td valign="top"><a href="#index-gl_002dcolor_002dpointer"><code>gl-color-pointer</code></a></td><td valign="top"><a href="#Vertex-arrays">4.8 Vertex arrays</a></td></tr>
5312 <tr><td></td><td valign="top"><a href="#index-gl_002dcolor_002dsub_002dtable"><code>gl-color-sub-table</code></a></td><td valign="top"><a href="#Color-tables">Color tables</a></td></tr>
5313 <tr><td></td><td valign="top"><a href="#index-gl_002dcolor_002dtable"><code>gl-color-table</code></a></td><td valign="top"><a href="#Color-tables">Color tables</a></td></tr>
5314 <tr><td></td><td valign="top"><a href="#index-gl_002dcolor_002dtable_002dparameter"><code>gl-color-table-parameter</code></a></td><td valign="top"><a href="#Color-tables">Color tables</a></td></tr>
5315 <tr><td></td><td valign="top"><a href="#index-gl_002dcompile_002dshader_002darb"><code>gl-compile-shader-arb</code></a></td><td valign="top"><a href="#Shader-objects">Shader objects</a></td></tr>
5316 <tr><td></td><td valign="top"><a href="#index-gl_002dconvolution_002dfilter_002d1d"><code>gl-convolution-filter-1d</code></a></td><td valign="top"><a href="#Convolutions">Convolutions</a></td></tr>
5317 <tr><td></td><td valign="top"><a href="#index-gl_002dconvolution_002dfilter_002d2d"><code>gl-convolution-filter-2d</code></a></td><td valign="top"><a href="#Convolutions">Convolutions</a></td></tr>
5318 <tr><td></td><td valign="top"><a href="#index-gl_002dconvolution_002dparameter"><code>gl-convolution-parameter</code></a></td><td valign="top"><a href="#Convolutions">Convolutions</a></td></tr>
5319 <tr><td></td><td valign="top"><a href="#index-gl_002dcopy_002dcolor_002dsub_002dtable"><code>gl-copy-color-sub-table</code></a></td><td valign="top"><a href="#Color-tables">Color tables</a></td></tr>
5320 <tr><td></td><td valign="top"><a href="#index-gl_002dcopy_002dcolor_002dtable"><code>gl-copy-color-table</code></a></td><td valign="top"><a href="#Color-tables">Color tables</a></td></tr>
5321 <tr><td></td><td valign="top"><a href="#index-gl_002dcopy_002dconvolution_002dfilter_002d1d"><code>gl-copy-convolution-filter-1d</code></a></td><td valign="top"><a href="#Convolutions">Convolutions</a></td></tr>
5322 <tr><td></td><td valign="top"><a href="#index-gl_002dcopy_002dconvolution_002dfilter_002d2d"><code>gl-copy-convolution-filter-2d</code></a></td><td valign="top"><a href="#Convolutions">Convolutions</a></td></tr>
5323 <tr><td></td><td valign="top"><a href="#index-gl_002dcopy_002dpixels"><code>gl-copy-pixels</code></a></td><td valign="top"><a href="#Pixel-operations">Pixel operations</a></td></tr>
5324 <tr><td></td><td valign="top"><a href="#index-gl_002dcopy_002dtex_002dimage_002d1d"><code>gl-copy-tex-image-1d</code></a></td><td valign="top"><a href="#Defining-textures">Defining textures</a></td></tr>
5325 <tr><td></td><td valign="top"><a href="#index-gl_002dcopy_002dtex_002dimage_002d2d"><code>gl-copy-tex-image-2d</code></a></td><td valign="top"><a href="#Defining-textures">Defining textures</a></td></tr>
5326 <tr><td></td><td valign="top"><a href="#index-gl_002dcopy_002dtex_002dsub_002dimage_002d1d"><code>gl-copy-tex-sub-image-1d</code></a></td><td valign="top"><a href="#Defining-textures">Defining textures</a></td></tr>
5327 <tr><td></td><td valign="top"><a href="#index-gl_002dcopy_002dtex_002dsub_002dimage_002d2d"><code>gl-copy-tex-sub-image-2d</code></a></td><td valign="top"><a href="#Defining-textures">Defining textures</a></td></tr>
5328 <tr><td></td><td valign="top"><a href="#index-gl_002dcopy_002dtex_002dsub_002dimage_002d3d"><code>gl-copy-tex-sub-image-3d</code></a></td><td valign="top"><a href="#Defining-textures">Defining textures</a></td></tr>
5329 <tr><td></td><td valign="top"><a href="#index-gl_002dcreate_002dprogram_002dobject_002darb"><code>gl-create-program-object-arb</code></a></td><td valign="top"><a href="#Shader-objects">Shader objects</a></td></tr>
5330 <tr><td></td><td valign="top"><a href="#index-gl_002dcreate_002dshader_002dobject_002darb"><code>gl-create-shader-object-arb</code></a></td><td valign="top"><a href="#Shader-objects">Shader objects</a></td></tr>
5331 <tr><td></td><td valign="top"><a href="#index-gl_002dcull_002dface"><code>gl-cull-face</code></a></td><td valign="top"><a href="#GL-states-for-drawing">4.5 GL states for drawing</a></td></tr>
5332 <tr><td></td><td valign="top"><a href="#index-gl_002ddelete_002dlists"><code>gl-delete-lists</code></a></td><td valign="top"><a href="#Display-lists">4.7 Display lists</a></td></tr>
5333 <tr><td></td><td valign="top"><a href="#index-gl_002ddelete_002dobject_002darb"><code>gl-delete-object-arb</code></a></td><td valign="top"><a href="#Shader-objects">Shader objects</a></td></tr>
5334 <tr><td></td><td valign="top"><a href="#index-gl_002ddelete_002dprograms_002darb"><code>gl-delete-programs-arb</code></a></td><td valign="top"><a href="#Vertex-and-fragment-programs">Vertex and fragment programs</a></td></tr>
5335 <tr><td></td><td valign="top"><a href="#index-gl_002ddelete_002dtextures"><code>gl-delete-textures</code></a></td><td valign="top"><a href="#Texture-objects">Texture objects</a></td></tr>
5336 <tr><td></td><td valign="top"><a href="#index-gl_002ddepth_002dfunc"><code>gl-depth-func</code></a></td><td valign="top"><a href="#Testing-and-operating-on-fragments">Testing and operating on fragments</a></td></tr>
5337 <tr><td></td><td valign="top"><a href="#index-gl_002ddepth_002dmask"><code>gl-depth-mask</code></a></td><td valign="top"><a href="#Masking-buffers">Masking buffers</a></td></tr>
5338 <tr><td></td><td valign="top"><a href="#index-gl_002ddepth_002drange"><code>gl-depth-range</code></a></td><td valign="top"><a href="#Testing-and-operating-on-fragments">Testing and operating on fragments</a></td></tr>
5339 <tr><td></td><td valign="top"><a href="#index-gl_002ddetach_002dobject_002darb"><code>gl-detach-object-arb</code></a></td><td valign="top"><a href="#Shader-objects">Shader objects</a></td></tr>
5340 <tr><td></td><td valign="top"><a href="#index-gl_002ddisable"><code>gl-disable</code></a></td><td valign="top"><a href="#Capabilities">Capabilities</a></td></tr>
5341 <tr><td></td><td valign="top"><a href="#index-gl_002ddisable_002dclient_002dstate"><code>gl-disable-client-state</code></a></td><td valign="top"><a href="#Capabilities">Capabilities</a></td></tr>
5342 <tr><td></td><td valign="top"><a href="#index-gl_002ddisable_002dvertex_002dattrib_002darray_002darb"><code>gl-disable-vertex-attrib-array-arb</code></a></td><td valign="top"><a href="#Specifying-vertex-attributes">Specifying vertex attributes</a></td></tr>
5343 <tr><td></td><td valign="top"><a href="#index-gl_002ddraw_002darrays"><code>gl-draw-arrays</code></a></td><td valign="top"><a href="#Vertex-arrays">4.8 Vertex arrays</a></td></tr>
5344 <tr><td></td><td valign="top"><a href="#index-gl_002ddraw_002dbuffer"><code>gl-draw-buffer</code></a></td><td valign="top"><a href="#Selecting-color-buffers">Selecting color buffers</a></td></tr>
5345 <tr><td></td><td valign="top"><a href="#index-gl_002ddraw_002delements"><code>gl-draw-elements</code></a></td><td valign="top"><a href="#Vertex-arrays">4.8 Vertex arrays</a></td></tr>
5346 <tr><td></td><td valign="top"><a href="#index-gl_002ddraw_002dpixels"><code>gl-draw-pixels</code></a></td><td valign="top"><a href="#Pixel-operations">Pixel operations</a></td></tr>
5347 <tr><td></td><td valign="top"><a href="#index-gl_002ddraw_002drange_002delements"><code>gl-draw-range-elements</code></a></td><td valign="top"><a href="#Vertex-arrays">4.8 Vertex arrays</a></td></tr>
5348 <tr><td></td><td valign="top"><a href="#index-gl_002dedge_002dflag"><code>gl-edge-flag</code></a></td><td valign="top"><a href="#GL-states-for-drawing">4.5 GL states for drawing</a></td></tr>
5349 <tr><td></td><td valign="top"><a href="#index-gl_002dedge_002dflag_002dpointer"><code>gl-edge-flag-pointer</code></a></td><td valign="top"><a href="#Vertex-arrays">4.8 Vertex arrays</a></td></tr>
5350 <tr><td></td><td valign="top"><a href="#index-gl_002denable"><code>gl-enable</code></a></td><td valign="top"><a href="#Capabilities">Capabilities</a></td></tr>
5351 <tr><td></td><td valign="top"><a href="#index-gl_002denable_002dclient_002dstate"><code>gl-enable-client-state</code></a></td><td valign="top"><a href="#Capabilities">Capabilities</a></td></tr>
5352 <tr><td></td><td valign="top"><a href="#index-gl_002denable_002dvertex_002dattrib_002darray_002darb"><code>gl-enable-vertex-attrib-array-arb</code></a></td><td valign="top"><a href="#Specifying-vertex-attributes">Specifying vertex attributes</a></td></tr>
5353 <tr><td></td><td valign="top"><a href="#index-gl_002dend"><code>gl-end</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
5354 <tr><td></td><td valign="top"><a href="#index-gl_002dend_002dlist"><code>gl-end-list</code></a></td><td valign="top"><a href="#Display-lists">4.7 Display lists</a></td></tr>
5355 <tr><td></td><td valign="top"><a href="#index-gl_002dextension_002davailable_003f"><code>gl-extension-available?</code></a></td><td valign="top"><a href="#GL-feature-checking">4.2 GL feature checking</a></td></tr>
5356 <tr><td></td><td valign="top"><a href="#index-gl_002dfeedback_002dbuffer"><code>gl-feedback-buffer</code></a></td><td valign="top"><a href="#Selection-and-feedback">4.13 Selection and feedback</a></td></tr>
5357 <tr><td></td><td valign="top"><a href="#index-gl_002dfinish"><code>gl-finish</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
5358 <tr><td></td><td valign="top"><a href="#index-gl_002dflush"><code>gl-flush</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
5359 <tr><td></td><td valign="top"><a href="#index-gl_002dfog"><code>gl-fog</code></a></td><td valign="top"><a href="#GL-states-for-drawing">4.5 GL states for drawing</a></td></tr>
5360 <tr><td></td><td valign="top"><a href="#index-gl_002dfront_002dface"><code>gl-front-face</code></a></td><td valign="top"><a href="#GL-states-for-drawing">4.5 GL states for drawing</a></td></tr>
5361 <tr><td></td><td valign="top"><a href="#index-gl_002dfrustum"><code>gl-frustum</code></a></td><td valign="top"><a href="#Transformation">4.6 Transformation</a></td></tr>
5362 <tr><td></td><td valign="top"><a href="#index-gl_002dgen_002dlists"><code>gl-gen-lists</code></a></td><td valign="top"><a href="#Display-lists">4.7 Display lists</a></td></tr>
5363 <tr><td></td><td valign="top"><a href="#index-gl_002dgen_002dprograms_002darb"><code>gl-gen-programs-arb</code></a></td><td valign="top"><a href="#Vertex-and-fragment-programs">Vertex and fragment programs</a></td></tr>
5364 <tr><td></td><td valign="top"><a href="#index-gl_002dgen_002dtextures"><code>gl-gen-textures</code></a></td><td valign="top"><a href="#Texture-objects">Texture objects</a></td></tr>
5365 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dactive_002dattrib_002darb"><code>gl-get-active-attrib-arb</code></a></td><td valign="top"><a href="#Specifying-vertex-attributes">Specifying vertex attributes</a></td></tr>
5366 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dactive_002duniform_002darb"><code>gl-get-active-uniform-arb</code></a></td><td valign="top"><a href="#Specifying-uniform-variables">Specifying uniform variables</a></td></tr>
5367 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dattached_002dobjects_002darb"><code>gl-get-attached-objects-arb</code></a></td><td valign="top"><a href="#Shader-objects">Shader objects</a></td></tr>
5368 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dattrib_002dlocation_002darb"><code>gl-get-attrib-location-arb</code></a></td><td valign="top"><a href="#Specifying-vertex-attributes">Specifying vertex attributes</a></td></tr>
5369 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dboolean"><code>gl-get-boolean</code></a></td><td valign="top"><a href="#State-values">State values</a></td></tr>
5370 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dboolean_0021"><code>gl-get-boolean!</code></a></td><td valign="top"><a href="#State-values">State values</a></td></tr>
5371 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dclip_002dplane"><code>gl-get-clip-plane</code></a></td><td valign="top"><a href="#GL-states-for-drawing">4.5 GL states for drawing</a></td></tr>
5372 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dcolor_002dtable_0021"><code>gl-get-color-table!</code></a></td><td valign="top"><a href="#Color-tables">Color tables</a></td></tr>
5373 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002ddouble"><code>gl-get-double</code></a></td><td valign="top"><a href="#State-values">State values</a></td></tr>
5374 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002ddouble_0021"><code>gl-get-double!</code></a></td><td valign="top"><a href="#State-values">State values</a></td></tr>
5375 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002derror"><code>gl-get-error</code></a></td><td valign="top"><a href="#Other-queries">Other queries</a></td></tr>
5376 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dfloat"><code>gl-get-float</code></a></td><td valign="top"><a href="#State-values">State values</a></td></tr>
5377 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dfloat_0021"><code>gl-get-float!</code></a></td><td valign="top"><a href="#State-values">State values</a></td></tr>
5378 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dhandle_002darb"><code>gl-get-handle-arb</code></a></td><td valign="top"><a href="#Shader-objects">Shader objects</a></td></tr>
5379 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dhistogram"><code>gl-get-histogram</code></a></td><td valign="top"><a href="#Histogram">Histogram</a></td></tr>
5380 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dhistogram_002dparameter"><code>gl-get-histogram-parameter</code></a></td><td valign="top"><a href="#Histogram">Histogram</a></td></tr>
5381 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dinfo_002dlog_002darb"><code>gl-get-info-log-arb</code></a></td><td valign="top"><a href="#Shader-objects">Shader objects</a></td></tr>
5382 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dinteger"><code>gl-get-integer</code></a></td><td valign="top"><a href="#State-values">State values</a></td></tr>
5383 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dinteger_0021"><code>gl-get-integer!</code></a></td><td valign="top"><a href="#State-values">State values</a></td></tr>
5384 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dlight"><code>gl-get-light</code></a></td><td valign="top"><a href="#Lighting">4.9 Lighting</a></td></tr>
5385 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dmaterial"><code>gl-get-material</code></a></td><td valign="top"><a href="#Lighting">4.9 Lighting</a></td></tr>
5386 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dminmax"><code>gl-get-minmax</code></a></td><td valign="top"><a href="#Minmax">Minmax</a></td></tr>
5387 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dminmax_002dparameter"><code>gl-get-minmax-parameter</code></a></td><td valign="top"><a href="#Minmax">Minmax</a></td></tr>
5388 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dobject_002dparameter_002darb"><code>gl-get-object-parameter-arb</code></a></td><td valign="top"><a href="#Shader-objects">Shader objects</a></td></tr>
5389 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dpixel_002dmap"><code>gl-get-pixel-map</code></a></td><td valign="top"><a href="#Pixel-operations">Pixel operations</a></td></tr>
5390 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dpixel_002dmap_0021"><code>gl-get-pixel-map!</code></a></td><td valign="top"><a href="#Pixel-operations">Pixel operations</a></td></tr>
5391 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dshader_002dsource_002darb"><code>gl-get-shader-source-arb</code></a></td><td valign="top"><a href="#Shader-objects">Shader objects</a></td></tr>
5392 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dstring"><code>gl-get-string</code></a></td><td valign="top"><a href="#Other-queries">Other queries</a></td></tr>
5393 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dtex_002dlevel_002dparameter"><code>gl-get-tex-level-parameter</code></a></td><td valign="top"><a href="#Texture-parameters">Texture parameters</a></td></tr>
5394 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002dtex_002dparameter"><code>gl-get-tex-parameter</code></a></td><td valign="top"><a href="#Texture-parameters">Texture parameters</a></td></tr>
5395 <tr><td></td><td valign="top"><a href="#index-gl_002dget_002duniform_002dlocation_002darb"><code>gl-get-uniform-location-arb</code></a></td><td valign="top"><a href="#Specifying-uniform-variables">Specifying uniform variables</a></td></tr>
5396 <tr><td></td><td valign="top"><a href="#index-gl_002dhint"><code>gl-hint</code></a></td><td valign="top"><a href="#Hints">Hints</a></td></tr>
5397 <tr><td></td><td valign="top"><a href="#index-gl_002dhistogram"><code>gl-histogram</code></a></td><td valign="top"><a href="#Histogram">Histogram</a></td></tr>
5398 <tr><td></td><td valign="top"><a href="#index-gl_002dindex_002dmask"><code>gl-index-mask</code></a></td><td valign="top"><a href="#Masking-buffers">Masking buffers</a></td></tr>
5399 <tr><td></td><td valign="top"><a href="#index-gl_002dindex_002dpointer"><code>gl-index-pointer</code></a></td><td valign="top"><a href="#Vertex-arrays">4.8 Vertex arrays</a></td></tr>
5400 <tr><td></td><td valign="top"><a href="#index-gl_002dinit_002dnames"><code>gl-init-names</code></a></td><td valign="top"><a href="#Selection-and-feedback">4.13 Selection and feedback</a></td></tr>
5401 <tr><td></td><td valign="top"><a href="#index-gl_002dinterleaved_002darrays"><code>gl-interleaved-arrays</code></a></td><td valign="top"><a href="#Vertex-arrays">4.8 Vertex arrays</a></td></tr>
5402 <tr><td></td><td valign="top"><a href="#index-gl_002dis_002denabled"><code>gl-is-enabled</code></a></td><td valign="top"><a href="#Capabilities">Capabilities</a></td></tr>
5403 <tr><td></td><td valign="top"><a href="#index-gl_002dis_002dlist"><code>gl-is-list</code></a></td><td valign="top"><a href="#Display-lists">4.7 Display lists</a></td></tr>
5404 <tr><td></td><td valign="top"><a href="#index-gl_002dis_002dprogram_002darb"><code>gl-is-program-arb</code></a></td><td valign="top"><a href="#Vertex-and-fragment-programs">Vertex and fragment programs</a></td></tr>
5405 <tr><td></td><td valign="top"><a href="#index-gl_002dis_002dtexture"><code>gl-is-texture</code></a></td><td valign="top"><a href="#Texture-objects">Texture objects</a></td></tr>
5406 <tr><td></td><td valign="top"><a href="#index-gl_002dlight"><code>gl-light</code></a></td><td valign="top"><a href="#Lighting">4.9 Lighting</a></td></tr>
5407 <tr><td></td><td valign="top"><a href="#index-gl_002dlight_002dmodel"><code>gl-light-model</code></a></td><td valign="top"><a href="#Lighting">4.9 Lighting</a></td></tr>
5408 <tr><td></td><td valign="top"><a href="#index-gl_002dline_002dstipple"><code>gl-line-stipple</code></a></td><td valign="top"><a href="#GL-states-for-drawing">4.5 GL states for drawing</a></td></tr>
5409 <tr><td></td><td valign="top"><a href="#index-gl_002dline_002dwidth"><code>gl-line-width</code></a></td><td valign="top"><a href="#GL-states-for-drawing">4.5 GL states for drawing</a></td></tr>
5410 <tr><td></td><td valign="top"><a href="#index-gl_002dlink_002dprogram_002darb"><code>gl-link-program-arb</code></a></td><td valign="top"><a href="#Shader-objects">Shader objects</a></td></tr>
5411 <tr><td></td><td valign="top"><a href="#index-gl_002dlist_002dbase"><code>gl-list-base</code></a></td><td valign="top"><a href="#Display-lists">4.7 Display lists</a></td></tr>
5412 <tr><td></td><td valign="top"><a href="#index-gl_002dload_002didentity"><code>gl-load-identity</code></a></td><td valign="top"><a href="#Transformation">4.6 Transformation</a></td></tr>
5413 <tr><td></td><td valign="top"><a href="#index-gl_002dload_002dmatrix"><code>gl-load-matrix</code></a></td><td valign="top"><a href="#Transformation">4.6 Transformation</a></td></tr>
5414 <tr><td></td><td valign="top"><a href="#index-gl_002dload_002dname"><code>gl-load-name</code></a></td><td valign="top"><a href="#Selection-and-feedback">4.13 Selection and feedback</a></td></tr>
5415 <tr><td></td><td valign="top"><a href="#index-gl_002dlogic_002dop"><code>gl-logic-op</code></a></td><td valign="top"><a href="#Testing-and-operating-on-fragments">Testing and operating on fragments</a></td></tr>
5416 <tr><td></td><td valign="top"><a href="#index-gl_002dmaterial"><code>gl-material</code></a></td><td valign="top"><a href="#Lighting">4.9 Lighting</a></td></tr>
5417 <tr><td></td><td valign="top"><a href="#index-gl_002dmatrix_002dmode"><code>gl-matrix-mode</code></a></td><td valign="top"><a href="#Transformation">4.6 Transformation</a></td></tr>
5418 <tr><td></td><td valign="top"><a href="#index-gl_002dminmax"><code>gl-minmax</code></a></td><td valign="top"><a href="#Minmax">Minmax</a></td></tr>
5419 <tr><td></td><td valign="top"><a href="#index-gl_002dmult_002dmatrix"><code>gl-mult-matrix</code></a></td><td valign="top"><a href="#Transformation">4.6 Transformation</a></td></tr>
5420 <tr><td></td><td valign="top"><a href="#index-gl_002dmulti_002dtex_002dcoord_002darb"><code>gl-multi-tex-coord-arb</code></a></td><td valign="top"><a href="#Multitexturing">Multitexturing</a></td></tr>
5421 <tr><td></td><td valign="top"><a href="#index-gl_002dmulti_002dtex_002dcoord_002darb-1"><code>gl-multi-tex-coord-arb</code></a></td><td valign="top"><a href="#Multitexturing">Multitexturing</a></td></tr>
5422 <tr><td></td><td valign="top"><a href="#index-gl_002dnew_002dlist"><code>gl-new-list</code></a></td><td valign="top"><a href="#Display-lists">4.7 Display lists</a></td></tr>
5423 <tr><td></td><td valign="top"><a href="#index-gl_002dnormal"><code>gl-normal</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
5424 <tr><td></td><td valign="top"><a href="#index-gl_002dnormal-1"><code>gl-normal</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
5425 <tr><td></td><td valign="top"><a href="#index-gl_002dnormal_002dpointer"><code>gl-normal-pointer</code></a></td><td valign="top"><a href="#Vertex-arrays">4.8 Vertex arrays</a></td></tr>
5426 <tr><td></td><td valign="top"><a href="#index-gl_002dortho"><code>gl-ortho</code></a></td><td valign="top"><a href="#Transformation">4.6 Transformation</a></td></tr>
5427 <tr><td></td><td valign="top"><a href="#index-gl_002dpass_002dthrough"><code>gl-pass-through</code></a></td><td valign="top"><a href="#Selection-and-feedback">4.13 Selection and feedback</a></td></tr>
5428 <tr><td></td><td valign="top"><a href="#index-gl_002dpixel_002dmap"><code>gl-pixel-map</code></a></td><td valign="top"><a href="#Pixel-operations">Pixel operations</a></td></tr>
5429 <tr><td></td><td valign="top"><a href="#index-gl_002dpixel_002dstore"><code>gl-pixel-store</code></a></td><td valign="top"><a href="#Pixel-operations">Pixel operations</a></td></tr>
5430 <tr><td></td><td valign="top"><a href="#index-gl_002dpixel_002dtransfer"><code>gl-pixel-transfer</code></a></td><td valign="top"><a href="#Pixel-operations">Pixel operations</a></td></tr>
5431 <tr><td></td><td valign="top"><a href="#index-gl_002dpixel_002dzoom"><code>gl-pixel-zoom</code></a></td><td valign="top"><a href="#Pixel-operations">Pixel operations</a></td></tr>
5432 <tr><td></td><td valign="top"><a href="#index-gl_002dpoint_002dsize"><code>gl-point-size</code></a></td><td valign="top"><a href="#GL-states-for-drawing">4.5 GL states for drawing</a></td></tr>
5433 <tr><td></td><td valign="top"><a href="#index-gl_002dpolygon_002dmode"><code>gl-polygon-mode</code></a></td><td valign="top"><a href="#GL-states-for-drawing">4.5 GL states for drawing</a></td></tr>
5434 <tr><td></td><td valign="top"><a href="#index-gl_002dpolygon_002doffset"><code>gl-polygon-offset</code></a></td><td valign="top"><a href="#GL-states-for-drawing">4.5 GL states for drawing</a></td></tr>
5435 <tr><td></td><td valign="top"><a href="#index-gl_002dpolygon_002dstipple"><code>gl-polygon-stipple</code></a></td><td valign="top"><a href="#GL-states-for-drawing">4.5 GL states for drawing</a></td></tr>
5436 <tr><td></td><td valign="top"><a href="#index-gl_002dpop_002dattrib"><code>gl-pop-attrib</code></a></td><td valign="top"><a href="#Push_002fpop-attributes">Push/pop attributes</a></td></tr>
5437 <tr><td></td><td valign="top"><a href="#index-gl_002dpop_002dclient_002dattrib"><code>gl-pop-client-attrib</code></a></td><td valign="top"><a href="#Push_002fpop-attributes">Push/pop attributes</a></td></tr>
5438 <tr><td></td><td valign="top"><a href="#index-gl_002dpop_002dmatrix"><code>gl-pop-matrix</code></a></td><td valign="top"><a href="#Transformation">4.6 Transformation</a></td></tr>
5439 <tr><td></td><td valign="top"><a href="#index-gl_002dpop_002dname"><code>gl-pop-name</code></a></td><td valign="top"><a href="#Selection-and-feedback">4.13 Selection and feedback</a></td></tr>
5440 <tr><td></td><td valign="top"><a href="#index-gl_002dprioritize_002dtextures"><code>gl-prioritize-textures</code></a></td><td valign="top"><a href="#Texture-objects">Texture objects</a></td></tr>
5441 <tr><td></td><td valign="top"><a href="#index-gl_002dprogram_002denv_002dparameter_002darb"><code>gl-program-env-parameter-arb</code></a></td><td valign="top"><a href="#Vertex-and-fragment-programs">Vertex and fragment programs</a></td></tr>
5442 <tr><td></td><td valign="top"><a href="#index-gl_002dprogram_002denv_002dparameter_002darb-1"><code>gl-program-env-parameter-arb</code></a></td><td valign="top"><a href="#Vertex-and-fragment-programs">Vertex and fragment programs</a></td></tr>
5443 <tr><td></td><td valign="top"><a href="#index-gl_002dprogram_002dlocal_002dparameter_002darb"><code>gl-program-local-parameter-arb</code></a></td><td valign="top"><a href="#Vertex-and-fragment-programs">Vertex and fragment programs</a></td></tr>
5444 <tr><td></td><td valign="top"><a href="#index-gl_002dprogram_002dlocal_002dparameter_002darb-1"><code>gl-program-local-parameter-arb</code></a></td><td valign="top"><a href="#Vertex-and-fragment-programs">Vertex and fragment programs</a></td></tr>
5445 <tr><td></td><td valign="top"><a href="#index-gl_002dprogram_002dstring_002darb"><code>gl-program-string-arb</code></a></td><td valign="top"><a href="#Vertex-and-fragment-programs">Vertex and fragment programs</a></td></tr>
5446 <tr><td></td><td valign="top"><a href="#index-gl_002dpush_002dattrib"><code>gl-push-attrib</code></a></td><td valign="top"><a href="#Push_002fpop-attributes">Push/pop attributes</a></td></tr>
5447 <tr><td></td><td valign="top"><a href="#index-gl_002dpush_002dclient_002dattrib"><code>gl-push-client-attrib</code></a></td><td valign="top"><a href="#Push_002fpop-attributes">Push/pop attributes</a></td></tr>
5448 <tr><td></td><td valign="top"><a href="#index-gl_002dpush_002dmatrix"><code>gl-push-matrix</code></a></td><td valign="top"><a href="#Transformation">4.6 Transformation</a></td></tr>
5449 <tr><td></td><td valign="top"><a href="#index-gl_002dpush_002dmatrix_002a"><code>gl-push-matrix*</code></a></td><td valign="top"><a href="#Transformation">4.6 Transformation</a></td></tr>
5450 <tr><td></td><td valign="top"><a href="#index-gl_002dpush_002dname"><code>gl-push-name</code></a></td><td valign="top"><a href="#Selection-and-feedback">4.13 Selection and feedback</a></td></tr>
5451 <tr><td></td><td valign="top"><a href="#index-gl_002draster_002dpos"><code>gl-raster-pos</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
5452 <tr><td></td><td valign="top"><a href="#index-gl_002draster_002dpos-1"><code>gl-raster-pos</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
5453 <tr><td></td><td valign="top"><a href="#index-gl_002dread_002dbuffer"><code>gl-read-buffer</code></a></td><td valign="top"><a href="#Selecting-color-buffers">Selecting color buffers</a></td></tr>
5454 <tr><td></td><td valign="top"><a href="#index-gl_002dread_002dpixels"><code>gl-read-pixels</code></a></td><td valign="top"><a href="#Pixel-operations">Pixel operations</a></td></tr>
5455 <tr><td></td><td valign="top"><a href="#index-gl_002drect"><code>gl-rect</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
5456 <tr><td></td><td valign="top"><a href="#index-gl_002drect-1"><code>gl-rect</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
5457 <tr><td></td><td valign="top"><a href="#index-gl_002drender_002dmode"><code>gl-render-mode</code></a></td><td valign="top"><a href="#Selection-and-feedback">4.13 Selection and feedback</a></td></tr>
5458 <tr><td></td><td valign="top"><a href="#index-gl_002dreset_002dhistogram"><code>gl-reset-histogram</code></a></td><td valign="top"><a href="#Histogram">Histogram</a></td></tr>
5459 <tr><td></td><td valign="top"><a href="#index-gl_002dreset_002dminmax"><code>gl-reset-minmax</code></a></td><td valign="top"><a href="#Minmax">Minmax</a></td></tr>
5460 <tr><td></td><td valign="top"><a href="#index-gl_002drotate"><code>gl-rotate</code></a></td><td valign="top"><a href="#Transformation">4.6 Transformation</a></td></tr>
5461 <tr><td></td><td valign="top"><a href="#index-gl_002dscale"><code>gl-scale</code></a></td><td valign="top"><a href="#Transformation">4.6 Transformation</a></td></tr>
5462 <tr><td></td><td valign="top"><a href="#index-gl_002dscissor"><code>gl-scissor</code></a></td><td valign="top"><a href="#Testing-and-operating-on-fragments">Testing and operating on fragments</a></td></tr>
5463 <tr><td></td><td valign="top"><a href="#index-gl_002dselect_002dbuffer"><code>gl-select-buffer</code></a></td><td valign="top"><a href="#Selection-and-feedback">4.13 Selection and feedback</a></td></tr>
5464 <tr><td></td><td valign="top"><a href="#index-gl_002dseparable_002dfiletr_002d2d"><code>gl-separable-filetr-2d</code></a></td><td valign="top"><a href="#Convolutions">Convolutions</a></td></tr>
5465 <tr><td></td><td valign="top"><a href="#index-gl_002dshade_002dmodel"><code>gl-shade-model</code></a></td><td valign="top"><a href="#Lighting">4.9 Lighting</a></td></tr>
5466 <tr><td></td><td valign="top"><a href="#index-gl_002dshader_002dsource_002darb"><code>gl-shader-source-arb</code></a></td><td valign="top"><a href="#Shader-objects">Shader objects</a></td></tr>
5467 <tr><td></td><td valign="top"><a href="#index-gl_002dstate_002dvector_002dsize"><code>gl-state-vector-size</code></a></td><td valign="top"><a href="#State-values">State values</a></td></tr>
5468 <tr><td></td><td valign="top"><a href="#index-gl_002dstencil_002dfunc"><code>gl-stencil-func</code></a></td><td valign="top"><a href="#Testing-and-operating-on-fragments">Testing and operating on fragments</a></td></tr>
5469 <tr><td></td><td valign="top"><a href="#index-gl_002dstencil_002dmask"><code>gl-stencil-mask</code></a></td><td valign="top"><a href="#Masking-buffers">Masking buffers</a></td></tr>
5470 <tr><td></td><td valign="top"><a href="#index-gl_002dstencil_002dop"><code>gl-stencil-op</code></a></td><td valign="top"><a href="#Testing-and-operating-on-fragments">Testing and operating on fragments</a></td></tr>
5471 <tr><td></td><td valign="top"><a href="#index-gl_002dtex_002dcoord"><code>gl-tex-coord</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
5472 <tr><td></td><td valign="top"><a href="#index-gl_002dtex_002dcoord-1"><code>gl-tex-coord</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
5473 <tr><td></td><td valign="top"><a href="#index-gl_002dtex_002dcoord_002dpointer"><code>gl-tex-coord-pointer</code></a></td><td valign="top"><a href="#Vertex-arrays">4.8 Vertex arrays</a></td></tr>
5474 <tr><td></td><td valign="top"><a href="#index-gl_002dtex_002denv"><code>gl-tex-env</code></a></td><td valign="top"><a href="#Texture-environment-and-coordinates">Texture environment and coordinates</a></td></tr>
5475 <tr><td></td><td valign="top"><a href="#index-gl_002dtex_002dgen"><code>gl-tex-gen</code></a></td><td valign="top"><a href="#Texture-environment-and-coordinates">Texture environment and coordinates</a></td></tr>
5476 <tr><td></td><td valign="top"><a href="#index-gl_002dtex_002dimage_002d1d"><code>gl-tex-image-1d</code></a></td><td valign="top"><a href="#Defining-textures">Defining textures</a></td></tr>
5477 <tr><td></td><td valign="top"><a href="#index-gl_002dtex_002dimage_002d2d"><code>gl-tex-image-2d</code></a></td><td valign="top"><a href="#Defining-textures">Defining textures</a></td></tr>
5478 <tr><td></td><td valign="top"><a href="#index-gl_002dtex_002dimage_002d3d"><code>gl-tex-image-3d</code></a></td><td valign="top"><a href="#Defining-textures">Defining textures</a></td></tr>
5479 <tr><td></td><td valign="top"><a href="#index-gl_002dtex_002dparameter"><code>gl-tex-parameter</code></a></td><td valign="top"><a href="#Texture-parameters">Texture parameters</a></td></tr>
5480 <tr><td></td><td valign="top"><a href="#index-gl_002dtex_002dsub_002dimage_002d1d"><code>gl-tex-sub-image-1d</code></a></td><td valign="top"><a href="#Defining-textures">Defining textures</a></td></tr>
5481 <tr><td></td><td valign="top"><a href="#index-gl_002dtex_002dsub_002dimage_002d2d"><code>gl-tex-sub-image-2d</code></a></td><td valign="top"><a href="#Defining-textures">Defining textures</a></td></tr>
5482 <tr><td></td><td valign="top"><a href="#index-gl_002dtex_002dsub_002dimage_002d3d"><code>gl-tex-sub-image-3d</code></a></td><td valign="top"><a href="#Defining-textures">Defining textures</a></td></tr>
5483 <tr><td></td><td valign="top"><a href="#index-gl_002dtranslate"><code>gl-translate</code></a></td><td valign="top"><a href="#Transformation">4.6 Transformation</a></td></tr>
5484 <tr><td></td><td valign="top"><a href="#index-gl_002duniform_002dmatrix2_002darb"><code>gl-uniform-matrix2-arb</code></a></td><td valign="top"><a href="#Specifying-uniform-variables">Specifying uniform variables</a></td></tr>
5485 <tr><td></td><td valign="top"><a href="#index-gl_002duniform_002dmatrix3_002darb"><code>gl-uniform-matrix3-arb</code></a></td><td valign="top"><a href="#Specifying-uniform-variables">Specifying uniform variables</a></td></tr>
5486 <tr><td></td><td valign="top"><a href="#index-gl_002duniform_002dmatrix4_002darb"><code>gl-uniform-matrix4-arb</code></a></td><td valign="top"><a href="#Specifying-uniform-variables">Specifying uniform variables</a></td></tr>
5487 <tr><td></td><td valign="top"><a href="#index-gl_002duniform1_002darb"><code>gl-uniform1-arb</code></a></td><td valign="top"><a href="#Specifying-uniform-variables">Specifying uniform variables</a></td></tr>
5488 <tr><td></td><td valign="top"><a href="#index-gl_002duniform1_002darb-1"><code>gl-uniform1-arb</code></a></td><td valign="top"><a href="#Specifying-uniform-variables">Specifying uniform variables</a></td></tr>
5489 <tr><td></td><td valign="top"><a href="#index-gl_002duniform2_002darb"><code>gl-uniform2-arb</code></a></td><td valign="top"><a href="#Specifying-uniform-variables">Specifying uniform variables</a></td></tr>
5490 <tr><td></td><td valign="top"><a href="#index-gl_002duniform2_002darb-1"><code>gl-uniform2-arb</code></a></td><td valign="top"><a href="#Specifying-uniform-variables">Specifying uniform variables</a></td></tr>
5491 <tr><td></td><td valign="top"><a href="#index-gl_002duniform3_002darb"><code>gl-uniform3-arb</code></a></td><td valign="top"><a href="#Specifying-uniform-variables">Specifying uniform variables</a></td></tr>
5492 <tr><td></td><td valign="top"><a href="#index-gl_002duniform3_002darb-1"><code>gl-uniform3-arb</code></a></td><td valign="top"><a href="#Specifying-uniform-variables">Specifying uniform variables</a></td></tr>
5493 <tr><td></td><td valign="top"><a href="#index-gl_002duniform4_002darb"><code>gl-uniform4-arb</code></a></td><td valign="top"><a href="#Specifying-uniform-variables">Specifying uniform variables</a></td></tr>
5494 <tr><td></td><td valign="top"><a href="#index-gl_002duniform4_002darb-1"><code>gl-uniform4-arb</code></a></td><td valign="top"><a href="#Specifying-uniform-variables">Specifying uniform variables</a></td></tr>
5495 <tr><td></td><td valign="top"><a href="#index-gl_002duse_002dprogram_002dobject_002darb"><code>gl-use-program-object-arb</code></a></td><td valign="top"><a href="#Shader-objects">Shader objects</a></td></tr>
5496 <tr><td></td><td valign="top"><a href="#index-gl_002dvalidate_002dprogram_002darb"><code>gl-validate-program-arb</code></a></td><td valign="top"><a href="#Shader-objects">Shader objects</a></td></tr>
5497 <tr><td></td><td valign="top"><a href="#index-gl_002dversion_003c_003d_003f"><code>gl-version&lt;=?</code></a></td><td valign="top"><a href="#GL-feature-checking">4.2 GL feature checking</a></td></tr>
5498 <tr><td></td><td valign="top"><a href="#index-gl_002dversion_003c_003f"><code>gl-version&lt;?</code></a></td><td valign="top"><a href="#GL-feature-checking">4.2 GL feature checking</a></td></tr>
5499 <tr><td></td><td valign="top"><a href="#index-gl_002dversion_003d_003f"><code>gl-version=?</code></a></td><td valign="top"><a href="#GL-feature-checking">4.2 GL feature checking</a></td></tr>
5500 <tr><td></td><td valign="top"><a href="#index-gl_002dversion_003e_003d_003f"><code>gl-version&gt;=?</code></a></td><td valign="top"><a href="#GL-feature-checking">4.2 GL feature checking</a></td></tr>
5501 <tr><td></td><td valign="top"><a href="#index-gl_002dversion_003e_003f"><code>gl-version&gt;?</code></a></td><td valign="top"><a href="#GL-feature-checking">4.2 GL feature checking</a></td></tr>
5502 <tr><td></td><td valign="top"><a href="#index-gl_002dvertex"><code>gl-vertex</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
5503 <tr><td></td><td valign="top"><a href="#index-gl_002dvertex-1"><code>gl-vertex</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
5504 <tr><td></td><td valign="top"><a href="#index-gl_002dvertex_002dattrib_002d4n_002darb"><code>gl-vertex-attrib-4n-arb</code></a></td><td valign="top"><a href="#Specifying-vertex-attributes">Specifying vertex attributes</a></td></tr>
5505 <tr><td></td><td valign="top"><a href="#index-gl_002dvertex_002dattrib_002d4n_002darb-1"><code>gl-vertex-attrib-4n-arb</code></a></td><td valign="top"><a href="#Specifying-vertex-attributes">Specifying vertex attributes</a></td></tr>
5506 <tr><td></td><td valign="top"><a href="#index-gl_002dvertex_002dattrib_002darb"><code>gl-vertex-attrib-arb</code></a></td><td valign="top"><a href="#Specifying-vertex-attributes">Specifying vertex attributes</a></td></tr>
5507 <tr><td></td><td valign="top"><a href="#index-gl_002dvertex_002dattrib_002darb-1"><code>gl-vertex-attrib-arb</code></a></td><td valign="top"><a href="#Specifying-vertex-attributes">Specifying vertex attributes</a></td></tr>
5508 <tr><td></td><td valign="top"><a href="#index-gl_002dvertex_002dattrib_002dpointer_002darb"><code>gl-vertex-attrib-pointer-arb</code></a></td><td valign="top"><a href="#Specifying-vertex-attributes">Specifying vertex attributes</a></td></tr>
5509 <tr><td></td><td valign="top"><a href="#index-gl_002dvertex_002dpointer"><code>gl-vertex-pointer</code></a></td><td valign="top"><a href="#Vertex-arrays">4.8 Vertex arrays</a></td></tr>
5510 <tr><td></td><td valign="top"><a href="#index-gl_002dviewport"><code>gl-viewport</code></a></td><td valign="top"><a href="#Transformation">4.6 Transformation</a></td></tr>
5511 <tr><td></td><td valign="top"><a href="#index-glu_002dbegin_002dcurve"><code>glu-begin-curve</code></a></td><td valign="top"><a href="#Nurbs">4.16 Nurbs</a></td></tr>
5512 <tr><td></td><td valign="top"><a href="#index-glu_002dbegin_002dsurface"><code>glu-begin-surface</code></a></td><td valign="top"><a href="#Nurbs">4.16 Nurbs</a></td></tr>
5513 <tr><td></td><td valign="top"><a href="#index-glu_002dbuild_002d1d_002dmipmap_002dlevels"><code>glu-build-1d-mipmap-levels</code></a></td><td valign="top"><a href="#Mipmaps">Mipmaps</a></td></tr>
5514 <tr><td></td><td valign="top"><a href="#index-glu_002dbuild_002d1d_002dmipmaps"><code>glu-build-1d-mipmaps</code></a></td><td valign="top"><a href="#Mipmaps">Mipmaps</a></td></tr>
5515 <tr><td></td><td valign="top"><a href="#index-glu_002dbuild_002d2d_002dmipmap_002dlevels"><code>glu-build-2d-mipmap-levels</code></a></td><td valign="top"><a href="#Mipmaps">Mipmaps</a></td></tr>
5516 <tr><td></td><td valign="top"><a href="#index-glu_002dbuild_002d2d_002dmipmaps"><code>glu-build-2d-mipmaps</code></a></td><td valign="top"><a href="#Mipmaps">Mipmaps</a></td></tr>
5517 <tr><td></td><td valign="top"><a href="#index-glu_002dbuild_002d3d_002dmipmap_002dlevels"><code>glu-build-3d-mipmap-levels</code></a></td><td valign="top"><a href="#Mipmaps">Mipmaps</a></td></tr>
5518 <tr><td></td><td valign="top"><a href="#index-glu_002dbuild_002d3d_002dmipmaps"><code>glu-build-3d-mipmaps</code></a></td><td valign="top"><a href="#Mipmaps">Mipmaps</a></td></tr>
5519 <tr><td></td><td valign="top"><a href="#index-glu_002dcylinder"><code>glu-cylinder</code></a></td><td valign="top"><a href="#Quadrics">4.15 Quadrics</a></td></tr>
5520 <tr><td></td><td valign="top"><a href="#index-glu_002ddisk"><code>glu-disk</code></a></td><td valign="top"><a href="#Quadrics">4.15 Quadrics</a></td></tr>
5521 <tr><td></td><td valign="top"><a href="#index-glu_002dend_002dcurve"><code>glu-end-curve</code></a></td><td valign="top"><a href="#Nurbs">4.16 Nurbs</a></td></tr>
5522 <tr><td></td><td valign="top"><a href="#index-glu_002dend_002dsurface"><code>glu-end-surface</code></a></td><td valign="top"><a href="#Nurbs">4.16 Nurbs</a></td></tr>
5523 <tr><td></td><td valign="top"><a href="#index-glu_002derror_002dstring"><code>glu-error-string</code></a></td><td valign="top"><a href="#Other-queries">Other queries</a></td></tr>
5524 <tr><td></td><td valign="top"><a href="#index-glu_002dget_002dnurbs_002dproperty"><code>glu-get-nurbs-property</code></a></td><td valign="top"><a href="#Nurbs">4.16 Nurbs</a></td></tr>
5525 <tr><td></td><td valign="top"><a href="#index-glu_002dget_002dstring"><code>glu-get-string</code></a></td><td valign="top"><a href="#Other-queries">Other queries</a></td></tr>
5526 <tr><td></td><td valign="top"><a href="#index-glu_002dload_002dsampling_002dmatrices"><code>glu-load-sampling-matrices</code></a></td><td valign="top"><a href="#Nurbs">4.16 Nurbs</a></td></tr>
5527 <tr><td></td><td valign="top"><a href="#index-glu_002dlook_002dat"><code>glu-look-at</code></a></td><td valign="top"><a href="#Transformation">4.6 Transformation</a></td></tr>
5528 <tr><td></td><td valign="top"><a href="#index-glu_002dnurbs_002dcurve"><code>glu-nurbs-curve</code></a></td><td valign="top"><a href="#Nurbs">4.16 Nurbs</a></td></tr>
5529 <tr><td></td><td valign="top"><a href="#index-glu_002dnurbs_002dproperty"><code>glu-nurbs-property</code></a></td><td valign="top"><a href="#Nurbs">4.16 Nurbs</a></td></tr>
5530 <tr><td></td><td valign="top"><a href="#index-glu_002dortho_002d2d"><code>glu-ortho-2d</code></a></td><td valign="top"><a href="#Transformation">4.6 Transformation</a></td></tr>
5531 <tr><td></td><td valign="top"><a href="#index-glu_002dpartial_002ddisk"><code>glu-partial-disk</code></a></td><td valign="top"><a href="#Quadrics">4.15 Quadrics</a></td></tr>
5532 <tr><td></td><td valign="top"><a href="#index-glu_002dperspective"><code>glu-perspective</code></a></td><td valign="top"><a href="#Transformation">4.6 Transformation</a></td></tr>
5533 <tr><td></td><td valign="top"><a href="#index-glu_002dpick_002dmatrix"><code>glu-pick-matrix</code></a></td><td valign="top"><a href="#Projection">4.14 Projection</a></td></tr>
5534 <tr><td></td><td valign="top"><a href="#index-glu_002dproject"><code>glu-project</code></a></td><td valign="top"><a href="#Projection">4.14 Projection</a></td></tr>
5535 <tr><td></td><td valign="top"><a href="#index-glu_002dproject_0021"><code>glu-project!</code></a></td><td valign="top"><a href="#Projection">4.14 Projection</a></td></tr>
5536 <tr><td></td><td valign="top"><a href="#index-glu_002dquadric_002ddraw_002dstyle"><code>glu-quadric-draw-style</code></a></td><td valign="top"><a href="#Quadrics">4.15 Quadrics</a></td></tr>
5537 <tr><td></td><td valign="top"><a href="#index-glu_002dquadric_002dnormals"><code>glu-quadric-normals</code></a></td><td valign="top"><a href="#Quadrics">4.15 Quadrics</a></td></tr>
5538 <tr><td></td><td valign="top"><a href="#index-glu_002dquadric_002dorientation"><code>glu-quadric-orientation</code></a></td><td valign="top"><a href="#Quadrics">4.15 Quadrics</a></td></tr>
5539 <tr><td></td><td valign="top"><a href="#index-glu_002dquadric_002dtexture"><code>glu-quadric-texture</code></a></td><td valign="top"><a href="#Quadrics">4.15 Quadrics</a></td></tr>
5540 <tr><td></td><td valign="top"><a href="#index-glu_002dsphere"><code>glu-sphere</code></a></td><td valign="top"><a href="#Quadrics">4.15 Quadrics</a></td></tr>
5541 <tr><td></td><td valign="top"><a href="#index-glu_002dun_002dproject"><code>glu-un-project</code></a></td><td valign="top"><a href="#Projection">4.14 Projection</a></td></tr>
5542 <tr><td></td><td valign="top"><a href="#index-glu_002dun_002dproject_0021"><code>glu-un-project!</code></a></td><td valign="top"><a href="#Projection">4.14 Projection</a></td></tr>
5543 <tr><td></td><td valign="top"><a href="#index-glut_002dadd_002dmenu_002dentry"><code>glut-add-menu-entry</code></a></td><td valign="top"><a href="#GLUT-menu-API">5.3 GLUT menu API</a></td></tr>
5544 <tr><td></td><td valign="top"><a href="#index-glut_002dadd_002dsub_002dmenu"><code>glut-add-sub-menu</code></a></td><td valign="top"><a href="#GLUT-menu-API">5.3 GLUT menu API</a></td></tr>
5545 <tr><td></td><td valign="top"><a href="#index-glut_002dbitmap_002dcharacter"><code>glut-bitmap-character</code></a></td><td valign="top"><a href="#GLUT-font">5.7 GLUT font</a></td></tr>
5546 <tr><td></td><td valign="top"><a href="#index-glut_002dbitmap_002dlength"><code>glut-bitmap-length</code></a></td><td valign="top"><a href="#GLUT-font">5.7 GLUT font</a></td></tr>
5547 <tr><td></td><td valign="top"><a href="#index-glut_002dbitmap_002dwidth"><code>glut-bitmap-width</code></a></td><td valign="top"><a href="#GLUT-font">5.7 GLUT font</a></td></tr>
5548 <tr><td></td><td valign="top"><a href="#index-glut_002dbutton_002dbox_002dfunc"><code>glut-button-box-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5549 <tr><td></td><td valign="top"><a href="#index-glut_002dchange_002dto_002dmenu_002dentry"><code>glut-change-to-menu-entry</code></a></td><td valign="top"><a href="#GLUT-menu-API">5.3 GLUT menu API</a></td></tr>
5550 <tr><td></td><td valign="top"><a href="#index-glut_002dchange_002dto_002dsub_002dmenu"><code>glut-change-to-sub-menu</code></a></td><td valign="top"><a href="#GLUT-menu-API">5.3 GLUT menu API</a></td></tr>
5551 <tr><td></td><td valign="top"><a href="#index-glut_002dcopy_002dcolormap"><code>glut-copy-colormap</code></a></td><td valign="top"><a href="#GLUT-colormap">5.5 GLUT colormap</a></td></tr>
5552 <tr><td></td><td valign="top"><a href="#index-glut_002dcreate_002dmenu"><code>glut-create-menu</code></a></td><td valign="top"><a href="#GLUT-menu-API">5.3 GLUT menu API</a></td></tr>
5553 <tr><td></td><td valign="top"><a href="#index-glut_002dcreate_002dsub_002dwindow"><code>glut-create-sub-window</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5554 <tr><td></td><td valign="top"><a href="#index-glut_002dcreate_002dwidnow"><code>glut-create-widnow</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5555 <tr><td></td><td valign="top"><a href="#index-glut_002ddestroy_002dmenu"><code>glut-destroy-menu</code></a></td><td valign="top"><a href="#GLUT-menu-API">5.3 GLUT menu API</a></td></tr>
5556 <tr><td></td><td valign="top"><a href="#index-glut_002ddestroy_002dwindow"><code>glut-destroy-window</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5557 <tr><td></td><td valign="top"><a href="#index-glut_002ddetach_002dmenu"><code>glut-detach-menu</code></a></td><td valign="top"><a href="#GLUT-menu-API">5.3 GLUT menu API</a></td></tr>
5558 <tr><td></td><td valign="top"><a href="#index-glut_002ddevice_002dget"><code>glut-device-get</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5559 <tr><td></td><td valign="top"><a href="#index-glut_002ddials_002dfunc"><code>glut-dials-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5560 <tr><td></td><td valign="top"><a href="#index-glut_002ddisplay_002dfunc"><code>glut-display-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5561 <tr><td></td><td valign="top"><a href="#index-glut_002dentry_002dfunc"><code>glut-entry-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5562 <tr><td></td><td valign="top"><a href="#index-glut_002destablish_002doverlay"><code>glut-establish-overlay</code></a></td><td valign="top"><a href="#GLUT-overlay">5.2 GLUT overlay</a></td></tr>
5563 <tr><td></td><td valign="top"><a href="#index-glut_002dextension_002dsupported"><code>glut-extension-supported</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5564 <tr><td></td><td valign="top"><a href="#index-glut_002dfull_002dscreen"><code>glut-full-screen</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5565 <tr><td></td><td valign="top"><a href="#index-glut_002dget"><code>glut-get</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5566 <tr><td></td><td valign="top"><a href="#index-glut_002dget_002dcolor"><code>glut-get-color</code></a></td><td valign="top"><a href="#GLUT-colormap">5.5 GLUT colormap</a></td></tr>
5567 <tr><td></td><td valign="top"><a href="#index-glut_002dget_002demnu"><code>glut-get-emnu</code></a></td><td valign="top"><a href="#GLUT-menu-API">5.3 GLUT menu API</a></td></tr>
5568 <tr><td></td><td valign="top"><a href="#index-glut_002dget_002dmodifiers"><code>glut-get-modifiers</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5569 <tr><td></td><td valign="top"><a href="#index-glut_002dget_002dwindow"><code>glut-get-window</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5570 <tr><td></td><td valign="top"><a href="#index-glut_002dhide_002doverlay"><code>glut-hide-overlay</code></a></td><td valign="top"><a href="#GLUT-overlay">5.2 GLUT overlay</a></td></tr>
5571 <tr><td></td><td valign="top"><a href="#index-glut_002dhide_002dwindow"><code>glut-hide-window</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5572 <tr><td></td><td valign="top"><a href="#index-glut_002diconify_002dwindow"><code>glut-iconify-window</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5573 <tr><td></td><td valign="top"><a href="#index-glut_002didle_002dfunc"><code>glut-idle-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5574 <tr><td></td><td valign="top"><a href="#index-glut_002dinit"><code>glut-init</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5575 <tr><td></td><td valign="top"><a href="#index-glut_002dinit_002ddisplay_002dmode"><code>glut-init-display-mode</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5576 <tr><td></td><td valign="top"><a href="#index-glut_002dinit_002ddisplay_002dstring"><code>glut-init-display-string</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5577 <tr><td></td><td valign="top"><a href="#index-glut_002dinit_002dwindow_002dposition"><code>glut-init-window-position</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5578 <tr><td></td><td valign="top"><a href="#index-glut_002dinit_002dwindow_002dsize"><code>glut-init-window-size</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5579 <tr><td></td><td valign="top"><a href="#index-glut_002djoystick_002dfunc"><code>glut-joystick-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5580 <tr><td></td><td valign="top"><a href="#index-glut_002dkeyboard_002dfunc"><code>glut-keyboard-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5581 <tr><td></td><td valign="top"><a href="#index-glut_002dkeyboard_002dup_002dfunc"><code>glut-keyboard-up-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5582 <tr><td></td><td valign="top"><a href="#index-glut_002dlayer_002dget"><code>glut-layer-get</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5583 <tr><td></td><td valign="top"><a href="#index-glut_002dmain_002dloop"><code>glut-main-loop</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5584 <tr><td></td><td valign="top"><a href="#index-glut_002dmenu_002dstate_002dfunc"><code>glut-menu-state-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5585 <tr><td></td><td valign="top"><a href="#index-glut_002dmenu_002dstatus_002dfunc"><code>glut-menu-status-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5586 <tr><td></td><td valign="top"><a href="#index-glut_002dmotion_002dfunc"><code>glut-motion-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5587 <tr><td></td><td valign="top"><a href="#index-glut_002dmouse_002dfunc"><code>glut-mouse-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5588 <tr><td></td><td valign="top"><a href="#index-glut_002doverlay_002ddislay_002dfunc"><code>glut-overlay-dislay-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5589 <tr><td></td><td valign="top"><a href="#index-glut_002dpassive_002dmotion_002dfunc"><code>glut-passive-motion-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5590 <tr><td></td><td valign="top"><a href="#index-glut_002dpop_002dwindow"><code>glut-pop-window</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5591 <tr><td></td><td valign="top"><a href="#index-glut_002dposition_002dwindow"><code>glut-position-window</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5592 <tr><td></td><td valign="top"><a href="#index-glut_002dpost_002doverlay_002dredisplay"><code>glut-post-overlay-redisplay</code></a></td><td valign="top"><a href="#GLUT-overlay">5.2 GLUT overlay</a></td></tr>
5593 <tr><td></td><td valign="top"><a href="#index-glut_002dpost_002dredisplay"><code>glut-post-redisplay</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5594 <tr><td></td><td valign="top"><a href="#index-glut_002dpost_002dwindow_002doverlay_002dredisplay"><code>glut-post-window-overlay-redisplay</code></a></td><td valign="top"><a href="#GLUT-overlay">5.2 GLUT overlay</a></td></tr>
5595 <tr><td></td><td valign="top"><a href="#index-glut_002dpost_002dwindow_002dredisplay"><code>glut-post-window-redisplay</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5596 <tr><td></td><td valign="top"><a href="#index-glut_002dpush_002dwindow"><code>glut-push-window</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5597 <tr><td></td><td valign="top"><a href="#index-glut_002dremove_002dmenu_002ditem"><code>glut-remove-menu-item</code></a></td><td valign="top"><a href="#GLUT-menu-API">5.3 GLUT menu API</a></td></tr>
5598 <tr><td></td><td valign="top"><a href="#index-glut_002dremove_002doverlay"><code>glut-remove-overlay</code></a></td><td valign="top"><a href="#GLUT-overlay">5.2 GLUT overlay</a></td></tr>
5599 <tr><td></td><td valign="top"><a href="#index-glut_002dreshape_002dfunc"><code>glut-reshape-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5600 <tr><td></td><td valign="top"><a href="#index-glut_002dreshape_002dwindow"><code>glut-reshape-window</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5601 <tr><td></td><td valign="top"><a href="#index-glut_002dset_002dcolor"><code>glut-set-color</code></a></td><td valign="top"><a href="#GLUT-colormap">5.5 GLUT colormap</a></td></tr>
5602 <tr><td></td><td valign="top"><a href="#index-glut_002dset_002dcursor"><code>glut-set-cursor</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5603 <tr><td></td><td valign="top"><a href="#index-glut_002dset_002dicon_002dtitle"><code>glut-set-icon-title</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5604 <tr><td></td><td valign="top"><a href="#index-glut_002dset_002dmenu"><code>glut-set-menu</code></a></td><td valign="top"><a href="#GLUT-menu-API">5.3 GLUT menu API</a></td></tr>
5605 <tr><td></td><td valign="top"><a href="#index-glut_002dset_002dwindow"><code>glut-set-window</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5606 <tr><td></td><td valign="top"><a href="#index-glut_002dset_002dwindow_002dtitle"><code>glut-set-window-title</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5607 <tr><td></td><td valign="top"><a href="#index-glut_002dshow_002doverlay"><code>glut-show-overlay</code></a></td><td valign="top"><a href="#GLUT-overlay">5.2 GLUT overlay</a></td></tr>
5608 <tr><td></td><td valign="top"><a href="#index-glut_002dshow_002dwindow"><code>glut-show-window</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5609 <tr><td></td><td valign="top"><a href="#index-glut_002dsoild_002dteapot"><code>glut-soild-teapot</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5610 <tr><td></td><td valign="top"><a href="#index-glut_002dsolid_002dcone"><code>glut-solid-cone</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5611 <tr><td></td><td valign="top"><a href="#index-glut_002dsolid_002dcube"><code>glut-solid-cube</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5612 <tr><td></td><td valign="top"><a href="#index-glut_002dsolid_002ddodecahedron"><code>glut-solid-dodecahedron</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5613 <tr><td></td><td valign="top"><a href="#index-glut_002dsolid_002dicosahedron"><code>glut-solid-icosahedron</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5614 <tr><td></td><td valign="top"><a href="#index-glut_002dsolid_002doctahedron"><code>glut-solid-octahedron</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5615 <tr><td></td><td valign="top"><a href="#index-glut_002dsolid_002dsphere"><code>glut-solid-sphere</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5616 <tr><td></td><td valign="top"><a href="#index-glut_002dsolid_002dtetrahedron"><code>glut-solid-tetrahedron</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5617 <tr><td></td><td valign="top"><a href="#index-glut_002dsolid_002dtorus"><code>glut-solid-torus</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5618 <tr><td></td><td valign="top"><a href="#index-glut_002dspaceball_002dbutton_002dfunc"><code>glut-spaceball-button-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5619 <tr><td></td><td valign="top"><a href="#index-glut_002dspaceball_002dmotion_002dfunc"><code>glut-spaceball-motion-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5620 <tr><td></td><td valign="top"><a href="#index-glut_002dspaceball_002drotate_002dfunc"><code>glut-spaceball-rotate-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5621 <tr><td></td><td valign="top"><a href="#index-glut_002dspecial_002dfunc"><code>glut-special-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5622 <tr><td></td><td valign="top"><a href="#index-glut_002dspecial_002dup_002dfunc"><code>glut-special-up-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5623 <tr><td></td><td valign="top"><a href="#index-glut_002dstroke_002dcharacter"><code>glut-stroke-character</code></a></td><td valign="top"><a href="#GLUT-font">5.7 GLUT font</a></td></tr>
5624 <tr><td></td><td valign="top"><a href="#index-glut_002dstroke_002dlength"><code>glut-stroke-length</code></a></td><td valign="top"><a href="#GLUT-font">5.7 GLUT font</a></td></tr>
5625 <tr><td></td><td valign="top"><a href="#index-glut_002dstroke_002dwidth"><code>glut-stroke-width</code></a></td><td valign="top"><a href="#GLUT-font">5.7 GLUT font</a></td></tr>
5626 <tr><td></td><td valign="top"><a href="#index-glut_002dswap_002dbuffers"><code>glut-swap-buffers</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5627 <tr><td></td><td valign="top"><a href="#index-glut_002dtablet_002dbutton_002dfunc"><code>glut-tablet-button-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5628 <tr><td></td><td valign="top"><a href="#index-glut_002dtablet_002dmotion_002dfunc"><code>glut-tablet-motion-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5629 <tr><td></td><td valign="top"><a href="#index-glut_002dtimer_002dfunc"><code>glut-timer-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5630 <tr><td></td><td valign="top"><a href="#index-glut_002duse_002dlayer"><code>glut-use-layer</code></a></td><td valign="top"><a href="#GLUT-overlay">5.2 GLUT overlay</a></td></tr>
5631 <tr><td></td><td valign="top"><a href="#index-glut_002dvisibility_002dfunc"><code>glut-visibility-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5632 <tr><td></td><td valign="top"><a href="#index-glut_002dwarp_002dpointer"><code>glut-warp-pointer</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5633 <tr><td></td><td valign="top"><a href="#index-glut_002dwindow_002dstatus_002dfunc"><code>glut-window-status-func</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5634 <tr><td></td><td valign="top"><a href="#index-glut_002dwire_002dcone"><code>glut-wire-cone</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5635 <tr><td></td><td valign="top"><a href="#index-glut_002dwire_002dcube"><code>glut-wire-cube</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5636 <tr><td></td><td valign="top"><a href="#index-glut_002dwire_002ddodecahedron"><code>glut-wire-dodecahedron</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5637 <tr><td></td><td valign="top"><a href="#index-glut_002dwire_002dicosahedron"><code>glut-wire-icosahedron</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5638 <tr><td></td><td valign="top"><a href="#index-glut_002dwire_002doctahedron"><code>glut-wire-octahedron</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5639 <tr><td></td><td valign="top"><a href="#index-glut_002dwire_002dsphere"><code>glut-wire-sphere</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5640 <tr><td></td><td valign="top"><a href="#index-glut_002dwire_002dteapot"><code>glut-wire-teapot</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5641 <tr><td></td><td valign="top"><a href="#index-glut_002dwire_002dtetrahedron"><code>glut-wire-tetrahedron</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5642 <tr><td></td><td valign="top"><a href="#index-glut_002dwire_002dtorus"><code>glut-wire-torus</code></a></td><td valign="top"><a href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></td></tr>
5643 <tr><td></td><td valign="top"><a href="#index-gult_002dattach_002dmenu"><code>gult-attach-menu</code></a></td><td valign="top"><a href="#GLUT-menu-API">5.3 GLUT menu API</a></td></tr>
5644 <tr><td colspan="3"> <hr></td></tr>
5645 <tr><th><a name="Function-and-Syntax-Index-1_fn_letter-L">L</a></th><td></td><td></td></tr>
5646 <tr><td></td><td valign="top"><a href="#index-list_002d_003egl_002dboolean_002dvector"><code>list-&gt;gl-boolean-vector</code></a></td><td valign="top"><a href="#GL-boolean-vectors">GL boolean vectors</a></td></tr>
5647 <tr><td></td><td valign="top"><a href="#index-list_002d_003ematrix4f"><code>list-&gt;matrix4f</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5648 <tr><td></td><td valign="top"><a href="#index-list_002d_003epoint4f"><code>list-&gt;point4f</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5649 <tr><td></td><td valign="top"><a href="#index-list_002d_003epoint4f_002darray"><code>list-&gt;point4f-array</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5650 <tr><td></td><td valign="top"><a href="#index-list_002d_003equatf"><code>list-&gt;quatf</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5651 <tr><td></td><td valign="top"><a href="#index-list_002d_003evector4f"><code>list-&gt;vector4f</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5652 <tr><td></td><td valign="top"><a href="#index-list_002d_003evector4f_002darray"><code>list-&gt;vector4f-array</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5653 <tr><td colspan="3"> <hr></td></tr>
5654 <tr><th><a name="Function-and-Syntax-Index-1_fn_letter-M">M</a></th><td></td><td></td></tr>
5655 <tr><td></td><td valign="top"><a href="#index-make_002dgl_002dboolean_002dvector"><code>make-gl-boolean-vector</code></a></td><td valign="top"><a href="#GL-boolean-vectors">GL boolean vectors</a></td></tr>
5656 <tr><td></td><td valign="top"><a href="#index-make_002dmatrix4f"><code>make-matrix4f</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5657 <tr><td></td><td valign="top"><a href="#index-make_002dpoint4f"><code>make-point4f</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5658 <tr><td></td><td valign="top"><a href="#index-make_002dpoint4f_002darray"><code>make-point4f-array</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5659 <tr><td></td><td valign="top"><a href="#index-make_002dquatf"><code>make-quatf</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5660 <tr><td></td><td valign="top"><a href="#index-make_002dvector4f"><code>make-vector4f</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5661 <tr><td></td><td valign="top"><a href="#index-make_002dvector4f_002darray"><code>make-vector4f-array</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5662 <tr><td></td><td valign="top"><a href="#index-matrix4f-1"><code>matrix4f</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5663 <tr><td></td><td valign="top"><a href="#index-matrix4f_002d_003ef32vector"><code>matrix4f-&gt;f32vector</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5664 <tr><td></td><td valign="top"><a href="#index-matrix4f_002d_003elist"><code>matrix4f-&gt;list</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5665 <tr><td></td><td valign="top"><a href="#index-matrix4f_002d_003equatf"><code>matrix4f-&gt;quatf</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5666 <tr><td></td><td valign="top"><a href="#index-matrix4f_002d_003equatf_0021"><code>matrix4f-&gt;quatf!</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5667 <tr><td></td><td valign="top"><a href="#index-matrix4f_002d_003erotation"><code>matrix4f-&gt;rotation</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5668 <tr><td></td><td valign="top"><a href="#index-matrix4f_002d_003erotation_0021"><code>matrix4f-&gt;rotation!</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5669 <tr><td></td><td valign="top"><a href="#index-matrix4f_002d_003etranslation"><code>matrix4f-&gt;translation</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5670 <tr><td></td><td valign="top"><a href="#index-matrix4f_002d_003etranslation_0021"><code>matrix4f-&gt;translation!</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5671 <tr><td></td><td valign="top"><a href="#index-matrix4f_002dcolumn"><code>matrix4f-column</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5672 <tr><td></td><td valign="top"><a href="#index-matrix4f_002dcolumn_002fshared"><code>matrix4f-column/shared</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5673 <tr><td></td><td valign="top"><a href="#index-matrix4f_002dcopy"><code>matrix4f-copy</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5674 <tr><td></td><td valign="top"><a href="#index-matrix4f_002dcopy_0021"><code>matrix4f-copy!</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5675 <tr><td></td><td valign="top"><a href="#index-matrix4f_002ddecompose"><code>matrix4f-decompose</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5676 <tr><td></td><td valign="top"><a href="#index-matrix4f_002ddecompose_0021"><code>matrix4f-decompose!</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5677 <tr><td></td><td valign="top"><a href="#index-matrix4f_002ddeterminant"><code>matrix4f-determinant</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5678 <tr><td></td><td valign="top"><a href="#index-matrix4f_002dinverse"><code>matrix4f-inverse</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5679 <tr><td></td><td valign="top"><a href="#index-matrix4f_002dinverse_0021"><code>matrix4f-inverse!</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5680 <tr><td></td><td valign="top"><a href="#index-matrix4f_002dmul"><code>matrix4f-mul</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5681 <tr><td></td><td valign="top"><a href="#index-matrix4f_002dmul_0021"><code>matrix4f-mul!</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5682 <tr><td></td><td valign="top"><a href="#index-matrix4f_002dref"><code>matrix4f-ref</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5683 <tr><td></td><td valign="top"><a href="#index-matrix4f_002dref2"><code>matrix4f-ref2</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5684 <tr><td></td><td valign="top"><a href="#index-matrix4f_002drow"><code>matrix4f-row</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5685 <tr><td></td><td valign="top"><a href="#index-matrix4f_002dset_0021"><code>matrix4f-set!</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5686 <tr><td></td><td valign="top"><a href="#index-matrix4f_002dset2_0021"><code>matrix4f-set2!</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5687 <tr><td></td><td valign="top"><a href="#index-matrix4f_002dtranspose"><code>matrix4f-transpose</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5688 <tr><td></td><td valign="top"><a href="#index-matrix4f_002dtranspose_0021"><code>matrix4f-transpose!</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5689 <tr><td></td><td valign="top"><a href="#index-matrix4f_003f"><code>matrix4f?</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5690 <tr><td colspan="3"> <hr></td></tr>
5691 <tr><th><a name="Function-and-Syntax-Index-1_fn_letter-P">P</a></th><td></td><td></td></tr>
5692 <tr><td></td><td valign="top"><a href="#index-point4f-1"><code>point4f</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5693 <tr><td></td><td valign="top"><a href="#index-point4f_002d_003ef32vector"><code>point4f-&gt;f32vector</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5694 <tr><td></td><td valign="top"><a href="#index-point4f_002d_003elist"><code>point4f-&gt;list</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5695 <tr><td></td><td valign="top"><a href="#index-point4f_002dadd"><code>point4f-add</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5696 <tr><td></td><td valign="top"><a href="#index-point4f_002dadd_0021"><code>point4f-add!</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5697 <tr><td></td><td valign="top"><a href="#index-point4f_002darray_002d_003ef32vector"><code>point4f-array-&gt;f32vector</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5698 <tr><td></td><td valign="top"><a href="#index-point4f_002darray_002dlength"><code>point4f-array-length</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5699 <tr><td></td><td valign="top"><a href="#index-point4f_002darray_002dref"><code>point4f-array-ref</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5700 <tr><td></td><td valign="top"><a href="#index-point4f_002darray_002dref_002fshared"><code>point4f-array-ref/shared</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5701 <tr><td></td><td valign="top"><a href="#index-point4f_002darray_002dset_0021"><code>point4f-array-set!</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5702 <tr><td></td><td valign="top"><a href="#index-point4f_002darray_003f"><code>point4f-array?</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5703 <tr><td></td><td valign="top"><a href="#index-point4f_002dcopy"><code>point4f-copy</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5704 <tr><td></td><td valign="top"><a href="#index-point4f_002dcopy_0021"><code>point4f-copy!</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5705 <tr><td></td><td valign="top"><a href="#index-point4f_002dref"><code>point4f-ref</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5706 <tr><td></td><td valign="top"><a href="#index-point4f_002dset_0021"><code>point4f-set!</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5707 <tr><td></td><td valign="top"><a href="#index-point4f_002dsub"><code>point4f-sub</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5708 <tr><td></td><td valign="top"><a href="#index-point4f_003f"><code>point4f?</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5709 <tr><td colspan="3"> <hr></td></tr>
5710 <tr><th><a name="Function-and-Syntax-Index-1_fn_letter-Q">Q</a></th><td></td><td></td></tr>
5711 <tr><td></td><td valign="top"><a href="#index-quatf-1"><code>quatf</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5712 <tr><td></td><td valign="top"><a href="#index-quatf_002d_003ef32vector"><code>quatf-&gt;f32vector</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5713 <tr><td></td><td valign="top"><a href="#index-quatf_002d_003elist"><code>quatf-&gt;list</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5714 <tr><td></td><td valign="top"><a href="#index-quatf_002d_003ematrix4f"><code>quatf-&gt;matrix4f</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5715 <tr><td></td><td valign="top"><a href="#index-quatf_002d_003ematrix4f_0021"><code>quatf-&gt;matrix4f!</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5716 <tr><td></td><td valign="top"><a href="#index-quatf_002dadd"><code>quatf-add</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5717 <tr><td></td><td valign="top"><a href="#index-quatf_002dadd_0021"><code>quatf-add!</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5718 <tr><td></td><td valign="top"><a href="#index-quatf_002dconjugate"><code>quatf-conjugate</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5719 <tr><td></td><td valign="top"><a href="#index-quatf_002dconjugate_0021"><code>quatf-conjugate!</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5720 <tr><td></td><td valign="top"><a href="#index-quatf_002dcopy"><code>quatf-copy</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5721 <tr><td></td><td valign="top"><a href="#index-quatf_002dcopy_0021"><code>quatf-copy!</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5722 <tr><td></td><td valign="top"><a href="#index-quatf_002dmul"><code>quatf-mul</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5723 <tr><td></td><td valign="top"><a href="#index-quatf_002dmul_0021"><code>quatf-mul!</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5724 <tr><td></td><td valign="top"><a href="#index-quatf_002dnorm"><code>quatf-norm</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5725 <tr><td></td><td valign="top"><a href="#index-quatf_002dnormalize"><code>quatf-normalize</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5726 <tr><td></td><td valign="top"><a href="#index-quatf_002dnormalize_0021"><code>quatf-normalize!</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5727 <tr><td></td><td valign="top"><a href="#index-quatf_002dscale"><code>quatf-scale</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5728 <tr><td></td><td valign="top"><a href="#index-quatf_002dscale_0021"><code>quatf-scale!</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5729 <tr><td></td><td valign="top"><a href="#index-quatf_002dslerp"><code>quatf-slerp</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5730 <tr><td></td><td valign="top"><a href="#index-quatf_002dslerp_0021"><code>quatf-slerp!</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5731 <tr><td></td><td valign="top"><a href="#index-quatf_002dsub"><code>quatf-sub</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5732 <tr><td></td><td valign="top"><a href="#index-quatf_002dsub_0021"><code>quatf-sub!</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5733 <tr><td></td><td valign="top"><a href="#index-quatf_002dtransform"><code>quatf-transform</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5734 <tr><td></td><td valign="top"><a href="#index-quatf_003f"><code>quatf?</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5735 <tr><td colspan="3"> <hr></td></tr>
5736 <tr><th><a name="Function-and-Syntax-Index-1_fn_letter-R">R</a></th><td></td><td></td></tr>
5737 <tr><td></td><td valign="top"><a href="#index-read_002dsgi_002dimage"><code>read-sgi-image</code></a></td><td valign="top"><a href="#Simple-image-handling">7.1 Simple image handling</a></td></tr>
5738 <tr><td></td><td valign="top"><a href="#index-read_002dsgi_002dimage_002dfrom_002dport"><code>read-sgi-image-from-port</code></a></td><td valign="top"><a href="#Simple-image-handling">7.1 Simple image handling</a></td></tr>
5739 <tr><td></td><td valign="top"><a href="#index-rotation_002d_003ematrix4f"><code>rotation-&gt;matrix4f</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5740 <tr><td></td><td valign="top"><a href="#index-rotation_002d_003ematrix4f_0021"><code>rotation-&gt;matrix4f!</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5741 <tr><td></td><td valign="top"><a href="#index-rotation_002d_003equatf_0021"><code>rotation-&gt;quatf!</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5742 <tr><td colspan="3"> <hr></td></tr>
5743 <tr><th><a name="Function-and-Syntax-Index-1_fn_letter-S">S</a></th><td></td><td></td></tr>
5744 <tr><td></td><td valign="top"><a href="#index-scale_002d_003ematrix4f"><code>scale-&gt;matrix4f</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5745 <tr><td></td><td valign="top"><a href="#index-scale_002d_003ematrix4f_0021"><code>scale-&gt;matrix4f!</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5746 <tr><td></td><td valign="top"><a href="#index-simple_002dviewer_002daxis"><code>simple-viewer-axis</code></a></td><td valign="top"><a href="#Simple-viewer">7.2 Simple viewer</a></td></tr>
5747 <tr><td></td><td valign="top"><a href="#index-simple_002dviewer_002ddisplay"><code>simple-viewer-display</code></a></td><td valign="top"><a href="#Simple-viewer">7.2 Simple viewer</a></td></tr>
5748 <tr><td></td><td valign="top"><a href="#index-simple_002dviewer_002dgrid"><code>simple-viewer-grid</code></a></td><td valign="top"><a href="#Simple-viewer">7.2 Simple viewer</a></td></tr>
5749 <tr><td></td><td valign="top"><a href="#index-simple_002dviewer_002dreshape"><code>simple-viewer-reshape</code></a></td><td valign="top"><a href="#Simple-viewer">7.2 Simple viewer</a></td></tr>
5750 <tr><td></td><td valign="top"><a href="#index-simple_002dviewer_002dset_002dkey_0021"><code>simple-viewer-set-key!</code></a></td><td valign="top"><a href="#Simple-viewer">7.2 Simple viewer</a></td></tr>
5751 <tr><td></td><td valign="top"><a href="#index-simple_002dviewer_002dwindow"><code>simple-viewer-window</code></a></td><td valign="top"><a href="#Simple-viewer">7.2 Simple viewer</a></td></tr>
5752 <tr><td colspan="3"> <hr></td></tr>
5753 <tr><th><a name="Function-and-Syntax-Index-1_fn_letter-T">T</a></th><td></td><td></td></tr>
5754 <tr><td></td><td valign="top"><a href="#index-tqs_002d_003ematrix4f"><code>tqs-&gt;matrix4f</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5755 <tr><td></td><td valign="top"><a href="#index-tqs_002d_003ematrix4f_0021"><code>tqs-&gt;matrix4f!</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5756 <tr><td></td><td valign="top"><a href="#index-translation_002d_003ematrix4f"><code>translation-&gt;matrix4f</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5757 <tr><td></td><td valign="top"><a href="#index-translation_002d_003ematrix4f_0021"><code>translation-&gt;matrix4f!</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5758 <tr><td></td><td valign="top"><a href="#index-trs_002d_003ematrix4f"><code>trs-&gt;matrix4f</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5759 <tr><td></td><td valign="top"><a href="#index-trs_002d_003ematrix4f_0021"><code>trs-&gt;matrix4f!</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5760 <tr><td colspan="3"> <hr></td></tr>
5761 <tr><th><a name="Function-and-Syntax-Index-1_fn_letter-V">V</a></th><td></td><td></td></tr>
5762 <tr><td></td><td valign="top"><a href="#index-vector4f-1"><code>vector4f</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5763 <tr><td></td><td valign="top"><a href="#index-vector4f_002d_003ef32vector"><code>vector4f-&gt;f32vector</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5764 <tr><td></td><td valign="top"><a href="#index-vector4f_002d_003elist"><code>vector4f-&gt;list</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5765 <tr><td></td><td valign="top"><a href="#index-vector4f_002dadd"><code>vector4f-add</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5766 <tr><td></td><td valign="top"><a href="#index-vector4f_002dadd_0021"><code>vector4f-add!</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5767 <tr><td></td><td valign="top"><a href="#index-vector4f_002darray_002d_003ef32vector"><code>vector4f-array-&gt;f32vector</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5768 <tr><td></td><td valign="top"><a href="#index-vector4f_002darray_002dlength"><code>vector4f-array-length</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5769 <tr><td></td><td valign="top"><a href="#index-vector4f_002darray_002dref"><code>vector4f-array-ref</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5770 <tr><td></td><td valign="top"><a href="#index-vector4f_002darray_002dref_002fshared"><code>vector4f-array-ref/shared</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5771 <tr><td></td><td valign="top"><a href="#index-vector4f_002darray_002dset_0021"><code>vector4f-array-set!</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5772 <tr><td></td><td valign="top"><a href="#index-vector4f_002darray_003f"><code>vector4f-array?</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5773 <tr><td></td><td valign="top"><a href="#index-vector4f_002dcopy"><code>vector4f-copy</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5774 <tr><td></td><td valign="top"><a href="#index-vector4f_002dcopy_0021"><code>vector4f-copy!</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5775 <tr><td></td><td valign="top"><a href="#index-vector4f_002dcross"><code>vector4f-cross</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5776 <tr><td></td><td valign="top"><a href="#index-vector4f_002ddot"><code>vector4f-dot</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5777 <tr><td></td><td valign="top"><a href="#index-vector4f_002dnorm"><code>vector4f-norm</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5778 <tr><td></td><td valign="top"><a href="#index-vector4f_002dnormalize"><code>vector4f-normalize</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5779 <tr><td></td><td valign="top"><a href="#index-vector4f_002dnormalize_0021"><code>vector4f-normalize!</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5780 <tr><td></td><td valign="top"><a href="#index-vector4f_002dref"><code>vector4f-ref</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5781 <tr><td></td><td valign="top"><a href="#index-vector4f_002dset_0021"><code>vector4f-set!</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5782 <tr><td></td><td valign="top"><a href="#index-vector4f_002dsub"><code>vector4f-sub</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5783 <tr><td></td><td valign="top"><a href="#index-vector4f_002dsub_0021"><code>vector4f-sub!</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5784 <tr><td></td><td valign="top"><a href="#index-vector4f_003f"><code>vector4f?</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5785 <tr><td></td><td valign="top"><a href="#index-vectors_002d_003equatf"><code>vectors-&gt;quatf</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5786 <tr><td></td><td valign="top"><a href="#index-vectors_002d_003equatf_0021"><code>vectors-&gt;quatf!</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5787 <tr><td colspan="3"> <hr></td></tr>
5788 </table>
5789 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#Function-and-Syntax-Index-1_fn_letter-A" class="summary-letter"><b>A</b></a>
5790 &nbsp;
5791 <a href="#Function-and-Syntax-Index-1_fn_letter-E" class="summary-letter"><b>E</b></a>
5792 &nbsp;
5793 <a href="#Function-and-Syntax-Index-1_fn_letter-F" class="summary-letter"><b>F</b></a>
5794 &nbsp;
5795 <a href="#Function-and-Syntax-Index-1_fn_letter-G" class="summary-letter"><b>G</b></a>
5796 &nbsp;
5797 <a href="#Function-and-Syntax-Index-1_fn_letter-L" class="summary-letter"><b>L</b></a>
5798 &nbsp;
5799 <a href="#Function-and-Syntax-Index-1_fn_letter-M" class="summary-letter"><b>M</b></a>
5800 &nbsp;
5801 <a href="#Function-and-Syntax-Index-1_fn_letter-P" class="summary-letter"><b>P</b></a>
5802 &nbsp;
5803 <a href="#Function-and-Syntax-Index-1_fn_letter-Q" class="summary-letter"><b>Q</b></a>
5804 &nbsp;
5805 <a href="#Function-and-Syntax-Index-1_fn_letter-R" class="summary-letter"><b>R</b></a>
5806 &nbsp;
5807 <a href="#Function-and-Syntax-Index-1_fn_letter-S" class="summary-letter"><b>S</b></a>
5808 &nbsp;
5809 <a href="#Function-and-Syntax-Index-1_fn_letter-T" class="summary-letter"><b>T</b></a>
5810 &nbsp;
5811 <a href="#Function-and-Syntax-Index-1_fn_letter-V" class="summary-letter"><b>V</b></a>
5812 &nbsp;
5813 </td></tr></table>
5814
5815 <hr size="6">
5816 <a name="Module-Index"></a>
5817 <table cellpadding="1" cellspacing="1" border="0">
5818 <tr><td valign="middle" align="left">[<a href="#Function-and-Syntax-Index" title="Previous section in reading order"> &lt; </a>]</td>
5819 <td valign="middle" align="left">[<a href="#Class-Index" title="Next section in reading order"> &gt; </a>]</td>
5820 <td valign="middle" align="left"> &nbsp; </td>
5821 <td valign="middle" align="left">[<a href="#Indices" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
5822 <td valign="middle" align="left">[<a href="#Indices" title="Up section"> Up </a>]</td>
5823 <td valign="middle" align="left">[ &gt;&gt; ]</td>
5824 <td valign="middle" align="left"> &nbsp; </td>
5825 <td valign="middle" align="left"> &nbsp; </td>
5826 <td valign="middle" align="left"> &nbsp; </td>
5827 <td valign="middle" align="left"> &nbsp; </td>
5828 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
5829 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
5830 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
5831 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
5832 </tr></table>
5833 <a name="Module-Index-1"></a>
5834 <h2 class="appendixsec">A.2 Module Index</h2>
5835 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#Module-Index-1_md_letter-G" class="summary-letter"><b>G</b></a>
5836 &nbsp;
5837 </td></tr></table>
5838 <table border="0" class="index-md">
5839 <tr><td></td><th align="left">Index Entry</th><th align="left"> Section</th></tr>
5840 <tr><td colspan="3"> <hr></td></tr>
5841 <tr><th><a name="Module-Index-1_md_letter-G">G</a></th><td></td><td></td></tr>
5842 <tr><td></td><td valign="top"><a href="#index-gl_002emath3d-1"><code>gl.math3d</code></a></td><td valign="top"><a href="#Vectors-and-matrices">6. Vectors and matrices</a></td></tr>
5843 <tr><td></td><td valign="top"><a href="#index-gl_002esimple_002eimage-1"><code>gl.simple.image</code></a></td><td valign="top"><a href="#Simple-image-handling">7.1 Simple image handling</a></td></tr>
5844 <tr><td></td><td valign="top"><a href="#index-gl_002esimple_002eviewer-1"><code>gl.simple.viewer</code></a></td><td valign="top"><a href="#Simple-viewer">7.2 Simple viewer</a></td></tr>
5845 <tr><td colspan="3"> <hr></td></tr>
5846 </table>
5847 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#Module-Index-1_md_letter-G" class="summary-letter"><b>G</b></a>
5848 &nbsp;
5849 </td></tr></table>
5850
5851 <hr size="6">
5852 <a name="Class-Index"></a>
5853 <table cellpadding="1" cellspacing="1" border="0">
5854 <tr><td valign="middle" align="left">[<a href="#Module-Index" title="Previous section in reading order"> &lt; </a>]</td>
5855 <td valign="middle" align="left">[<a href="#Variable-Index" title="Next section in reading order"> &gt; </a>]</td>
5856 <td valign="middle" align="left"> &nbsp; </td>
5857 <td valign="middle" align="left">[<a href="#Indices" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
5858 <td valign="middle" align="left">[<a href="#Indices" title="Up section"> Up </a>]</td>
5859 <td valign="middle" align="left">[ &gt;&gt; ]</td>
5860 <td valign="middle" align="left"> &nbsp; </td>
5861 <td valign="middle" align="left"> &nbsp; </td>
5862 <td valign="middle" align="left"> &nbsp; </td>
5863 <td valign="middle" align="left"> &nbsp; </td>
5864 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
5865 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
5866 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
5867 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
5868 </tr></table>
5869 <a name="Class-Index-1"></a>
5870 <h2 class="appendixsec">A.3 Class Index</h2>
5871
5872 <p>For readability, the surrounding <code>&lt;</code> and <code>&gt;</code> are stripped off.
5873 </p>
5874 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#Class-Index-1_cl_letter-G" class="summary-letter"><b>G</b></a>
5875 &nbsp;
5876 <a href="#Class-Index-1_cl_letter-M" class="summary-letter"><b>M</b></a>
5877 &nbsp;
5878 <a href="#Class-Index-1_cl_letter-P" class="summary-letter"><b>P</b></a>
5879 &nbsp;
5880 <a href="#Class-Index-1_cl_letter-Q" class="summary-letter"><b>Q</b></a>
5881 &nbsp;
5882 <a href="#Class-Index-1_cl_letter-V" class="summary-letter"><b>V</b></a>
5883 &nbsp;
5884 </td></tr></table>
5885 <table border="0" class="index-cl">
5886 <tr><td></td><th align="left">Index Entry</th><th align="left"> Section</th></tr>
5887 <tr><td colspan="3"> <hr></td></tr>
5888 <tr><th><a name="Class-Index-1_cl_letter-G">G</a></th><td></td><td></td></tr>
5889 <tr><td></td><td valign="top"><a href="#index-glut_002dfont"><code>glut-font</code></a></td><td valign="top"><a href="#GLUT-font">5.7 GLUT font</a></td></tr>
5890 <tr><td colspan="3"> <hr></td></tr>
5891 <tr><th><a name="Class-Index-1_cl_letter-M">M</a></th><td></td><td></td></tr>
5892 <tr><td></td><td valign="top"><a href="#index-matrix4f"><code>matrix4f</code></a></td><td valign="top"><a href="#Matrices">6.3 Matrices</a></td></tr>
5893 <tr><td colspan="3"> <hr></td></tr>
5894 <tr><th><a name="Class-Index-1_cl_letter-P">P</a></th><td></td><td></td></tr>
5895 <tr><td></td><td valign="top"><a href="#index-point4f"><code>point4f</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5896 <tr><td></td><td valign="top"><a href="#index-point4f_002darray"><code>point4f-array</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5897 <tr><td colspan="3"> <hr></td></tr>
5898 <tr><th><a name="Class-Index-1_cl_letter-Q">Q</a></th><td></td><td></td></tr>
5899 <tr><td></td><td valign="top"><a href="#index-quatf"><code>quatf</code></a></td><td valign="top"><a href="#Quaternions">6.4 Quaternions</a></td></tr>
5900 <tr><td colspan="3"> <hr></td></tr>
5901 <tr><th><a name="Class-Index-1_cl_letter-V">V</a></th><td></td><td></td></tr>
5902 <tr><td></td><td valign="top"><a href="#index-vector4f"><code>vector4f</code></a></td><td valign="top"><a href="#Vectors-and-points">6.1 Vectors and points</a></td></tr>
5903 <tr><td></td><td valign="top"><a href="#index-vector4f_002darray"><code>vector4f-array</code></a></td><td valign="top"><a href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></td></tr>
5904 <tr><td colspan="3"> <hr></td></tr>
5905 </table>
5906 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#Class-Index-1_cl_letter-G" class="summary-letter"><b>G</b></a>
5907 &nbsp;
5908 <a href="#Class-Index-1_cl_letter-M" class="summary-letter"><b>M</b></a>
5909 &nbsp;
5910 <a href="#Class-Index-1_cl_letter-P" class="summary-letter"><b>P</b></a>
5911 &nbsp;
5912 <a href="#Class-Index-1_cl_letter-Q" class="summary-letter"><b>Q</b></a>
5913 &nbsp;
5914 <a href="#Class-Index-1_cl_letter-V" class="summary-letter"><b>V</b></a>
5915 &nbsp;
5916 </td></tr></table>
5917
5918 <hr size="6">
5919 <a name="Variable-Index"></a>
5920 <table cellpadding="1" cellspacing="1" border="0">
5921 <tr><td valign="middle" align="left">[<a href="#Class-Index" title="Previous section in reading order"> &lt; </a>]</td>
5922 <td valign="middle" align="left">[ &gt; ]</td>
5923 <td valign="middle" align="left"> &nbsp; </td>
5924 <td valign="middle" align="left">[<a href="#Indices" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
5925 <td valign="middle" align="left">[<a href="#Indices" title="Up section"> Up </a>]</td>
5926 <td valign="middle" align="left">[ &gt;&gt; ]</td>
5927 <td valign="middle" align="left"> &nbsp; </td>
5928 <td valign="middle" align="left"> &nbsp; </td>
5929 <td valign="middle" align="left"> &nbsp; </td>
5930 <td valign="middle" align="left"> &nbsp; </td>
5931 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
5932 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
5933 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
5934 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
5935 </tr></table>
5936 <a name="Variable-Index-1"></a>
5937 <h2 class="appendixsec">A.4 Variable Index</h2>
5938 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#Variable-Index-1_vr_letter-G" class="summary-letter"><b>G</b></a>
5939 &nbsp;
5940 </td></tr></table>
5941 <table border="0" class="index-vr">
5942 <tr><td></td><th align="left">Index Entry</th><th align="left"> Section</th></tr>
5943 <tr><td colspan="3"> <hr></td></tr>
5944 <tr><th><a name="Variable-Index-1_vr_letter-G">G</a></th><td></td><td></td></tr>
5945 <tr><td></td><td valign="top"><a href="#index-GLUT_005fACCUM"><code>GLUT_ACCUM</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5946 <tr><td></td><td valign="top"><a href="#index-GLUT_005fACTIVE_005fALT"><code>GLUT_ACTIVE_ALT</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5947 <tr><td></td><td valign="top"><a href="#index-GLUT_005fACTIVE_005fCTRL"><code>GLUT_ACTIVE_CTRL</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5948 <tr><td></td><td valign="top"><a href="#index-GLUT_005fACTIVE_005fSHIFT"><code>GLUT_ACTIVE_SHIFT</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5949 <tr><td></td><td valign="top"><a href="#index-GLUT_005fALPHA"><code>GLUT_ALPHA</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5950 <tr><td></td><td valign="top"><a href="#index-GLUT_005fBLUE"><code>GLUT_BLUE</code></a></td><td valign="top"><a href="#GLUT-colormap">5.5 GLUT colormap</a></td></tr>
5951 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fBOTTOM_005fLEFT_005fCORNER"><code>GLUT_CURSOR_BOTTOM_LEFT_CORNER</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5952 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fBOTTOM_005fRIGHT_005fCORNER"><code>GLUT_CURSOR_BOTTOM_RIGHT_CORNER</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5953 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fBOTTOM_005fSIDE"><code>GLUT_CURSOR_BOTTOM_SIDE</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5954 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fCROSSHAIR"><code>GLUT_CURSOR_CROSSHAIR</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5955 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fCYCLE"><code>GLUT_CURSOR_CYCLE</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5956 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fDESTROY"><code>GLUT_CURSOR_DESTROY</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5957 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fFULL_005fCROSSHAIR"><code>GLUT_CURSOR_FULL_CROSSHAIR</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5958 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fHELP"><code>GLUT_CURSOR_HELP</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5959 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fINFO"><code>GLUT_CURSOR_INFO</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5960 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fINHERIT"><code>GLUT_CURSOR_INHERIT</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5961 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fLEFT_005fARROW"><code>GLUT_CURSOR_LEFT_ARROW</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5962 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fLEFT_005fRIGHT"><code>GLUT_CURSOR_LEFT_RIGHT</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5963 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fLEFT_005fSIDE"><code>GLUT_CURSOR_LEFT_SIDE</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5964 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fNONE"><code>GLUT_CURSOR_NONE</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5965 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fRIGHT_005fARROW"><code>GLUT_CURSOR_RIGHT_ARROW</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5966 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fRIGHT_005fSIDE"><code>GLUT_CURSOR_RIGHT_SIDE</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5967 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fSPRAY"><code>GLUT_CURSOR_SPRAY</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5968 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fTEXT"><code>GLUT_CURSOR_TEXT</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5969 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fTOP_005fLEFT_005fCORNER"><code>GLUT_CURSOR_TOP_LEFT_CORNER</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5970 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fTOP_005fRIGHT_005fCORNER"><code>GLUT_CURSOR_TOP_RIGHT_CORNER</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5971 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fTOP_005fSIDE"><code>GLUT_CURSOR_TOP_SIDE</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5972 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fUP_005fDOWN"><code>GLUT_CURSOR_UP_DOWN</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5973 <tr><td></td><td valign="top"><a href="#index-GLUT_005fCURSOR_005fWAIT"><code>GLUT_CURSOR_WAIT</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5974 <tr><td></td><td valign="top"><a href="#index-GLUT_005fDEPTH"><code>GLUT_DEPTH</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5975 <tr><td></td><td valign="top"><a href="#index-GLUT_005fDEVICE_005fIGNORE_005fKEY_005fREPEAT"><code>GLUT_DEVICE_IGNORE_KEY_REPEAT</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5976 <tr><td></td><td valign="top"><a href="#index-GLUT_005fDEVICE_005fKEY_005fREPEAT"><code>GLUT_DEVICE_KEY_REPEAT</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5977 <tr><td></td><td valign="top"><a href="#index-GLUT_005fDISPLAY_005fMODE_005fPOSSIBLE"><code>GLUT_DISPLAY_MODE_POSSIBLE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5978 <tr><td></td><td valign="top"><a href="#index-GLUT_005fDOUBLE"><code>GLUT_DOUBLE</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5979 <tr><td></td><td valign="top"><a href="#index-GLUT_005fDOWN"><code>GLUT_DOWN</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5980 <tr><td></td><td valign="top"><a href="#index-GLUT_005fELAPSED_005fTIME"><code>GLUT_ELAPSED_TIME</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5981 <tr><td></td><td valign="top"><a href="#index-GLUT_005fENTERED"><code>GLUT_ENTERED</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
5982 <tr><td></td><td valign="top"><a href="#index-GLUT_005fGREEN"><code>GLUT_GREEN</code></a></td><td valign="top"><a href="#GLUT-colormap">5.5 GLUT colormap</a></td></tr>
5983 <tr><td></td><td valign="top"><a href="#index-GLUT_005fHAS_005fDIAL_005fAND_005fBUTTON_005fBOX"><code>GLUT_HAS_DIAL_AND_BUTTON_BOX</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5984 <tr><td></td><td valign="top"><a href="#index-GLUT_005fHAS_005fJOYSTICK"><code>GLUT_HAS_JOYSTICK</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5985 <tr><td></td><td valign="top"><a href="#index-GLUT_005fHAS_005fKEYBOARD"><code>GLUT_HAS_KEYBOARD</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5986 <tr><td></td><td valign="top"><a href="#index-GLUT_005fHAS_005fMOUSE"><code>GLUT_HAS_MOUSE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5987 <tr><td></td><td valign="top"><a href="#index-GLUT_005fHAS_005fOVERLAY"><code>GLUT_HAS_OVERLAY</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5988 <tr><td></td><td valign="top"><a href="#index-GLUT_005fHAS_005fSPACEBALL"><code>GLUT_HAS_SPACEBALL</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5989 <tr><td></td><td valign="top"><a href="#index-GLUT_005fHAS_005fTABLET"><code>GLUT_HAS_TABLET</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5990 <tr><td></td><td valign="top"><a href="#index-GLUT_005fINDEX"><code>GLUT_INDEX</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
5991 <tr><td></td><td valign="top"><a href="#index-GLUT_005fINIT_005fDISPLAY_005fMODE"><code>GLUT_INIT_DISPLAY_MODE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5992 <tr><td></td><td valign="top"><a href="#index-GLUT_005fINIT_005fWINDOW_005fHEIGHT"><code>GLUT_INIT_WINDOW_HEIGHT</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5993 <tr><td></td><td valign="top"><a href="#index-GLUT_005fINIT_005fWINDOW_005fWIDTH"><code>GLUT_INIT_WINDOW_WIDTH</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5994 <tr><td></td><td valign="top"><a href="#index-GLUT_005fINIT_005fWINDOW_005fX"><code>GLUT_INIT_WINDOW_X</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5995 <tr><td></td><td valign="top"><a href="#index-GLUT_005fINIT_005fWINDOW_005fY"><code>GLUT_INIT_WINDOW_Y</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5996 <tr><td></td><td valign="top"><a href="#index-GLUT_005fJOYSTICK_005fAXES"><code>GLUT_JOYSTICK_AXES</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5997 <tr><td></td><td valign="top"><a href="#index-GLUT_005fJOYSTICK_005fBUTTONS"><code>GLUT_JOYSTICK_BUTTONS</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5998 <tr><td></td><td valign="top"><a href="#index-GLUT_005fJOYSTICK_005fPOLL_005fRATE"><code>GLUT_JOYSTICK_POLL_RATE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
5999 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fDOWN"><code>GLUT_KEY_DOWN</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6000 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fEND"><code>GLUT_KEY_END</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6001 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fF1"><code>GLUT_KEY_F1</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6002 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fF10"><code>GLUT_KEY_F10</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6003 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fF11"><code>GLUT_KEY_F11</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6004 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fF12"><code>GLUT_KEY_F12</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6005 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fF2"><code>GLUT_KEY_F2</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6006 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fF3"><code>GLUT_KEY_F3</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6007 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fF4"><code>GLUT_KEY_F4</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6008 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fF5"><code>GLUT_KEY_F5</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6009 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fF6"><code>GLUT_KEY_F6</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6010 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fF7"><code>GLUT_KEY_F7</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6011 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fF8"><code>GLUT_KEY_F8</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6012 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fF9"><code>GLUT_KEY_F9</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6013 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fHOME"><code>GLUT_KEY_HOME</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6014 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fINSERT"><code>GLUT_KEY_INSERT</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6015 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fLEFT"><code>GLUT_KEY_LEFT</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6016 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fPAGE_005fDOWN"><code>GLUT_KEY_PAGE_DOWN</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6017 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fPAGE_005fUP"><code>GLUT_KEY_PAGE_UP</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6018 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fRIGHT"><code>GLUT_KEY_RIGHT</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6019 <tr><td></td><td valign="top"><a href="#index-GLUT_005fKEY_005fUP"><code>GLUT_KEY_UP</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6020 <tr><td></td><td valign="top"><a href="#index-GLUT_005fLAYER_005fIN_005fUSE"><code>GLUT_LAYER_IN_USE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6021 <tr><td></td><td valign="top"><a href="#index-GLUT_005fLEFT"><code>GLUT_LEFT</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6022 <tr><td></td><td valign="top"><a href="#index-GLUT_005fLEFT_005fBUTTON"><code>GLUT_LEFT_BUTTON</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6023 <tr><td></td><td valign="top"><a href="#index-GLUT_005fLUMINANCE"><code>GLUT_LUMINANCE</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
6024 <tr><td></td><td valign="top"><a href="#index-GLUT_005fMENU_005fNUM_005fITEMS"><code>GLUT_MENU_NUM_ITEMS</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6025 <tr><td></td><td valign="top"><a href="#index-GLUT_005fMIDDLE_005fBUTTON"><code>GLUT_MIDDLE_BUTTON</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6026 <tr><td></td><td valign="top"><a href="#index-GLUT_005fMULTISAMPLE"><code>GLUT_MULTISAMPLE</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
6027 <tr><td></td><td valign="top"><a href="#index-GLUT_005fNORMAL_005fDAMAGED"><code>GLUT_NORMAL_DAMAGED</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6028 <tr><td></td><td valign="top"><a href="#index-GLUT_005fNOT_005fVISIBLE"><code>GLUT_NOT_VISIBLE</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6029 <tr><td></td><td valign="top"><a href="#index-GLUT_005fNUM_005fBUTTON_005fBOX_005fBUTTONS"><code>GLUT_NUM_BUTTON_BOX_BUTTONS</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6030 <tr><td></td><td valign="top"><a href="#index-GLUT_005fNUM_005fDIALS"><code>GLUT_NUM_DIALS</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6031 <tr><td></td><td valign="top"><a href="#index-GLUT_005fNUM_005fMOUSE_005fBUTTONS"><code>GLUT_NUM_MOUSE_BUTTONS</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6032 <tr><td></td><td valign="top"><a href="#index-GLUT_005fNUM_005fSPACEBALL_005fBUTTONS"><code>GLUT_NUM_SPACEBALL_BUTTONS</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6033 <tr><td></td><td valign="top"><a href="#index-GLUT_005fNUM_005fTABLET_005fBUTTONS"><code>GLUT_NUM_TABLET_BUTTONS</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6034 <tr><td></td><td valign="top"><a href="#index-GLUT_005fOVERLAY_005fDAMAGED"><code>GLUT_OVERLAY_DAMAGED</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6035 <tr><td></td><td valign="top"><a href="#index-GLUT_005fOVERLAY_005fPOSSIBLE"><code>GLUT_OVERLAY_POSSIBLE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6036 <tr><td></td><td valign="top"><a href="#index-GLUT_005fOWNS_005fJOYSTICK"><code>GLUT_OWNS_JOYSTICK</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6037 <tr><td></td><td valign="top"><a href="#index-GLUT_005fRED"><code>GLUT_RED</code></a></td><td valign="top"><a href="#GLUT-colormap">5.5 GLUT colormap</a></td></tr>
6038 <tr><td></td><td valign="top"><a href="#index-GLUT_005fRGB"><code>GLUT_RGB</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
6039 <tr><td></td><td valign="top"><a href="#index-GLUT_005fRGBA"><code>GLUT_RGBA</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
6040 <tr><td></td><td valign="top"><a href="#index-GLUT_005fRIGHT_005fBUTTON"><code>GLUT_RIGHT_BUTTON</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6041 <tr><td></td><td valign="top"><a href="#index-GLUT_005fSCREEN_005fHEIGHT"><code>GLUT_SCREEN_HEIGHT</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6042 <tr><td></td><td valign="top"><a href="#index-GLUT_005fSCREEN_005fHEIGHT_005fMM"><code>GLUT_SCREEN_HEIGHT_MM</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6043 <tr><td></td><td valign="top"><a href="#index-GLUT_005fSCREEN_005fWIDTH"><code>GLUT_SCREEN_WIDTH</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6044 <tr><td></td><td valign="top"><a href="#index-GLUT_005fSCREEN_005fWIDTH_005fMM"><code>GLUT_SCREEN_WIDTH_MM</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6045 <tr><td></td><td valign="top"><a href="#index-GLUT_005fSINGLE"><code>GLUT_SINGLE</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
6046 <tr><td></td><td valign="top"><a href="#index-GLUT_005fSTENCIL"><code>GLUT_STENCIL</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
6047 <tr><td></td><td valign="top"><a href="#index-GLUT_005fSTEREO"><code>GLUT_STEREO</code></a></td><td valign="top"><a href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></td></tr>
6048 <tr><td></td><td valign="top"><a href="#index-GLUT_005fTRANSPARENT_005fINDEX"><code>GLUT_TRANSPARENT_INDEX</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6049 <tr><td></td><td valign="top"><a href="#index-GLUT_005fUP"><code>GLUT_UP</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6050 <tr><td></td><td valign="top"><a href="#index-GLUT_005fVISIBLE"><code>GLUT_VISIBLE</code></a></td><td valign="top"><a href="#GLUT-callbacks">5.4 GLUT callbacks</a></td></tr>
6051 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fACCUM_005fALPHA_005fSIZE"><code>GLUT_WINDOW_ACCUM_ALPHA_SIZE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6052 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fACCUM_005fBLUE_005fSIZE"><code>GLUT_WINDOW_ACCUM_BLUE_SIZE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6053 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fACCUM_005fGREEN_005fSIZE"><code>GLUT_WINDOW_ACCUM_GREEN_SIZE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6054 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fACCUM_005fRED_005fSIZE"><code>GLUT_WINDOW_ACCUM_RED_SIZE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6055 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fALPHA_005fSIZE"><code>GLUT_WINDOW_ALPHA_SIZE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6056 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fBLUE_005fSIZE"><code>GLUT_WINDOW_BLUE_SIZE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6057 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fBUFFER_005fSIZE"><code>GLUT_WINDOW_BUFFER_SIZE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6058 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fCOLORMAP_005fSIZE"><code>GLUT_WINDOW_COLORMAP_SIZE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6059 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fCURSOR"><code>GLUT_WINDOW_CURSOR</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6060 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fDEPTH_005fSIZE"><code>GLUT_WINDOW_DEPTH_SIZE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6061 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fDOUBLEBUFFER"><code>GLUT_WINDOW_DOUBLEBUFFER</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6062 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fFORMAT_005fID"><code>GLUT_WINDOW_FORMAT_ID</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6063 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fGREEN_005fSIZE"><code>GLUT_WINDOW_GREEN_SIZE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6064 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fHEIGHT"><code>GLUT_WINDOW_HEIGHT</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6065 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fNUM_005fCHILDREN"><code>GLUT_WINDOW_NUM_CHILDREN</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6066 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fNUM_005fSAMPLES"><code>GLUT_WINDOW_NUM_SAMPLES</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6067 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fPARENT"><code>GLUT_WINDOW_PARENT</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6068 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fRED_005fSIZE"><code>GLUT_WINDOW_RED_SIZE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6069 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fRGBA"><code>GLUT_WINDOW_RGBA</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6070 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fSTENCIL_005fSIZE"><code>GLUT_WINDOW_STENCIL_SIZE</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6071 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fSTEREO"><code>GLUT_WINDOW_STEREO</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6072 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fWIDTH"><code>GLUT_WINDOW_WIDTH</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6073 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fX"><code>GLUT_WINDOW_X</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6074 <tr><td></td><td valign="top"><a href="#index-GLUT_005fWINDOW_005fY"><code>GLUT_WINDOW_Y</code></a></td><td valign="top"><a href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></td></tr>
6075 <tr><td></td><td valign="top"><a href="#index-GLU_005fFILL"><code>GLU_FILL</code></a></td><td valign="top"><a href="#Quadrics">4.15 Quadrics</a></td></tr>
6076 <tr><td></td><td valign="top"><a href="#index-GLU_005fFLAT"><code>GLU_FLAT</code></a></td><td valign="top"><a href="#Quadrics">4.15 Quadrics</a></td></tr>
6077 <tr><td></td><td valign="top"><a href="#index-GLU_005fINSIDE"><code>GLU_INSIDE</code></a></td><td valign="top"><a href="#Quadrics">4.15 Quadrics</a></td></tr>
6078 <tr><td></td><td valign="top"><a href="#index-GLU_005fLINE"><code>GLU_LINE</code></a></td><td valign="top"><a href="#Quadrics">4.15 Quadrics</a></td></tr>
6079 <tr><td></td><td valign="top"><a href="#index-GLU_005fNONE"><code>GLU_NONE</code></a></td><td valign="top"><a href="#Quadrics">4.15 Quadrics</a></td></tr>
6080 <tr><td></td><td valign="top"><a href="#index-GLU_005fOUTSIDE"><code>GLU_OUTSIDE</code></a></td><td valign="top"><a href="#Quadrics">4.15 Quadrics</a></td></tr>
6081 <tr><td></td><td valign="top"><a href="#index-GLU_005fPOINT"><code>GLU_POINT</code></a></td><td valign="top"><a href="#Quadrics">4.15 Quadrics</a></td></tr>
6082 <tr><td></td><td valign="top"><a href="#index-GLU_005fSILHUETTE"><code>GLU_SILHUETTE</code></a></td><td valign="top"><a href="#Quadrics">4.15 Quadrics</a></td></tr>
6083 <tr><td></td><td valign="top"><a href="#index-GLU_005fSMOOTH"><code>GLU_SMOOTH</code></a></td><td valign="top"><a href="#Quadrics">4.15 Quadrics</a></td></tr>
6084 <tr><td></td><td valign="top"><a href="#index-GL_005fLINES"><code>GL_LINES</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
6085 <tr><td></td><td valign="top"><a href="#index-GL_005fLINE_005fLOOP"><code>GL_LINE_LOOP</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
6086 <tr><td></td><td valign="top"><a href="#index-GL_005fLINE_005fSTRIP"><code>GL_LINE_STRIP</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
6087 <tr><td></td><td valign="top"><a href="#index-GL_005fPOINTS"><code>GL_POINTS</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
6088 <tr><td></td><td valign="top"><a href="#index-GL_005fPOLYGON"><code>GL_POLYGON</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
6089 <tr><td></td><td valign="top"><a href="#index-GL_005fQUADS"><code>GL_QUADS</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
6090 <tr><td></td><td valign="top"><a href="#index-GL_005fQUAD_005fSTRIP"><code>GL_QUAD_STRIP</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
6091 <tr><td></td><td valign="top"><a href="#index-GL_005fTRIANGLES"><code>GL_TRIANGLES</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
6092 <tr><td></td><td valign="top"><a href="#index-GL_005fTRIANGLE_005fFAN"><code>GL_TRIANGLE_FAN</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
6093 <tr><td></td><td valign="top"><a href="#index-GL_005fTRIANGLE_005fSTRIP"><code>GL_TRIANGLE_STRIP</code></a></td><td valign="top"><a href="#Drawing-functions">4.3 Drawing functions</a></td></tr>
6094 <tr><td colspan="3"> <hr></td></tr>
6095 </table>
6096 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#Variable-Index-1_vr_letter-G" class="summary-letter"><b>G</b></a>
6097 &nbsp;
6098 </td></tr></table>
6099
6100
6101 <hr size="6">
6102 <a name="SEC_Contents"></a>
6103 <table cellpadding="1" cellspacing="1" border="0">
6104 <tr><td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6105 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6106 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
6107 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6108 </tr></table>
6109 <h1>Table of Contents</h1>
6110 <div class="contents">
6111
6112 <ul class="toc">
6113 <li><a name="toc-Introduction-1" href="#Introduction">1. Introduction</a></li>
6114 <li><a name="toc-Installation-1" href="#Installation">2. Installation</a></li>
6115 <li><a name="toc-Getting-Started-1" href="#Getting-Started">3. Getting Started</a>
6116 <ul class="toc">
6117 <li><a name="toc-GL-calls-in-Scheme-1" href="#GL-calls-in-Scheme">3.1 GL calls in Scheme</a></li>
6118 <li><a name="toc-Advanced-GL-features-1" href="#Advanced-GL-features">3.2 Advanced GL features</a></li>
6119 <li><a name="toc-Using-GLUT-1" href="#Using-GLUT">3.3 Using GLUT</a></li>
6120 <li><a name="toc-Performance-tips-1" href="#Performance-tips">3.4 Performance tips</a></li>
6121 </ul></li>
6122 <li><a name="toc-OpenGL-API-1" href="#OpenGL-API">4. OpenGL API</a>
6123 <ul class="toc">
6124 <li><a name="toc-GL-data-types-1" href="#GL-data-types">4.1 GL data types</a></li>
6125 <li><a name="toc-GL-feature-checking-1" href="#GL-feature-checking">4.2 GL feature checking</a></li>
6126 <li><a name="toc-Drawing-functions-1" href="#Drawing-functions">4.3 Drawing functions</a></li>
6127 <li><a name="toc-GL-state-control-1" href="#GL-state-control">4.4 GL state control</a></li>
6128 <li><a name="toc-GL-states-for-drawing-1" href="#GL-states-for-drawing">4.5 GL states for drawing</a></li>
6129 <li><a name="toc-Transformation-1" href="#Transformation">4.6 Transformation</a></li>
6130 <li><a name="toc-Display-lists-1" href="#Display-lists">4.7 Display lists</a></li>
6131 <li><a name="toc-Vertex-arrays-1" href="#Vertex-arrays">4.8 Vertex arrays</a></li>
6132 <li><a name="toc-Lighting-1" href="#Lighting">4.9 Lighting</a></li>
6133 <li><a name="toc-Pixels_002c-bitmaps-and-images" href="#Pixels">4.10 Pixels, bitmaps and images</a></li>
6134 <li><a name="toc-Texture-mapping-1" href="#Texture-mapping">4.11 Texture mapping</a></li>
6135 <li><a name="toc-Framebuffers-1" href="#Framebuffers">4.12 Framebuffers</a></li>
6136 <li><a name="toc-Selection-and-feedback-1" href="#Selection-and-feedback">4.13 Selection and feedback</a></li>
6137 <li><a name="toc-Projection-1" href="#Projection">4.14 Projection</a></li>
6138 <li><a name="toc-Quadrics-1" href="#Quadrics">4.15 Quadrics</a></li>
6139 <li><a name="toc-Nurbs-1" href="#Nurbs">4.16 Nurbs</a></li>
6140 <li><a name="toc-Polygon-tesselation-1" href="#Polygon-tesselation">4.17 Polygon tesselation</a></li>
6141 <li><a name="toc-Programmable-shaders-1" href="#Programmable-shaders">4.18 Programmable shaders</a></li>
6142 </ul></li>
6143 <li><a name="toc-GLUT-API-1" href="#GLUT-API">5. GLUT API</a>
6144 <ul class="toc">
6145 <li><a name="toc-GLUT-window-manipulation-1" href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></li>
6146 <li><a name="toc-GLUT-overlay-1" href="#GLUT-overlay">5.2 GLUT overlay</a></li>
6147 <li><a name="toc-GLUT-menu-API-1" href="#GLUT-menu-API">5.3 GLUT menu API</a></li>
6148 <li><a name="toc-GLUT-callbacks-1" href="#GLUT-callbacks">5.4 GLUT callbacks</a></li>
6149 <li><a name="toc-GLUT-colormap-1" href="#GLUT-colormap">5.5 GLUT colormap</a></li>
6150 <li><a name="toc-GLUT-state-retrieval-1" href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></li>
6151 <li><a name="toc-GLUT-font-1" href="#GLUT-font">5.7 GLUT font</a></li>
6152 <li><a name="toc-GLUT-pre_002dbuilt-models-1" href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></li>
6153 </ul></li>
6154 <li><a name="toc-Vectors-and-matrices-1" href="#Vectors-and-matrices">6. Vectors and matrices</a>
6155 <ul class="toc">
6156 <li><a name="toc-Vectors-and-points-1" href="#Vectors-and-points">6.1 Vectors and points</a></li>
6157 <li><a name="toc-Vector-arrays-and-point-arrays-1" href="#Vector-arrays-and-point-arrays">6.2 Vector arrays and point arrays</a></li>
6158 <li><a name="toc-Matrices-1" href="#Matrices">6.3 Matrices</a></li>
6159 <li><a name="toc-Quaternions-1" href="#Quaternions">6.4 Quaternions</a></li>
6160 </ul></li>
6161 <li><a name="toc-Simple-utilities-1" href="#Simple-utilities">7. Simple utilities</a>
6162 <ul class="toc">
6163 <li><a name="toc-Simple-image-handling-1" href="#Simple-image-handling">7.1 Simple image handling</a></li>
6164 <li><a name="toc-Simple-viewer-1" href="#Simple-viewer">7.2 Simple viewer</a></li>
6165 </ul></li>
6166 <li><a name="toc-Indices-1" href="#Indices">A. Indices</a>
6167 <ul class="toc">
6168 <li><a name="toc-Function-and-Syntax-Index-1" href="#Function-and-Syntax-Index">A.1 Function and Syntax Index</a></li>
6169 <li><a name="toc-Module-Index-1" href="#Module-Index">A.2 Module Index</a></li>
6170 <li><a name="toc-Class-Index-1" href="#Class-Index">A.3 Class Index</a></li>
6171 <li><a name="toc-Variable-Index-1" href="#Variable-Index">A.4 Variable Index</a></li>
6172 </ul>
6173 </li>
6174 </ul>
6175 </div>
6176 <hr size="1">
6177 <a name="SEC_About"></a>
6178 <table cellpadding="1" cellspacing="1" border="0">
6179 <tr><td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6180 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6181 <td valign="middle" align="left">[<a href="#Indices" title="Index">Index</a>]</td>
6182 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6183 </tr></table>
6184 <h1>About This Document</h1>
6185 <p>
6186 This document was generated on <i>August 9, 2014</i> using <a href="http://www.nongnu.org/texi2html/"><i>texi2html 1.82</i></a>.
6187 </p>
6188 <p>
6189 The buttons in the navigation panels have the following meaning:
6190 </p>
6191 <table border="1">
6192 <tr>
6193 <th> Button </th>
6194 <th> Name </th>
6195 <th> Go to </th>
6196 <th> From 1.2.3 go to</th>
6197 </tr>
6198 <tr>
6199 <td align="center"> [ &lt; ] </td>
6200 <td align="center">Back</td>
6201 <td>Previous section in reading order</td>
6202 <td>1.2.2</td>
6203 </tr>
6204 <tr>
6205 <td align="center"> [ &gt; ] </td>
6206 <td align="center">Forward</td>
6207 <td>Next section in reading order</td>
6208 <td>1.2.4</td>
6209 </tr>
6210 <tr>
6211 <td align="center"> [ &lt;&lt; ] </td>
6212 <td align="center">FastBack</td>
6213 <td>Beginning of this chapter or previous chapter</td>
6214 <td>1</td>
6215 </tr>
6216 <tr>
6217 <td align="center"> [ Up ] </td>
6218 <td align="center">Up</td>
6219 <td>Up section</td>
6220 <td>1.2</td>
6221 </tr>
6222 <tr>
6223 <td align="center"> [ &gt;&gt; ] </td>
6224 <td align="center">FastForward</td>
6225 <td>Next chapter</td>
6226 <td>2</td>
6227 </tr>
6228 <tr>
6229 <td align="center"> [Top] </td>
6230 <td align="center">Top</td>
6231 <td>Cover (top) of document</td>
6232 <td> &nbsp; </td>
6233 </tr>
6234 <tr>
6235 <td align="center"> [Contents] </td>
6236 <td align="center">Contents</td>
6237 <td>Table of contents</td>
6238 <td> &nbsp; </td>
6239 </tr>
6240 <tr>
6241 <td align="center"> [Index] </td>
6242 <td align="center">Index</td>
6243 <td>Index</td>
6244 <td> &nbsp; </td>
6245 </tr>
6246 <tr>
6247 <td align="center"> [ ? ] </td>
6248 <td align="center">About</td>
6249 <td>About (help)</td>
6250 <td> &nbsp; </td>
6251 </tr>
6252 </table>
6253
6254 <p>
6255 where the <strong> Example </strong> assumes that the current position is at <strong> Subsubsection One-Two-Three </strong> of a document of the following structure:
6256 </p>
6257
6258 <ul>
6259 <li> 1. Section One
6260 <ul>
6261 <li>1.1 Subsection One-One
6262 <ul>
6263 <li>...</li>
6264 </ul>
6265 </li>
6266 <li>1.2 Subsection One-Two
6267 <ul>
6268 <li>1.2.1 Subsubsection One-Two-One</li>
6269 <li>1.2.2 Subsubsection One-Two-Two</li>
6270 <li>1.2.3 Subsubsection One-Two-Three &nbsp; &nbsp;
6271 <strong>&lt;== Current Position </strong></li>
6272 <li>1.2.4 Subsubsection One-Two-Four</li>
6273 </ul>
6274 </li>
6275 <li>1.3 Subsection One-Three
6276 <ul>
6277 <li>...</li>
6278 </ul>
6279 </li>
6280 <li>1.4 Subsection One-Four</li>
6281 </ul>
6282 </li>
6283 </ul>
6284
6285 <hr size="1">
6286 <p>
6287 <font size="-1">
6288 This document was generated on <i>August 9, 2014</i> using <a href="http://www.nongnu.org/texi2html/"><i>texi2html 1.82</i></a>.
6289 </font>
6290 <br>
6291
6292 </p>
6293 </body>
6294 </html>