Debian Codegraph @

doc/gauche-gl-refj.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="#g_t_00e7_00b4_00a2_00e5_00bc_0095" 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="#g_t_00e3_0081_00af_00e3_0081_0098_00e3_0082_0081_00e3_0081_00ab">1. はじめに</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
59 <tr><td align="left" valign="top"><a href="#Installation">2. Installation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
60 </td></tr>
61 <tr><td align="left" valign="top"><a href="#Getting-Started">3. Getting Started</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
62 </td></tr>
63 <tr><td align="left" valign="top"><a href="#OpenGL-API">4. OpenGL API</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
64 </td></tr>
65 <tr><td align="left" valign="top"><a href="#GLUT-API">5. GLUT API</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
66 </td></tr>
67 <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">
68 </td></tr>
69 <tr><td align="left" valign="top"><a href="#Simple-utilities">7. Simple utilities</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
70 </td></tr>
71 <tr><td align="left" valign="top"><a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095">A. 索引</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
72 </table>
73
74 <hr size="1">
75 <a name="g_t_00e3_0081_00af_00e3_0081_0098_00e3_0082_0081_00e3_0081_00ab"></a>
76 <table cellpadding="1" cellspacing="1" border="0">
77 <tr><td valign="middle" align="left">[<a href="#Top" title="Previous section in reading order"> &lt; </a>]</td>
78 <td valign="middle" align="left">[<a href="#Installation" title="Next section in reading order"> &gt; </a>]</td>
79 <td valign="middle" align="left"> &nbsp; </td>
80 <td valign="middle" align="left">[ &lt;&lt; ]</td>
81 <td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
82 <td valign="middle" align="left">[<a href="#Installation" title="Next chapter"> &gt;&gt; </a>]</td>
83 <td valign="middle" align="left"> &nbsp; </td>
84 <td valign="middle" align="left"> &nbsp; </td>
85 <td valign="middle" align="left"> &nbsp; </td>
86 <td valign="middle" align="left"> &nbsp; </td>
87 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
88 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
89 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
90 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
91 </tr></table>
92 <a name="a_0081_00afa_0081_0098a_0082_0081a_0081_00ab"></a>
93 <h1 class="chapter">1. はじめに</h1>
94
95 <p>Gauche-gl is an extension module of Gauche Scheme implementation.
96 It provides the following modules:
97 </p>
98 <dl compact="compact">
99 <dt> <code>gl</code></dt>
100 <dd><p>This module provides bindings to OpenGL API.
101 It covers most functions in OpenGL 1.0 through 2.0,
102 and GLU. The functions are described in <a href="#OpenGL-API">OpenGL API</a>.
103 </p></dd>
104 <dt> <code>gl.glut</code></dt>
105 <dd><p>This module provides bindings to most functions in GLUT.
106 The functions are described in <a href="#GLUT-API">GLUT API</a>.
107 </p></dd>
108 <dt> <code>gl.math3d</code></dt>
109 <dd><p>This module provides vector and matrix calculations
110 optimized for 3D homogeneous coordinates.
111 The vector and matrix objects here can be directly passed to
112 Gauche-gl functions.
113 The functions are descrbied in <a href="#Vectors-and-matrices">Vectors and matrices</a>.
114 </p></dd>
115 <dt> <code>gl.simple.*</code></dt>
116 <dd><p>These modules provide simple APIs for programmers to
117 hack up a very simple OpenGL application. They are by no
118 means intended for general application development, but
119 would be handy for throwaway script.
120 See <a href="#Simple-utilities">Simple utilities</a> for the details.
121 </p></dd>
122 </dl>
123
124 <hr size="6">
125 <a name="Installation"></a>
126 <table cellpadding="1" cellspacing="1" border="0">
127 <tr><td valign="middle" align="left">[<a href="#g_t_00e3_0081_00af_00e3_0081_0098_00e3_0082_0081_00e3_0081_00ab" title="Previous section in reading order"> &lt; </a>]</td>
128 <td valign="middle" align="left">[<a href="#Getting-Started" title="Next section in reading order"> &gt; </a>]</td>
129 <td valign="middle" align="left"> &nbsp; </td>
130 <td valign="middle" align="left">[<a href="#g_t_00e3_0081_00af_00e3_0081_0098_00e3_0082_0081_00e3_0081_00ab" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
131 <td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
132 <td valign="middle" align="left">[<a href="#Getting-Started" title="Next chapter"> &gt;&gt; </a>]</td>
133 <td valign="middle" align="left"> &nbsp; </td>
134 <td valign="middle" align="left"> &nbsp; </td>
135 <td valign="middle" align="left"> &nbsp; </td>
136 <td valign="middle" align="left"> &nbsp; </td>
137 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
138 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
139 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
140 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
141 </tr></table>
142 <a name="Installation-1"></a>
143 <h1 class="chapter">2. Installation</h1>
144
145 <p>Installing Gauche-gl is usually straightforward on Unix variants.
146 </p>
147 <p>You have to have the following programs installed on your machine.
148 </p><ul>
149 <li>
150 Gauche 0.8.5 or later
151 </li><li>
152 OpenGL 1.1 equivalent library; the auther checked with Mesa 3.4
153 and NVidia&rsquo;s GLX driver.
154 </li><li>
155 GLUT 3.7 or later.
156 </li></ul>
157
158 <p>The standard way to compile and install Gauche-gl is as follows:
159 </p><table><tr><td>&nbsp;</td><td><pre class="example">% gzcat Gauche-gl-0.6.tgz | tar xf -
160 % cd Gauche-gl-0.6
161 % ./configure
162 % make
163 % make test
164 % make install
165 </pre></td></tr></table>
166
167 <p>Or you can use &lsquo;<tt>gauche-package</tt>&rsquo; command:
168 </p><table><tr><td>&nbsp;</td><td><pre class="example">% gauche-package install -C=&lt;configure-option&gt; Gauche-gl-0.6.tgz
169 </pre></td></tr></table>
170
171
172 <p>The confiugre script figures out the location Gauche is installed,
173 and install Gauche-gl in the same place.
174 </p>
175 <p>If you have GLUT installed in non-standard place, you have to
176 tell the configure script where it is.
177 </p><table><tr><td>&nbsp;</td><td><pre class="example">% ./configure --with-glut=DIR
178 </pre></td></tr></table>
179
180 <p>Since version 0.4, Gauche-gl can be configured to include bindings
181 to NVidia&rsquo;s Cg Toolkit. The binding code is contributed by Issac Trotts.
182 To enable Cg binding, give <code>--enable-cg</code> option to the configure
183 script.
184 </p><table><tr><td>&nbsp;</td><td><pre class="example">% ./configure --enable-cg
185 </pre></td></tr></table>
186
187
188 <p>It is reported that Mesa in FreeBSD ports is compiled with pthreads
189 enabled, and Gauche-gl can&rsquo;t be linked unless Gauche itself is
190 compiled with pthreads. The configure script of Gauche prints
191 warning if you specify pthreads, but it is safe as far as you
192 don&rsquo;t call make-thread in your program.
193 </p>
194 <p>There are various examples under &lsquo;<tt>examples/</tt>&rsquo; directory.
195 If you want to run the examples before installing Gauche-gl,
196 you have to tell the location of the library to <code>gosh</code>
197 command, e.g. <code>gosh -I../src -I../lib gears.scm</code>.
198 Some demos under subdirectories have a shell script that invokes
199 <code>gosh</code> with proper command-line options.
200 </p>
201 <dl compact="compact">
202 <dt> &lsquo;<tt>gears.scm</tt>&rsquo;</dt>
203 <dd><p>Brian Paul&rsquo;s 3D gear wheels.
204 </p></dd>
205 <dt> &lsquo;<tt>mandelbrot.scm</tt>&rsquo;</dt>
206 <dd><p>Simple calculated texture.
207 </p></dd>
208 <dt> &lsquo;<tt>glbook/</tt>&rsquo;</dt>
209 <dd><p>This subdirectory contains examples found in &quot;OpenGL Programming Guide&quot;,
210 a.k.a. Redbook.
211 </p></dd>
212 <dt> &lsquo;<tt>slbook/</tt>&rsquo;</dt>
213 <dd><p>This subdirectory contains examples found in &quot;OpenGL Shading Language&quot;.
214 Each demo is under its own subdirectories. You need to have
215 proper driver/hardware that supports GLSL to run these demos.
216 </p></dd>
217 </dl>
218
219
220 <hr size="6">
221 <a name="Getting-Started"></a>
222 <table cellpadding="1" cellspacing="1" border="0">
223 <tr><td valign="middle" align="left">[<a href="#Installation" title="Previous section in reading order"> &lt; </a>]</td>
224 <td valign="middle" align="left">[<a href="#GL-calls-in-Scheme" title="Next section in reading order"> &gt; </a>]</td>
225 <td valign="middle" align="left"> &nbsp; </td>
226 <td valign="middle" align="left">[<a href="#Installation" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
227 <td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
228 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Next chapter"> &gt;&gt; </a>]</td>
229 <td valign="middle" align="left"> &nbsp; </td>
230 <td valign="middle" align="left"> &nbsp; </td>
231 <td valign="middle" align="left"> &nbsp; </td>
232 <td valign="middle" align="left"> &nbsp; </td>
233 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
234 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
235 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
236 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
237 </tr></table>
238 <a name="Getting-Started-1"></a>
239 <h1 class="chapter">3. Getting Started</h1>
240
241 <table class="menu" border="0" cellspacing="0">
242 <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">
243 </td></tr>
244 <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">
245 </td></tr>
246 <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">
247 </td></tr>
248 <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">
249 </td></tr>
250 </table>
251
252 <hr size="6">
253 <a name="GL-calls-in-Scheme"></a>
254 <table cellpadding="1" cellspacing="1" border="0">
255 <tr><td valign="middle" align="left">[<a href="#Getting-Started" title="Previous section in reading order"> &lt; </a>]</td>
256 <td valign="middle" align="left">[<a href="#Advanced-GL-features" title="Next section in reading order"> &gt; </a>]</td>
257 <td valign="middle" align="left"> &nbsp; </td>
258 <td valign="middle" align="left">[<a href="#Getting-Started" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
259 <td valign="middle" align="left">[<a href="#Getting-Started" title="Up section"> Up </a>]</td>
260 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Next chapter"> &gt;&gt; </a>]</td>
261 <td valign="middle" align="left"> &nbsp; </td>
262 <td valign="middle" align="left"> &nbsp; </td>
263 <td valign="middle" align="left"> &nbsp; </td>
264 <td valign="middle" align="left"> &nbsp; </td>
265 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
266 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
267 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
268 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
269 </tr></table>
270 <a name="GL-calls-in-Scheme-1"></a>
271 <h2 class="section">3.1 GL calls in Scheme</h2>
272
273 <p>I assume you have basic knowledge of OpenGL API.
274 Gauche-gl maps OpenGL calls to Scheme procedures
275 pretty straightforwardly. For example, the very first
276 example of &quot;OpenGL Programming Guide&quot;, the pseudo code
277 of OpenGL application, can be written in Gauche-gl like
278 this:
279 </p>
280 <table><tr><td>&nbsp;</td><td><pre class="example">(use gl)
281
282 (define (main args)
283 (<i>initialize-a-window-please</i>)
284
285 (gl-clear-color 0.0 0.0 0.0 0.0)
286 (gl-clear GL_COLOR_BUFFER_BIT)
287 (gl-color 1.0 1.0 1.0)
288 (gl-ortho 0.0 1.0 0.0 1.0 -1.0 1.0)
289 (gl-begin* GL_POLYGON
290 (gl-vertex 0.25 0.25 0.0)
291 (gl-vertex 0.75 0.25 0.0)
292 (gl-vertex 0.75 0.75 0.0)
293 (gl-vertex 0.25 0.75 0.0)
294 )
295 (gl-flush)
296 (<i>update-the-window-and-check-for-events</i>)
297 0)
298 </pre></td></tr></table>
299
300 <p>Note that <i>initialize-a-window-please</i> and
301 <i>update-the-window-and-check-for-events</i> are function calls
302 dependent on the windowing system. Gauche-gl comes with GLUT
303 binding and you can use it to do basic stuff. In the separate
304 package Gauche-gtk, a binding to GtkGLExt is provided, which allows
305 you to do GL rendering inside Gtk widgets.
306 </p>
307 <p>For the time being, let&rsquo;s focus on the pure GL part.
308 </p>
309 <p>The mapping of GL call name is straightforward.
310 The mixed case names in OpenGL C API is expanded to hyphenated name,
311 e.g. <code>glClearColor</code> &rArr; <code>gl-clear-color</code>.
312 OpenGL enums are mapped as is, e.g.
313 <code>GL_POLYGON</code>. (Note that Gauche is case-sensitive by default.
314 Also note the underscore, not hyphen, in constants).
315 </p>
316 <p>A few convenience macros, such as <code>gl-begin*</code>, is defined.
317 There are straight bindings of <code>gl-begin</code> and <code>gl-end</code>,
318 so you can write the drawing part in the same way as in C:
319 </p><table><tr><td>&nbsp;</td><td><pre class="example"> (gl-begin GL_POLYGON)
320 (gl-vertex 0.25 0.25 0.0)
321 (gl-vertex 0.75 0.25 0.0)
322 (gl-vertex 0.75 0.75 0.0)
323 (gl-vertex 0.25 0.75 0.0)
324 (gl-end)
325 </pre></td></tr></table>
326
327 <p>Actually <code>gl-begin*</code> macro expands into the above calls.
328 It&rsquo;s a matter of taste, but the macro version guarantees
329 begin and end match, and the syntax-aware editor can indent
330 internal calls accordingly.
331 </p>
332 <p>You might have noticed that the type suffix in C API
333 is not in Gauche binding. The Scheme function figures out the
334 type of passed arguments and calls appropriate C API.
335 SRFI-4 uniform numeric vectors are used to represent
336 arrays of numbers.
337 </p>
338 <table><tr><td>&nbsp;</td><td><pre class="example"> (gl-vertex 1.0 2.0 3.0) &rArr; glVertex3d
339 (gl-vertex '#f32(1.0 2.0)) &rArr; glVertex2fv
340 (gl-vertex '#s32(3 2 5)) &rArr; glVertex3iv
341 </pre></td></tr></table>
342
343 <p>Generally, passing uniform vectors is much more efficient than
344 giving individual numbers, for the former can eliminate
345 the cost of type checking and unboxing.
346 </p>
347 <p>Some GL calls can also take <code>gl.math3d</code> primitive objects
348 such as <code>vector4f</code>, <code>point4f</code> or <code>matrix4f</code>
349 (See section <a href="#Vectors-and-matrices">Vectors and matrices</a>). For example, you can pass
350 <code>point4f</code> object to <code>gl-vertex</code>, <code>vector4f</code> to
351 <code>gl-normal</code>, and <code>matrix4f</code> to <code>gl-mult-matrix</code>.
352 They are efficient since calculations on those types are
353 defined natively in <code>gl.math3d</code>, and passing it to GL call
354 doesn&rsquo;t cost unboxing.
355 </p>
356 <hr size="6">
357 <a name="Advanced-GL-features"></a>
358 <table cellpadding="1" cellspacing="1" border="0">
359 <tr><td valign="middle" align="left">[<a href="#GL-calls-in-Scheme" title="Previous section in reading order"> &lt; </a>]</td>
360 <td valign="middle" align="left">[<a href="#Using-GLUT" title="Next section in reading order"> &gt; </a>]</td>
361 <td valign="middle" align="left"> &nbsp; </td>
362 <td valign="middle" align="left">[<a href="#Getting-Started" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
363 <td valign="middle" align="left">[<a href="#Getting-Started" title="Up section"> Up </a>]</td>
364 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Next chapter"> &gt;&gt; </a>]</td>
365 <td valign="middle" align="left"> &nbsp; </td>
366 <td valign="middle" align="left"> &nbsp; </td>
367 <td valign="middle" align="left"> &nbsp; </td>
368 <td valign="middle" align="left"> &nbsp; </td>
369 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
370 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
371 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
372 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
373 </tr></table>
374 <a name="Advanced-GL-features-1"></a>
375 <h2 class="section">3.2 Advanced GL features</h2>
376
377 <p>Although Gauche-gl supports up to OpenGL 2.0, all functionalities
378 may not be available on the target machine&rsquo;s driver/hardware.
379 The application needs to check the availability of the extension
380 and/or GL version before using the features that are only supported
381 by the extension/version.
382 </p>
383 <p>Gauche-gl provides a couple of utility procedures to check the
384 feature sets at runtime.
385 For example, you can switch behavior depending on OpenGL 1.3 feature
386 availability:
387 </p>
388 <table><tr><td>&nbsp;</td><td><pre class="example">(if (gl-version&gt;=? &quot;1.3&quot;)
389 (code-using-features-available-in-OpenGL-1.3-and-later ...)
390 (alternative-code ...))
391 </pre></td></tr></table>
392
393 <p>Or you can check the availability of extensions:
394 </p>
395 <table><tr><td>&nbsp;</td><td><pre class="example">(unless (gl-extension-supported? 'GL_ARB_shader_objects
396 'GL_ARB_fragment_shader
397 'GL_ARB_vertex_shader
398 'GL_ARB_shading_language_100)
399 (error &quot;OpenGL Shading Language extensions not available&quot;))
400 </pre></td></tr></table>
401
402 <p>See <a href="#GL-feature-checking">GL feature checking</a> for the details.
403 </p>
404 <p>If the client program calls a GL API that are not supported on
405 the platform, an error is signalled.
406 </p>
407
408 <hr size="6">
409 <a name="Using-GLUT"></a>
410 <table cellpadding="1" cellspacing="1" border="0">
411 <tr><td valign="middle" align="left">[<a href="#Advanced-GL-features" title="Previous section in reading order"> &lt; </a>]</td>
412 <td valign="middle" align="left">[<a href="#Performance-tips" title="Next section in reading order"> &gt; </a>]</td>
413 <td valign="middle" align="left"> &nbsp; </td>
414 <td valign="middle" align="left">[<a href="#Getting-Started" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
415 <td valign="middle" align="left">[<a href="#Getting-Started" title="Up section"> Up </a>]</td>
416 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Next chapter"> &gt;&gt; </a>]</td>
417 <td valign="middle" align="left"> &nbsp; </td>
418 <td valign="middle" align="left"> &nbsp; </td>
419 <td valign="middle" align="left"> &nbsp; </td>
420 <td valign="middle" align="left"> &nbsp; </td>
421 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
422 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
423 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
424 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
425 </tr></table>
426 <a name="Using-GLUT-1"></a>
427 <h2 class="section">3.3 Using GLUT</h2>
428
429 <p>In order to make a runnable script, you need to use some
430 windowing system interface. GLUT binding provides a simple
431 way for it.
432 </p>
433 <p>Here is a complete runnable Scheme script, ported from
434 Example 1-2 in &quot;OpenGL Programming Guide&quot;:
435 </p>
436 <table><tr><td>&nbsp;</td><td><pre class="example">(use gl)
437 (use gl.glut)
438
439 (define (disp)
440 (gl-clear GL_COLOR_BUFFER_BIT)
441 (gl-color '#f32(1.0 1.0 1.0))
442 (gl-begin* GL_POLYGON
443 (gl-vertex '#f32(0.25 0.25 0.0))
444 (gl-vertex '#f32(0.75 0.25 0.0))
445 (gl-vertex '#f32(0.75 0.75 0.0))
446 (gl-vertex '#f32(0.25 0.75 0.0))
447 )
448 (gl-flush)
449 )
450
451 (define (init)
452 (gl-clear-color 0.0 0.0 0.0 0.0)
453 (gl-matrix-mode GL_PROJECTION)
454 (gl-load-identity)
455 (gl-ortho 0.0 1.0 0.0 1.0 -1.0 1.0)
456 )
457
458 (define (keyboard key x y)
459 (cond
460 ((= key 27) (exit 0))
461 ))
462
463 (define (main args)
464 (glut-init args)
465 (glut-init-display-mode (logior GLUT_SINGLE GLUT_RGB))
466 (glut-init-window-size 250 250)
467 (glut-init-window-position 100 100)
468 (glut-create-window &quot;hello&quot;)
469 (init)
470 (glut-display-func disp)
471 (glut-keyboard-func keyboard)
472 (glut-main-loop)
473 0)
474 </pre></td></tr></table>
475
476 <p>The <code>(use gl.glut)</code> form loads GLUT binding.
477 The name mapping is the same as GL&rsquo;s: mixed case names to
478 hyphenated names.
479 </p>
480 <p>In order to handle various events, you can pass a closure
481 to <code>glut-display-func</code> etc. In the keyboard and mouse
482 event callback, all arguments are integers.
483 </p>
484 <p>There are more examples under the &lsquo;<tt>examples/</tt>&rsquo; directory
485 which uses GLUT.
486 </p>
487 <hr size="6">
488 <a name="Performance-tips"></a>
489 <table cellpadding="1" cellspacing="1" border="0">
490 <tr><td valign="middle" align="left">[<a href="#Using-GLUT" title="Previous section in reading order"> &lt; </a>]</td>
491 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Next section in reading order"> &gt; </a>]</td>
492 <td valign="middle" align="left"> &nbsp; </td>
493 <td valign="middle" align="left">[<a href="#Getting-Started" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
494 <td valign="middle" align="left">[<a href="#Getting-Started" title="Up section"> Up </a>]</td>
495 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Next chapter"> &gt;&gt; </a>]</td>
496 <td valign="middle" align="left"> &nbsp; </td>
497 <td valign="middle" align="left"> &nbsp; </td>
498 <td valign="middle" align="left"> &nbsp; </td>
499 <td valign="middle" align="left"> &nbsp; </td>
500 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
501 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
502 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
503 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
504 </tr></table>
505 <a name="Performance-tips-1"></a>
506 <h2 class="section">3.4 Performance tips</h2>
507
508 <p>If you want to display millions of polygons in 30 fps,
509 Gauche-gl is not for you. Consider using implementations
510 that compiles into native code. The purpose of Gauche-gl
511 is to provide reasonable performance for interactive development
512 and experiment.
513 </p>
514 <p>However, if you know some tips, actually you can go quite far,
515 especially with recent processors and graphics chips.
516 </p>
517 <dl compact="compact">
518 <dt> <em>Avoid alocation within the inner loop.</em></dt>
519 <dd><p>The functional (non-destructive) operations tend to return
520 newly-allocated objects.
521 Use linear-update (destructive) versions instead,
522 such as <code>matrix-mul!</code>, <code>u8vector-add!</code>, etc,
523 whenever possible.
524 Pre-allocating temporary vectors is also effective.
525 </p>
526 </dd>
527 <dt> <em>Reduce the number of calls within the inner loop.</em></dt>
528 <dd><p>Vertex arrays are much better than calling <code>gl-vertex</code>
529 over and over. Also consider using display lists if
530 you&rsquo;re displaying rigid objects.
531 </p>
532 </dd>
533 <dt> <em>Keep numbers within a uniform vector.</em></dt>
534 <dd><p>Every time you take a number out of a uniform vector
535 (or <code>&lt;vector4f&gt;</code> etc.), Gauche has to wrap the
536 number by a tag (boxing). Also when you store a number
537 into a uniform vector, Gauche has to check the type
538 of the object, then strip a tag (unboxing).
539 Those are all overhead you wouldn&rsquo;t have if
540 you operate directly on uniform vectors (or <code>&lt;vector4f&gt;</code> etc).
541 </p>
542 </dd>
543 <dt> <em>Write extensions to accelerate.</em></dt>
544 <dd><p>If the above strategies are not enough, consider writing
545 computation-intensive part in C as an extension.
546 The easier way is to make C routines operate on uniform vectors,
547 which is essentially a pointer to an array of numbers from C,
548 and let Scheme handle higher-level data structures.
549 (It could be viewed like relations between a coprocessor and
550 a processor; the former does simple, iterative calculations
551 fast, and the latter handles complicated logic).
552 </p></dd>
553 </dl>
554
555 <hr size="6">
556 <a name="OpenGL-API"></a>
557 <table cellpadding="1" cellspacing="1" border="0">
558 <tr><td valign="middle" align="left">[<a href="#Performance-tips" title="Previous section in reading order"> &lt; </a>]</td>
559 <td valign="middle" align="left">[<a href="#GL-data-types" title="Next section in reading order"> &gt; </a>]</td>
560 <td valign="middle" align="left"> &nbsp; </td>
561 <td valign="middle" align="left">[<a href="#Getting-Started" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
562 <td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
563 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
564 <td valign="middle" align="left"> &nbsp; </td>
565 <td valign="middle" align="left"> &nbsp; </td>
566 <td valign="middle" align="left"> &nbsp; </td>
567 <td valign="middle" align="left"> &nbsp; </td>
568 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
569 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
570 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
571 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
572 </tr></table>
573 <a name="OpenGL-API-1"></a>
574 <h1 class="chapter">4. OpenGL API</h1>
575
576 <p>In this chapter we list a GL and GLU procedures accessible from
577 Gauche-gl, with brief descriptions to help programmers
578 to remind what the functions are. We don&rsquo;t intend to make
579 this an OpenGL reference, though; you should look at the OpenGL book
580 for the details of what each API do.
581 </p>
582 <table class="menu" border="0" cellspacing="0">
583 <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">
584 </td></tr>
585 <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">
586 </td></tr>
587 <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">
588 </td></tr>
589 <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">
590 </td></tr>
591 <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">
592 </td></tr>
593 <tr><td align="left" valign="top"><a href="#Transformation">4.6 Transformation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
594 </td></tr>
595 <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">
596 </td></tr>
597 <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">
598 </td></tr>
599 <tr><td align="left" valign="top"><a href="#Lighting">4.9 Lighting</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
600 </td></tr>
601 <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">
602 </td></tr>
603 <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">
604 </td></tr>
605 <tr><td align="left" valign="top"><a href="#Framebuffers">4.12 Framebuffers</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
606 </td></tr>
607 <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">
608 </td></tr>
609 <tr><td align="left" valign="top"><a href="#Projection">4.14 Projection</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
610 </td></tr>
611 <tr><td align="left" valign="top"><a href="#Quadrics">4.15 Quadrics</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
612 </td></tr>
613 <tr><td align="left" valign="top"><a href="#Nurbs">4.16 Nurbs</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
614 </td></tr>
615 <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">
616 </td></tr>
617 <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">
618 </td></tr>
619 </table>
620
621 <hr size="6">
622 <a name="GL-data-types"></a>
623 <table cellpadding="1" cellspacing="1" border="0">
624 <tr><td valign="middle" align="left">[<a href="#OpenGL-API" title="Previous section in reading order"> &lt; </a>]</td>
625 <td valign="middle" align="left">[<a href="#GL-feature-checking" title="Next section in reading order"> &gt; </a>]</td>
626 <td valign="middle" align="left"> &nbsp; </td>
627 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
628 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
629 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
630 <td valign="middle" align="left"> &nbsp; </td>
631 <td valign="middle" align="left"> &nbsp; </td>
632 <td valign="middle" align="left"> &nbsp; </td>
633 <td valign="middle" align="left"> &nbsp; </td>
634 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
635 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
636 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
637 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
638 </tr></table>
639 <a name="GL-data-types-1"></a>
640 <h2 class="section">4.1 GL data types</h2>
641
642 <p>GL doesn&rsquo;t define many data structures: some scalar primitives (e.g.
643 <code>GLint</code>) and arrays of them.
644 </p>
645 <p>For scalar values, Gauche-gl has natural mappings:
646 </p><dl compact="compact">
647 <dt> <code>GLboolean</code></dt>
648 <dd><p>Scheme booleans.
649 </p></dd>
650 <dt> <code>GLbyte, GLubyte, GLshort, GLushort, GLint, GLuint, GLenum, GLbitfield</code></dt>
651 <dd><p>Scheme exact integers.
652 </p></dd>
653 <dt> <code>GLfloat, GLdouble, GLclampf, GLclampd</code></dt>
654 <dd><p>Scheme real numbers.
655 </p></dd>
656 </dl>
657
658
659 <p>For arrays, Gauche-gl uses uniform (srfi-4) vector whenever possible.
660 For float arrays, however, Gauche-gl allows more structured types,
661 such as points or matrices, when they are relevant. Such types are provided
662 in <code>gl.math3d</code> module (see <a href="#Vectors-and-matrices">Vectors and matrices</a>),
663 which also provides common arithmetics between those types.
664 Another exception is an array of GLboolean&mdash;it doesn&rsquo;t have corresponding
665 uniform vector representation. Gauche-gl defines a new type,
666 <code>&lt;gl-boolean-vector&gt;</code>, to represent an array of GLboolean.
667 See below for operations provided on it.
668 </p>
669 <dl compact="compact">
670 <dt> <code>GLbyte[]</code></dt>
671 <dd><p><code>&lt;s8vector&gt;</code>
672 </p></dd>
673 <dt> <code>GLubyte[]</code></dt>
674 <dd><p><code>&lt;u8vector&gt;</code>
675 </p></dd>
676 <dt> <code>GLshort[]</code></dt>
677 <dd><p><code>&lt;s16vector&gt;</code>
678 </p></dd>
679 <dt> <code>GLushort[]</code></dt>
680 <dd><p><code>&lt;u16vector&gt;</code>
681 </p></dd>
682 <dt> <code>GLint[]</code></dt>
683 <dd><p><code>&lt;s32vector&gt;</code>
684 </p></dd>
685 <dt> <code>GLuint[]</code></dt>
686 <dd><p><code>&lt;u32vector&gt;</code>
687 </p></dd>
688 <dt> <code>GLfloat[], GLclampf[]</code></dt>
689 <dd><p><code>&lt;f32vector&gt;</code>, <code>&lt;point4f&gt;</code>, <code>&lt;vector-4f&gt;</code>,
690 <code>&lt;point4f-array&gt;</code>, <code>&lt;vector4f-array&gt;</code>,
691 <code>&lt;matrix4f&gt;</code>, <code>&lt;quatf&gt;</code>.
692 </p></dd>
693 <dt> <code>GLdouble[], GLclampd[]</code></dt>
694 <dd><p><code>&lt;f64vector&gt;</code>
695 </p></dd>
696 <dt> <code>GLboolean[]</code></dt>
697 <dd><p><code>&lt;gl-boolean-vector&gt;</code>
698 </p></dd>
699 </dl>
700
701 <a name="GL-boolean-vectors"></a>
702 <h3 class="subheading">GL boolean vectors</h3>
703
704 <dl>
705 <dt><a name="index-_003cgl_002dboolean_002dvector_003e"></a><u>Class:</u> <b>&lt;gl-boolean-vector&gt;</b></dt>
706 <dd><p>A class for an array of boolean values. You can pass its instance
707 to the GL APIs that expect an array of GLbooleans. Its internal
708 representation is bitwise compatible to GLbooean array, so passing
709 it is quite efficient.
710 </p>
711 <p>This class inherits <code>&lt;sequence&gt;</code>, so you can use generic
712 sequence operations on it.
713 </p>
714 <p>The external representation of GL boolean vector uses srfi-10
715 notation, and can be read back. For example, a GL boolean vector
716 of length 5 may be written something like this:
717 </p><table><tr><td>&nbsp;</td><td><pre class="example">#,(gl-boolean-vector #t #f #t #f #t)
718 </pre></td></tr></table>
719 </dd></dl>
720
721 <dl>
722 <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>
723 <dd><p>Returns a GL boolean vector of <var>size</var> elements. Elements are
724 initialized by either <code>#f</code> or <code>#t</code>, according to <var>init</var>.
725 </p>
726 <table><tr><td>&nbsp;</td><td><pre class="example">(make-gl-boolean-vector 3 #t) &rArr; #,(gl-boolean-vector #t #t #t)
727 </pre></td></tr></table>
728 </dd></dl>
729
730 <dl>
731 <dt><a name="index-gl_002dboolean_002dvector"></a><u>Function:</u> <b>gl-boolean-vector</b><i> bool &hellip;</i></dt>
732 <dd><p>Returns a GL boolean vector, whose elements are <var>bool</var> &hellip;.
733 </p>
734 <table><tr><td>&nbsp;</td><td><pre class="example">(gl-boolean-vector #f #t #t) &rArr; #,(gl-boolean-vector #f #t #t)
735 </pre></td></tr></table>
736 </dd></dl>
737
738 <dl>
739 <dt><a name="index-gl_002dboolean_002dvector_003f"></a><u>Function:</u> <b>gl-boolean-vector?</b><i> obj</i></dt>
740 <dd><p>Returns <code>#t</code> if <var>obj</var> is a GL boolean vector, <code>#f</code> otherwise.
741 </p></dd></dl>
742
743 <dl>
744 <dt><a name="index-gl_002dboolean_002dvector_002dlength"></a><u>Function:</u> <b>gl-boolean-vector-length</b><i> v</i></dt>
745 <dd><p>Returns length of a GL boolean vector <var>v</var>.
746 You can also use the sequence generic function <code>size-of</code>.
747 </p></dd></dl>
748
749 <dl>
750 <dt><a name="index-gl_002dboolean_002dvector_002dfill_0021"></a><u>Function:</u> <b>gl-boolean-vector-fill!</b><i> v bool</i></dt>
751 <dd><p>Fills a GL boolean vector <var>v</var> with a boolean value <var>bool</var>.
752 </p></dd></dl>
753
754 <dl>
755 <dt><a name="index-list_002d_003egl_002dboolean_002dvector"></a><u>Function:</u> <b>list-&gt;gl-boolean-vector</b><i> bools</i></dt>
756 <dd><p>Coerce list of boolean values to a GL boolean vector.
757 </p>
758 <p>You can also use the <code>coerce-to</code> generic function to convert
759 between GL boolean vectors and other sequences.
760 </p></dd></dl>
761
762 <dl>
763 <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>
764 <dd><p>Returns <var>k</var>-th element of a GL boolean vector <var>v</var>.
765 If <var>k</var> is out of range and <var>fallback</var> is provided,
766 it is returned. If <var>k</var> is out of range and <var>fallback</var> is
767 omitted, an error is signalled.
768 </p>
769 <p>You can also use generic function <code>ref</code> to access a
770 GL boolean vector.
771 </p></dd></dl>
772
773 <dl>
774 <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>
775 <dd><p>Sets <var>k</var>-th element of a GL boolean vector <var>v</var>
776 by a boolean value <var>bool</var>.
777 </p>
778 <p>You can also use generic function <code>(setter ref)</code> to modify a
779 GL boolean vector.
780 </p></dd></dl>
781
782 <dl>
783 <dt><a name="index-gl_002dboolean_002dvector_002dcopy"></a><u>Function:</u> <b>gl-boolean-vector-copy</b><i> v</i></dt>
784 <dd><p>Returns a copy of a GL boolean vector <var>v</var>.
785 </p></dd></dl>
786
787
788 <hr size="6">
789 <a name="GL-feature-checking"></a>
790 <table cellpadding="1" cellspacing="1" border="0">
791 <tr><td valign="middle" align="left">[<a href="#GL-data-types" title="Previous section in reading order"> &lt; </a>]</td>
792 <td valign="middle" align="left">[<a href="#Drawing-functions" title="Next section in reading order"> &gt; </a>]</td>
793 <td valign="middle" align="left"> &nbsp; </td>
794 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
795 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
796 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
797 <td valign="middle" align="left"> &nbsp; </td>
798 <td valign="middle" align="left"> &nbsp; </td>
799 <td valign="middle" align="left"> &nbsp; </td>
800 <td valign="middle" align="left"> &nbsp; </td>
801 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
802 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
803 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
804 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
805 </tr></table>
806 <a name="GL-feature-checking-1"></a>
807 <h2 class="section">4.2 GL feature checking</h2>
808
809 <p>If you want to use a feature that are in OpenGL 1.2 or later, or
810 in a GL extension, you have to check its availability before
811 actually calling the API function. You can use the following
812 utility procedures.
813 </p>
814 <p>Note that those functions may return <code>#f</code> if the connection
815 to the display subsystem isn&rsquo;t established yet. Usually you have
816 to initialize and open an window before checking the features.
817 </p>
818 <dl>
819 <dt><a name="index-gl_002dextension_002davailable_003f"></a><u>Function:</u> <b>gl-extension-available?</b><i> extension-name &hellip;</i></dt>
820 <dd><p>Returns <code>#t</code> if GL extensions listed in <var>extension-name</var> &hellip;
821 are all available. <var>Extension-name</var> can be a symbol or
822 a string (e.g. <code>GL_ARB_multisample</code>).
823 </p></dd></dl>
824
825 <dl>
826 <dt><a name="index-gl_002dversion_003c_003f"></a><u>Function:</u> <b>gl-version&lt;?</b><i> version</i></dt>
827 <dt><a name="index-gl_002dversion_003c_003d_003f"></a><u>Function:</u> <b>gl-version&lt;=?</b><i> version</i></dt>
828 <dt><a name="index-gl_002dversion_003e_003f"></a><u>Function:</u> <b>gl-version&gt;?</b><i> version</i></dt>
829 <dt><a name="index-gl_002dversion_003e_003d_003f"></a><u>Function:</u> <b>gl-version&gt;=?</b><i> version</i></dt>
830 <dt><a name="index-gl_002dversion_003d_003f"></a><u>Function:</u> <b>gl-version=?</b><i> version</i></dt>
831 <dd><p>Returns <code>#t</code> if the runtime OpenGL version is less than,
832 less thanor equal to, greater than, greater than or equal to,
833 and equal to, the given <var>version</var>, respectively.
834 </p>
835 <p>Give <var>version</var> in a string, e.g. <code>&quot;1.3&quot;</code>.
836 </p></dd></dl>
837
838 <hr size="6">
839 <a name="Drawing-functions"></a>
840 <table cellpadding="1" cellspacing="1" border="0">
841 <tr><td valign="middle" align="left">[<a href="#GL-feature-checking" title="Previous section in reading order"> &lt; </a>]</td>
842 <td valign="middle" align="left">[<a href="#GL-state-control" title="Next section in reading order"> &gt; </a>]</td>
843 <td valign="middle" align="left"> &nbsp; </td>
844 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
845 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
846 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
847 <td valign="middle" align="left"> &nbsp; </td>
848 <td valign="middle" align="left"> &nbsp; </td>
849 <td valign="middle" align="left"> &nbsp; </td>
850 <td valign="middle" align="left"> &nbsp; </td>
851 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
852 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
853 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
854 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
855 </tr></table>
856 <a name="Drawing-functions-1"></a>
857 <h2 class="section">4.3 Drawing functions</h2>
858
859 <dl>
860 <dt><a name="index-gl_002dbegin_002a"></a><u>Macro:</u> <b>gl-begin*</b><i> mode gl-commands &hellip;</i></dt>
861 <dd><a name="index-GL_005fPOINTS"></a>
862 <a name="index-GL_005fLINES"></a>
863 <a name="index-GL_005fLINE_005fSTRIP"></a>
864 <a name="index-GL_005fLINE_005fLOOP"></a>
865 <a name="index-GL_005fTRIANGLES"></a>
866 <a name="index-GL_005fTRIANGLE_005fSTRIP"></a>
867 <a name="index-GL_005fTRIANGLE_005fFAN"></a>
868 <a name="index-GL_005fQUADS"></a>
869 <a name="index-GL_005fQUAD_005fSTRIP"></a>
870 <a name="index-GL_005fPOLYGON"></a>
871
872 <p>Executes <var>gl-commands</var> between <code>(gl-begin <var>mode</var>)</code> and
873 <code>(gl-end)</code>. <var>Mode</var> can be one of the following constants.
874 </p>
875 <dl compact="compact">
876 <dt> <code>GL_POINTS</code></dt>
877 <dd><p>Individual points.
878 </p></dd>
879 <dt> <code>GL_LINES</code></dt>
880 <dd><p>Pairs of vertices interpreted as individual line segments.
881 </p></dd>
882 <dt> <code>GL_LINE_STRIP</code></dt>
883 <dd><p>Series of connected line segments.
884 </p></dd>
885 <dt> <code>GL_LINE_LOOP</code></dt>
886 <dd><p>Same as above, with a segment added between last and first vertices.
887 </p></dd>
888 <dt> <code>GL_TRIANGLES</code></dt>
889 <dd><p>Triples of vertices interpreted as triangles.
890 </p></dd>
891 <dt> <code>GL_TRIANGLE_STRIP</code></dt>
892 <dd><p>Linked trip of triangles.
893 </p></dd>
894 <dt> <code>GL_TRIANGLE_FAN</code></dt>
895 <dd><p>Linked fan of triangles.
896 </p></dd>
897 <dt> <code>GL_QUADS</code></dt>
898 <dd><p>Quadruples of vertices interpreted as four-sided polygons.
899 </p></dd>
900 <dt> <code>GL_QUAD_STRIP</code></dt>
901 <dd><p>Linked strip of quadrilaterals.
902 </p></dd>
903 <dt> <code>GL_POLYGON</code></dt>
904 <dd><p>Boundary of a simple, convex polygon.
905 </p></dd>
906 </dl>
907
908 </dd></dl>
909
910 <dl>
911 <dt><a name="index-gl_002dbegin"></a><u>Function:</u> <b>gl-begin</b><i> mode</i></dt>
912 <dt><a name="index-gl_002dend"></a><u>Function:</u> <b>gl-end</b></dt>
913 <dd><p>Corresponds to <code>glBegin</code> and <code>glEnd</code>.
914 Use of <code>gl-begin*</code> macro is recommended, though.
915 </p></dd></dl>
916
917 <dl>
918 <dt><a name="index-gl_002dflush"></a><u>Function:</u> <b>gl-flush</b></dt>
919 <dd><p>Flush the GL command buffer.
920 </p></dd></dl>
921
922 <dl>
923 <dt><a name="index-gl_002dfinish"></a><u>Function:</u> <b>gl-finish</b></dt>
924 <dd><p>Make sure all previously issued GL commands are completed.
925 </p></dd></dl>
926
927 <dl>
928 <dt><a name="index-gl_002drect"></a><u>Function:</u> <b>gl-rect</b><i> point1 point2</i></dt>
929 <dt><a name="index-gl_002drect-1"></a><u>Function:</u> <b>gl-rect</b><i> x1 y1 x2 y2</i></dt>
930 <dd><p>Draws a rectangle. In the first form,
931 <var>point1</var> and <var>point2</var> can be either
932 <code>&lt;point4f&gt;</code>, or f32, f64, s32, or s16vector of
933 length 2. Types of both args should match.
934 In the second form, all args should be a real numbers (<code>glRectd</code> is used).
935 </p></dd></dl>
936
937 <dl>
938 <dt><a name="index-gl_002dvertex"></a><u>Function:</u> <b>gl-vertex</b><i> point</i></dt>
939 <dt><a name="index-gl_002dvertex-1"></a><u>Function:</u> <b>gl-vertex</b><i> x y &amp;optional z w</i></dt>
940 <dd><p>Specify vertices. In the first form, <var>point</var> can be
941 either <code>&lt;point4f&gt;</code>, or f32, f64, s32 or s16vector
942 of length 2, 3 or 4.
943 In the second form, all args should be a real numbers.
944 </p></dd></dl>
945
946 <dl>
947 <dt><a name="index-gl_002dnormal"></a><u>Function:</u> <b>gl-normal</b><i> vector</i></dt>
948 <dt><a name="index-gl_002dnormal-1"></a><u>Function:</u> <b>gl-normal</b><i> x y z</i></dt>
949 <dd><p>Sets vertex normal vector. In the first form, <var>vector</var> can be
950 either <code>&lt;vector4f&gt;</code> (the fourth element is ignored),
951 or f32, f64, s32 ro s16vector of length 3.
952 In the second form, all args should be a real numbers.
953 </p></dd></dl>
954
955 <dl>
956 <dt><a name="index-gl_002dcolor"></a><u>Function:</u> <b>gl-color</b><i> color</i></dt>
957 <dt><a name="index-gl_002dcolor-1"></a><u>Function:</u> <b>gl-color</b><i> r g b &amp;optional a</i></dt>
958 <dd><p>Sets the current color. In the first form, <var>color</var> can be
959 either f32, f64, u8, u16, u32, s8, s16, or s32vector of length 3 or 4.
960 In the second form, all args should be a real numbers.
961 </p></dd></dl>
962
963 <dl>
964 <dt><a name="index-gl_002dtex_002dcoord"></a><u>Function:</u> <b>gl-tex-coord</b><i> coord</i></dt>
965 <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>
966 <dd><p>Sets the current texture coordinates. In the first form,
967 <var>coord</var> can be either f32, f64, s32 or s16vector of length
968 1, 2, 3, or 4. In the second form, all args should be a real numbers.
969 </p></dd></dl>
970
971 <dl>
972 <dt><a name="index-gl_002draster_002dpos"></a><u>Function:</u> <b>gl-raster-pos</b><i> pos</i></dt>
973 <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>
974 <dd><p>Sets the current raster position. In the first form,
975 <var>pos</var> can be eitehr f32, f64, s32 or s16vector. In the
976 second form, all args should be a real numbers.
977 </p></dd></dl>
978
979 <hr size="6">
980 <a name="GL-state-control"></a>
981 <table cellpadding="1" cellspacing="1" border="0">
982 <tr><td valign="middle" align="left">[<a href="#Drawing-functions" title="Previous section in reading order"> &lt; </a>]</td>
983 <td valign="middle" align="left">[<a href="#GL-states-for-drawing" title="Next section in reading order"> &gt; </a>]</td>
984 <td valign="middle" align="left"> &nbsp; </td>
985 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
986 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
987 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
988 <td valign="middle" align="left"> &nbsp; </td>
989 <td valign="middle" align="left"> &nbsp; </td>
990 <td valign="middle" align="left"> &nbsp; </td>
991 <td valign="middle" align="left"> &nbsp; </td>
992 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
993 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
994 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
995 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
996 </tr></table>
997 <a name="GL-state-control-1"></a>
998 <h2 class="section">4.4 GL state control</h2>
999
1000 <a name="Capabilities"></a>
1001 <h4 class="subsubheading">Capabilities</h4>
1002
1003 <dl>
1004 <dt><a name="index-gl_002denable"></a><u>Function:</u> <b>gl-enable</b><i> cap</i></dt>
1005 <dt><a name="index-gl_002ddisable"></a><u>Function:</u> <b>gl-disable</b><i> cap</i></dt>
1006 <dd><p>Turns on and off a capability <var>cap</var>. Check out OpenGL reference
1007 for the list of capabilities.
1008 </p></dd></dl>
1009
1010 <dl>
1011 <dt><a name="index-gl_002dis_002denabled"></a><u>Function:</u> <b>gl-is-enabled</b><i> cap</i></dt>
1012 <dd><p>Returns <code>#t</code> of <code>#f</code> depending on <var>cap</var> is enabled or not.
1013 </p></dd></dl>
1014
1015 <dl>
1016 <dt><a name="index-gl_002denable_002dclient_002dstate"></a><u>Function:</u> <b>gl-enable-client-state</b><i> array</i></dt>
1017 <dt><a name="index-gl_002ddisable_002dclient_002dstate"></a><u>Function:</u> <b>gl-disable-client-state</b><i> array</i></dt>
1018 <dd><p>Enable/disable a client-side array (e.g. vertex array) specified by
1019 <var>array</var>. <var>Array</var> can be one of the following constants.
1020 </p>
1021 <dl compact="compact">
1022 <dt> <code>GL_VERTEX_ARRAY</code></dt>
1023 <dt> <code>GL_COLOR_ARRAY</code></dt>
1024 <dt> <code>GL_INDEX_ARRAY</code></dt>
1025 <dt> <code>GL_NORMAL_ARRAY</code></dt>
1026 <dt> <code>GL_TEXTURE_COORD_ARRAY</code></dt>
1027 <dt> <code>GL_EDGE_FLAG_ARRAY</code></dt>
1028 </dl>
1029
1030 </dd></dl>
1031
1032 <a name="State-values"></a>
1033 <h4 class="subsubheading">State values</h4>
1034
1035 <p>Gauche has two variations for each type of OpenGL <code>glGetTYPE</code> APIs;
1036 nondestructive version and destructive versions. Nondestructive versions
1037 such as <code>gl-get-boolean</code> allocates and returns the vector of
1038 appropriate type for the state. For destructive versions such as
1039 <code>gl-get-boolean!</code>, you need to pass a vector to be filled in.
1040 </p>
1041 <p>The destructive version is non-allocating operation, so it is suitable
1042 if you call it within the drawing loop.
1043 </p>
1044 <p>If the state has a scalar value, the non-destructive version of
1045 query function returns a scalar value, but you need to pass a
1046 (uniform) vector of length 1 for the destructive version.
1047 </p>
1048 <dl>
1049 <dt><a name="index-gl_002dstate_002dvector_002dsize"></a><u>Function:</u> <b>gl-state-vector-size</b><i> state</i></dt>
1050 <dd><p>[Gauche specific]
1051 Returns the required size of the vector to retrieve GL state <var>state</var>.
1052 It is useful to prepare the vector to pass to the destructive version
1053 of <code>glGetTYPE</code> API.
1054 </p></dd></dl>
1055
1056 <dl>
1057 <dt><a name="index-gl_002dget_002dboolean"></a><u>Function:</u> <b>gl-get-boolean</b><i> state</i></dt>
1058 <dt><a name="index-gl_002dget_002dboolean_0021"></a><u>Function:</u> <b>gl-get-boolean!</b><i> gl-boolean-vector state</i></dt>
1059 <dd><p>Get (a) boolean state value(s).
1060 </p></dd></dl>
1061
1062 <dl>
1063 <dt><a name="index-gl_002dget_002dinteger"></a><u>Function:</u> <b>gl-get-integer</b><i> state</i></dt>
1064 <dt><a name="index-gl_002dget_002dinteger_0021"></a><u>Function:</u> <b>gl-get-integer!</b><i> s32vector state</i></dt>
1065 <dd><p>Get (an) integer state value(s).
1066 </p></dd></dl>
1067
1068 <dl>
1069 <dt><a name="index-gl_002dget_002dfloat"></a><u>Function:</u> <b>gl-get-float</b><i> state</i></dt>
1070 <dt><a name="index-gl_002dget_002dfloat_0021"></a><u>Function:</u> <b>gl-get-float!</b><i> f32vector state</i></dt>
1071 <dd><p>Get (a) single-precision floating-point state value(s).
1072 </p></dd></dl>
1073
1074 <dl>
1075 <dt><a name="index-gl_002dget_002ddouble"></a><u>Function:</u> <b>gl-get-double</b><i> state</i></dt>
1076 <dt><a name="index-gl_002dget_002ddouble_0021"></a><u>Function:</u> <b>gl-get-double!</b><i> f64vector state</i></dt>
1077 <dd><p>Get (a) double-precision floating-point state value(s).
1078 </p></dd></dl>
1079
1080 <a name="Push_002fpop-attributes"></a>
1081 <h4 class="subsubheading">Push/pop attributes</h4>
1082
1083 <dl>
1084 <dt><a name="index-gl_002dpush_002dattrib"></a><u>Function:</u> <b>gl-push-attrib</b><i> mask</i></dt>
1085 <dt><a name="index-gl_002dpop_002dattrib"></a><u>Function:</u> <b>gl-pop-attrib</b></dt>
1086 <dd><p>Push/pop attributes indicated by <var>mask</var>.
1087 Valid <var>mask</var> can be <code>logior</code> of the following bits
1088 (GLL_ALL_ATTRIB_BITS is <code>logior</code> of all the bits).
1089 </p>
1090 <dl compact="compact">
1091 <dt> <code>GL_ACCUM_BUFFER_BIT</code></dt>
1092 <dt> <code>GL_COLOR_BUFFER_BIT</code></dt>
1093 <dt> <code>GL_CURRENT_BIT</code></dt>
1094 <dt> <code>GL_DEPTH_BUFFER_BIT</code></dt>
1095 <dt> <code>GL_ENABLE_BIT</code></dt>
1096 <dt> <code>GL_EVAL_BIT</code></dt>
1097 <dt> <code>GL_FOG_BIT</code></dt>
1098 <dt> <code>GL_HINT_BIT</code></dt>
1099 <dt> <code>GL_LIGHTING_BIT</code></dt>
1100 <dt> <code>GL_LINE_BIT</code></dt>
1101 <dt> <code>GL_LIST_BIT</code></dt>
1102 <dt> <code>GL_PIXEL_MODE_BIT</code></dt>
1103 <dt> <code>GL_POINT_BIT</code></dt>
1104 <dt> <code>GL_POLYGON_BIT</code></dt>
1105 <dt> <code>GL_POLYGON_STIPPLE_BIT</code></dt>
1106 <dt> <code>GL_SCISSOR_BIT</code></dt>
1107 <dt> <code>GL_STENCIL_BUFFER_BIT</code></dt>
1108 <dt> <code>GL_TEXTURE_BIT</code></dt>
1109 <dt> <code>GL_TRANSFORM_BIT</code></dt>
1110 <dt> <code>GL_VIEWPORT_BIT</code></dt>
1111 <dt> <code>GL_ALL_ATTRIB_BITS</code></dt>
1112 <dd><p>All of the above.
1113 </p></dd>
1114 </dl>
1115 </dd></dl>
1116
1117 <dl>
1118 <dt><a name="index-gl_002dpush_002dclient_002dattrib"></a><u>Function:</u> <b>gl-push-client-attrib</b><i> mask</i></dt>
1119 <dt><a name="index-gl_002dpop_002dclient_002dattrib"></a><u>Function:</u> <b>gl-pop-client-attrib</b></dt>
1120 <dd><p>Push/pop client attributes. Valid <var>mask</var> can be
1121 <code>logior</code> of the following
1122 </p>
1123 <dl compact="compact">
1124 <dt> <code>GL_CLIENT_PIXEL_STORE_BIT</code></dt>
1125 <dt> <code>GL_CLIENT_VERTEX_ARRAY_BIT</code></dt>
1126 <dt> <code>GL_ALL_CLIENT_ATTRIB_BITS</code></dt>
1127 <dd><p>All of the above.
1128 </p></dd>
1129 </dl>
1130 </dd></dl>
1131
1132 <a name="Other-queries"></a>
1133 <h4 class="subsubheading">Other queries</h4>
1134
1135 <dl>
1136 <dt><a name="index-gl_002dget_002derror"></a><u>Function:</u> <b>gl-get-error</b></dt>
1137 <dd><p>Returns the value of the error flag. Returned an integer value.
1138 Check out the OpenGL documentation for the possible error values.
1139 </p>
1140 <p>This function resets the error flag to <code>GL_NO_ERROR</code>.
1141 </p></dd></dl>
1142
1143 <dl>
1144 <dt><a name="index-glu_002derror_002dstring"></a><u>Function:</u> <b>glu-error-string</b><i> error-code</i></dt>
1145 <dd><p>Returns a descriptive string for <var>error-code</var> returned by
1146 <code>gl-get-error</code>.
1147 </p></dd></dl>
1148
1149 <dl>
1150 <dt><a name="index-gl_002dget_002dstring"></a><u>Function:</u> <b>gl-get-string</b><i> name</i></dt>
1151 <dd><p>Returns informative string about <var>name</var> of the GL library.
1152 <var>Name</var> can be one of the following.
1153 </p>
1154 <dl compact="compact">
1155 <dt> <code>GL_VENDOR</code></dt>
1156 <dt> <code>GL_RENDERER</code></dt>
1157 <dt> <code>GL_VERSION</code></dt>
1158 <dt> <code>GL_EXTENSIONS</code></dt>
1159 </dl>
1160
1161 <p>To check a specific version or extension, you can also use
1162 the utility procedure <code>gl-version&gt;?</code> etc. See
1163 <a href="#GL-feature-checking">GL feature checking</a>.
1164 </p></dd></dl>
1165
1166 <dl>
1167 <dt><a name="index-glu_002dget_002dstring"></a><u>Function:</u> <b>glu-get-string</b><i> name</i></dt>
1168 <dd><p>Returns informative string about <var>name</var> of the GLU library.
1169 <var>Name</var> can be one of the following.
1170 </p>
1171 <dl compact="compact">
1172 <dt> <code>GLU_VERSION</code></dt>
1173 <dt> <code>GLU_EXTENSIONS</code></dt>
1174 </dl>
1175 </dd></dl>
1176
1177 <a name="Hints"></a>
1178 <h4 class="subsubheading">Hints</h4>
1179
1180 <dl>
1181 <dt><a name="index-gl_002dhint"></a><u>Function:</u> <b>gl-hint</b><i> target hint</i></dt>
1182 <dd><p>Controls quality of <var>target</var> by <var>hint</var>.
1183 <var>Target</var> can be one of the following:
1184 </p>
1185 <dl compact="compact">
1186 <dt> <code>GL_POINT_SMOOTH_HINT</code></dt>
1187 <dt> <code>GL_LINE_SMOOTH_HINT</code></dt>
1188 <dt> <code>GL_POLYGON_SMOOTH_HINT</code></dt>
1189 <dt> <code>GL_FOG_HINT</code></dt>
1190 <dt> <code>GL_PERSPECTIVE_CORRECTION_HINT</code></dt>
1191 </dl>
1192
1193 <p>And <var>hint</var> can be one of the following:
1194 </p><dl compact="compact">
1195 <dt> <code>GL_FASTEST</code></dt>
1196 <dt> <code>GL_NICEST</code></dt>
1197 <dt> <code>GL_DONT_CARE</code></dt>
1198 </dl>
1199 </dd></dl>
1200
1201
1202 <hr size="6">
1203 <a name="GL-states-for-drawing"></a>
1204 <table cellpadding="1" cellspacing="1" border="0">
1205 <tr><td valign="middle" align="left">[<a href="#GL-state-control" title="Previous section in reading order"> &lt; </a>]</td>
1206 <td valign="middle" align="left">[<a href="#Transformation" title="Next section in reading order"> &gt; </a>]</td>
1207 <td valign="middle" align="left"> &nbsp; </td>
1208 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
1209 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
1210 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
1211 <td valign="middle" align="left"> &nbsp; </td>
1212 <td valign="middle" align="left"> &nbsp; </td>
1213 <td valign="middle" align="left"> &nbsp; </td>
1214 <td valign="middle" align="left"> &nbsp; </td>
1215 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
1216 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
1217 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
1218 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
1219 </tr></table>
1220 <a name="GL-states-for-drawing-1"></a>
1221 <h2 class="section">4.5 GL states for drawing</h2>
1222
1223 <dl>
1224 <dt><a name="index-gl_002dpoint_002dsize"></a><u>Function:</u> <b>gl-point-size</b><i> size</i></dt>
1225 <dd><p>Sets the width in pixels for rendered points.
1226 The possible range of <var>size</var> on the running GL implementation
1227 can be obtained by passing either <code>GL_ALIASED_POINT_SIZE_RANGE</code> or
1228 <code>GL_SMOOTH_POINT_SIZE_RANGE</code> to <code>gl-get-float</code>.
1229 </p></dd></dl>
1230
1231 <dl>
1232 <dt><a name="index-gl_002dline_002dwidth"></a><u>Function:</u> <b>gl-line-width</b><i> width</i></dt>
1233 <dd><p>Sets the width in pixels for rendered lines.
1234 The possible range of <var>width</var> on the running GL implementation
1235 can be obtained by passing either <code>GL_ALIASED_LINE_WIDTH_RANGE</code> or
1236 <code>GL_SMOOTH_LINE_WIDTH_RANGE</code> to <code>gl-get-float</code>.
1237 </p></dd></dl>
1238
1239 <dl>
1240 <dt><a name="index-gl_002dline_002dstipple"></a><u>Function:</u> <b>gl-line-stipple</b><i> factor pat</i></dt>
1241 <dd><p>Sets the current stippling pattern for lines.
1242 <code>pat</code> must be an exact integer, and its lower 16 bits are used
1243 to specify the stipple pattern. <var>Factor</var> is an integer factor
1244 to specify how many pixels corresponds to one bit in <var>pat</var>.
1245 </p>
1246 <p>You have to enable <var>GL_LINE_STIPPLE</var> to use face culling.
1247 </p></dd></dl>
1248
1249 <dl>
1250 <dt><a name="index-gl_002dpolygon_002dmode"></a><u>Function:</u> <b>gl-polygon-mode</b><i> face mode</i></dt>
1251 <dd><p>Specifies the drawing mode for a polygon&rsquo;s front and back faces.
1252 <var>Face</var> can be one of the followings:
1253 </p><dl compact="compact">
1254 <dt> <code>GL_FRONT_AND_BACK</code></dt>
1255 <dt> <code>GL_FRONT</code></dt>
1256 <dt> <code>GL_BACK</code></dt>
1257 </dl>
1258
1259 <p><var>Mode</var> can be one of the followings:
1260 </p><dl compact="compact">
1261 <dt> <code>GL_POINT</code></dt>
1262 <dt> <code>GL_LINE</code></dt>
1263 <dt> <code>GL_FILL</code></dt>
1264 </dl>
1265 </dd></dl>
1266
1267 <dl>
1268 <dt><a name="index-gl_002dfront_002dface"></a><u>Function:</u> <b>gl-front-face</b><i> mode</i></dt>
1269 <dd><p>Controls how OpenGL determine front face of a polygon
1270 <var>Mode</var> can be one of the followings:
1271 </p><dl compact="compact">
1272 <dt> <code>GL_CCW</code></dt>
1273 <dd><p>Front face is where ordered vertices appear in a counterclockwise orientation
1274 (default).
1275 </p></dd>
1276 <dt> <code>GL_CW</code></dt>
1277 <dd><p>Front face is where ordered vertices appear in a clockwise orientation.
1278 </p></dd>
1279 </dl>
1280 </dd></dl>
1281
1282 <dl>
1283 <dt><a name="index-gl_002dcull_002dface"></a><u>Function:</u> <b>gl-cull-face</b><i> mode</i></dt>
1284 <dd><p>Indicates which face of polygons should be culled.
1285 <var>Mode</var> can be one of the followings:
1286 </p><dl compact="compact">
1287 <dt> <code>GL_FRONT</code></dt>
1288 <dt> <code>GL_BACK</code></dt>
1289 <dt> <code>GL_FRONT_AND_BACK</code></dt>
1290 </dl>
1291
1292 <p>You have to enable <var>GL_CULL_FACE</var> to use face culling.
1293 </p></dd></dl>
1294
1295 <dl>
1296 <dt><a name="index-gl_002dpolygon_002dstipple"></a><u>Function:</u> <b>gl-polygon-stipple</b><i> mask</i></dt>
1297 <dd><p>Defines the current stipple pattern for filled polygons.
1298 <var>Mask</var> has to be a u8vector of length 128, specifying a 32x32
1299 bitmap pattern.
1300 You have to enable <var>GL_POLYGON_STIPPLE</var> to use this feature.
1301 </p></dd></dl>
1302
1303
1304 <dl>
1305 <dt><a name="index-gl_002dedge_002dflag"></a><u>Function:</u> <b>gl-edge-flag</b><i> flag</i></dt>
1306 <dd><p>Sets the edge flag(s) of vertices. When <var>flag</var> is
1307 a GL boolean vector, <code>glEdgeFlagv</code> is called.
1308 Otherwise <var>flag</var> is used as a single boolean value
1309 for <code>glEdgeFlag</code>.
1310 </p></dd></dl>
1311
1312 <dl>
1313 <dt><a name="index-gl_002dblend_002dfunc"></a><u>Function:</u> <b>gl-blend-func</b><i> sfactor dfactor</i></dt>
1314 <dd><p>Controls how color values in the fragment being processed (the source)
1315 are combined with the ones in the framebuffer (the destination).
1316 </p>
1317 <p>Possible values for the <var>sfactor</var> and <var>dfactor</var> arguments
1318 are as follows.
1319 </p><dl compact="compact">
1320 <dt> <code>GL_ZERO</code></dt>
1321 <dt> <code>GL_ONE</code></dt>
1322 <dt> <code>GL_DST_COLOR</code></dt>
1323 <dt> <code>GL_SRC_COLOR</code></dt>
1324 <dt> <code>GL_ONE_MINUS_DST_COLOR</code></dt>
1325 <dt> <code>GL_ONE_MINUS_SRC_COLOR</code></dt>
1326 <dt> <code>GL_SRC_ALPHA</code></dt>
1327 <dt> <code>GL_ONE_MINUS_SRC_ALPHA</code></dt>
1328 <dt> <code>GL_DST_ALPHA</code></dt>
1329 <dt> <code>GL_ONE_MINUS_DST_ALPHA</code></dt>
1330 <dt> <code>GL_SRC_ALPHA_SATURATE</code></dt>
1331 <dt> <code>GL_CONSTANT_COLOR</code></dt>
1332 <dt> <code>GL_ONE_MINUS_CONSTANT_COLOR</code></dt>
1333 <dt> <code>GL_CONSTANT_ALPHA</code></dt>
1334 <dt> <code>GL_ONE_MINUS_CONSTANT_ALPHA</code></dt>
1335 </dl>
1336 </dd></dl>
1337
1338 <dl>
1339 <dt><a name="index-gl_002dblend_002dequation"></a><u>Function:</u> <b>gl-blend-equation</b><i> mode</i></dt>
1340 <dd><p>[GL_ARB_imaging]
1341 By default, the source and destination colors are added after
1342 processed as specified by <var>gl-blend-func</var>. With this extension API
1343 you can change the function. <var>Mode</var> can be one of the
1344 following values:
1345 </p><dl compact="compact">
1346 <dt> <code>GL_FUNC_ADD</code></dt>
1347 <dt> <code>GL_FUNC_SUBTRACT</code></dt>
1348 <dt> <code>GL_FUNC_REVERSE_SUBTRACT</code></dt>
1349 <dt> <code>GL_MIN</code></dt>
1350 <dt> <code>GL_MAX</code></dt>
1351 </dl>
1352 </dd></dl>
1353
1354 <dl>
1355 <dt><a name="index-gl_002dblend_002dcolor"></a><u>Function:</u> <b>gl-blend-color</b><i> red green blue alpha</i></dt>
1356 <dd><p>[GL_ARB_imaging]
1357 Sets the constant color used in the blending function.
1358 </p></dd></dl>
1359
1360 <dl>
1361 <dt><a name="index-gl_002dpolygon_002doffset"></a><u>Function:</u> <b>gl-polygon-offset</b><i> factor units</i></dt>
1362 <dd><p>[GL1.1]
1363 Offset the depth value of each fragment. Useful to avoid
1364 artifacts when you draw polygon edges over its surfaces,
1365 for example.
1366 </p></dd></dl>
1367
1368 <dl>
1369 <dt><a name="index-gl_002dclip_002dplane"></a><u>Function:</u> <b>gl-clip-plane</b><i> plane equation</i></dt>
1370 <dd><p>Defines a clipping plane. <var>Plane</var> specifies which clipping
1371 plane you&rsquo;re defining. Use <code>GL_MAX_CLIP_PLANES</code> to
1372 <code>gl-get-integer</code> to obtain the number of clipping planes
1373 you can use. You have to enable the specific clipping plane
1374 (e.g. <code>(gl-enable GL_CLIP_PLANE0)</code>) to use the clipping plane.
1375 </p>
1376 <p><var>Equation</var> must be an f64vector of size 4, specifying four
1377 coefficients of the plane equation, <code>Ax + By + Cz + D = 0</code>.
1378 </p></dd></dl>
1379
1380 <dl>
1381 <dt><a name="index-gl_002dget_002dclip_002dplane"></a><u>Function:</u> <b>gl-get-clip-plane</b><i> plane</i></dt>
1382 <dd><p>Returns the four coefficients of the equation of clipping plane
1383 <var>plane</var>, in f64vector.
1384 </p></dd></dl>
1385
1386 <dl>
1387 <dt><a name="index-gl_002dfog"></a><u>Function:</u> <b>gl-fog</b><i> pname param</i></dt>
1388 <dd><p>Sets the parameters and function for the fog effect.
1389 Possible values for <var>pname</var> and accepted <var>param</var> for each
1390 <var>pname</var> are shown below.
1391 </p>
1392 <dl compact="compact">
1393 <dt> <code>GL_FOG_MODE</code></dt>
1394 <dd><p>Either <code>GL_EXP</code>, <code>GL_EXP2</code>, <code>GL_LINEAR</code> to select
1395 the fog factors.
1396 </p></dd>
1397 <dt> <code>GL_FOG_DENSITY</code></dt>
1398 <dt> <code>GL_FOG_START</code></dt>
1399 <dt> <code>GL_FO_END</code></dt>
1400 <dd><p>A real number to specify those parametes.
1401 </p></dd>
1402 <dt> <code>GL_FOG_COLOR</code></dt>
1403 <dd><p>An f32vector of size 4 to specify the color.
1404 </p></dd>
1405 </dl>
1406 </dd></dl>
1407
1408 <hr size="6">
1409 <a name="Transformation"></a>
1410 <table cellpadding="1" cellspacing="1" border="0">
1411 <tr><td valign="middle" align="left">[<a href="#GL-states-for-drawing" title="Previous section in reading order"> &lt; </a>]</td>
1412 <td valign="middle" align="left">[<a href="#Display-lists" title="Next section in reading order"> &gt; </a>]</td>
1413 <td valign="middle" align="left"> &nbsp; </td>
1414 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
1415 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
1416 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
1417 <td valign="middle" align="left"> &nbsp; </td>
1418 <td valign="middle" align="left"> &nbsp; </td>
1419 <td valign="middle" align="left"> &nbsp; </td>
1420 <td valign="middle" align="left"> &nbsp; </td>
1421 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
1422 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
1423 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
1424 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
1425 </tr></table>
1426 <a name="Transformation-1"></a>
1427 <h2 class="section">4.6 Transformation</h2>
1428
1429 <dl>
1430 <dt><a name="index-gl_002dmatrix_002dmode"></a><u>Function:</u> <b>gl-matrix-mode</b><i> mode</i></dt>
1431 <dd><p>Speficies whether the modelview, projection, or texture matrix
1432 will be modified. <var>Mode</var> can be one of the followings:
1433 </p>
1434 <dl compact="compact">
1435 <dt> <code>GL_MODELVIEW</code></dt>
1436 <dt> <code>GL_PROJECTION</code></dt>
1437 <dt> <code>GL_TEXTURE</code></dt>
1438 </dl>
1439 </dd></dl>
1440
1441 <dl>
1442 <dt><a name="index-gl_002dload_002didentity"></a><u>Function:</u> <b>gl-load-identity</b></dt>
1443 <dd><p>Loads an identity matrix to the current modifiable matrix.
1444 </p></dd></dl>
1445
1446 <dl>
1447 <dt><a name="index-gl_002dload_002dmatrix"></a><u>Function:</u> <b>gl-load-matrix</b><i> mat</i></dt>
1448 <dd><p>Loads the matrix <var>mat</var> to the current modifiable matrix.
1449 <var>Mat</var> can be a <code>&lt;matrix4f&gt;</code> instance, or
1450 f32 or f64vector of length 16.
1451 </p></dd></dl>
1452
1453 <dl>
1454 <dt><a name="index-gl_002dmult_002dmatrix"></a><u>Function:</u> <b>gl-mult-matrix</b><i> mat</i></dt>
1455 <dd><p>Multiplies the matrix <var>mat</var> to the current modifiable matrix.
1456 <var>Mat</var> can be a <code>&lt;matrix4f&gt;</code> instance, or
1457 f32 or f64vector of length 16.
1458 </p></dd></dl>
1459
1460 <dl>
1461 <dt><a name="index-gl_002dtranslate"></a><u>Function:</u> <b>gl-translate</b><i> x y z</i></dt>
1462 <dd><p>Multiplies the current matrix by a matrix taht translates
1463 an object by (<var>x</var>, <var>y</var>, <var>z</var>).
1464 Internally, <code>glTranslated</code> is called.
1465 </p></dd></dl>
1466
1467 <dl>
1468 <dt><a name="index-gl_002drotate"></a><u>Function:</u> <b>gl-rotate</b><i> angle x y z</i></dt>
1469 <dd><p>Multiplies the current matrix by a matrix that rotates
1470 an object in a counterclockwise direction about the ray
1471 from the origin through the point (<var>x</var>, <var>y</var>, <var>z</var>)
1472 by <var>angle</var> degrees.
1473 Internally, <code>glRotated</code> is called.
1474 </p></dd></dl>
1475
1476 <dl>
1477 <dt><a name="index-gl_002dscale"></a><u>Function:</u> <b>gl-scale</b><i> x y z</i></dt>
1478 <dd><p>Multiplies the current matrix by a matrix that scales
1479 an object by (<var>x</var>, <var>y</var>, <var>z</var>).
1480 Internally, <code>glScaled</code> is called.
1481 </p></dd></dl>
1482
1483 <dl>
1484 <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>
1485 <dd><p>Defines a viewing matrix and multiplies it to the right of
1486 the current matrix.
1487 </p></dd></dl>
1488
1489 <dl>
1490 <dt><a name="index-gl_002dfrustum"></a><u>Function:</u> <b>gl-frustum</b><i> left right bottom top nearv farv</i></dt>
1491 <dd><p>Creates a matrix for a perspective-view frustum and
1492 multiplies the current matrix by it.
1493 </p></dd></dl>
1494
1495 <dl>
1496 <dt><a name="index-glu_002dperspective"></a><u>Function:</u> <b>glu-perspective</b><i> fovy aspect znear zfar</i></dt>
1497 <dd><p>Creates a matrix for a symmetrix perspective-view frustum and
1498 multiplies the current matrix by it.
1499 </p></dd></dl>
1500
1501 <dl>
1502 <dt><a name="index-gl_002dortho"></a><u>Function:</u> <b>gl-ortho</b><i> left right bottom top nearv farv</i></dt>
1503 <dd><p>Creates a matrix for an orthographic parallel viewing volume nand
1504 multiplies the current matrix by it.
1505 </p></dd></dl>
1506
1507 <dl>
1508 <dt><a name="index-glu_002dortho_002d2d"></a><u>Function:</u> <b>glu-ortho-2d</b><i> left right bottom top</i></dt>
1509 <dd><p>Convenience procedure for 2D drawing; it is the same as <code>gl-ortho</code>
1510 except nearv and farv are fixed (along Z axis) to -1.0 and 1.0, respectively.
1511 </p></dd></dl>
1512
1513 <dl>
1514 <dt><a name="index-gl_002dviewport"></a><u>Function:</u> <b>gl-viewport</b><i> x y width height</i></dt>
1515 <dd><p>Defines a pixel rectangle in the window into which the final image
1516 is mapped.
1517 </p></dd></dl>
1518
1519 <dl>
1520 <dt><a name="index-gl_002dpush_002dmatrix"></a><u>Function:</u> <b>gl-push-matrix</b></dt>
1521 <dt><a name="index-gl_002dpop_002dmatrix"></a><u>Function:</u> <b>gl-pop-matrix</b></dt>
1522 <dd><p>Pushes/pops the current matrix.
1523 </p></dd></dl>
1524
1525 <dl>
1526 <dt><a name="index-gl_002dpush_002dmatrix_002a"></a><u>Macro:</u> <b>gl-push-matrix*</b><i> expr &hellip;</i></dt>
1527 <dd><p>A convenience macro. Pushes the current matrix,
1528 executes <var>expr</var>s, then pop the current matrix.
1529 </p></dd></dl>
1530
1531
1532 <hr size="6">
1533 <a name="Display-lists"></a>
1534 <table cellpadding="1" cellspacing="1" border="0">
1535 <tr><td valign="middle" align="left">[<a href="#Transformation" title="Previous section in reading order"> &lt; </a>]</td>
1536 <td valign="middle" align="left">[<a href="#Vertex-arrays" title="Next section in reading order"> &gt; </a>]</td>
1537 <td valign="middle" align="left"> &nbsp; </td>
1538 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
1539 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
1540 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
1541 <td valign="middle" align="left"> &nbsp; </td>
1542 <td valign="middle" align="left"> &nbsp; </td>
1543 <td valign="middle" align="left"> &nbsp; </td>
1544 <td valign="middle" align="left"> &nbsp; </td>
1545 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
1546 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
1547 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
1548 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
1549 </tr></table>
1550 <a name="Display-lists-1"></a>
1551 <h2 class="section">4.7 Display lists</h2>
1552
1553 <dl>
1554 <dt><a name="index-gl_002dgen_002dlists"></a><u>Function:</u> <b>gl-gen-lists</b><i> range</i></dt>
1555 <dd><p>Allocates <var>range</var> number of contiguous display list indices.
1556 Returns an integer which is the smallest display list index you
1557 can use.
1558 </p></dd></dl>
1559
1560 <dl>
1561 <dt><a name="index-gl_002dnew_002dlist"></a><u>Function:</u> <b>gl-new-list</b><i> list-no mode</i></dt>
1562 <dd><p>Starts a display list construction. <var>Mode</var> may be
1563 one of the constants <code>GL_COMPILE</code> or <code>GL_COMPILE_AND_EXECUTE</code>.
1564 </p></dd></dl>
1565
1566 <dl>
1567 <dt><a name="index-gl_002dend_002dlist"></a><u>Function:</u> <b>gl-end-list</b></dt>
1568 <dd><p>Ends a display list construction.
1569 </p></dd></dl>
1570
1571 <dl>
1572 <dt><a name="index-gl_002dcall_002dlist"></a><u>Function:</u> <b>gl-call-list</b><i> list-no</i></dt>
1573 <dd><p>Calls a display list.
1574 </p></dd></dl>
1575
1576 <dl>
1577 <dt><a name="index-gl_002dis_002dlist"></a><u>Function:</u> <b>gl-is-list</b><i> list-no</i></dt>
1578 <dd><p>Returns <code>#t</code> if <var>list-no</var> is an already used display list number,
1579 <code>#f</code> otherwise.
1580 </p></dd></dl>
1581
1582 <dl>
1583 <dt><a name="index-gl_002ddelete_002dlists"></a><u>Function:</u> <b>gl-delete-lists</b><i> list-no-start range</i></dt>
1584 <dd><p>Deletes <var>range</var> display list, beginning from <var>list-no-start</var>.
1585 </p></dd></dl>
1586
1587 <dl>
1588 <dt><a name="index-gl_002dlist_002dbase"></a><u>Function:</u> <b>gl-list-base</b><i> base</i></dt>
1589 <dd><p>Specifies the offset that&rsquo;s added to the display list indices in
1590 <code>gl-call-list</code>.
1591 </p></dd></dl>
1592
1593 <dl>
1594 <dt><a name="index-gl_002dcall_002dlists"></a><u>Function:</u> <b>gl-call-lists</b><i> size type lists</i></dt>
1595 <dt><a name="index-gl_002dcall_002dlists-1"></a><u>Function:</u> <b>gl-call-lists</b><i> size lists</i></dt>
1596 <dt><a name="index-gl_002dcall_002dlists-2"></a><u>Function:</u> <b>gl-call-lists</b><i> lists</i></dt>
1597 <dd><p>Executes <var>size</var> display list, whose indices are contained in <var>lists</var>.
1598 You can pass a u8, s8, u16, s16, u32, s32 or f32vector, or a string,
1599 as <var>lists</var>. If it is a string, each byte consists of the string
1600 is interpreted as an unsigned integer specifying a display list.
1601 It is useful for the technique to display character strings by
1602 creating display lists for each ASCII characters. But be aware that
1603 it doesn&rsquo;t work for multibyte characters.
1604 </p>
1605 <p>Usually you can use the simplest form (the third form) and Gauche-gl
1606 infers the <var>size</var> and <var>type</var> from the passed <var>lists</var>.
1607 You can explicitly specify <var>size</var> if you want to use just a
1608 beginning portion of <var>lists</var>. An error is signalled if you
1609 specify <var>size</var> that is larger than the size of <var>lists</var>.
1610 </p>
1611 <p>Specifying <var>type</var> is useful only if <var>lists</var> is a u8vector,
1612 and you want to use one of three special types allowed to <code>glCallLists</code>,
1613 namely <code>GL_2_BYTES</code>, <code>GL_3_BYTES</code>, and <code>GL_4_BYTES</code>.
1614 </p></dd></dl>
1615
1616 <hr size="6">
1617 <a name="Vertex-arrays"></a>
1618 <table cellpadding="1" cellspacing="1" border="0">
1619 <tr><td valign="middle" align="left">[<a href="#Display-lists" title="Previous section in reading order"> &lt; </a>]</td>
1620 <td valign="middle" align="left">[<a href="#Lighting" title="Next section in reading order"> &gt; </a>]</td>
1621 <td valign="middle" align="left"> &nbsp; </td>
1622 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
1623 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
1624 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
1625 <td valign="middle" align="left"> &nbsp; </td>
1626 <td valign="middle" align="left"> &nbsp; </td>
1627 <td valign="middle" align="left"> &nbsp; </td>
1628 <td valign="middle" align="left"> &nbsp; </td>
1629 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
1630 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
1631 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
1632 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
1633 </tr></table>
1634 <a name="Vertex-arrays-1"></a>
1635 <h2 class="section">4.8 Vertex arrays</h2>
1636
1637 <p>Scheme version of APIs doesn&rsquo;t have <var>GLenum type</var> argument
1638 in C API, since Gauche-gl can figure out the type by passed
1639 vectors.
1640 </p>
1641 <p>Scheme API of <code>gl-*-array</code> has <var>offset</var> optional argument,
1642 by which you can pass the GL the values beginning from the <var>offset</var>-th
1643 element of the passed uniform vector. This isn&rsquo;t in GL C API,
1644 since you can just offset the pointer in C.
1645 </p>
1646 <p>NOTE: it is caller&rsquo;s responsibility to guarantee the passed vector
1647 has enough length. GL doesn&rsquo;t have an interface to specify the boundary,
1648 so Gauche can&rsquo;t detect an invalid length vector.
1649 </p>
1650
1651 <dl>
1652 <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>
1653 <dd><p>Sets the vertex array. <var>Size</var> specifies the number of
1654 scalar values per vertex (2, 3, or 4), and <var>vec</var> provides
1655 the actual value in either f32, f64, s32 or s16vector.
1656 <code>Stride</code> and <var>offset</var> can be used to tell GL to
1657 access <var>vec</var> sparsely.
1658 </p></dd></dl>
1659
1660 <dl>
1661 <dt><a name="index-gl_002dnormal_002dpointer"></a><u>Function:</u> <b>gl-normal-pointer</b><i> vec &amp;optional stride offset</i></dt>
1662 <dd><p>Sets the normal array. <var>Vec</var> should be either
1663 a f32, f64, s32 or s16vector, where each consecutive triplet
1664 specifies a normal vector.
1665 <code>Stride</code> and <var>offset</var> can be used to tell GL to
1666 access <var>vec</var> sparsely.
1667 </p></dd></dl>
1668
1669 <dl>
1670 <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>
1671 <dd><p>Sets the color array. <var>Size</var> specifies the number of
1672 scalar values per color (3 or 4), and <var>vec</var> provides
1673 the actual values in either f32, f64, u32, u16, u8, s32, s16, or s8vector.
1674 <code>Stride</code> and <var>offset</var> can be used to tell GL to
1675 access <var>vec</var> sparsely.
1676 </p></dd></dl>
1677
1678 <dl>
1679 <dt><a name="index-gl_002dindex_002dpointer"></a><u>Function:</u> <b>gl-index-pointer</b><i> vec &amp;optional stride offset</i></dt>
1680 <dd><p>Sets the index array. <var>Vec</var> can be either s32, s16, u8, f32, or
1681 f64vector.
1682 <code>Stride</code> and <var>offset</var> can be used to tell GL to
1683 access <var>vec</var> sparsely.
1684 </p></dd></dl>
1685
1686 <dl>
1687 <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>
1688 <dd><p>Sets the texture coordinate array. <var>Size</var> specifies the
1689 number of scalar values per texture coordinate (1, 2, 3 or 4),
1690 and <var>vec</var> provides the actual values in either f32, f64, s32 or
1691 s16vector.
1692 <code>Stride</code> and <var>offset</var> can be used to tell GL to
1693 access <var>vec</var> sparsely.
1694 </p></dd></dl>
1695
1696 <dl>
1697 <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>
1698 <dd><p>Sets the edge flag array. <var>Vec</var> must be a GL boolean vector.
1699 <code>Stride</code> and <var>offset</var> can be used to tell GL to
1700 access <var>vec</var> sparsely.
1701 </p></dd></dl>
1702
1703 <dl>
1704 <dt><a name="index-gl_002darray_002delement"></a><u>Function:</u> <b>gl-array-element</b><i> ith</i></dt>
1705 <dd><p>Dereference <var>ith</var> vertex information of the currently enabled arrays.
1706 </p></dd></dl>
1707
1708 <dl>
1709 <dt><a name="index-gl_002ddraw_002delements"></a><u>Function:</u> <b>gl-draw-elements</b><i> mode indices</i></dt>
1710 <dd><p>Issues geometric primitive calls consists of the vertex information
1711 of the currently enabled arrays, each of which is specified
1712 by <var>indices</var>, which should be either a u8, u16 or u32vector.
1713 </p>
1714 <p><var>Mode</var> is the same as of <code>gl-begin</code>.
1715 </p></dd></dl>
1716
1717 <dl>
1718 <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>
1719 <dd><p>[GL1.2] Like <code>gl-draw-elements</code>, but limits the range of indices
1720 between <var>start</var> and <var>end</var>, inclusive. GL driver may take
1721 advantage of the information for better performance.
1722 </p></dd></dl>
1723
1724 <dl>
1725 <dt><a name="index-gl_002ddraw_002darrays"></a><u>Function:</u> <b>gl-draw-arrays</b><i> mode first count</i></dt>
1726 <dd><p>This is more straightforward. Starting from <var>first</var> index,
1727 <var>count</var> vertices is wrtten in the drawing mode <var>mode</var>
1728 (same as of <code>gl-begin</code>), taken from the current enabled arrays.
1729 </p></dd></dl>
1730
1731 <dl>
1732 <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>
1733 <dd><p><var>Vec</var> must be a f32vector. It contains various information
1734 (e.g. vertex position, color and texture coordinate) interleaved,
1735 in the way specified by <var>format</var>.
1736 </p>
1737 <p>In Scheme API, we only allow uniform vector as <var>vec</var>, so
1738 you can&rsquo;t use the format that mixes float and integer, such as
1739 <code>GL_C4UB_V2F</code>.
1740 </p></dd></dl>
1741
1742 <hr size="6">
1743 <a name="Lighting"></a>
1744 <table cellpadding="1" cellspacing="1" border="0">
1745 <tr><td valign="middle" align="left">[<a href="#Vertex-arrays" title="Previous section in reading order"> &lt; </a>]</td>
1746 <td valign="middle" align="left">[<a href="#Pixels" title="Next section in reading order"> &gt; </a>]</td>
1747 <td valign="middle" align="left"> &nbsp; </td>
1748 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
1749 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
1750 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
1751 <td valign="middle" align="left"> &nbsp; </td>
1752 <td valign="middle" align="left"> &nbsp; </td>
1753 <td valign="middle" align="left"> &nbsp; </td>
1754 <td valign="middle" align="left"> &nbsp; </td>
1755 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
1756 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
1757 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
1758 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
1759 </tr></table>
1760 <a name="Lighting-1"></a>
1761 <h2 class="section">4.9 Lighting</h2>
1762
1763 <dl>
1764 <dt><a name="index-gl_002dshade_002dmodel"></a><u>Function:</u> <b>gl-shade-model</b><i> mode</i></dt>
1765 <dd><p>Sets the shading model, either <code>GL_SMOOTH</code> or <code>GL_FLAT</code>.
1766 </p></dd></dl>
1767
1768 <dl>
1769 <dt><a name="index-gl_002dlight"></a><u>Function:</u> <b>gl-light</b><i> light pname param</i></dt>
1770 <dd><p>Creates a light specified by <var>light</var>, which is
1771 one of <code>GL_LIGHT0</code>, &hellip;, <code>GL_LIGHT7</code>,
1772 and sets a characteristics named by <var>pname</var> with the value <var>param</var>.
1773 </p>
1774 <p>Possible values as <var>pname</var> and acceptable types of <var>param</var> are
1775 as follows.
1776 </p><dl compact="compact">
1777 <dt> <code>GL_AMBIENT</code>, <code>GL_DIFFUSE</code>, <code>GL_SPECULAR</code>, <code>GL_POSITION</code></dt>
1778 <dd><p>Accepts an f32 or s32vector of size 4.
1779 </p></dd>
1780 <dt> <code>GL_SPOT_DIRECTION</code></dt>
1781 <dd><p>Accepts an f32 or s32vector of size 3.
1782 </p></dd>
1783 <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>
1784 <dd><p>Accepts a real number (<code>glLightf</code> is used).
1785 </p></dd>
1786 </dl>
1787 </dd></dl>
1788
1789 <dl>
1790 <dt><a name="index-gl_002dget_002dlight"></a><u>Function:</u> <b>gl-get-light</b><i> light pname</i></dt>
1791 <dd><p>Returns the value of the property <var>pname</var> of the light <var>light</var>.
1792 Returned value can be f32vector or a real number.
1793 </p></dd></dl>
1794
1795 <dl>
1796 <dt><a name="index-gl_002dlight_002dmodel"></a><u>Function:</u> <b>gl-light-model</b><i> pname param</i></dt>
1797 <dd><p>Sets the value of the property <var>pname</var> of the lighting model.
1798 Possible <var>pname</var> and its allowed <var>param</var> is as follows.
1799 </p><dl compact="compact">
1800 <dt> <code>GL_LIGHT_MODEL_AMBIENT</code></dt>
1801 <dd><p>Accepts f32 or s32vector of size 4.
1802 </p></dd>
1803 <dt> <code>GL_LIGHT_MODEL_LOCAL_VIEWER</code>, <code>GL_LIGHT_MODEL_TWO_SIDE</code></dt>
1804 <dd><p>Accepts any Scheme value, which is interpreted as a boolean value.
1805 (That is, you have to pass <code>#f</code> to turn off these properties,
1806 and any other value to turn on.
1807 </p></dd>
1808 <dt> <code>GL_LIGHT_MODEL_COLOR_CONTROL</code></dt>
1809 <dd><p>Accepts an enum value either <code>GL_SINGLE_COLOR</code> or
1810 <code>GL_SEPARATE_SPECULAR_COLOR</code>.
1811 </p></dd>
1812 </dl>
1813 </dd></dl>
1814
1815 <dl>
1816 <dt><a name="index-gl_002dmaterial"></a><u>Function:</u> <b>gl-material</b><i> face pname param</i></dt>
1817 <dd><p>Sets the current material property. <var>Face</var> may be either
1818 <code>GL_FRONT</code>, <code>GL_BACK</code>, or <code>GL_FRONT_AND_BACK</code>.
1819 Possible values of <var>pname</var> and acceptable <var>param</var> types are
1820 as follows.
1821 </p><dl compact="compact">
1822 <dt> <code>GL_AMBIENT</code>, <code>GL_DIFFUSE</code>, <code>GL_AMBIENT_AND_DIFFUSE</code>, <code>GL_SPECULAR</code>, <code>GL_EMISSION</code></dt>
1823 <dd><p>Accepts f32 or s32vector of size 4.
1824 </p></dd>
1825 <dt> <code>GL_SHININESS</code></dt>
1826 <dd><p>Accepts a single real number (<code>glMaterialf</code> is called).
1827 </p></dd>
1828 <dt> <code>GL_COLOR_INDEXES</code></dt>
1829 <dd><p>Accepts f32 or s32vector of size 3.
1830 </p></dd>
1831 </dl>
1832 </dd></dl>
1833
1834 <dl>
1835 <dt><a name="index-gl_002dget_002dmaterial"></a><u>Function:</u> <b>gl-get-material</b><i> face pname</i></dt>
1836 <dd><p>Returns the current material property of <var>face</var> and <var>pname</var>.
1837 The type of returned value may be f32vector, s32vector (only for
1838 <code>GL_COLOR_INDEXES</code>), or a real number.
1839 </p></dd></dl>
1840
1841 <dl>
1842 <dt><a name="index-gl_002dcolor_002dmaterial"></a><u>Function:</u> <b>gl-color-material</b><i> face mode</i></dt>
1843 <dd><p>Makes the material property <var>mode</var> (e.g. <code>GL_AMBIENT</code> etc.)
1844 of the face <var>face</var> follow the current color set by <code>gl-color</code>.
1845 </p></dd></dl>
1846
1847 <hr size="6">
1848 <a name="Pixels"></a>
1849 <table cellpadding="1" cellspacing="1" border="0">
1850 <tr><td valign="middle" align="left">[<a href="#Lighting" title="Previous section in reading order"> &lt; </a>]</td>
1851 <td valign="middle" align="left">[<a href="#Texture-mapping" title="Next section in reading order"> &gt; </a>]</td>
1852 <td valign="middle" align="left"> &nbsp; </td>
1853 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
1854 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
1855 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
1856 <td valign="middle" align="left"> &nbsp; </td>
1857 <td valign="middle" align="left"> &nbsp; </td>
1858 <td valign="middle" align="left"> &nbsp; </td>
1859 <td valign="middle" align="left"> &nbsp; </td>
1860 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
1861 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
1862 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
1863 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
1864 </tr></table>
1865 <a name="Pixels_002c-bitmaps-and-images"></a>
1866 <h2 class="section">4.10 Pixels, bitmaps and images</h2>
1867
1868 <a name="Pixel-operations"></a>
1869 <h3 class="subheading">Pixel operations</h3>
1870
1871 <dl>
1872 <dt><a name="index-gl_002dbitmap"></a><u>Function:</u> <b>gl-bitmap</b><i> width height xbo ybo xbi ybi bitmap</i></dt>
1873 <dd><p>Draws a bitmap. <var>Width</var> and <var>height</var> gives the dimension
1874 of the bitmap. <var>Xbo</var>, <var>ybo</var>, <var>xbi</var>, and <var>ybi</var>
1875 specifies the origin and increment of the current raster position.
1876 <var>Bitmap</var> is the actual bitmap data, packed in a u8vector.
1877 </p></dd></dl>
1878
1879 <dl>
1880 <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>
1881 <dd><p>Reads pixel data from the framebuffer. Returns the pixel data
1882 in a uniform vector of the type determined by <var>format</var> and
1883 <var>type</var> (check out OpenGL doc to find out the actual data format).
1884 </p></dd></dl>
1885
1886 <dl>
1887 <dt><a name="index-gl_002ddraw_002dpixels"></a><u>Function:</u> <b>gl-draw-pixels</b><i> width height format type pixels</i></dt>
1888 <dd><p>Draws a pixel data <var>pixels</var> at the current raster position.
1889 <var>Pixels</var> must be a uniform vector compatible to the specified
1890 <var>format</var> and <var>type</var> values.
1891 </p></dd></dl>
1892
1893 <dl>
1894 <dt><a name="index-gl_002dcopy_002dpixels"></a><u>Function:</u> <b>gl-copy-pixels</b><i> x y width height buffer</i></dt>
1895 <dd><p>Copies pixel data in a rectangle area of the framebuffer,
1896 specified by lower-left corner (<var>x</var>, <var>y</var>) and dimensions
1897 (<var>width</var>, <var>height</var>). <var>Buffer</var> specifies which buffer
1898 is used, and should be one of <code>GL_COLOR</code>, <code>GL_STENCIL</code>
1899 or <code>GL_DEPTH</code>.
1900 </p></dd></dl>
1901
1902 <dl>
1903 <dt><a name="index-gl_002dpixel_002dstore"></a><u>Function:</u> <b>gl-pixel-store</b><i> pname param</i></dt>
1904 <dd><p>Sets the pixel stroage models. Check out the OpenGL doc for
1905 the possible <var>pname</var> and <var>param</var> values.
1906 </p></dd></dl>
1907
1908 <dl>
1909 <dt><a name="index-gl_002dpixel_002dtransfer"></a><u>Function:</u> <b>gl-pixel-transfer</b><i> pname param</i></dt>
1910 <dd><p>Sets the pixel transfer modes. Check out the OpenGL doc for
1911 the possible <var>pname</var> and <var>param</var> values.
1912 </p></dd></dl>
1913
1914 <dl>
1915 <dt><a name="index-gl_002dpixel_002dmap"></a><u>Function:</u> <b>gl-pixel-map</b><i> map values</i></dt>
1916 <dd><p>Sets the pixel map table <var>map</var> with <var>values</var>,
1917 which must be either u16, u32 or f32vecotor.
1918 Check out the OpenGL doc for the possible <var>map</var> values.
1919 </p></dd></dl>
1920
1921 <dl>
1922 <dt><a name="index-gl_002dpixel_002dzoom"></a><u>Function:</u> <b>gl-pixel-zoom</b><i> xfactor yfactor</i></dt>
1923 <dd><p>Sets the magnification/reduction factors for pixel-write operations.
1924 </p></dd></dl>
1925
1926 <dl>
1927 <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>
1928 <dd><p>Returns the current pixel map table as an uniform vector specified
1929 by <var>type</var>, which must be either a class <code>&lt;u32vector&gt;</code> (default),
1930 <code>&lt;u16vector&gt;</code>, or <code>&lt;f32vector&gt;</code>.
1931 </p></dd></dl>
1932
1933 <dl>
1934 <dt><a name="index-gl_002dget_002dpixel_002dmap_0021"></a><u>Function:</u> <b>gl-get-pixel-map!</b><i> map values</i></dt>
1935 <dd><p>Like <code>gl-get-pixel-map</code>, but instead of allocating a new vector,
1936 it stores the result to a uniform vector passed to <var>values</var>.
1937 It is a caller&rsquo;s responsibility to ensure <var>values</var> has enough size.
1938 </p></dd></dl>
1939
1940 <a name="Color-tables"></a>
1941 <h3 class="subheading">Color tables</h3>
1942
1943 <dl>
1944 <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>
1945 <dd><p>[GL_ARB_imaging]
1946 Specifies one of the color table <var>target</var>.
1947 <var>Data</var> should be a uniform vector compatible to the
1948 <var>format</var> and <var>type</var> parameters.
1949 </p></dd></dl>
1950
1951 <dl>
1952 <dt><a name="index-gl_002dcolor_002dtable_002dparameter"></a><u>Function:</u> <b>gl-color-table-parameter</b><i> target pname param</i></dt>
1953 <dd><p>[GL_ARB_imaging]
1954 Sets the color table parameter <var>pname</var>
1955 (either <code>GL_COLOR_TABLE_SCALE</code> or <code>GL_COLOR_TABLE_BIAS</code>),
1956 of the color table <var>target</var>. <var>Param</var> must be
1957 an f32 or s32vector of size 4.
1958 </p></dd></dl>
1959
1960 <dl>
1961 <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>
1962 <dd><p>[GL_ARB_imaging]
1963 Creates a color table <var>target</var> using framebuffer data.
1964 The pixels are
1965 read from the current buffer for read (specified by <code>glReadBuffer</code>).
1966 </p></dd></dl>
1967
1968 <dl>
1969 <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>
1970 <dd><p>[GL_ARB_imaging]
1971 Replaces a part of color table <var>target</var>, starting <var>start</var>
1972 and <var>count</var> entries. Values are given in <var>data</var> as a
1973 uniform vector compatible to the <var>format</var> and <var>type</var> arguments.
1974 </p></dd></dl>
1975
1976 <dl>
1977 <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>
1978 <dd><p>[GL_ARB_imaging] Replaces a part of color table entries using framebuffer data.
1979 </p></dd></dl>
1980
1981 <dl>
1982 <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>
1983 <dd><p>[GL_ARB_imaging]
1984 Reads the color table <var>target</var> and store it in <var>data</var>,
1985 in the format specified by <var>format</var> and <var>type</var>.
1986 <var>Data</var> must be a uniform vector compatible to the
1987 <var>format</var> and <var>type</var> arguments. The caller must ensure
1988 that <var>data</var> has enough size to contain the result.
1989 </p></dd></dl>
1990
1991 <a name="Convolutions"></a>
1992 <h3 class="subheading">Convolutions</h3>
1993
1994 <dl>
1995 <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>
1996 <dd><p>[GL_ARB_imaging]
1997 Defines a 2D convolution filter. <var>Target</var> must be GL_CONVOLUTION_2D.
1998 <code>Data</code> must be a uniform vector
1999 compatible to the <var>format</var> and <var>type</var> arguments, and must have
2000 enough size.
2001 </p></dd></dl>
2002
2003 <dl>
2004 <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>
2005 <dd><p>[GL_ARB_imaging]
2006 Defines a 2D convolution filter,
2007 taking the convolution filter data from the current color buffer to read.
2008 </p></dd></dl>
2009
2010 <dl>
2011 <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>
2012 <dd><p>[GL_ARB_imaging]
2013 Defines a 2D convolution filter by a product of a 1D row vector and
2014 1D column vector. <var>Target</var> must be GL_SEPARABLE_2D.
2015 Both <var>row</var> and <var>column</var> must be a uniform
2016 vector, compatible with the <var>format</var> and <var>type</var> arguments,
2017 and must have enough size.
2018 </p></dd></dl>
2019
2020 <dl>
2021 <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>
2022 <dd><p>[GL_ARB_imaging]
2023 Defines 1D convolution filter. <var>Target</var> must be GL_CONVOLUTION_1D.
2024 <code>Data</code> must be a uniform vector
2025 compatible to the <var>format</var> and <var>type</var> arguments, and must have
2026 enough size.
2027 </p></dd></dl>
2028
2029 <dl>
2030 <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>
2031 <dd><p>[GL_ARB_imaging]
2032 Defines 1D convolution filter, taking the convolution filter data
2033 from the current color buffer to read.
2034 </p></dd></dl>
2035
2036 <dl>
2037 <dt><a name="index-gl_002dconvolution_002dparameter"></a><u>Function:</u> <b>gl-convolution-parameter</b><i> target pname param</i></dt>
2038 <dd><p>[GL_ARB_imaging]
2039 Sets a parameter for a convolution filter <var>target</var>, which can
2040 be either <code>GL_CONVOLUTION_2D</code>, <code>GL_SEPARABLE_2D</code>,
2041 or <code>GL_CONVOLUTION_1D</code>. Possible values of <var>pname</var> and
2042 their acceptable <var>param</var> are as follows.
2043 </p><dl compact="compact">
2044 <dt> <code>GL_CONVOLUTION_BORDER_MODE</code></dt>
2045 <dd><p>Either one of the constants: <code>GL_REDUCE</code>, <code>GL_CONSTNAT_BORDER</code>,
2046 <code>GL_REPLICATE_BORDER</code>
2047 </p></dd>
2048 <dt> <code>GL_CONVOLUTION_FILTER_SCALE</code>, <code>GL_CONVOLUTION_FILTER_BIAS</code></dt>
2049 <dd><p>An s32 or f32vector of size 4, specifying color values.
2050 </p></dd>
2051 </dl>
2052 </dd></dl>
2053
2054
2055 <a name="Histogram"></a>
2056 <h3 class="subheading">Histogram</h3>
2057
2058 <dl>
2059 <dt><a name="index-gl_002dhistogram"></a><u>Function:</u> <b>gl-histogram</b><i> target width internal-format sink</i></dt>
2060 <dd><p>[GL_ARB_imaging]
2061 Specifies the way the histogram data is stored.
2062 <var>Target</var> must be either <code>GL_HISTOGRAM</code> or <code>GL_PROXY_HISTOGRAM</code>.
2063 <var>Width</var> is the number of entires of the histogram, and has to be
2064 a power of 2.
2065 <var>Sink</var> is a boolean value to indicate whether pixels should be
2066 discarded or sent down further to the pipeline.
2067 </p></dd></dl>
2068
2069 <dl>
2070 <dt><a name="index-gl_002dreset_002dhistogram"></a><u>Function:</u> <b>gl-reset-histogram</b><i> target</i></dt>
2071 <dd><p>[GL_ARB_imaging]
2072 Resets the histogram counters. <var>Target</var> must be <code>GL_HISTOGRAM</code>.
2073 </p></dd></dl>
2074
2075 <dl>
2076 <dt><a name="index-gl_002dget_002dhistogram"></a><u>Function:</u> <b>gl-get-histogram</b><i> target reset format type</i></dt>
2077 <dd><p>[GL_ARB_imaging]
2078 Returns histogram data in a uniform vector, whose type and size
2079 are determined by <var>format</var> and <var>type</var>.
2080 A boolean value <var>reset</var> specifies whether the histogram should
2081 be reset or not.
2082 </p></dd></dl>
2083
2084 <dl>
2085 <dt><a name="index-gl_002dget_002dhistogram_002dparameter"></a><u>Function:</u> <b>gl-get-histogram-parameter</b><i> target pname</i></dt>
2086 <dd><p>[GL_ARB_imaging]
2087 Returns the parameter value of the histogram.
2088 <var>Pname</var> can be either one of <code>GL_HISTOGRAM_WIDTH</code>,
2089 <code>GL_HISTOGRAM_FORMAT</code>, <code>GL_HISTOGRAM_RED_SIZE</code>,
2090 <code>GL_HISTOGRAM_GREEN_SIZE</code>, <code>GL_HISTOGRAM_BLUE_SIZE</code>,
2091 <code>GL_HISTOGRAM_ALPHA_SIZE</code>, <code>GL_HISTOGRAM_LUMINANCE_SIZE</code>,
2092 or <code>GL_HISTOGRAM_SINK</code>. The returned value is an integer,
2093 except the case of <code>GL_HISTOGRAM_SINK</code>, which returns a boolean value.
2094 </p></dd></dl>
2095
2096
2097 <a name="Minmax"></a>
2098 <h3 class="subheading">Minmax</h3>
2099
2100 <dl>
2101 <dt><a name="index-gl_002dminmax"></a><u>Function:</u> <b>gl-minmax</b><i> target internal-format sink</i></dt>
2102 <dd><p>[GL_ARB_imaging]
2103 Computes the minimum and maximum pixel values for an image.
2104 <var>Target</var> must be <code>GL_MINMAX</code>.
2105 <var>Sink</var> is a boolean value to indicate whether pixels should be
2106 discarded or sent down further to the pipeline.
2107 </p></dd></dl>
2108
2109 <dl>
2110 <dt><a name="index-gl_002dget_002dminmax"></a><u>Function:</u> <b>gl-get-minmax</b><i> target reset format type</i></dt>
2111 <dd><p>[GL_ARB_imaging]
2112 Returns the results of the minmax operation in a uniform vector,
2113 whose type and size are determined by the <var>format</var> and
2114 <var>type</var> arguments.
2115 A boolean value <var>reset</var> specifies whether the histogram should
2116 be reset or not.
2117 </p></dd></dl>
2118
2119 <dl>
2120 <dt><a name="index-gl_002dreset_002dminmax"></a><u>Function:</u> <b>gl-reset-minmax</b><i> target</i></dt>
2121 <dd><p>[GL_ARB_imaging]
2122 Resets the minmax counter.
2123 </p></dd></dl>
2124
2125 <dl>
2126 <dt><a name="index-gl_002dget_002dminmax_002dparameter"></a><u>Function:</u> <b>gl-get-minmax-parameter</b><i> target pname</i></dt>
2127 <dd><p>[GL_ARB_imaging]
2128 Returns the parameter value of the histogram.
2129 <var>Pname</var> can be either <code>GL_MINMAX_SINK</code> (returns
2130 a boolean value) or <code>GL_MINMAX_FORMAT</code> (returns an integer).
2131 </p></dd></dl>
2132
2133 <hr size="6">
2134 <a name="Texture-mapping"></a>
2135 <table cellpadding="1" cellspacing="1" border="0">
2136 <tr><td valign="middle" align="left">[<a href="#Pixels" title="Previous section in reading order"> &lt; </a>]</td>
2137 <td valign="middle" align="left">[<a href="#Framebuffers" title="Next section in reading order"> &gt; </a>]</td>
2138 <td valign="middle" align="left"> &nbsp; </td>
2139 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
2140 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
2141 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
2142 <td valign="middle" align="left"> &nbsp; </td>
2143 <td valign="middle" align="left"> &nbsp; </td>
2144 <td valign="middle" align="left"> &nbsp; </td>
2145 <td valign="middle" align="left"> &nbsp; </td>
2146 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
2147 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
2148 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
2149 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
2150 </tr></table>
2151 <a name="Texture-mapping-1"></a>
2152 <h2 class="section">4.11 Texture mapping</h2>
2153
2154 <a name="Defining-textures"></a>
2155 <h3 class="subheading">Defining textures</h3>
2156
2157 <dl>
2158 <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>
2159 <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>
2160 <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>
2161 <dd><p>Defines an 1D, 2D or 3D texture. 3D texture is available only
2162 if the GL version is 1.2 or later.
2163 The <var>target</var> parameter can be <code>GL_TEXTURE_1D</code> or
2164 <code>GL_PROXY_TEXTURE_1D</code> for <code>gl-tex-image-1d</code>, etc.
2165 The <var>level</var> parameter can be used for multiresolution textures; if
2166 this is a single resolution texture, pass 0.
2167 </p>
2168 <p><var>Width</var>, <var>height</var>, and <var>depth</var> specify
2169 the dimensions of the texture.
2170 <var>Border</var> can be 0 or 1, specifying the border.
2171 </p>
2172 <p>The actual texture data is passed to the <var>texels</var> argument in
2173 a uniform vector, which should be compatible with the <var>format</var>
2174 and <var>type</var> parameters and match the size calculated by <var>width</var>,
2175 <var>height</var> and <var>depth</var> (and possibly the pixel store setting).
2176 </p></dd></dl>
2177
2178 <dl>
2179 <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>
2180 <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>
2181 <dd><p>Cerates a 1D or 2D texture from the framebuffer data.
2182 </p></dd></dl>
2183
2184 <dl>
2185 <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>
2186 <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>
2187 <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>
2188 <dd><p>Replaces a part of the current 1D, 2D or 3D texture image by <var>texels</var>.
2189 3D texture is available only
2190 if the GL version is 1.2 or later.
2191 </p></dd></dl>
2192
2193 <dl>
2194 <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>
2195 <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>
2196 <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>
2197 <dd><p>Replaces a part of the current 1D, 2D or 3D texture image by
2198 the data from the framebuffer. 3D texture is available only
2199 if the GL version is 1.2 or later.
2200 </p></dd></dl>
2201
2202 <a name="Texture-parameters"></a>
2203 <h3 class="subheading">Texture parameters</h3>
2204
2205 <dl>
2206 <dt><a name="index-gl_002dtex_002dparameter"></a><u>Function:</u> <b>gl-tex-parameter</b><i> target pname param</i></dt>
2207 <dd><p>Sets parameters for the current texture.
2208 <var>Target</var> can be either <var>GL_TEXTURE_1D</var>, <code>GL_TEXTURE_2D</code> or
2209 <var>GL_TEXTURE_3D</var>. Possible values for <var>pname</var>, and accepted
2210 type of <var>param</var> for each <var>pname</var>, are shown below.
2211 </p>
2212 <dl compact="compact">
2213 <dt> <code>GL_TEXTURE_WRAP_S</code></dt>
2214 <dt> <code>GL_TEXTURE_WRAP_T</code></dt>
2215 <dt> <code>GL_TEXTURE_WRAP_R</code></dt>
2216 <dt> <code>GL_TEXTURE_BASE_LEVEL</code></dt>
2217 <dt> <code>GL_TEXTURE_MAX_LEVEL</code></dt>
2218 <dt> <code>GL_TEXTURE_MAG_FILTER</code></dt>
2219 <dt> <code>GL_TEXTURE_MIN_FILTER</code></dt>
2220 <dd><p><var>Param</var> must be an integer.
2221 </p></dd>
2222 <dt> <code>GL_TEXTURE_PRIORITY</code></dt>
2223 <dt> <code>GL_TEXTURE_MIN_LOD</code></dt>
2224 <dt> <code>GL_TEXTURE_MAX_LOD</code></dt>
2225 <dd><p><var>Param</var> must be a real number.
2226 </p></dd>
2227 <dt> <code>GL_TEXTURE_BORDER_COLOR</code></dt>
2228 <dd><p><var>Param</var> must be an f32vector of size 4, representing a color.
2229 </p></dd>
2230 </dl>
2231 </dd></dl>
2232
2233 <dl>
2234 <dt><a name="index-gl_002dget_002dtex_002dparameter"></a><u>Function:</u> <b>gl-get-tex-parameter</b><i> target pname</i></dt>
2235 <dd><p>Obtains the parameter of the current texture, set by <code>gl-tex-parameter</code>.
2236 </p></dd></dl>
2237
2238 <dl>
2239 <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>
2240 <dd><p>Obtains the parameter of the level <var>level</var>
2241 of the current texture specified by <var>target</var>,
2242 which can be either <code>GL_TEXTURE_1D</code>, <code>GL_TEXTURE_2D</code>,
2243 <code>GL_TEXTURE_3D</code>, <code>GL_PROXY_TEXTURE_1D</code>,
2244 <code>GL_PROXY_TEXTURE_2D</code>, or <code>GL_PROXY_TEXTURE_3D</code>.
2245 </p>
2246 <p>Possible values for <var>pname</var> is either one of the
2247 following constants: <code>GL_TEXTURE_WIDTH</code>, <code>GL_TEXTURE_HEIGHT</code>,
2248 <code>GL_TEXTURE_DEPTH</code>, <code>GL_TEXTURE_BORDER</code>,
2249 <code>GL_TEXTURE_INTERNAL_FORMAT</code>, <code>GL_TEXTURE_RED_SIZE</code>,
2250 <code>GL_TEXTURE_GREEN_SIZE</code>, <code>GL_TEXTURE_BLUE_SIZE</code>,
2251 <code>GL_TEXTURE_ALPHA_SIZE</code>, <code>GL_TEXTURE_LUMINANCE_SIZE</code>, or
2252 <code>GL_TEXTURE_INTENSITY_SIZE</code>. This procedure returns an integer.
2253 </p></dd></dl>
2254
2255 <a name="Mipmaps"></a>
2256 <h3 class="subheading">Mipmaps</h3>
2257
2258 <dl>
2259 <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>
2260 <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>
2261 <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>
2262 <dd><p>Constructs a serids of mipmaps and calls <code>gl-tex-image-*d</code> to load
2263 the images. Returns 0 on success, or a GLU error code on failure.
2264 <var>Texels</var> is a uniform vector, that must be compatible with
2265 <var>format</var> and <var>type</var> arguments, and must have the enough length
2266 as specified by <var>width</var>, <var>height</var> and <var>depth</var> parameters.
2267 </p></dd></dl>
2268
2269 <dl>
2270 <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>
2271 <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>
2272 <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>
2273 <dd><p>Like <code>glu-build-*d-mipmaps</code>, but you can specify the level of
2274 <var>texels</var>, and the range of levels to be generated
2275 by the <var>base</var> and <var>max</var> parameters. It is used to generate
2276 a subset of mipmaps.
2277 </p>
2278 <p>Returns 0 on success, or a GLU error code on failure.
2279 <var>Texels</var> is a uniform vector, that must be compatible with
2280 <var>format</var> and <var>type</var> arguments, and must have the enough length
2281 as specified by <var>width</var>, <var>height</var> and <var>depth</var> parameters.
2282 </p></dd></dl>
2283
2284 <a name="Texture-objects"></a>
2285 <h3 class="subheading">Texture objects</h3>
2286
2287 <dl>
2288 <dt><a name="index-gl_002dgen_002dtextures"></a><u>Function:</u> <b>gl-gen-textures</b><i> size</i></dt>
2289 <dd><p>Returns <var>size</var> new names for texture objects in a u32vector.
2290 </p></dd></dl>
2291
2292 <dl>
2293 <dt><a name="index-gl_002dis_002dtexture"></a><u>Function:</u> <b>gl-is-texture</b><i> name</i></dt>
2294 <dd><p>Returns <code>#t</code> if an integer <var>name</var> is the name of a texture
2295 that has been bound and not deleted yet, <code>#f</code> otherwise.
2296 </p></dd></dl>
2297
2298 <dl>
2299 <dt><a name="index-gl_002dbind_002dtexture"></a><u>Function:</u> <b>gl-bind-texture</b><i> target name</i></dt>
2300 <dd><p>Bind the current texture (specified by <var>target</var>,
2301 e.g. <code>GL_TEXTURE_2D</code>) to the integer <var>name</var>.
2302 If there&rsquo;s already a texture bound to <var>name</var>, it becomes current.
2303 Otherwise a new texture object is created and made current.
2304 </p></dd></dl>
2305
2306 <dl>
2307 <dt><a name="index-gl_002ddelete_002dtextures"></a><u>Function:</u> <b>gl-delete-textures</b><i> names</i></dt>
2308 <dd><p>Delets textures. <var>Names</var> must be a u32vector contains integer names
2309 of the texture objects to be deleted.
2310 </p></dd></dl>
2311
2312 <dl>
2313 <dt><a name="index-gl_002dare_002dtextures_002dresident_0021"></a><u>Function:</u> <b>gl-are-textures-resident!</b><i> names residences</i></dt>
2314 <dd><p><var>Names</var> must be a u32vector contains integer names
2315 of the texture objects, and <var>residences</var> must be a GL boolean vector
2316 of the same length as <var>names</var>. If all textures named in <var>names</var>
2317 are resident, <code>#t</code> is returned and <var>residences</var> is not
2318 modified. Othewise, <code>#f</code> is returned and
2319 <var>residences</var> is modified to contain <code>#t</code> if the corresponding
2320 texture in <var>names</var> is resident, <code>#f</code> othewise.
2321 </p></dd></dl>
2322
2323 <dl>
2324 <dt><a name="index-gl_002dprioritize_002dtextures"></a><u>Function:</u> <b>gl-prioritize-textures</b><i> names priorities</i></dt>
2325 <dd><p>Sets the prioridies of texture objects named by <var>names</var> to
2326 the corresponding entry of <var>priorities</var>
2327 <var>Names</var> must be a u32vectore and <var>priorities</var> must be an f32vector,
2328 and the lengths of both vectors must match.
2329 </p></dd></dl>
2330
2331 <a name="Texture-environment-and-coordinates"></a>
2332 <h3 class="subheading">Texture environment and coordinates</h3>
2333
2334 <dl>
2335 <dt><a name="index-gl_002dtex_002denv"></a><u>Function:</u> <b>gl-tex-env</b><i> target pname param</i></dt>
2336 <dd><p>Sets the current texturing function. <var>Target</var> must be
2337 <code>GL_TEXTURE_ENV</code>. Possible values of <var>pname</var> and accepted
2338 <var>param</var> for each value is as follows.
2339 </p>
2340 <dl compact="compact">
2341 <dt> <code>GL_TEXTURE_ENV_MODE</code></dt>
2342 <dd><p>One of <code>GL_DECAL</code>, <code>GL_REPLACE</code>, <code>GL_MODULATE</code> or
2343 <code>GL_BLEND</code>.
2344 </p></dd>
2345 <dt> <code>GL_TEXTURE_ENV_COLOR</code></dt>
2346 <dd><p>f32vector of size 4 to specify the color.
2347 </p></dd>
2348 </dl>
2349 </dd></dl>
2350
2351 <dl>
2352 <dt><a name="index-gl_002dtex_002dgen"></a><u>Function:</u> <b>gl-tex-gen</b><i> coord pname param</i></dt>
2353 <dd><p>Specifies the functions for automatic texture coordinate generation.
2354 <var>Coord</var> specifies the coordinates, either one of <code>GL_S</code>,
2355 <code>GL_T</code>, <code>GL_R</code> or <code>GL_Q</code>.
2356 Possible values of <var>pname</var> and accepted
2357 <var>param</var> for each value is as follows.
2358 </p><dl compact="compact">
2359 <dt> <code>GL_TEXTURE_GEN_MODE</code></dt>
2360 <dd><p>Either <code>GL_OBJECT_LINEAR</code>, <code>GL_EYE_LINEAR</code> or
2361 <code>GL_SPHERE_MAP</code>.
2362 </p></dd>
2363 <dt> <code>GL_OBJECT_PLANE</code></dt>
2364 <dt> <code>GL_EYE_PLANE</code></dt>
2365 <dd><p>An s32, f32 or f64vector of size 4 to specify the plane.
2366 </p></dd>
2367 </dl>
2368 </dd></dl>
2369
2370 <a name="Multitexturing"></a>
2371 <h3 class="subheading">Multitexturing</h3>
2372
2373 <dl>
2374 <dt><a name="index-gl_002dactive_002dtexture_002darb"></a><u>Function:</u> <b>gl-active-texture-arb</b><i> texunit</i></dt>
2375 <dd><p>[GL_ARB_multitexture]
2376 Selects the texture unit that is currently modified by
2377 texturing routines. <var>Texunit</var> is a constant
2378 <code>GL_TEXTUREi_ARB</code>, where <var>i</var> is 0 to the maximum
2379 number of the supported texture units.
2380 </p></dd></dl>
2381
2382 <dl>
2383 <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>
2384 <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>
2385 <dd><p>[GL_ARB_multitexture]
2386 Specifies the texture coordinate of the texture unit <var>texunit</var>.
2387 In the first form, you can pass either an f32, f64, s32, or s16vector
2388 of length 1 to 4. In the second form, <var>s</var>, <var>t</var>, <var>r</var>
2389 and <var>q</var> must be real numbers.
2390 </p></dd></dl>
2391
2392 <dl>
2393 <dt><a name="index-gl_002dclient_002dactive_002dtexture_002darb"></a><u>Function:</u> <b>gl-client-active-texture-arb</b><i> texunit</i></dt>
2394 <dd><p>Selects the current texture unit for specifying texutre-coordinate
2395 data with vertex arrays.
2396 </p></dd></dl>
2397
2398 <hr size="6">
2399 <a name="Framebuffers"></a>
2400 <table cellpadding="1" cellspacing="1" border="0">
2401 <tr><td valign="middle" align="left">[<a href="#Texture-mapping" title="Previous section in reading order"> &lt; </a>]</td>
2402 <td valign="middle" align="left">[<a href="#Selection-and-feedback" title="Next section in reading order"> &gt; </a>]</td>
2403 <td valign="middle" align="left"> &nbsp; </td>
2404 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
2405 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
2406 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
2407 <td valign="middle" align="left"> &nbsp; </td>
2408 <td valign="middle" align="left"> &nbsp; </td>
2409 <td valign="middle" align="left"> &nbsp; </td>
2410 <td valign="middle" align="left"> &nbsp; </td>
2411 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
2412 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
2413 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
2414 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
2415 </tr></table>
2416 <a name="Framebuffers-1"></a>
2417 <h2 class="section">4.12 Framebuffers</h2>
2418
2419 <a name="Clearing-buffers"></a>
2420 <h3 class="subheading">Clearing buffers</h3>
2421
2422 <dl>
2423 <dt><a name="index-gl_002dclear_002dcolor"></a><u>Function:</u> <b>gl-clear-color</b><i> r g b a</i></dt>
2424 <dd><p>Sets the current clearing color.
2425 Each color value sould be a real number, and is clamped to
2426 <code>[0.0,1.0]</code>.
2427 </p></dd></dl>
2428
2429 <dl>
2430 <dt><a name="index-gl_002dclear_002dindex"></a><u>Function:</u> <b>gl-clear-index</b><i> c</i></dt>
2431 <dd><p>Sets the current clearing color (in color index mode).
2432 <var>c</var> must be a real number.
2433 </p></dd></dl>
2434
2435 <dl>
2436 <dt><a name="index-gl_002dclear_002ddepth"></a><u>Function:</u> <b>gl-clear-depth</b><i> depth</i></dt>
2437 <dd><p>Sets the current clearing depth value.
2438 <var>Depth</var> must be a real number and clamped to <code>[0.0,1.0]</code>.
2439 </p></dd></dl>
2440
2441 <dl>
2442 <dt><a name="index-gl_002dclear_002dstencil"></a><u>Function:</u> <b>gl-clear-stencil</b><i> s</i></dt>
2443 <dd><p>Sets the current clearing value of the stencil buffer.
2444 </p></dd></dl>
2445
2446 <dl>
2447 <dt><a name="index-gl_002dclear_002daccum"></a><u>Function:</u> <b>gl-clear-accum</b><i> r g b a</i></dt>
2448 <dd><p>Sets the current clearing value of accumulation buffer.
2449 </p></dd></dl>
2450
2451 <dl>
2452 <dt><a name="index-gl_002dclear"></a><u>Function:</u> <b>gl-clear</b><i> mask</i></dt>
2453 <dd><p>Clears the specified buffer. <var>Mask</var> is a logical-or of
2454 the following constants.
2455 </p>
2456 <dl compact="compact">
2457 <dt> <code>GL_COLOR_BUFFER_BIT</code></dt>
2458 <dt> <code>GL_DEPTH_BUFFER_BIT</code></dt>
2459 <dt> <code>GL_ACCUM_BUFFER_BIT</code></dt>
2460 <dt> <code>GL_STENCIL_BUFFER_BIT</code></dt>
2461 </dl>
2462
2463 </dd></dl>
2464
2465 <a name="Selecting-color-buffers"></a>
2466 <h3 class="subheading">Selecting color buffers</h3>
2467
2468 <dl>
2469 <dt><a name="index-gl_002ddraw_002dbuffer"></a><u>Function:</u> <b>gl-draw-buffer</b><i> mode</i></dt>
2470 <dd><p>Selects (a) buffer(s) to which the image is rendered.
2471 Possible <var>mode</var> values are: <code>GL_FRONT</code>,
2472 <code>GL_FRONT_LEFT</code>, <code>GL_FRONT_RIGHT</code>,
2473 <code>GL_BACK</code>, <var>GL_BACK_LEFT</var>, <var>GL_BACK_RIGHT</var>,
2474 <code>GL_LEFT</code>, <code>GL_RIGHT</code>, <code>GL_AUXi</code>,
2475 <code>GL_FRONT_AND_BACK</code>, and <code>GL_NONE</code>.
2476 </p></dd></dl>
2477
2478 <dl>
2479 <dt><a name="index-gl_002dread_002dbuffer"></a><u>Function:</u> <b>gl-read-buffer</b><i> mode</i></dt>
2480 <dd><p>Selects a color buffer as the source for reading pixels.
2481 Possible <var>mode</var> values are the same as <code>gl-draw-buffer</code>
2482 except <code>GL_FRONT_AND_BACK</code> and <code>GL_NONE</code>.
2483 </p></dd></dl>
2484
2485 <a name="Masking-buffers"></a>
2486 <h3 class="subheading">Masking buffers</h3>
2487
2488 <dl>
2489 <dt><a name="index-gl_002dindex_002dmask"></a><u>Function:</u> <b>gl-index-mask</b><i> mask</i></dt>
2490 <dd><p>In color index mode, sets the mask of the color-index buffer.
2491 <var>Mask</var> is an exact integer.
2492 </p></dd></dl>
2493
2494 <dl>
2495 <dt><a name="index-gl_002dcolor_002dmask"></a><u>Function:</u> <b>gl-color-mask</b><i> r g b a</i></dt>
2496 <dd><p><var>R</var>, <var>g</var>, <var>b</var> and <var>a</var> are boolean values to
2497 specify whether the corresponding color channel should be written
2498 to the color buffer or not.
2499 </p></dd></dl>
2500
2501 <dl>
2502 <dt><a name="index-gl_002ddepth_002dmask"></a><u>Function:</u> <b>gl-depth-mask</b><i> flag</i></dt>
2503 <dd><p><var>Flag</var> is a boolean value specifies whether depth buffer should
2504 be written or not.
2505 </p></dd></dl>
2506
2507 <dl>
2508 <dt><a name="index-gl_002dstencil_002dmask"></a><u>Function:</u> <b>gl-stencil-mask</b><i> mask</i></dt>
2509 <dd><p>Sets the mask bit pattern for the stencil buffer. <var>Mask</var> is
2510 an exact integer.
2511 </p></dd></dl>
2512
2513
2514 <a name="Testing-and-operating-on-fragments"></a>
2515 <h3 class="subheading">Testing and operating on fragments</h3>
2516
2517 <dl>
2518 <dt><a name="index-gl_002dscissor"></a><u>Function:</u> <b>gl-scissor</b><i> x y width height</i></dt>
2519 <dd><p>Sets the scissor rectangle. If the scissor test is enabled
2520 (use <code>(gl-enable GL_SCISSOR_TEST)</code>), only the pixels that lie inside
2521 the rectangle are written.
2522 </p></dd></dl>
2523
2524 <dl>
2525 <dt><a name="index-gl_002dalpha_002dfunc"></a><u>Function:</u> <b>gl-alpha-func</b><i> func ref</i></dt>
2526 <dd><p>Sets the reference value and comparison function for the alpha test.
2527 <var>Func</var> may be either one of <code>GL_NEVER</code>, <code>GL_ALWAYS</code>,
2528 <code>GL_LESS</code>, <code>GL_LEQUAL</code>, <code>GL_EQUAL</code>, <code>GL_GEQUAL</code>,
2529 <code>GL_GREATER</code>, or <code>GL_NOTEQUAL</code>. <var>Ref</var> sets the reference
2530 value, a real number clamped to be between 0.0 and 1.0.
2531 </p></dd></dl>
2532
2533 <dl>
2534 <dt><a name="index-gl_002dstencil_002dfunc"></a><u>Function:</u> <b>gl-stencil-func</b><i> func ref mask</i></dt>
2535 <dd><p>Sets the comparison function, the reference value, and a mask for
2536 stencil test. <var>Func</var> specifies the funciton, and its possible
2537 value is the same as <code>gl-alpha-func</code>&rsquo;s. <var>Ref</var> is an integer
2538 reference value, and <var>mask</var> is an integer specifying bitwise mask.
2539 Before the comparison, the reference value and the fragment value are
2540 taken bitwise AND by <var>mask</var>.
2541 </p></dd></dl>
2542
2543 <dl>
2544 <dt><a name="index-gl_002dstencil_002dop"></a><u>Function:</u> <b>gl-stencil-op</b><i> func zfail zpass</i></dt>
2545 <dd><p>Speficies how the stencil buffer should be modified by the result of
2546 the stencil test. Each three parameter can take one of the following
2547 values independently: <code>GL_KEEP</code>, <code>GL_ZERO</code>, <code>GL_REPLACE</code>,
2548 <code>GL_INCR</code>, <code>GL_DECR</code>, or <code>GL_INVERT</code>.
2549 </p></dd></dl>
2550
2551
2552 <dl>
2553 <dt><a name="index-gl_002ddepth_002dfunc"></a><u>Function:</u> <b>gl-depth-func</b><i> func</i></dt>
2554 <dd><p>Sets the comparison function for the depth test. <var>Func</var> may
2555 be one of the following constant value: <code>GL_NEVER</code>,
2556 <code>GL_ALWAYS</code>, <code>GL_LESS</code>, <code>GL_LEQUAL</code>, <code>GL_EQUAL</code>,
2557 <code>GL_GEQUAL</code>, <code>GL_GREATER</code>, or <code>GL_NOTEQUAL</code>.
2558 </p></dd></dl>
2559
2560 <dl>
2561 <dt><a name="index-gl_002ddepth_002drange"></a><u>Function:</u> <b>gl-depth-range</b><i> nearv farv</i></dt>
2562 <dd><p>Defines an encoding for z-coordinates. <var>Nearv</var> and <var>farv</var>
2563 define the minimum and maximum values that can be stored in the
2564 depth buffer. By default, they&rsquo;re 0.0 and 1.0, respectively.
2565 </p></dd></dl>
2566
2567 <dl>
2568 <dt><a name="index-gl_002dlogic_002dop"></a><u>Function:</u> <b>gl-logic-op</b><i> opcode</i></dt>
2569 <dd><p>Selects the logical operation to be performed, given an incoming
2570 (source) fragment and the pixel currently in the color buffer
2571 (destination). <var>Opcode</var> may be one of the following values:
2572 <code>GL_CLEAR</code>, <code>GL_COPY</code>, <code>GL_NOOP</code>, <code>GL_SET</code>,
2573 <code>GL_COPY_INVERTED</code>, <code>GL_INVERT</code>, <code>GL_AND_REVERSE</code>,
2574 <code>GL_OR_REVERSE</code>, <code>GL_AND</code>, <code>GL_OR</code>, <code>GL_NAND</code>,
2575 <code>GL_NOR</code>, <code>GL_XOR</code>, <code>GL_EQUIV</code>, <code>GL_AND_INVERTED</code>
2576 or <code>GL_OR_INVERTED</code>.
2577 </p></dd></dl>
2578
2579 <dl>
2580 <dt><a name="index-gl_002daccum"></a><u>Function:</u> <b>gl-accum</b><i> op value</i></dt>
2581 <dd><p>Sets the accumulation buffer operation mode. <var>Op</var> may be
2582 one of the following values:
2583 </p><dl compact="compact">
2584 <dt> <code>GL_ACCUM</code></dt>
2585 <dd><p>Reads each pixel from the current selected buffer to read
2586 (by <code>gl-read-buffer</code>), multiplies its values by <var>value</var>,
2587 and adds the result into the accumulation buffer.
2588 </p></dd>
2589 <dt> <code>GL_LOAD</code></dt>
2590 <dd><p>Same as <code>GL_ACCUM</code> but replacing the accumulation buffer by
2591 the result of multiplication, instead of adding it.
2592 </p></dd>
2593 <dt> <code>GL_RETURN</code></dt>
2594 <dd><p>Takes the values from accumulation buffer, multiplies them with <var>value</var>,
2595 then write it to the current color buffer to write (by <code>gl-draw-buffer</code>).
2596 </p></dd>
2597 <dt> <code>GL_ADD</code></dt>
2598 <dd><p>Adds <var>value</var> to each pixel in the accumulation buffer and write
2599 it back.
2600 </p></dd>
2601 <dt> <code>GL_MULT</code></dt>
2602 <dd><p>Multiplies <var>value</var> to each pixel in the accumulation buffer and write
2603 it back. The result value is clamped to [-1.0, 1.0].
2604 </p></dd>
2605 </dl>
2606 </dd></dl>
2607
2608
2609 <hr size="6">
2610 <a name="Selection-and-feedback"></a>
2611 <table cellpadding="1" cellspacing="1" border="0">
2612 <tr><td valign="middle" align="left">[<a href="#Framebuffers" title="Previous section in reading order"> &lt; </a>]</td>
2613 <td valign="middle" align="left">[<a href="#Projection" title="Next section in reading order"> &gt; </a>]</td>
2614 <td valign="middle" align="left"> &nbsp; </td>
2615 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
2616 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
2617 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
2618 <td valign="middle" align="left"> &nbsp; </td>
2619 <td valign="middle" align="left"> &nbsp; </td>
2620 <td valign="middle" align="left"> &nbsp; </td>
2621 <td valign="middle" align="left"> &nbsp; </td>
2622 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
2623 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
2624 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
2625 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
2626 </tr></table>
2627 <a name="Selection-and-feedback-1"></a>
2628 <h2 class="section">4.13 Selection and feedback</h2>
2629
2630 <dl>
2631 <dt><a name="index-gl_002dfeedback_002dbuffer"></a><u>Function:</u> <b>gl-feedback-buffer</b><i> type buffer</i></dt>
2632 </dl>
2633
2634 <dl>
2635 <dt><a name="index-gl_002dselect_002dbuffer"></a><u>Function:</u> <b>gl-select-buffer</b><i> buffer</i></dt>
2636 </dl>
2637
2638 <dl>
2639 <dt><a name="index-gl_002drender_002dmode"></a><u>Function:</u> <b>gl-render-mode</b><i> mode</i></dt>
2640 </dl>
2641
2642 <dl>
2643 <dt><a name="index-gl_002dpass_002dthrough"></a><u>Function:</u> <b>gl-pass-through</b><i> token</i></dt>
2644 </dl>
2645
2646 <dl>
2647 <dt><a name="index-gl_002dinit_002dnames"></a><u>Function:</u> <b>gl-init-names</b></dt>
2648 </dl>
2649
2650 <dl>
2651 <dt><a name="index-gl_002dload_002dname"></a><u>Function:</u> <b>gl-load-name</b><i> name</i></dt>
2652 </dl>
2653
2654 <dl>
2655 <dt><a name="index-gl_002dpush_002dname"></a><u>Function:</u> <b>gl-push-name</b><i> name</i></dt>
2656 </dl>
2657
2658 <dl>
2659 <dt><a name="index-gl_002dpop_002dname"></a><u>Function:</u> <b>gl-pop-name</b></dt>
2660 </dl>
2661
2662
2663
2664 <hr size="6">
2665 <a name="Projection"></a>
2666 <table cellpadding="1" cellspacing="1" border="0">
2667 <tr><td valign="middle" align="left">[<a href="#Selection-and-feedback" title="Previous section in reading order"> &lt; </a>]</td>
2668 <td valign="middle" align="left">[<a href="#Quadrics" title="Next section in reading order"> &gt; </a>]</td>
2669 <td valign="middle" align="left"> &nbsp; </td>
2670 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
2671 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
2672 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
2673 <td valign="middle" align="left"> &nbsp; </td>
2674 <td valign="middle" align="left"> &nbsp; </td>
2675 <td valign="middle" align="left"> &nbsp; </td>
2676 <td valign="middle" align="left"> &nbsp; </td>
2677 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
2678 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
2679 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
2680 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
2681 </tr></table>
2682 <a name="Projection-1"></a>
2683 <h2 class="section">4.14 Projection</h2>
2684
2685 <dl>
2686 <dt><a name="index-glu_002dpick_002dmatrix"></a><u>Function:</u> <b>glu-pick-matrix</b><i> x y w h vp</i></dt>
2687 </dl>
2688
2689 <dl>
2690 <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>
2691 </dl>
2692
2693 <dl>
2694 <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>
2695 </dl>
2696
2697 <dl>
2698 <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>
2699 </dl>
2700
2701 <dl>
2702 <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>
2703 </dl>
2704
2705 <hr size="6">
2706 <a name="Quadrics"></a>
2707 <table cellpadding="1" cellspacing="1" border="0">
2708 <tr><td valign="middle" align="left">[<a href="#Projection" title="Previous section in reading order"> &lt; </a>]</td>
2709 <td valign="middle" align="left">[<a href="#Nurbs" title="Next section in reading order"> &gt; </a>]</td>
2710 <td valign="middle" align="left"> &nbsp; </td>
2711 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
2712 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
2713 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
2714 <td valign="middle" align="left"> &nbsp; </td>
2715 <td valign="middle" align="left"> &nbsp; </td>
2716 <td valign="middle" align="left"> &nbsp; </td>
2717 <td valign="middle" align="left"> &nbsp; </td>
2718 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
2719 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
2720 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
2721 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
2722 </tr></table>
2723 <a name="Quadrics-1"></a>
2724 <h2 class="section">4.15 Quadrics</h2>
2725
2726 <dl>
2727 <dt><a name="index-_003cglu_002dquadric_003e"></a><u>Class:</u> <b>&lt;glu-quadric&gt;</b></dt>
2728 </dl>
2729
2730 <dl>
2731 <dt><a name="index-glu_002dquadric_002ddraw_002dstyle"></a><u>Function:</u> <b>glu-quadric-draw-style</b><i> quad style</i></dt>
2732 <dd>
2733 <dl>
2734 <dt><a name="index-GLU_005fPOINT"></a><u>Constant:</u> <b>GLU_POINT</b></dt>
2735 <dt><a name="index-GLU_005fLINE"></a><u>Constant:</u> <b>GLU_LINE</b></dt>
2736 <dt><a name="index-GLU_005fFILL"></a><u>Constant:</u> <b>GLU_FILL</b></dt>
2737 <dt><a name="index-GLU_005fSILHUETTE"></a><u>Constant:</u> <b>GLU_SILHUETTE</b></dt>
2738 </dl>
2739
2740 </dd></dl>
2741
2742 <dl>
2743 <dt><a name="index-glu_002dquadric_002dorientation"></a><u>Function:</u> <b>glu-quadric-orientation</b><i> quad orientation</i></dt>
2744 <dd>
2745 <dl>
2746 <dt><a name="index-GLU_005fOUTSIDE"></a><u>Constant:</u> <b>GLU_OUTSIDE</b></dt>
2747 <dt><a name="index-GLU_005fINSIDE"></a><u>Constant:</u> <b>GLU_INSIDE</b></dt>
2748 </dl>
2749
2750 </dd></dl>
2751
2752 <dl>
2753 <dt><a name="index-glu_002dquadric_002dnormals"></a><u>Function:</u> <b>glu-quadric-normals</b><i> quad normals</i></dt>
2754 <dd>
2755 <dl>
2756 <dt><a name="index-GLU_005fSMOOTH"></a><u>Constant:</u> <b>GLU_SMOOTH</b></dt>
2757 <dt><a name="index-GLU_005fFLAT"></a><u>Constant:</u> <b>GLU_FLAT</b></dt>
2758 <dt><a name="index-GLU_005fNONE"></a><u>Constant:</u> <b>GLU_NONE</b></dt>
2759 </dl>
2760
2761 </dd></dl>
2762
2763 <dl>
2764 <dt><a name="index-glu_002dquadric_002dtexture"></a><u>Function:</u> <b>glu-quadric-texture</b><i> quad texcoords</i></dt>
2765 </dl>
2766
2767 <dl>
2768 <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>
2769 </dl>
2770
2771 <dl>
2772 <dt><a name="index-glu_002dsphere"></a><u>Function:</u> <b>glu-sphere</b><i> quad radius slices stacks</i></dt>
2773 </dl>
2774
2775 <dl>
2776 <dt><a name="index-glu_002ddisk"></a><u>Function:</u> <b>glu-disk</b><i> quad inner-radius outer-radius slices loops</i></dt>
2777 </dl>
2778
2779 <dl>
2780 <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>
2781 </dl>
2782
2783 <hr size="6">
2784 <a name="Nurbs"></a>
2785 <table cellpadding="1" cellspacing="1" border="0">
2786 <tr><td valign="middle" align="left">[<a href="#Quadrics" title="Previous section in reading order"> &lt; </a>]</td>
2787 <td valign="middle" align="left">[<a href="#Polygon-tesselation" title="Next section in reading order"> &gt; </a>]</td>
2788 <td valign="middle" align="left"> &nbsp; </td>
2789 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
2790 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
2791 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
2792 <td valign="middle" align="left"> &nbsp; </td>
2793 <td valign="middle" align="left"> &nbsp; </td>
2794 <td valign="middle" align="left"> &nbsp; </td>
2795 <td valign="middle" align="left"> &nbsp; </td>
2796 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
2797 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
2798 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
2799 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
2800 </tr></table>
2801 <a name="Nurbs-1"></a>
2802 <h2 class="section">4.16 Nurbs</h2>
2803
2804 <dl>
2805 <dt><a name="index-_003cglu_002dnurbs_003e"></a><u>Class:</u> <b>&lt;glu-nurbs&gt;</b></dt>
2806 </dl>
2807
2808 <dl>
2809 <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>
2810 </dl>
2811
2812 <dl>
2813 <dt><a name="index-glu_002dnurbs_002dproperty"></a><u>Function:</u> <b>glu-nurbs-property</b><i> nurbs property value</i></dt>
2814 </dl>
2815
2816 <dl>
2817 <dt><a name="index-glu_002dget_002dnurbs_002dproperty"></a><u>Function:</u> <b>glu-get-nurbs-property</b><i> nurbs property</i></dt>
2818 </dl>
2819
2820 <dl>
2821 <dt><a name="index-glu_002dbegin_002dcurve"></a><u>Function:</u> <b>glu-begin-curve</b><i> nurbs</i></dt>
2822 </dl>
2823
2824 <dl>
2825 <dt><a name="index-glu_002dend_002dcurve"></a><u>Function:</u> <b>glu-end-curve</b><i> nurbs</i></dt>
2826 </dl>
2827
2828 <dl>
2829 <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>
2830 </dl>
2831
2832 <dl>
2833 <dt><a name="index-glu_002dbegin_002dsurface"></a><u>Function:</u> <b>glu-begin-surface</b><i> nurbs</i></dt>
2834 </dl>
2835
2836 <dl>
2837 <dt><a name="index-glu_002dend_002dsurface"></a><u>Function:</u> <b>glu-end-surface</b><i> nurbs</i></dt>
2838 </dl>
2839
2840
2841 <hr size="6">
2842 <a name="Polygon-tesselation"></a>
2843 <table cellpadding="1" cellspacing="1" border="0">
2844 <tr><td valign="middle" align="left">[<a href="#Nurbs" title="Previous section in reading order"> &lt; </a>]</td>
2845 <td valign="middle" align="left">[<a href="#Programmable-shaders" title="Next section in reading order"> &gt; </a>]</td>
2846 <td valign="middle" align="left"> &nbsp; </td>
2847 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
2848 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
2849 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
2850 <td valign="middle" align="left"> &nbsp; </td>
2851 <td valign="middle" align="left"> &nbsp; </td>
2852 <td valign="middle" align="left"> &nbsp; </td>
2853 <td valign="middle" align="left"> &nbsp; </td>
2854 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
2855 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
2856 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
2857 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
2858 </tr></table>
2859 <a name="Polygon-tesselation-1"></a>
2860 <h2 class="section">4.17 Polygon tesselation</h2>
2861
2862 <dl>
2863 <dt><a name="index-_003cglu_002dtesselator_003e"></a><u>Class:</u> <b>&lt;glu-tesselator&gt;</b></dt>
2864 </dl>
2865
2866 <hr size="6">
2867 <a name="Programmable-shaders"></a>
2868 <table cellpadding="1" cellspacing="1" border="0">
2869 <tr><td valign="middle" align="left">[<a href="#Polygon-tesselation" title="Previous section in reading order"> &lt; </a>]</td>
2870 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next section in reading order"> &gt; </a>]</td>
2871 <td valign="middle" align="left"> &nbsp; </td>
2872 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
2873 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Up section"> Up </a>]</td>
2874 <td valign="middle" align="left">[<a href="#GLUT-API" title="Next chapter"> &gt;&gt; </a>]</td>
2875 <td valign="middle" align="left"> &nbsp; </td>
2876 <td valign="middle" align="left"> &nbsp; </td>
2877 <td valign="middle" align="left"> &nbsp; </td>
2878 <td valign="middle" align="left"> &nbsp; </td>
2879 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
2880 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
2881 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
2882 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
2883 </tr></table>
2884 <a name="Programmable-shaders-1"></a>
2885 <h2 class="section">4.18 Programmable shaders</h2>
2886
2887 <a name="Shader-objects"></a>
2888 <h3 class="subheading">Shader objects</h3>
2889
2890 <dl>
2891 <dt><a name="index-gl_002dcreate_002dshader_002dobject_002darb"></a><u>Function:</u> <b>gl-create-shader-object-arb</b><i> type</i></dt>
2892 <dd><p>[GL_ARB_shader_objects]
2893 Creates a new shader object and returns its handle.
2894 <var>Type</var> can be either <code>GL_VERTEX_SHADER_ARB</code> or
2895 <code>GL_FRAGMENT_SHADER_ARB</code>.
2896 </p></dd></dl>
2897
2898 <dl>
2899 <dt><a name="index-gl_002dshader_002dsource_002darb"></a><u>Function:</u> <b>gl-shader-source-arb</b><i> shader strings</i></dt>
2900 <dd><p>[GL_ARB_shader_objects]
2901 Sets the source code of the shader, whose handle is <var>shader</var>.
2902 You can give the source code as a list of strings to <var>strings</var>.
2903 All strings are concatenated internally in the OpenGL driver.
2904 </p></dd></dl>
2905
2906 <dl>
2907 <dt><a name="index-gl_002dcompile_002dshader_002darb"></a><u>Function:</u> <b>gl-compile-shader-arb</b><i> shader</i></dt>
2908 <dd><p>[GL_ARB_shader_objects]
2909 Compile the source code attached to the shader, whose handle is <var>shader</var>.
2910 You can query the result of the compilation by passing
2911 <code>GL_OBJECT_COMPILE_STATUS_ARB</code> to <code>gl-get-object-parameter-arb</code>;
2912 it returns <code>#t</code> if the compilation succeeded, or <code>#f</code> if failed.
2913 The information about the compilation can be obtained by
2914 <code>gl-get-info-log-arb</code>.
2915 </p></dd></dl>
2916
2917 <dl>
2918 <dt><a name="index-gl_002dcreate_002dprogram_002dobject_002darb"></a><u>Function:</u> <b>gl-create-program-object-arb</b></dt>
2919 <dd><p>[GL_ARB_shader_objects]
2920 Creates a new program object and returns its handle.
2921 </p></dd></dl>
2922
2923 <dl>
2924 <dt><a name="index-gl_002dattach_002dobject_002darb"></a><u>Function:</u> <b>gl-attach-object-arb</b><i> program shader</i></dt>
2925 <dd><p>[GL_ARB_shader_objects]
2926 Attach a shader whose handle is <var>shader</var> to the program whose handle
2927 is <var>program</var>.
2928 </p></dd></dl>
2929
2930 <dl>
2931 <dt><a name="index-gl_002ddetach_002dobject_002darb"></a><u>Function:</u> <b>gl-detach-object-arb</b><i> program shader</i></dt>
2932 <dd><p>[GL_ARB_shader_objects]
2933 Detach a shader from a program.
2934 </p></dd></dl>
2935
2936 <dl>
2937 <dt><a name="index-gl_002dlink_002dprogram_002darb"></a><u>Function:</u> <b>gl-link-program-arb</b><i> program</i></dt>
2938 <dd><p>[GL_ARB_shader_objects]
2939 Link the program object. The result of linking can be queried
2940 by passing <code>GL_OBJECT_LINK_STATUS_ARB</code> to
2941 <code>gl-get-object-parameter-arb</code>.
2942 </p></dd></dl>
2943
2944 <dl>
2945 <dt><a name="index-gl_002duse_002dprogram_002dobject_002darb"></a><u>Function:</u> <b>gl-use-program-object-arb</b><i> program</i></dt>
2946 <dd><p>[GL_ARB_shader_objects]
2947 Installs the program to the current rendering state.
2948 </p></dd></dl>
2949
2950 <dl>
2951 <dt><a name="index-gl_002ddelete_002dobject_002darb"></a><u>Function:</u> <b>gl-delete-object-arb</b><i> handle</i></dt>
2952 <dd><p>[GL_ARB_shader_objects]
2953 Deletes either a shader object or a program object specified by
2954 <var>handle</var>.
2955 </p></dd></dl>
2956
2957 <dl>
2958 <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>
2959 <dd><p>[GL_ARB_shader_objects]
2960 Queries the value of <var>pname</var> of the shader or the program
2961 specified by <var>object</var>. The following values are accepted
2962 as <var>pname</var>: <code>GL_OBJECT_TYPE_ARB</code>,
2963 <code>GL_OBJECT_SUBTYPE_ARB</code>,
2964 <code>GL_OBJECT_DELETE_STATUS_ARB</code>,
2965 <code>GL_OBJECT_COMPILE_STATUS_ARB</code>,
2966 <code>GL_OBJECT_LINK_STATUS_ARB</code>,
2967 <code>GL_OBJECT_VALIDATE_STATUS_ARB</code>,
2968 <code>GL_OBJECT_INFO_LOG_LENGTH_ARB</code>,
2969 <code>GL_OBJECT_ATTACHED_OBJECTS_ARB</code>,
2970 <code>GL_OBJECT_ACTIVE_ATTRIBUTES_ARB</code>,
2971 <code>GL_OBJECT_ACTIVE_ATTRIBUTE_MAX_LENGTH_ARB</code>,
2972 <code>GL_OBJECT_ACTIVE_UNIFORMS_ARB</code>,
2973 <code>GL_OBJECT_ACTIVE_UNIFORM_MAX_LENGTH_ARB</code>, and
2974 <code>GL_OBJECT_SHADER_SOURCE_LENGTH_ARB</code>.
2975 The procedure returns an integer value.
2976 </p></dd></dl>
2977
2978 <dl>
2979 <dt><a name="index-gl_002dget_002dshader_002dsource_002darb"></a><u>Function:</u> <b>gl-get-shader-source-arb</b><i> shader</i></dt>
2980 <dd><p>[GL_ARB_shader_objects]
2981 Returns the shader source code of a shader object <var>shader</var>
2982 in a string.
2983 </p></dd></dl>
2984
2985 <dl>
2986 <dt><a name="index-gl_002dget_002dinfo_002dlog_002darb"></a><u>Function:</u> <b>gl-get-info-log-arb</b><i> handle</i></dt>
2987 <dd><p>[GL_ARB_shader_objects]
2988 Returns the information log of an object pointed by <var>handle</var>.
2989 </p></dd></dl>
2990
2991 <dl>
2992 <dt><a name="index-gl_002dget_002dhandle_002darb"></a><u>Function:</u> <b>gl-get-handle-arb</b><i> pname</i></dt>
2993 <dd><p>[GL_ARB_shader_objects]
2994 Returns the handle to an object that is used in the current state.
2995 The only argument accepted currently as <var>pname</var> is
2996 <code>GL_PROGRAM_OBJECT_ARB</code>, which returns the handle to the current
2997 program object.
2998 </p></dd></dl>
2999
3000 <dl>
3001 <dt><a name="index-gl_002dget_002dattached_002dobjects_002darb"></a><u>Function:</u> <b>gl-get-attached-objects-arb</b><i> program</i></dt>
3002 <dd><p>[GL_ARB_shader_objects]
3003 Rethrns a vector of GL object handles that are attached to the <var>program</var>.
3004 </p></dd></dl>
3005
3006 <dl>
3007 <dt><a name="index-gl_002dvalidate_002dprogram_002darb"></a><u>Function:</u> <b>gl-validate-program-arb</b><i> program</i></dt>
3008 <dd><p>[GL_ARB_shader_objects]
3009 Checks whether the <var>program</var> can execute in the current GL state.
3010 The result is stored in <var>program</var>&rsquo;s log.
3011 </p></dd></dl>
3012
3013 <a name="Specifying-vertex-attributes"></a>
3014 <h3 class="subheading">Specifying vertex attributes</h3>
3015
3016 <dl>
3017 <dt><a name="index-gl_002dvertex_002dattrib_002darb"></a><u>Function:</u> <b>gl-vertex-attrib-arb</b><i> index values</i></dt>
3018 <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>
3019 <dd><p>[GL_ARB_vertex_program]
3020 Sets the generic vertex attribute specified by <var>index</var>.
3021 In the first form, you can pass f32, f64, or s16vector of size
3022 1 to 4, or u8, s8, u16, s32, or u32vector of size 4.
3023 In the second form, you can pass 1 to 4 real numbers (they
3024 are interpreted as C doubles and <code>glVertexAttrib4dARB</code> is called).
3025 </p></dd></dl>
3026
3027 <dl>
3028 <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>
3029 <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>
3030 <dd><p>[GL_ARB_vertex_program]
3031 These variations can be used to pass normalized values.
3032 The first form accepts s8, u8, s16, u16, s32, u32, f32 and f64vector
3033 of size 4. The second value takes four integers, whose lower 8bits
3034 are taken as unsigned byte and passed to <code>glVertexAttrib4NubARB</code>.
3035 </p></dd></dl>
3036
3037 <dl>
3038 <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>
3039 <dd><p>[GL_ARB_vertex_program]
3040 This is the generic version of vertex arrays. <var>Index</var> names
3041 the attribute, <var>size</var> specifies the number of components (1, 2, 3 or 4),
3042 and <var>vec</var> is a uniform vector that contains the array of values.
3043 </p>
3044 <p>The optional boolean <var>normalized</var> argument tells whether the
3045 passed integer values should be mapped to normalized range (<code>#t</code> or
3046 taken as are <code>#f</code>, default). The optional <var>stride</var> argument
3047 specifies the gap between each set of values within <var>vec</var>.
3048 The optional <var>offset</var> argument tells GL to take values beginning
3049 from the <var>offset</var>-th element of <var>vec</var>.
3050 </p></dd></dl>
3051
3052 <dl>
3053 <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>
3054 <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>
3055 <dd><p>[GL_ARB_vertex_program]
3056 Enable or disable a vertex attribute array specified by <var>index</var>.
3057 </p></dd></dl>
3058
3059 <dl>
3060 <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>
3061 <dd><p>[GL_ARB_vertex_shader]
3062 Associates a user-defined attribute variable in the program object
3063 <var>program</var> with an <var>index</var>-th generic vertex attribute.
3064 <var>Name</var> is a string of the name of user-defined attribute as appears
3065 in the shader program.
3066 </p></dd></dl>
3067
3068 <dl>
3069 <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>
3070 <dd><p>[GL_ARB_vertex_shader]
3071 Returns an integer index of the user-defined attribute <var>name</var>
3072 in the <var>program</var>. Must be called after <var>program</var> is linked.
3073 </p></dd></dl>
3074
3075 <dl>
3076 <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>
3077 <dd><p>[GL_ARB_vertex_shader]
3078 Obtains information about the <var>index</var>-th user-defined attribute
3079 in the <var>program</var>. Must be called after <var>program</var> is linked.
3080 </p>
3081 <p>It returns three values: the size of the attribute (1, 2, 3 or 4),
3082 the type of the attribute (an integer that matches one of the following
3083 constants: <code>GL_FLOAT</code>, <code>GL_FLOAT_VEC2_ARB</code>,
3084 <code>GL_FLOAT_VEC3_ARB</code>, <code>GL_FLOAT_VEC4_ARB</code>,
3085 <code>GL_FLOAT_MAT2_ARB</code>, <code>GL_FLOAT_MAT3_ARB</code>, or
3086 <code>GL_FLOAT_MAT4_ARB</code>.), and
3087 the name of the attribute.
3088 </p></dd></dl>
3089
3090 <a name="Specifying-uniform-variables"></a>
3091 <h3 class="subheading">Specifying uniform variables</h3>
3092
3093 <dl>
3094 <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>
3095 <dd><p>[GL_ARB_shader_objects]
3096 Returns an integer location of the uniform variable <var>name</var>
3097 of the program <var>program</var>.
3098 </p></dd></dl>
3099
3100 <dl>
3101 <dt><a name="index-gl_002duniform1_002darb"></a><u>Function:</u> <b>gl-uniform1-arb</b><i> location vec</i></dt>
3102 <dt><a name="index-gl_002duniform1_002darb-1"></a><u>Function:</u> <b>gl-uniform1-arb</b><i> location v0</i></dt>
3103 <dt><a name="index-gl_002duniform2_002darb"></a><u>Function:</u> <b>gl-uniform2-arb</b><i> location vec</i></dt>
3104 <dt><a name="index-gl_002duniform2_002darb-1"></a><u>Function:</u> <b>gl-uniform2-arb</b><i> location v0 v1</i></dt>
3105 <dt><a name="index-gl_002duniform3_002darb"></a><u>Function:</u> <b>gl-uniform3-arb</b><i> location vec</i></dt>
3106 <dt><a name="index-gl_002duniform3_002darb-1"></a><u>Function:</u> <b>gl-uniform3-arb</b><i> location v0 v1 v2</i></dt>
3107 <dt><a name="index-gl_002duniform4_002darb"></a><u>Function:</u> <b>gl-uniform4-arb</b><i> location vec</i></dt>
3108 <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>
3109 <dd><p>[GL_ARB_shader_objects]
3110 Sets a value of the uniform variable specified by <var>location</var>.
3111 <var>gl-uniform1-arb</var> sets a single component value (e.g. <code>float</code>)
3112 <var>gl-uniform2-arb</var> sets a double component value
3113 (e.g. <code>vec2</code>) etc.
3114 </p>
3115 <p>The first form of each function takes either an s32vector or f32vector.
3116 It can have a size multiple of the number of components to
3117 set an array uniform variable (e.g. you can pass an f32vector of
3118 size 8 to fill <code>vec2[2]</code>).
3119 </p>
3120 <p>The second form just sets the component(s) of a single uniform variable.
3121 The arguments <var>v0</var> to <var>v3</var> must be real numbers, and
3122 coerced to C <code>float</code> (i.e. <code>glUniform*fARB</code> is used).
3123 </p></dd></dl>
3124
3125
3126 <dl>
3127 <dt><a name="index-gl_002duniform_002dmatrix2_002darb"></a><u>Function:</u> <b>gl-uniform-matrix2-arb</b><i> location transpose v</i></dt>
3128 <dt><a name="index-gl_002duniform_002dmatrix3_002darb"></a><u>Function:</u> <b>gl-uniform-matrix3-arb</b><i> location transpose v</i></dt>
3129 <dt><a name="index-gl_002duniform_002dmatrix4_002darb"></a><u>Function:</u> <b>gl-uniform-matrix4-arb</b><i> location transpose v</i></dt>
3130 <dd><p>[GL_ARB_shader_objects]
3131 Sets a matrix uniform variable (or an array of matrix uniform variables)
3132 specified by <var>location</var>.
3133 A boolean flag <var>transpose</var> specifies whether the matrix should be
3134 transposed.
3135 The <var>v</var> argument must be a f32vector of size multiple of 4, 9, or
3136 16, respectively.
3137 </p></dd></dl>
3138
3139 <dl>
3140 <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>
3141 <dd><p>[GL_ARB_shader_objects]
3142 Returns informaton about the <var>index</var>-th uniform variable of
3143 <var>program</var>.
3144 </p>
3145 <p>Returns three values. The first one is the size, either 1, 2, 3 or 4.
3146 The second value is the type, which is an integer that matches
3147 one of the following constants: <code>GL_FLOAT</code>,
3148 <code>GL_FLOAT_VEC(1|2|3|4)_ARB</code>, <code>GL_INT</code>,
3149 <code>GL_INT_VEC(1|2|3|4)_ARB</code>, <code>GL_BOOL</code>,
3150 <code>GL_BOOL_VEC(1|2|3|4)_ARB</code>, <code>GL_FLOAT_MAT(2|3|4)_ARB</code>.
3151 And the third value is the name of the uniform variable.
3152 </p></dd></dl>
3153
3154 <a name="Vertex-and-fragment-programs"></a>
3155 <h3 class="subheading">Vertex and fragment programs</h3>
3156
3157 <p>These APIs are for low-level vertex/fragment pipeline programming.
3158 </p>
3159 <dl>
3160 <dt><a name="index-gl_002dgen_002dprograms_002darb"></a><u>Function:</u> <b>gl-gen-programs-arb</b><i> n</i></dt>
3161 <dd><p>[GL_ARB_vertex_program]
3162 Generates <var>N</var> names (integers) for the new programs and
3163 returns them in an s32vector.
3164 </p></dd></dl>
3165
3166 <dl>
3167 <dt><a name="index-gl_002ddelete_002dprograms_002darb"></a><u>Function:</u> <b>gl-delete-programs-arb</b><i> programs</i></dt>
3168 <dd><p>[GL_ARB_vertex_program]
3169 Deletes programs whose names are specified by an s32vector <var>programs</var>.
3170 </p></dd></dl>
3171
3172 <dl>
3173 <dt><a name="index-gl_002dis_002dprogram_002darb"></a><u>Function:</u> <b>gl-is-program-arb</b><i> prog-id</i></dt>
3174 <dd><p>[GL_ARB_vertex_program]
3175 Returns <code>#t</code> if an integer <var>prog-id</var> refers to a valid program.
3176 </p></dd></dl>
3177
3178 <dl>
3179 <dt><a name="index-gl_002dbind_002dprogram_002darb"></a><u>Function:</u> <b>gl-bind-program-arb</b><i> target prog-id</i></dt>
3180 <dd><p>[GL_ARB_vertex_program]
3181 Binds a program specified by <var>prog-id</var> to a <var>target</var>,
3182 which is either <code>GL_VERTEX_PROGRAM_ARB</code> or
3183 <var>GL_FRAGMENT_PROGRAM_ARB</var>.
3184 </p></dd></dl>
3185
3186 <dl>
3187 <dt><a name="index-gl_002dprogram_002dstring_002darb"></a><u>Function:</u> <b>gl-program-string-arb</b><i> target format text</i></dt>
3188 <dd><p>[GL_ARB_vertex_program]
3189 Sets the source code of the program currently bound to the
3190 <var>target</var> (<code>GL_VERTEX_PROGRAM_ARB</code> or
3191 <var>GL_FRAGMENT_PROGRAM_ARB</var>).
3192 </p>
3193 <p><var>Format</var> must be <code>GL_PROGRAM_FORMAT_ASCII_ARB</code>.
3194 <var>Text</var> is a string for the program source.
3195 </p></dd></dl>
3196
3197 <dl>
3198 <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>
3199 <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>
3200 <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>
3201 <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>
3202 <dd><p>[GL_ARB_vertex_program]
3203 Sets the value of the environment and local parameter
3204 specified by <var>param-id</var> of the program currently bount to the <var>target</var>.
3205 In the first form of each, <var>args</var> must be either f32 or
3206 f64vector of size 4 or <code>&lt;vector4f&gt;</code> object.
3207 </p></dd></dl>
3208
3209
3210 <hr size="6">
3211 <a name="GLUT-API"></a>
3212 <table cellpadding="1" cellspacing="1" border="0">
3213 <tr><td valign="middle" align="left">[<a href="#Programmable-shaders" title="Previous section in reading order"> &lt; </a>]</td>
3214 <td valign="middle" align="left">[<a href="#GLUT-window-manipulation" title="Next section in reading order"> &gt; </a>]</td>
3215 <td valign="middle" align="left"> &nbsp; </td>
3216 <td valign="middle" align="left">[<a href="#OpenGL-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3217 <td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
3218 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3219 <td valign="middle" align="left"> &nbsp; </td>
3220 <td valign="middle" align="left"> &nbsp; </td>
3221 <td valign="middle" align="left"> &nbsp; </td>
3222 <td valign="middle" align="left"> &nbsp; </td>
3223 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3224 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3225 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
3226 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3227 </tr></table>
3228 <a name="GLUT-API-1"></a>
3229 <h1 class="chapter">5. GLUT API</h1>
3230
3231 <table class="menu" border="0" cellspacing="0">
3232 <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">
3233 </td></tr>
3234 <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">
3235 </td></tr>
3236 <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">
3237 </td></tr>
3238 <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">
3239 </td></tr>
3240 <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">
3241 </td></tr>
3242 <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">
3243 </td></tr>
3244 <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">
3245 </td></tr>
3246 <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">
3247 </td></tr>
3248 </table>
3249
3250 <hr size="6">
3251 <a name="GLUT-window-manipulation"></a>
3252 <table cellpadding="1" cellspacing="1" border="0">
3253 <tr><td valign="middle" align="left">[<a href="#GLUT-API" title="Previous section in reading order"> &lt; </a>]</td>
3254 <td valign="middle" align="left">[<a href="#GLUT-overlay" title="Next section in reading order"> &gt; </a>]</td>
3255 <td valign="middle" align="left"> &nbsp; </td>
3256 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3257 <td valign="middle" align="left">[<a href="#GLUT-API" title="Up section"> Up </a>]</td>
3258 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3259 <td valign="middle" align="left"> &nbsp; </td>
3260 <td valign="middle" align="left"> &nbsp; </td>
3261 <td valign="middle" align="left"> &nbsp; </td>
3262 <td valign="middle" align="left"> &nbsp; </td>
3263 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3264 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3265 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
3266 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3267 </tr></table>
3268 <a name="GLUT-window-manipulation-1"></a>
3269 <h2 class="section">5.1 GLUT window manipulation</h2>
3270
3271 <dl>
3272 <dt><a name="index-glut_002dinit"></a><u>Function:</u> <b>glut-init</b><i> args</i></dt>
3273 </dl>
3274
3275 <dl>
3276 <dt><a name="index-glut_002dinit_002ddisplay_002dmode"></a><u>Function:</u> <b>glut-init-display-mode</b><i> mode</i></dt>
3277 </dl>
3278
3279 <dl>
3280 <dt><a name="index-GLUT_005fRGB"></a><u>Constant:</u> <b>GLUT_RGB</b></dt>
3281 <dt><a name="index-GLUT_005fRGBA"></a><u>Constant:</u> <b>GLUT_RGBA</b></dt>
3282 <dt><a name="index-GLUT_005fINDEX"></a><u>Constant:</u> <b>GLUT_INDEX</b></dt>
3283 <dt><a name="index-GLUT_005fSINGLE"></a><u>Constant:</u> <b>GLUT_SINGLE</b></dt>
3284 <dt><a name="index-GLUT_005fDOUBLE"></a><u>Constant:</u> <b>GLUT_DOUBLE</b></dt>
3285 <dt><a name="index-GLUT_005fACCUM"></a><u>Constant:</u> <b>GLUT_ACCUM</b></dt>
3286 <dt><a name="index-GLUT_005fALPHA"></a><u>Constant:</u> <b>GLUT_ALPHA</b></dt>
3287 <dt><a name="index-GLUT_005fDEPTH"></a><u>Constant:</u> <b>GLUT_DEPTH</b></dt>
3288 <dt><a name="index-GLUT_005fSTENCIL"></a><u>Constant:</u> <b>GLUT_STENCIL</b></dt>
3289 <dt><a name="index-GLUT_005fMULTISAMPLE"></a><u>Constant:</u> <b>GLUT_MULTISAMPLE</b></dt>
3290 <dt><a name="index-GLUT_005fSTEREO"></a><u>Constant:</u> <b>GLUT_STEREO</b></dt>
3291 <dt><a name="index-GLUT_005fLUMINANCE"></a><u>Constant:</u> <b>GLUT_LUMINANCE</b></dt>
3292 </dl>
3293
3294 <dl>
3295 <dt><a name="index-glut_002dinit_002ddisplay_002dstring"></a><u>Function:</u> <b>glut-init-display-string</b><i> string</i></dt>
3296 </dl>
3297
3298 <dl>
3299 <dt><a name="index-glut_002dinit_002dwindow_002dsize"></a><u>Function:</u> <b>glut-init-window-size</b><i> width height</i></dt>
3300 </dl>
3301
3302 <dl>
3303 <dt><a name="index-glut_002dinit_002dwindow_002dposition"></a><u>Function:</u> <b>glut-init-window-position</b><i> x y</i></dt>
3304 </dl>
3305
3306 <dl>
3307 <dt><a name="index-glut_002dmain_002dloop"></a><u>Function:</u> <b>glut-main-loop</b></dt>
3308 </dl>
3309
3310 <dl>
3311 <dt><a name="index-glut_002dcreate_002dwidnow"></a><u>Function:</u> <b>glut-create-widnow</b><i> name</i></dt>
3312 </dl>
3313
3314 <dl>
3315 <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>
3316 </dl>
3317
3318 <dl>
3319 <dt><a name="index-glut_002ddestroy_002dwindow"></a><u>Function:</u> <b>glut-destroy-window</b><i> win</i></dt>
3320 </dl>
3321
3322 <dl>
3323 <dt><a name="index-glut_002dpost_002dredisplay"></a><u>Function:</u> <b>glut-post-redisplay</b></dt>
3324 </dl>
3325
3326 <dl>
3327 <dt><a name="index-glut_002dpost_002dwindow_002dredisplay"></a><u>Function:</u> <b>glut-post-window-redisplay</b><i> win</i></dt>
3328 </dl>
3329
3330 <dl>
3331 <dt><a name="index-glut_002dswap_002dbuffers"></a><u>Function:</u> <b>glut-swap-buffers</b></dt>
3332 </dl>
3333
3334 <dl>
3335 <dt><a name="index-glut_002dget_002dwindow"></a><u>Function:</u> <b>glut-get-window</b></dt>
3336 </dl>
3337
3338 <dl>
3339 <dt><a name="index-glut_002dset_002dwindow"></a><u>Function:</u> <b>glut-set-window</b><i> win</i></dt>
3340 </dl>
3341
3342 <dl>
3343 <dt><a name="index-glut_002dset_002dwindow_002dtitle"></a><u>Function:</u> <b>glut-set-window-title</b><i> title</i></dt>
3344 </dl>
3345
3346 <dl>
3347 <dt><a name="index-glut_002dset_002dicon_002dtitle"></a><u>Function:</u> <b>glut-set-icon-title</b><i> title</i></dt>
3348 </dl>
3349
3350 <dl>
3351 <dt><a name="index-glut_002dposition_002dwindow"></a><u>Function:</u> <b>glut-position-window</b><i> x y</i></dt>
3352 </dl>
3353
3354 <dl>
3355 <dt><a name="index-glut_002dreshape_002dwindow"></a><u>Function:</u> <b>glut-reshape-window</b><i> width height</i></dt>
3356 </dl>
3357
3358 <dl>
3359 <dt><a name="index-glut_002dpush_002dwindow"></a><u>Function:</u> <b>glut-push-window</b></dt>
3360 <dt><a name="index-glut_002dpop_002dwindow"></a><u>Function:</u> <b>glut-pop-window</b></dt>
3361 </dl>
3362
3363 <dl>
3364 <dt><a name="index-glut_002diconify_002dwindow"></a><u>Function:</u> <b>glut-iconify-window</b></dt>
3365 </dl>
3366
3367 <dl>
3368 <dt><a name="index-glut_002dshow_002dwindow"></a><u>Function:</u> <b>glut-show-window</b></dt>
3369 <dt><a name="index-glut_002dhide_002dwindow"></a><u>Function:</u> <b>glut-hide-window</b></dt>
3370 </dl>
3371
3372 <dl>
3373 <dt><a name="index-glut_002dfull_002dscreen"></a><u>Function:</u> <b>glut-full-screen</b></dt>
3374 </dl>
3375
3376 <dl>
3377 <dt><a name="index-glut_002dset_002dcursor"></a><u>Function:</u> <b>glut-set-cursor</b><i> cursor</i></dt>
3378 </dl>
3379
3380 <dl>
3381 <dt><a name="index-GLUT_005fCURSOR_005fRIGHT_005fARROW"></a><u>Constant:</u> <b>GLUT_CURSOR_RIGHT_ARROW</b></dt>
3382 <dt><a name="index-GLUT_005fCURSOR_005fLEFT_005fARROW"></a><u>Constant:</u> <b>GLUT_CURSOR_LEFT_ARROW</b></dt>
3383 <dt><a name="index-GLUT_005fCURSOR_005fINFO"></a><u>Constant:</u> <b>GLUT_CURSOR_INFO</b></dt>
3384 <dt><a name="index-GLUT_005fCURSOR_005fDESTROY"></a><u>Constant:</u> <b>GLUT_CURSOR_DESTROY</b></dt>
3385 <dt><a name="index-GLUT_005fCURSOR_005fHELP"></a><u>Constant:</u> <b>GLUT_CURSOR_HELP</b></dt>
3386 <dt><a name="index-GLUT_005fCURSOR_005fCYCLE"></a><u>Constant:</u> <b>GLUT_CURSOR_CYCLE</b></dt>
3387 <dt><a name="index-GLUT_005fCURSOR_005fSPRAY"></a><u>Constant:</u> <b>GLUT_CURSOR_SPRAY</b></dt>
3388 <dt><a name="index-GLUT_005fCURSOR_005fWAIT"></a><u>Constant:</u> <b>GLUT_CURSOR_WAIT</b></dt>
3389 <dt><a name="index-GLUT_005fCURSOR_005fTEXT"></a><u>Constant:</u> <b>GLUT_CURSOR_TEXT</b></dt>
3390 <dt><a name="index-GLUT_005fCURSOR_005fCROSSHAIR"></a><u>Constant:</u> <b>GLUT_CURSOR_CROSSHAIR</b></dt>
3391 <dt><a name="index-GLUT_005fCURSOR_005fUP_005fDOWN"></a><u>Constant:</u> <b>GLUT_CURSOR_UP_DOWN</b></dt>
3392 <dt><a name="index-GLUT_005fCURSOR_005fLEFT_005fRIGHT"></a><u>Constant:</u> <b>GLUT_CURSOR_LEFT_RIGHT</b></dt>
3393 <dt><a name="index-GLUT_005fCURSOR_005fTOP_005fSIDE"></a><u>Constant:</u> <b>GLUT_CURSOR_TOP_SIDE</b></dt>
3394 <dt><a name="index-GLUT_005fCURSOR_005fBOTTOM_005fSIDE"></a><u>Constant:</u> <b>GLUT_CURSOR_BOTTOM_SIDE</b></dt>
3395 <dt><a name="index-GLUT_005fCURSOR_005fLEFT_005fSIDE"></a><u>Constant:</u> <b>GLUT_CURSOR_LEFT_SIDE</b></dt>
3396 <dt><a name="index-GLUT_005fCURSOR_005fRIGHT_005fSIDE"></a><u>Constant:</u> <b>GLUT_CURSOR_RIGHT_SIDE</b></dt>
3397 <dt><a name="index-GLUT_005fCURSOR_005fTOP_005fLEFT_005fCORNER"></a><u>Constant:</u> <b>GLUT_CURSOR_TOP_LEFT_CORNER</b></dt>
3398 <dt><a name="index-GLUT_005fCURSOR_005fTOP_005fRIGHT_005fCORNER"></a><u>Constant:</u> <b>GLUT_CURSOR_TOP_RIGHT_CORNER</b></dt>
3399 <dt><a name="index-GLUT_005fCURSOR_005fBOTTOM_005fRIGHT_005fCORNER"></a><u>Constant:</u> <b>GLUT_CURSOR_BOTTOM_RIGHT_CORNER</b></dt>
3400 <dt><a name="index-GLUT_005fCURSOR_005fBOTTOM_005fLEFT_005fCORNER"></a><u>Constant:</u> <b>GLUT_CURSOR_BOTTOM_LEFT_CORNER</b></dt>
3401 <dt><a name="index-GLUT_005fCURSOR_005fINHERIT"></a><u>Constant:</u> <b>GLUT_CURSOR_INHERIT</b></dt>
3402 <dt><a name="index-GLUT_005fCURSOR_005fNONE"></a><u>Constant:</u> <b>GLUT_CURSOR_NONE</b></dt>
3403 <dt><a name="index-GLUT_005fCURSOR_005fFULL_005fCROSSHAIR"></a><u>Constant:</u> <b>GLUT_CURSOR_FULL_CROSSHAIR</b></dt>
3404 </dl>
3405
3406
3407 <dl>
3408 <dt><a name="index-glut_002dwarp_002dpointer"></a><u>Function:</u> <b>glut-warp-pointer</b><i> x y</i></dt>
3409 </dl>
3410
3411 <hr size="6">
3412 <a name="GLUT-overlay"></a>
3413 <table cellpadding="1" cellspacing="1" border="0">
3414 <tr><td valign="middle" align="left">[<a href="#GLUT-window-manipulation" title="Previous section in reading order"> &lt; </a>]</td>
3415 <td valign="middle" align="left">[<a href="#GLUT-menu-API" title="Next section in reading order"> &gt; </a>]</td>
3416 <td valign="middle" align="left"> &nbsp; </td>
3417 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3418 <td valign="middle" align="left">[<a href="#GLUT-API" title="Up section"> Up </a>]</td>
3419 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3420 <td valign="middle" align="left"> &nbsp; </td>
3421 <td valign="middle" align="left"> &nbsp; </td>
3422 <td valign="middle" align="left"> &nbsp; </td>
3423 <td valign="middle" align="left"> &nbsp; </td>
3424 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3425 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3426 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
3427 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3428 </tr></table>
3429 <a name="GLUT-overlay-1"></a>
3430 <h2 class="section">5.2 GLUT overlay</h2>
3431
3432 <dl>
3433 <dt><a name="index-glut_002destablish_002doverlay"></a><u>Function:</u> <b>glut-establish-overlay</b></dt>
3434 </dl>
3435
3436 <dl>
3437 <dt><a name="index-glut_002dremove_002doverlay"></a><u>Function:</u> <b>glut-remove-overlay</b></dt>
3438 </dl>
3439
3440 <dl>
3441 <dt><a name="index-glut_002duse_002dlayer"></a><u>Function:</u> <b>glut-use-layer</b><i> layer</i></dt>
3442 </dl>
3443
3444 <dl>
3445 <dt><a name="index-glut_002dpost_002doverlay_002dredisplay"></a><u>Function:</u> <b>glut-post-overlay-redisplay</b></dt>
3446 </dl>
3447
3448 <dl>
3449 <dt><a name="index-glut_002dpost_002dwindow_002doverlay_002dredisplay"></a><u>Function:</u> <b>glut-post-window-overlay-redisplay</b><i> win</i></dt>
3450 </dl>
3451
3452 <dl>
3453 <dt><a name="index-glut_002dshow_002doverlay"></a><u>Function:</u> <b>glut-show-overlay</b></dt>
3454 </dl>
3455
3456 <dl>
3457 <dt><a name="index-glut_002dhide_002doverlay"></a><u>Function:</u> <b>glut-hide-overlay</b></dt>
3458 </dl>
3459
3460 <hr size="6">
3461 <a name="GLUT-menu-API"></a>
3462 <table cellpadding="1" cellspacing="1" border="0">
3463 <tr><td valign="middle" align="left">[<a href="#GLUT-overlay" title="Previous section in reading order"> &lt; </a>]</td>
3464 <td valign="middle" align="left">[<a href="#GLUT-callbacks" title="Next section in reading order"> &gt; </a>]</td>
3465 <td valign="middle" align="left"> &nbsp; </td>
3466 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3467 <td valign="middle" align="left">[<a href="#GLUT-API" title="Up section"> Up </a>]</td>
3468 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3469 <td valign="middle" align="left"> &nbsp; </td>
3470 <td valign="middle" align="left"> &nbsp; </td>
3471 <td valign="middle" align="left"> &nbsp; </td>
3472 <td valign="middle" align="left"> &nbsp; </td>
3473 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3474 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3475 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
3476 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3477 </tr></table>
3478 <a name="GLUT-menu-API-1"></a>
3479 <h2 class="section">5.3 GLUT menu API</h2>
3480
3481 <dl>
3482 <dt><a name="index-glut_002dcreate_002dmenu"></a><u>Function:</u> <b>glut-create-menu</b><i> callback</i></dt>
3483 </dl>
3484
3485 <dl>
3486 <dt><a name="index-glut_002ddestroy_002dmenu"></a><u>Function:</u> <b>glut-destroy-menu</b><i> menu</i></dt>
3487 </dl>
3488
3489 <dl>
3490 <dt><a name="index-glut_002dget_002demnu"></a><u>Function:</u> <b>glut-get-emnu</b></dt>
3491 </dl>
3492
3493 <dl>
3494 <dt><a name="index-glut_002dset_002dmenu"></a><u>Function:</u> <b>glut-set-menu</b><i> menu</i></dt>
3495 </dl>
3496
3497 <dl>
3498 <dt><a name="index-glut_002dadd_002dmenu_002dentry"></a><u>Function:</u> <b>glut-add-menu-entry</b><i> label value</i></dt>
3499 </dl>
3500
3501 <dl>
3502 <dt><a name="index-glut_002dadd_002dsub_002dmenu"></a><u>Function:</u> <b>glut-add-sub-menu</b><i> label submenu</i></dt>
3503 </dl>
3504
3505 <dl>
3506 <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>
3507 </dl>
3508
3509 <dl>
3510 <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>
3511 </dl>
3512
3513 <dl>
3514 <dt><a name="index-glut_002dremove_002dmenu_002ditem"></a><u>Function:</u> <b>glut-remove-menu-item</b><i> item</i></dt>
3515 </dl>
3516
3517 <dl>
3518 <dt><a name="index-gult_002dattach_002dmenu"></a><u>Function:</u> <b>gult-attach-menu</b><i> button</i></dt>
3519 </dl>
3520
3521 <dl>
3522 <dt><a name="index-glut_002ddetach_002dmenu"></a><u>Function:</u> <b>glut-detach-menu</b><i> button</i></dt>
3523 </dl>
3524
3525 <hr size="6">
3526 <a name="GLUT-callbacks"></a>
3527 <table cellpadding="1" cellspacing="1" border="0">
3528 <tr><td valign="middle" align="left">[<a href="#GLUT-menu-API" title="Previous section in reading order"> &lt; </a>]</td>
3529 <td valign="middle" align="left">[<a href="#GLUT-colormap" title="Next section in reading order"> &gt; </a>]</td>
3530 <td valign="middle" align="left"> &nbsp; </td>
3531 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3532 <td valign="middle" align="left">[<a href="#GLUT-API" title="Up section"> Up </a>]</td>
3533 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3534 <td valign="middle" align="left"> &nbsp; </td>
3535 <td valign="middle" align="left"> &nbsp; </td>
3536 <td valign="middle" align="left"> &nbsp; </td>
3537 <td valign="middle" align="left"> &nbsp; </td>
3538 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3539 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3540 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
3541 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3542 </tr></table>
3543 <a name="GLUT-callbacks-1"></a>
3544 <h2 class="section">5.4 GLUT callbacks</h2>
3545
3546 <dl>
3547 <dt><a name="index-glut_002ddisplay_002dfunc"></a><u>Function:</u> <b>glut-display-func</b><i> fn</i></dt>
3548 </dl>
3549
3550 <dl>
3551 <dt><a name="index-glut_002dreshape_002dfunc"></a><u>Function:</u> <b>glut-reshape-func</b><i> fn</i></dt>
3552 </dl>
3553
3554 <dl>
3555 <dt><a name="index-glut_002dkeyboard_002dfunc"></a><u>Function:</u> <b>glut-keyboard-func</b><i> fn</i></dt>
3556 </dl>
3557
3558 <dl>
3559 <dt><a name="index-GLUT_005fKEY_005fF1"></a><u>Constant:</u> <b>GLUT_KEY_F1</b></dt>
3560 <dt><a name="index-GLUT_005fKEY_005fF2"></a><u>Constant:</u> <b>GLUT_KEY_F2</b></dt>
3561 <dt><a name="index-GLUT_005fKEY_005fF3"></a><u>Constant:</u> <b>GLUT_KEY_F3</b></dt>
3562 <dt><a name="index-GLUT_005fKEY_005fF4"></a><u>Constant:</u> <b>GLUT_KEY_F4</b></dt>
3563 <dt><a name="index-GLUT_005fKEY_005fF5"></a><u>Constant:</u> <b>GLUT_KEY_F5</b></dt>
3564 <dt><a name="index-GLUT_005fKEY_005fF6"></a><u>Constant:</u> <b>GLUT_KEY_F6</b></dt>
3565 <dt><a name="index-GLUT_005fKEY_005fF7"></a><u>Constant:</u> <b>GLUT_KEY_F7</b></dt>
3566 <dt><a name="index-GLUT_005fKEY_005fF8"></a><u>Constant:</u> <b>GLUT_KEY_F8</b></dt>
3567 <dt><a name="index-GLUT_005fKEY_005fF9"></a><u>Constant:</u> <b>GLUT_KEY_F9</b></dt>
3568 <dt><a name="index-GLUT_005fKEY_005fF10"></a><u>Constant:</u> <b>GLUT_KEY_F10</b></dt>
3569 <dt><a name="index-GLUT_005fKEY_005fF11"></a><u>Constant:</u> <b>GLUT_KEY_F11</b></dt>
3570 <dt><a name="index-GLUT_005fKEY_005fF12"></a><u>Constant:</u> <b>GLUT_KEY_F12</b></dt>
3571 <dt><a name="index-GLUT_005fKEY_005fLEFT"></a><u>Constant:</u> <b>GLUT_KEY_LEFT</b></dt>
3572 <dt><a name="index-GLUT_005fKEY_005fUP"></a><u>Constant:</u> <b>GLUT_KEY_UP</b></dt>
3573 <dt><a name="index-GLUT_005fKEY_005fRIGHT"></a><u>Constant:</u> <b>GLUT_KEY_RIGHT</b></dt>
3574 <dt><a name="index-GLUT_005fKEY_005fDOWN"></a><u>Constant:</u> <b>GLUT_KEY_DOWN</b></dt>
3575 <dt><a name="index-GLUT_005fKEY_005fPAGE_005fUP"></a><u>Constant:</u> <b>GLUT_KEY_PAGE_UP</b></dt>
3576 <dt><a name="index-GLUT_005fKEY_005fPAGE_005fDOWN"></a><u>Constant:</u> <b>GLUT_KEY_PAGE_DOWN</b></dt>
3577 <dt><a name="index-GLUT_005fKEY_005fHOME"></a><u>Constant:</u> <b>GLUT_KEY_HOME</b></dt>
3578 <dt><a name="index-GLUT_005fKEY_005fEND"></a><u>Constant:</u> <b>GLUT_KEY_END</b></dt>
3579 <dt><a name="index-GLUT_005fKEY_005fINSERT"></a><u>Constant:</u> <b>GLUT_KEY_INSERT</b></dt>
3580 </dl>
3581
3582
3583 <dl>
3584 <dt><a name="index-glut_002dmouse_002dfunc"></a><u>Function:</u> <b>glut-mouse-func</b><i> fn</i></dt>
3585 </dl>
3586
3587 <dl>
3588 <dt><a name="index-GLUT_005fLEFT_005fBUTTON"></a><u>Constant:</u> <b>GLUT_LEFT_BUTTON</b></dt>
3589 <dt><a name="index-GLUT_005fMIDDLE_005fBUTTON"></a><u>Constant:</u> <b>GLUT_MIDDLE_BUTTON</b></dt>
3590 <dt><a name="index-GLUT_005fRIGHT_005fBUTTON"></a><u>Constant:</u> <b>GLUT_RIGHT_BUTTON</b></dt>
3591 <dt><a name="index-GLUT_005fDOWN"></a><u>Constant:</u> <b>GLUT_DOWN</b></dt>
3592 <dt><a name="index-GLUT_005fUP"></a><u>Constant:</u> <b>GLUT_UP</b></dt>
3593 </dl>
3594
3595 <dl>
3596 <dt><a name="index-glut_002dmotion_002dfunc"></a><u>Function:</u> <b>glut-motion-func</b><i> fn</i></dt>
3597 </dl>
3598
3599 <dl>
3600 <dt><a name="index-glut_002dpassive_002dmotion_002dfunc"></a><u>Function:</u> <b>glut-passive-motion-func</b><i> fn</i></dt>
3601 </dl>
3602
3603 <dl>
3604 <dt><a name="index-glut_002dentry_002dfunc"></a><u>Function:</u> <b>glut-entry-func</b><i> fn</i></dt>
3605 </dl>
3606
3607 <dl>
3608 <dt><a name="index-GLUT_005fLEFT"></a><u>Constant:</u> <b>GLUT_LEFT</b></dt>
3609 <dt><a name="index-GLUT_005fENTERED"></a><u>Constant:</u> <b>GLUT_ENTERED</b></dt>
3610 </dl>
3611
3612 <dl>
3613 <dt><a name="index-glut_002dvisibility_002dfunc"></a><u>Function:</u> <b>glut-visibility-func</b><i> fn</i></dt>
3614 </dl>
3615
3616 <dl>
3617 <dt><a name="index-GLUT_005fNOT_005fVISIBLE"></a><u>Constant:</u> <b>GLUT_NOT_VISIBLE</b></dt>
3618 <dt><a name="index-GLUT_005fVISIBLE"></a><u>Constant:</u> <b>GLUT_VISIBLE</b></dt>
3619 </dl>
3620
3621 <dl>
3622 <dt><a name="index-glut_002didle_002dfunc"></a><u>Function:</u> <b>glut-idle-func</b><i> fn</i></dt>
3623 </dl>
3624
3625 <dl>
3626 <dt><a name="index-glut_002dtimer_002dfunc"></a><u>Function:</u> <b>glut-timer-func</b><i> millis fn value</i></dt>
3627 </dl>
3628
3629 <dl>
3630 <dt><a name="index-glut_002dmenu_002dstate_002dfunc"></a><u>Function:</u> <b>glut-menu-state-func</b><i> fn</i></dt>
3631 </dl>
3632
3633 <dl>
3634 <dt><a name="index-glut_002dspecial_002dfunc"></a><u>Function:</u> <b>glut-special-func</b><i> fn</i></dt>
3635 </dl>
3636
3637 <dl>
3638 <dt><a name="index-glut_002dspaceball_002dmotion_002dfunc"></a><u>Function:</u> <b>glut-spaceball-motion-func</b><i> fn</i></dt>
3639 </dl>
3640
3641 <dl>
3642 <dt><a name="index-glut_002dspaceball_002drotate_002dfunc"></a><u>Function:</u> <b>glut-spaceball-rotate-func</b><i> fn</i></dt>
3643 </dl>
3644
3645 <dl>
3646 <dt><a name="index-glut_002dspaceball_002dbutton_002dfunc"></a><u>Function:</u> <b>glut-spaceball-button-func</b><i> fn</i></dt>
3647 </dl>
3648
3649 <dl>
3650 <dt><a name="index-glut_002dbutton_002dbox_002dfunc"></a><u>Function:</u> <b>glut-button-box-func</b><i> fn</i></dt>
3651 </dl>
3652
3653 <dl>
3654 <dt><a name="index-glut_002ddials_002dfunc"></a><u>Function:</u> <b>glut-dials-func</b><i> fn</i></dt>
3655 </dl>
3656
3657 <dl>
3658 <dt><a name="index-glut_002dtablet_002dmotion_002dfunc"></a><u>Function:</u> <b>glut-tablet-motion-func</b><i> fn</i></dt>
3659 </dl>
3660
3661 <dl>
3662 <dt><a name="index-glut_002dtablet_002dbutton_002dfunc"></a><u>Function:</u> <b>glut-tablet-button-func</b><i> fn</i></dt>
3663 </dl>
3664
3665 <dl>
3666 <dt><a name="index-glut_002dmenu_002dstatus_002dfunc"></a><u>Function:</u> <b>glut-menu-status-func</b><i> fn</i></dt>
3667 </dl>
3668
3669 <dl>
3670 <dt><a name="index-glut_002doverlay_002ddislay_002dfunc"></a><u>Function:</u> <b>glut-overlay-dislay-func</b><i> fn</i></dt>
3671 </dl>
3672
3673 <dl>
3674 <dt><a name="index-glut_002dwindow_002dstatus_002dfunc"></a><u>Function:</u> <b>glut-window-status-func</b><i> fn</i></dt>
3675 </dl>
3676
3677 <dl>
3678 <dt><a name="index-glut_002dkeyboard_002dup_002dfunc"></a><u>Function:</u> <b>glut-keyboard-up-func</b><i> fn</i></dt>
3679 </dl>
3680
3681 <dl>
3682 <dt><a name="index-glut_002dspecial_002dup_002dfunc"></a><u>Function:</u> <b>glut-special-up-func</b><i> fn</i></dt>
3683 </dl>
3684
3685 <dl>
3686 <dt><a name="index-glut_002djoystick_002dfunc"></a><u>Function:</u> <b>glut-joystick-func</b><i> fn interval</i></dt>
3687 </dl>
3688
3689 <hr size="6">
3690 <a name="GLUT-colormap"></a>
3691 <table cellpadding="1" cellspacing="1" border="0">
3692 <tr><td valign="middle" align="left">[<a href="#GLUT-callbacks" title="Previous section in reading order"> &lt; </a>]</td>
3693 <td valign="middle" align="left">[<a href="#GLUT-state-retrieval" title="Next section in reading order"> &gt; </a>]</td>
3694 <td valign="middle" align="left"> &nbsp; </td>
3695 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3696 <td valign="middle" align="left">[<a href="#GLUT-API" title="Up section"> Up </a>]</td>
3697 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3698 <td valign="middle" align="left"> &nbsp; </td>
3699 <td valign="middle" align="left"> &nbsp; </td>
3700 <td valign="middle" align="left"> &nbsp; </td>
3701 <td valign="middle" align="left"> &nbsp; </td>
3702 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3703 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3704 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
3705 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3706 </tr></table>
3707 <a name="GLUT-colormap-1"></a>
3708 <h2 class="section">5.5 GLUT colormap</h2>
3709
3710 <dl>
3711 <dt><a name="index-glut_002dset_002dcolor"></a><u>Function:</u> <b>glut-set-color</b><i> index r g b</i></dt>
3712 </dl>
3713
3714 <dl>
3715 <dt><a name="index-glut_002dget_002dcolor"></a><u>Function:</u> <b>glut-get-color</b><i> index component</i></dt>
3716 </dl>
3717
3718 <dl>
3719 <dt><a name="index-GLUT_005fRED"></a><u>Constant:</u> <b>GLUT_RED</b></dt>
3720 <dt><a name="index-GLUT_005fGREEN"></a><u>Constant:</u> <b>GLUT_GREEN</b></dt>
3721 <dt><a name="index-GLUT_005fBLUE"></a><u>Constant:</u> <b>GLUT_BLUE</b></dt>
3722 </dl>
3723
3724 <dl>
3725 <dt><a name="index-glut_002dcopy_002dcolormap"></a><u>Function:</u> <b>glut-copy-colormap</b><i> win</i></dt>
3726 </dl>
3727
3728 <hr size="6">
3729 <a name="GLUT-state-retrieval"></a>
3730 <table cellpadding="1" cellspacing="1" border="0">
3731 <tr><td valign="middle" align="left">[<a href="#GLUT-colormap" title="Previous section in reading order"> &lt; </a>]</td>
3732 <td valign="middle" align="left">[<a href="#GLUT-font" title="Next section in reading order"> &gt; </a>]</td>
3733 <td valign="middle" align="left"> &nbsp; </td>
3734 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3735 <td valign="middle" align="left">[<a href="#GLUT-API" title="Up section"> Up </a>]</td>
3736 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3737 <td valign="middle" align="left"> &nbsp; </td>
3738 <td valign="middle" align="left"> &nbsp; </td>
3739 <td valign="middle" align="left"> &nbsp; </td>
3740 <td valign="middle" align="left"> &nbsp; </td>
3741 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3742 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3743 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
3744 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3745 </tr></table>
3746 <a name="GLUT-state-retrieval-1"></a>
3747 <h2 class="section">5.6 GLUT state retrieval</h2>
3748
3749 <dl>
3750 <dt><a name="index-glut_002dget"></a><u>Function:</u> <b>glut-get</b><i> type</i></dt>
3751 </dl>
3752
3753 <dl>
3754 <dt><a name="index-GLUT_005fWINDOW_005fX"></a><u>Constant:</u> <b>GLUT_WINDOW_X</b></dt>
3755 <dt><a name="index-GLUT_005fWINDOW_005fY"></a><u>Constant:</u> <b>GLUT_WINDOW_Y</b></dt>
3756 <dt><a name="index-GLUT_005fWINDOW_005fWIDTH"></a><u>Constant:</u> <b>GLUT_WINDOW_WIDTH</b></dt>
3757 <dt><a name="index-GLUT_005fWINDOW_005fHEIGHT"></a><u>Constant:</u> <b>GLUT_WINDOW_HEIGHT</b></dt>
3758 <dt><a name="index-GLUT_005fWINDOW_005fBUFFER_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_BUFFER_SIZE</b></dt>
3759 <dt><a name="index-GLUT_005fWINDOW_005fSTENCIL_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_STENCIL_SIZE</b></dt>
3760 <dt><a name="index-GLUT_005fWINDOW_005fDEPTH_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_DEPTH_SIZE</b></dt>
3761 <dt><a name="index-GLUT_005fWINDOW_005fRED_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_RED_SIZE</b></dt>
3762 <dt><a name="index-GLUT_005fWINDOW_005fGREEN_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_GREEN_SIZE</b></dt>
3763 <dt><a name="index-GLUT_005fWINDOW_005fBLUE_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_BLUE_SIZE</b></dt>
3764 <dt><a name="index-GLUT_005fWINDOW_005fALPHA_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_ALPHA_SIZE</b></dt>
3765 <dt><a name="index-GLUT_005fWINDOW_005fACCUM_005fRED_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_ACCUM_RED_SIZE</b></dt>
3766 <dt><a name="index-GLUT_005fWINDOW_005fACCUM_005fGREEN_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_ACCUM_GREEN_SIZE</b></dt>
3767 <dt><a name="index-GLUT_005fWINDOW_005fACCUM_005fBLUE_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_ACCUM_BLUE_SIZE</b></dt>
3768 <dt><a name="index-GLUT_005fWINDOW_005fACCUM_005fALPHA_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_ACCUM_ALPHA_SIZE</b></dt>
3769 <dt><a name="index-GLUT_005fWINDOW_005fDOUBLEBUFFER"></a><u>Constant:</u> <b>GLUT_WINDOW_DOUBLEBUFFER</b></dt>
3770 <dt><a name="index-GLUT_005fWINDOW_005fRGBA"></a><u>Constant:</u> <b>GLUT_WINDOW_RGBA</b></dt>
3771 <dt><a name="index-GLUT_005fWINDOW_005fPARENT"></a><u>Constant:</u> <b>GLUT_WINDOW_PARENT</b></dt>
3772 <dt><a name="index-GLUT_005fWINDOW_005fNUM_005fCHILDREN"></a><u>Constant:</u> <b>GLUT_WINDOW_NUM_CHILDREN</b></dt>
3773 <dt><a name="index-GLUT_005fWINDOW_005fCOLORMAP_005fSIZE"></a><u>Constant:</u> <b>GLUT_WINDOW_COLORMAP_SIZE</b></dt>
3774 <dt><a name="index-GLUT_005fWINDOW_005fNUM_005fSAMPLES"></a><u>Constant:</u> <b>GLUT_WINDOW_NUM_SAMPLES</b></dt>
3775 <dt><a name="index-GLUT_005fWINDOW_005fSTEREO"></a><u>Constant:</u> <b>GLUT_WINDOW_STEREO</b></dt>
3776 <dt><a name="index-GLUT_005fWINDOW_005fCURSOR"></a><u>Constant:</u> <b>GLUT_WINDOW_CURSOR</b></dt>
3777 <dt><a name="index-GLUT_005fSCREEN_005fWIDTH"></a><u>Constant:</u> <b>GLUT_SCREEN_WIDTH</b></dt>
3778 <dt><a name="index-GLUT_005fSCREEN_005fHEIGHT"></a><u>Constant:</u> <b>GLUT_SCREEN_HEIGHT</b></dt>
3779 <dt><a name="index-GLUT_005fSCREEN_005fWIDTH_005fMM"></a><u>Constant:</u> <b>GLUT_SCREEN_WIDTH_MM</b></dt>
3780 <dt><a name="index-GLUT_005fSCREEN_005fHEIGHT_005fMM"></a><u>Constant:</u> <b>GLUT_SCREEN_HEIGHT_MM</b></dt>
3781 <dt><a name="index-GLUT_005fMENU_005fNUM_005fITEMS"></a><u>Constant:</u> <b>GLUT_MENU_NUM_ITEMS</b></dt>
3782 <dt><a name="index-GLUT_005fDISPLAY_005fMODE_005fPOSSIBLE"></a><u>Constant:</u> <b>GLUT_DISPLAY_MODE_POSSIBLE</b></dt>
3783 <dt><a name="index-GLUT_005fINIT_005fWINDOW_005fX"></a><u>Constant:</u> <b>GLUT_INIT_WINDOW_X</b></dt>
3784 <dt><a name="index-GLUT_005fINIT_005fWINDOW_005fY"></a><u>Constant:</u> <b>GLUT_INIT_WINDOW_Y</b></dt>
3785 <dt><a name="index-GLUT_005fINIT_005fWINDOW_005fWIDTH"></a><u>Constant:</u> <b>GLUT_INIT_WINDOW_WIDTH</b></dt>
3786 <dt><a name="index-GLUT_005fINIT_005fWINDOW_005fHEIGHT"></a><u>Constant:</u> <b>GLUT_INIT_WINDOW_HEIGHT</b></dt>
3787 <dt><a name="index-GLUT_005fINIT_005fDISPLAY_005fMODE"></a><u>Constant:</u> <b>GLUT_INIT_DISPLAY_MODE</b></dt>
3788 <dt><a name="index-GLUT_005fELAPSED_005fTIME"></a><u>Constant:</u> <b>GLUT_ELAPSED_TIME</b></dt>
3789 <dt><a name="index-GLUT_005fWINDOW_005fFORMAT_005fID"></a><u>Constant:</u> <b>GLUT_WINDOW_FORMAT_ID</b></dt>
3790 </dl>
3791
3792 <dl>
3793 <dt><a name="index-glut_002ddevice_002dget"></a><u>Function:</u> <b>glut-device-get</b><i> type</i></dt>
3794 </dl>
3795
3796 <dl>
3797 <dt><a name="index-GLUT_005fHAS_005fKEYBOARD"></a><u>Constant:</u> <b>GLUT_HAS_KEYBOARD</b></dt>
3798 <dt><a name="index-GLUT_005fHAS_005fMOUSE"></a><u>Constant:</u> <b>GLUT_HAS_MOUSE</b></dt>
3799 <dt><a name="index-GLUT_005fHAS_005fSPACEBALL"></a><u>Constant:</u> <b>GLUT_HAS_SPACEBALL</b></dt>
3800 <dt><a name="index-GLUT_005fHAS_005fDIAL_005fAND_005fBUTTON_005fBOX"></a><u>Constant:</u> <b>GLUT_HAS_DIAL_AND_BUTTON_BOX</b></dt>
3801 <dt><a name="index-GLUT_005fHAS_005fTABLET"></a><u>Constant:</u> <b>GLUT_HAS_TABLET</b></dt>
3802 <dt><a name="index-GLUT_005fNUM_005fMOUSE_005fBUTTONS"></a><u>Constant:</u> <b>GLUT_NUM_MOUSE_BUTTONS</b></dt>
3803 <dt><a name="index-GLUT_005fNUM_005fSPACEBALL_005fBUTTONS"></a><u>Constant:</u> <b>GLUT_NUM_SPACEBALL_BUTTONS</b></dt>
3804 <dt><a name="index-GLUT_005fNUM_005fBUTTON_005fBOX_005fBUTTONS"></a><u>Constant:</u> <b>GLUT_NUM_BUTTON_BOX_BUTTONS</b></dt>
3805 <dt><a name="index-GLUT_005fNUM_005fDIALS"></a><u>Constant:</u> <b>GLUT_NUM_DIALS</b></dt>
3806 <dt><a name="index-GLUT_005fNUM_005fTABLET_005fBUTTONS"></a><u>Constant:</u> <b>GLUT_NUM_TABLET_BUTTONS</b></dt>
3807 <dt><a name="index-GLUT_005fDEVICE_005fIGNORE_005fKEY_005fREPEAT"></a><u>Constant:</u> <b>GLUT_DEVICE_IGNORE_KEY_REPEAT</b></dt>
3808 <dt><a name="index-GLUT_005fDEVICE_005fKEY_005fREPEAT"></a><u>Constant:</u> <b>GLUT_DEVICE_KEY_REPEAT</b></dt>
3809 <dt><a name="index-GLUT_005fHAS_005fJOYSTICK"></a><u>Constant:</u> <b>GLUT_HAS_JOYSTICK</b></dt>
3810 <dt><a name="index-GLUT_005fOWNS_005fJOYSTICK"></a><u>Constant:</u> <b>GLUT_OWNS_JOYSTICK</b></dt>
3811 <dt><a name="index-GLUT_005fJOYSTICK_005fBUTTONS"></a><u>Constant:</u> <b>GLUT_JOYSTICK_BUTTONS</b></dt>
3812 <dt><a name="index-GLUT_005fJOYSTICK_005fAXES"></a><u>Constant:</u> <b>GLUT_JOYSTICK_AXES</b></dt>
3813 <dt><a name="index-GLUT_005fJOYSTICK_005fPOLL_005fRATE"></a><u>Constant:</u> <b>GLUT_JOYSTICK_POLL_RATE</b></dt>
3814 </dl>
3815
3816 <dl>
3817 <dt><a name="index-glut_002dextension_002dsupported"></a><u>Function:</u> <b>glut-extension-supported</b><i> name</i></dt>
3818 </dl>
3819
3820 <dl>
3821 <dt><a name="index-glut_002dget_002dmodifiers"></a><u>Function:</u> <b>glut-get-modifiers</b></dt>
3822 </dl>
3823
3824 <dl>
3825 <dt><a name="index-GLUT_005fACTIVE_005fSHIFT"></a><u>Constant:</u> <b>GLUT_ACTIVE_SHIFT</b></dt>
3826 <dt><a name="index-GLUT_005fACTIVE_005fCTRL"></a><u>Constant:</u> <b>GLUT_ACTIVE_CTRL</b></dt>
3827 <dt><a name="index-GLUT_005fACTIVE_005fALT"></a><u>Constant:</u> <b>GLUT_ACTIVE_ALT</b></dt>
3828 </dl>
3829
3830 <dl>
3831 <dt><a name="index-glut_002dlayer_002dget"></a><u>Function:</u> <b>glut-layer-get</b><i> type</i></dt>
3832 </dl>
3833
3834 <dl>
3835 <dt><a name="index-GLUT_005fOVERLAY_005fPOSSIBLE"></a><u>Constant:</u> <b>GLUT_OVERLAY_POSSIBLE</b></dt>
3836 <dt><a name="index-GLUT_005fLAYER_005fIN_005fUSE"></a><u>Constant:</u> <b>GLUT_LAYER_IN_USE</b></dt>
3837 <dt><a name="index-GLUT_005fHAS_005fOVERLAY"></a><u>Constant:</u> <b>GLUT_HAS_OVERLAY</b></dt>
3838 <dt><a name="index-GLUT_005fTRANSPARENT_005fINDEX"></a><u>Constant:</u> <b>GLUT_TRANSPARENT_INDEX</b></dt>
3839 <dt><a name="index-GLUT_005fNORMAL_005fDAMAGED"></a><u>Constant:</u> <b>GLUT_NORMAL_DAMAGED</b></dt>
3840 <dt><a name="index-GLUT_005fOVERLAY_005fDAMAGED"></a><u>Constant:</u> <b>GLUT_OVERLAY_DAMAGED</b></dt>
3841 </dl>
3842
3843 <hr size="6">
3844 <a name="GLUT-font"></a>
3845 <table cellpadding="1" cellspacing="1" border="0">
3846 <tr><td valign="middle" align="left">[<a href="#GLUT-state-retrieval" title="Previous section in reading order"> &lt; </a>]</td>
3847 <td valign="middle" align="left">[<a href="#GLUT-pre_002dbuilt-models" title="Next section in reading order"> &gt; </a>]</td>
3848 <td valign="middle" align="left"> &nbsp; </td>
3849 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3850 <td valign="middle" align="left">[<a href="#GLUT-API" title="Up section"> Up </a>]</td>
3851 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3852 <td valign="middle" align="left"> &nbsp; </td>
3853 <td valign="middle" align="left"> &nbsp; </td>
3854 <td valign="middle" align="left"> &nbsp; </td>
3855 <td valign="middle" align="left"> &nbsp; </td>
3856 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3857 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3858 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
3859 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3860 </tr></table>
3861 <a name="GLUT-font-1"></a>
3862 <h2 class="section">5.7 GLUT font</h2>
3863
3864 <dl>
3865 <dt><a name="index-_003cglut_002dfont_003e"></a><u>Class:</u> <b>&lt;glut-font&gt;</b></dt>
3866 <dd><a name="index-glut_002dfont"></a>
3867 </dd></dl>
3868
3869 <dl>
3870 <dt><a name="index-glut_002dbitmap_002dcharacter"></a><u>Function:</u> <b>glut-bitmap-character</b><i> font character</i></dt>
3871 </dl>
3872
3873 <dl>
3874 <dt><a name="index-glut_002dbitmap_002dwidth"></a><u>Function:</u> <b>glut-bitmap-width</b><i> font character</i></dt>
3875 </dl>
3876
3877 <dl>
3878 <dt><a name="index-glut_002dstroke_002dcharacter"></a><u>Function:</u> <b>glut-stroke-character</b><i> font character</i></dt>
3879 </dl>
3880
3881 <dl>
3882 <dt><a name="index-glut_002dstroke_002dwidth"></a><u>Function:</u> <b>glut-stroke-width</b><i> font character</i></dt>
3883 </dl>
3884
3885 <dl>
3886 <dt><a name="index-glut_002dbitmap_002dlength"></a><u>Function:</u> <b>glut-bitmap-length</b><i> font string</i></dt>
3887 </dl>
3888
3889 <dl>
3890 <dt><a name="index-glut_002dstroke_002dlength"></a><u>Function:</u> <b>glut-stroke-length</b><i> font string</i></dt>
3891 </dl>
3892
3893 <hr size="6">
3894 <a name="GLUT-pre_002dbuilt-models"></a>
3895 <table cellpadding="1" cellspacing="1" border="0">
3896 <tr><td valign="middle" align="left">[<a href="#GLUT-font" title="Previous section in reading order"> &lt; </a>]</td>
3897 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next section in reading order"> &gt; </a>]</td>
3898 <td valign="middle" align="left"> &nbsp; </td>
3899 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3900 <td valign="middle" align="left">[<a href="#GLUT-API" title="Up section"> Up </a>]</td>
3901 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Next chapter"> &gt;&gt; </a>]</td>
3902 <td valign="middle" align="left"> &nbsp; </td>
3903 <td valign="middle" align="left"> &nbsp; </td>
3904 <td valign="middle" align="left"> &nbsp; </td>
3905 <td valign="middle" align="left"> &nbsp; </td>
3906 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3907 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3908 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
3909 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3910 </tr></table>
3911 <a name="GLUT-pre_002dbuilt-models-1"></a>
3912 <h2 class="section">5.8 GLUT pre-built models</h2>
3913
3914 <dl>
3915 <dt><a name="index-glut_002dwire_002dsphere"></a><u>Function:</u> <b>glut-wire-sphere</b><i> radius slices stacks</i></dt>
3916 <dt><a name="index-glut_002dsolid_002dsphere"></a><u>Function:</u> <b>glut-solid-sphere</b><i> radius slices stacks</i></dt>
3917 </dl>
3918
3919 <dl>
3920 <dt><a name="index-glut_002dwire_002dcone"></a><u>Function:</u> <b>glut-wire-cone</b><i> radius height slices stacks</i></dt>
3921 <dt><a name="index-glut_002dsolid_002dcone"></a><u>Function:</u> <b>glut-solid-cone</b><i> radius height slices stacks</i></dt>
3922 </dl>
3923
3924 <dl>
3925 <dt><a name="index-glut_002dwire_002dcube"></a><u>Function:</u> <b>glut-wire-cube</b><i> size</i></dt>
3926 <dt><a name="index-glut_002dsolid_002dcube"></a><u>Function:</u> <b>glut-solid-cube</b><i> size</i></dt>
3927 </dl>
3928
3929 <dl>
3930 <dt><a name="index-glut_002dwire_002dtorus"></a><u>Function:</u> <b>glut-wire-torus</b><i> inner outer sides rings</i></dt>
3931 <dt><a name="index-glut_002dsolid_002dtorus"></a><u>Function:</u> <b>glut-solid-torus</b><i> inner outer sides rings</i></dt>
3932 </dl>
3933
3934 <dl>
3935 <dt><a name="index-glut_002dwire_002ddodecahedron"></a><u>Function:</u> <b>glut-wire-dodecahedron</b></dt>
3936 <dt><a name="index-glut_002dsolid_002ddodecahedron"></a><u>Function:</u> <b>glut-solid-dodecahedron</b></dt>
3937 </dl>
3938
3939 <dl>
3940 <dt><a name="index-glut_002dwire_002dteapot"></a><u>Function:</u> <b>glut-wire-teapot</b><i> size</i></dt>
3941 <dt><a name="index-glut_002dsoild_002dteapot"></a><u>Function:</u> <b>glut-soild-teapot</b><i> size</i></dt>
3942 </dl>
3943
3944 <dl>
3945 <dt><a name="index-glut_002dwire_002doctahedron"></a><u>Function:</u> <b>glut-wire-octahedron</b></dt>
3946 <dt><a name="index-glut_002dsolid_002doctahedron"></a><u>Function:</u> <b>glut-solid-octahedron</b></dt>
3947 </dl>
3948
3949 <dl>
3950 <dt><a name="index-glut_002dwire_002dtetrahedron"></a><u>Function:</u> <b>glut-wire-tetrahedron</b></dt>
3951 <dt><a name="index-glut_002dsolid_002dtetrahedron"></a><u>Function:</u> <b>glut-solid-tetrahedron</b></dt>
3952 </dl>
3953
3954 <dl>
3955 <dt><a name="index-glut_002dwire_002dicosahedron"></a><u>Function:</u> <b>glut-wire-icosahedron</b></dt>
3956 <dt><a name="index-glut_002dsolid_002dicosahedron"></a><u>Function:</u> <b>glut-solid-icosahedron</b></dt>
3957 </dl>
3958
3959
3960 <hr size="6">
3961 <a name="Vectors-and-matrices"></a>
3962 <table cellpadding="1" cellspacing="1" border="0">
3963 <tr><td valign="middle" align="left">[<a href="#GLUT-pre_002dbuilt-models" title="Previous section in reading order"> &lt; </a>]</td>
3964 <td valign="middle" align="left">[<a href="#Vectors-and-points" title="Next section in reading order"> &gt; </a>]</td>
3965 <td valign="middle" align="left"> &nbsp; </td>
3966 <td valign="middle" align="left">[<a href="#GLUT-API" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
3967 <td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
3968 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Next chapter"> &gt;&gt; </a>]</td>
3969 <td valign="middle" align="left"> &nbsp; </td>
3970 <td valign="middle" align="left"> &nbsp; </td>
3971 <td valign="middle" align="left"> &nbsp; </td>
3972 <td valign="middle" align="left"> &nbsp; </td>
3973 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
3974 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
3975 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
3976 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
3977 </tr></table>
3978 <a name="Vectors-and-matrices-1"></a>
3979 <h1 class="chapter">6. Vectors and matrices</h1>
3980
3981 <dl>
3982 <dt><a name="index-gl_002emath3d"></a><u>Module:</u> <b>gl.math3d</b></dt>
3983 <dd><a name="index-gl_002emath3d-1"></a>
3984 <p>The module provides vector and matrix operations useful for
3985 3D computer graphics.
3986 </p>
3987 <p>Actually this module itself doesn&rsquo;t depend on GL; you can use
3988 this module alone to do matrix calculations. However, the structure
3989 of objects are designed so that they can be passed directly to
3990 Gauche-gl functions, reducing the overhead of type conversions.
3991 </p>
3992 <p>The purpose of this module is to provide reasonable performance.
3993 So the operations are fixed to 3D homogeneous coordinates,
3994 i.e. a vector is 4-element column vector, and a matrix is 4x4
3995 square matrix. If you want more flexibility, <code>&lt;array&gt;</code>
3996 class in <code>gauche.array</code> provides much more generic
3997 structures, trading performance.
3998 </p>
3999 <p>Elements of vectors and matrices are represented in <code>float</code>
4000 internally. When you retrieve each element individually,
4001 it is converted to <code>double</code>, so you might see some precision
4002 errors. There are lots of operations directly manipulate group of
4003 elements without retrieving each element to Scheme world, avoiding
4004 overhead of conversion.
4005 </p></dd></dl>
4006
4007 <table class="menu" border="0" cellspacing="0">
4008 <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">
4009 </td></tr>
4010 <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">
4011 </td></tr>
4012 <tr><td align="left" valign="top"><a href="#Matrices">6.3 Matrices</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
4013 </td></tr>
4014 <tr><td align="left" valign="top"><a href="#Quaternions">6.4 Quaternions</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
4015 </td></tr>
4016 </table>
4017
4018 <hr size="6">
4019 <a name="Vectors-and-points"></a>
4020 <table cellpadding="1" cellspacing="1" border="0">
4021 <tr><td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Previous section in reading order"> &lt; </a>]</td>
4022 <td valign="middle" align="left">[<a href="#Vector-arrays-and-point-arrays" title="Next section in reading order"> &gt; </a>]</td>
4023 <td valign="middle" align="left"> &nbsp; </td>
4024 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
4025 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Up section"> Up </a>]</td>
4026 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Next chapter"> &gt;&gt; </a>]</td>
4027 <td valign="middle" align="left"> &nbsp; </td>
4028 <td valign="middle" align="left"> &nbsp; </td>
4029 <td valign="middle" align="left"> &nbsp; </td>
4030 <td valign="middle" align="left"> &nbsp; </td>
4031 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
4032 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
4033 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
4034 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
4035 </tr></table>
4036 <a name="Vectors-and-points-1"></a>
4037 <h2 class="section">6.1 Vectors and points</h2>
4038
4039 <dl>
4040 <dt><a name="index-_003cvector4f_003e"></a><u>Class:</u> <b>&lt;vector4f&gt;</b></dt>
4041 <dt><a name="index-_003cpoint4f_003e"></a><u>Class:</u> <b>&lt;point4f&gt;</b></dt>
4042 <dd><a name="index-vector4f"></a>
4043 <a name="index-point4f"></a>
4044 <p>4x1 column vectors. <code>Vector4f</code> is intended to be used
4045 to represent a vector, and <code>point4f</code> is to a point,
4046 but as far as OpenGL concerns, both are just an array of four floats,
4047 <var>x</var>, <var>y</var>, <var>z</var> and <var>w</var>.
4048 </p>
4049 <p>These classes inherit <code>&lt;sequence&gt;</code> and <code>&lt;collection&gt;</code>
4050 classes. So if you import <code>gauche.sequence</code> module,
4051 you can use generic function such as <code>ref</code> and <code>(setter ref)</code>
4052 to get/set individual elements. The generic version of
4053 <code>map</code> and <code>for-each</code> can also be used on the vector4f and
4054 point4f instances.
4055 </p>
4056 <p>Aside from the type,
4057 the only difference is that the default value of <var>w</var> component&mdash;
4058 it&rsquo;s 0.0 for vectors, and 1.0 for points. So usual transformation
4059 produces expected results; for example point plus vector
4060 becomes point, vector plus vector becomes vector,
4061 and translating point changes its coordinates but
4062 translating vectors doesn&rsquo;t, and so on.
4063 However, you can set <var>w</var> component to other value to do
4064 nontrivial operations.
4065 </p></dd></dl>
4066
4067 <dl>
4068 <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>
4069 <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>
4070 <dd><p>These SRFI-10 syntax can be used to denote literal <code>&lt;vector4f&gt;</code>
4071 and <code>&lt;point4f&gt;</code> instance, respectively.
4072 </p>
4073 <p>The write methods are defined so that the instance is written out
4074 in this form, and can be read back later.
4075 </p></dd></dl>
4076
4077 <dl>
4078 <dt><a name="index-vector4f_003f"></a><u>Function:</u> <b>vector4f?</b><i> obj</i></dt>
4079 <dt><a name="index-point4f_003f"></a><u>Function:</u> <b>point4f?</b><i> obj</i></dt>
4080 <dd><p>Returns true iff <var>obj</var> is vector4f and point4f, respectively.
4081 </p></dd></dl>
4082
4083
4084 <dl>
4085 <dt><a name="index-vector4f-1"></a><u>Function:</u> <b>vector4f</b><i> x y z &amp;optional (w 0.0)</i></dt>
4086 <dt><a name="index-point4f-1"></a><u>Function:</u> <b>point4f</b><i> x y z &amp;optional (w 1.0)</i></dt>
4087 <dd><p>Creates a vector4f and point4f instance with given values, respectively.
4088 </p></dd></dl>
4089
4090 <dl>
4091 <dt><a name="index-make_002dvector4f"></a><u>Function:</u> <b>make-vector4f</b></dt>
4092 <dt><a name="index-make_002dpoint4f"></a><u>Function:</u> <b>make-point4f</b></dt>
4093 <dd><p>Another way to create a vector4f and a point4f.
4094 The first returns <code>#,(vector4f 0.0 0.0 0.0 0.0)</code>,
4095 and the latter returns <code>#,(point4f 0.0 0.0 0.0 1.0)</code>.
4096 </p></dd></dl>
4097
4098 <dl>
4099 <dt><a name="index-list_002d_003evector4f"></a><u>Function:</u> <b>list-&gt;vector4f</b><i> l</i></dt>
4100 <dt><a name="index-list_002d_003epoint4f"></a><u>Function:</u> <b>list-&gt;point4f</b><i> l</i></dt>
4101 <dd><p>Convert a list of three or four real numbers to a vector4f and a point4f,
4102 respectively.
4103 If <var>l</var> is not a list of three or four real numbers, an error is
4104 signalled.
4105 </p>
4106 <table><tr><td>&nbsp;</td><td><pre class="example">(list-&gt;vector4f l)
4107 &equiv; (apply vector4f l)
4108 &equiv; (coerce-to &lt;vector4f&gt; l)
4109 </pre></td></tr></table>
4110 </dd></dl>
4111
4112 <dl>
4113 <dt><a name="index-vector4f_002d_003elist"></a><u>Function:</u> <b>vector4f-&gt;list</b><i> v</i></dt>
4114 <dt><a name="index-point4f_002d_003elist"></a><u>Function:</u> <b>point4f-&gt;list</b><i> p</i></dt>
4115 <dd><p>Convert a vector4f and a point4f to a list of four real numbers,
4116 respectively.
4117 </p>
4118 <table><tr><td>&nbsp;</td><td><pre class="example">(vector4f-&gt;list v)
4119 &equiv; (coerce-to &lt;list&gt; v)
4120 &equiv; (map (cut ref v &lt;&gt;) (iota 4))
4121 </pre></td></tr></table>
4122 </dd></dl>
4123
4124 <dl>
4125 <dt><a name="index-f32vector_002d_003evector4f"></a><u>Function:</u> <b>f32vector-&gt;vector4f</b><i> v &amp;optional start</i></dt>
4126 <dt><a name="index-f32vector_002d_003epoint4f"></a><u>Function:</u> <b>f32vector-&gt;point4f</b><i> v &amp;optional start</i></dt>
4127 <dd><p>Creates a vector4f or a point4f, initializing by the elements of
4128 f32vector <var>v</var>. <var>V</var> must be at least 4 elements long, and the first
4129 four elements are used to initialize the created vector or point.
4130 </p>
4131 <p>If optional <var>start</var> argument is given, it specifies an index
4132 of <var>v</var> from which the initial values are taken; that is,
4133 <var>start</var>, <var>start+1</var>, <var>start+2</var> and <var>start+3</var>-th
4134 elements are used to create a vector or a point.
4135 This allows to create vectors from plain float array:
4136 </p><table><tr><td>&nbsp;</td><td><pre class="example">(map (lambda (off) (f32vector-&gt;vector4f vec (* off 4)))
4137 (iota (/ (size-of vec) 4)))
4138 </pre></td></tr></table>
4139
4140 <p>The conversion can be done using <code>coerce-to</code>, as well.
4141 </p><table><tr><td>&nbsp;</td><td><pre class="example">(f32vector-&gt;vector4f vec)
4142 &equiv; (coerce-to &lt;vector4f&gt; vec)
4143 </pre></td></tr></table>
4144 </dd></dl>
4145
4146 <dl>
4147 <dt><a name="index-vector4f_002d_003ef32vector"></a><u>Function:</u> <b>vector4f-&gt;f32vector</b><i> v</i></dt>
4148 <dt><a name="index-point4f_002d_003ef32vector"></a><u>Function:</u> <b>point4f-&gt;f32vector</b><i> p</i></dt>
4149 <dd><p>Convert a vector4f <var>v</var> or a point4f <var>p</var> to four-element
4150 f32vector.
4151 </p>
4152 <table><tr><td>&nbsp;</td><td><pre class="example">(vector4f-&gt;f32vector v)
4153 &equiv; (coerce-to &lt;f32vector&gt; v)
4154 </pre></td></tr></table>
4155 </dd></dl>
4156
4157 <dl>
4158 <dt><a name="index-vector4f_002dcopy"></a><u>Function:</u> <b>vector4f-copy</b><i> v</i></dt>
4159 <dt><a name="index-point4f_002dcopy"></a><u>Function:</u> <b>point4f-copy</b><i> p</i></dt>
4160 <dd><p>Returns a new copy of vector4f <var>v</var> or point4f <var>p</var>, respectively.
4161 </p></dd></dl>
4162
4163 <dl>
4164 <dt><a name="index-vector4f_002dcopy_0021"></a><u>Function:</u> <b>vector4f-copy!</b><i> dstv srcv</i></dt>
4165 <dt><a name="index-point4f_002dcopy_0021"></a><u>Function:</u> <b>point4f-copy!</b><i> dstp srcp</i></dt>
4166 <dd><p>Destructively sets the content of <var>srcv</var> or <var>srcp</var> to
4167 <var>dstv</var> or <var>dstp</var>, respectively.
4168 </p></dd></dl>
4169
4170 <dl>
4171 <dt><a name="index-vector4f_002dset_0021"></a><u>Function:</u> <b>vector4f-set!</b><i> v k value</i></dt>
4172 <dt><a name="index-point4f_002dset_0021"></a><u>Function:</u> <b>point4f-set!</b><i> p k value</i></dt>
4173 <dd><p>Sets a real number <var>value</var> to
4174 <var>k</var>-th element of a vector4f <var>v</var> or a point4f <var>p</var>.
4175 </p>
4176 <table><tr><td>&nbsp;</td><td><pre class="example">(vector4f-set! v k value)
4177 &equiv; (set! (ref v k) value)
4178 </pre></td></tr></table>
4179 </dd></dl>
4180
4181 <dl>
4182 <dt><a name="index-vector4f_002dref"></a><u>Function:</u> <b>vector4f-ref</b><i> v k &amp;optional fallback</i></dt>
4183 <dt><a name="index-point4f_002dref"></a><u>Function:</u> <b>point4f-ref</b><i> p k &amp;optional fallback</i></dt>
4184 <dd><p>Gets a value of <var>k</var>-th element of a vector4f <var>v</var> or
4185 a point4f <var>p</var>. If <var>k</var> is out of range,
4186 an error is signalled, unless <var>fallback</var> is provided,
4187 in such a case <var>fallback</var> is returned.
4188 </p>
4189 <table><tr><td>&nbsp;</td><td><pre class="example">(vector4f-ref v k)
4190 &equiv; (ref v k)
4191 </pre></td></tr></table>
4192 </dd></dl>
4193
4194 <dl>
4195 <dt><a name="index-vector4f_002ddot"></a><u>Function:</u> <b>vector4f-dot</b><i> x y</i></dt>
4196 <dd><p>Returns a dot product of two vector4fs, <var>x</var> and <var>y</var>.
4197 </p></dd></dl>
4198
4199 <dl>
4200 <dt><a name="index-vector4f_002dcross"></a><u>Function:</u> <b>vector4f-cross</b><i> x y</i></dt>
4201 <dd><p>Returns a cross product of two vector4fs, <var>x</var> and <var>y</var>.
4202 (<var>w</var> element is ignored).
4203 </p></dd></dl>
4204
4205 <dl>
4206 <dt><a name="index-vector4f_002dnorm"></a><u>Function:</u> <b>vector4f-norm</b><i> v</i></dt>
4207 <dd><p>Returns the norm (length) of the vector <var>v</var>.
4208 </p></dd></dl>
4209
4210 <dl>
4211 <dt><a name="index-vector4f_002dnormalize"></a><u>Function:</u> <b>vector4f-normalize</b><i> x</i></dt>
4212 <dt><a name="index-vector4f_002dnormalize_0021"></a><u>Function:</u> <b>vector4f-normalize!</b><i> x</i></dt>
4213 <dd><p>Returns a normalized vector of vector4f <var>x</var>.
4214 <code>Vector4f-normalize</code> allocates a new vector, while
4215 <code>vector4f-normalize!</code> modifies the original vector.
4216 </p>
4217 <p>As a special case,
4218 if <var>x</var> is a vector of length 0, a vector of length 0 is returned.
4219 </p></dd></dl>
4220
4221 <dl>
4222 <dt><a name="index-vector4f_002dadd"></a><u>Function:</u> <b>vector4f-add</b><i> x y</i></dt>
4223 <dt><a name="index-vector4f_002dsub"></a><u>Function:</u> <b>vector4f-sub</b><i> x y</i></dt>
4224 <dt><a name="index-vector4f_002dadd_0021"></a><u>Function:</u> <b>vector4f-add!</b><i> x y</i></dt>
4225 <dt><a name="index-vector4f_002dsub_0021"></a><u>Function:</u> <b>vector4f-sub!</b><i> x y</i></dt>
4226 <dd><p>Returns a sum of two vector4fs, <var>x</var> and <var>y</var>.
4227 The destructive version modifies <var>x</var>.
4228 </p></dd></dl>
4229
4230 <dl>
4231 <dt><a name="index-point4f_002dadd"></a><u>Function:</u> <b>point4f-add</b><i> x y</i></dt>
4232 <dt><a name="index-point4f_002dadd_0021"></a><u>Function:</u> <b>point4f-add!</b><i> x y</i></dt>
4233 <dd><p>Adds a point4f <var>x</var> and a vector4f <var>y</var>, and returns
4234 a translated point. The destructive version modifies <var>x</var>.
4235 </p></dd></dl>
4236
4237 <dl>
4238 <dt><a name="index-point4f_002dsub"></a><u>Function:</u> <b>point4f-sub</b><i> x y</i></dt>
4239 <dd><p>Subtracts either a vector4f or a point4f <var>y</var> from
4240 a point4f <var>x</var>. If <var>y</var> is a vector4f, returns
4241 a translated point. If <var>y</var> is a point4f, returns
4242 a vector4f from point <var>y</var> to point <var>x</var>.
4243 </p></dd></dl>
4244
4245 <hr size="6">
4246 <a name="Vector-arrays-and-point-arrays"></a>
4247 <table cellpadding="1" cellspacing="1" border="0">
4248 <tr><td valign="middle" align="left">[<a href="#Vectors-and-points" title="Previous section in reading order"> &lt; </a>]</td>
4249 <td valign="middle" align="left">[<a href="#Matrices" title="Next section in reading order"> &gt; </a>]</td>
4250 <td valign="middle" align="left"> &nbsp; </td>
4251 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
4252 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Up section"> Up </a>]</td>
4253 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Next chapter"> &gt;&gt; </a>]</td>
4254 <td valign="middle" align="left"> &nbsp; </td>
4255 <td valign="middle" align="left"> &nbsp; </td>
4256 <td valign="middle" align="left"> &nbsp; </td>
4257 <td valign="middle" align="left"> &nbsp; </td>
4258 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
4259 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
4260 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
4261 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
4262 </tr></table>
4263 <a name="Vector-arrays-and-point-arrays-1"></a>
4264 <h2 class="section">6.2 Vector arrays and point arrays</h2>
4265
4266 <dl>
4267 <dt><a name="index-_003cvector4f_002darray_003e"></a><u>Class:</u> <b>&lt;vector4f-array&gt;</b></dt>
4268 <dt><a name="index-_003cpoint4f_002darray_003e"></a><u>Class:</u> <b>&lt;point4f-array&gt;</b></dt>
4269 <dd><a name="index-vector4f_002darray"></a>
4270 <a name="index-point4f_002darray"></a>
4271 <p>Represents an array of vector4fs and point4fs.
4272 This is an efficient way to keep an array of vectors or points,
4273 for the elements are packed in a simple float array.
4274 They are especially useful to work with GL&rsquo;s vertex array feature.
4275 <code>gl-vertex-pointer</code> can take <code>&lt;point4f-array&gt;</code>,
4276 and <code>gl-normal-pointer</code> can take <code>&lt;vector4f-array&gt;</code>.
4277 </p>
4278 <p>It is also possible to &quot;view&quot; a plain f32vector as <code>&lt;vector4f-array&gt;</code>
4279 or <code>&lt;point4f-array&gt;</code> without copying its content, by
4280 <code>f32vector-&gt;vector4f-array/shared</code> and
4281 <code>f32vector-&gt;point4f-array/shared</code>. Combined to
4282 <code>read-block!</code>, you can do efficient binary I/O of
4283 vertex arrays, for example.
4284 </p>
4285 <p>Inherits <code>&lt;sequence&gt;</code> and <code>&lt;collection&gt;</code>.
4286 When viewed as a sequence or a collection, they behaves like
4287 sequence or collection of <code>vector4f</code> and <code>point4f</code> objects,
4288 respectively.
4289 </p></dd></dl>
4290
4291 <dl>
4292 <dt><a name="index-make_002dvector4f_002darray"></a><u>Function:</u> <b>make-vector4f-array</b><i> len &amp;optional init-vector</i></dt>
4293 <dt><a name="index-make_002dpoint4f_002darray"></a><u>Function:</u> <b>make-point4f-array</b><i> len &amp;optional init-point</i></dt>
4294 <dd><p>Creates a vector4f-array or point4f-array with <var>len</var> elements.
4295 Each element is initialized by a vector4f <var>init-vector</var> or
4296 a point4f <var>init-point</var> if provided.
4297 </p></dd></dl>
4298
4299 <dl>
4300 <dt><a name="index-vector4f_002darray_003f"></a><u>Function:</u> <b>vector4f-array?</b><i> obj</i></dt>
4301 <dt><a name="index-point4f_002darray_003f"></a><u>Function:</u> <b>point4f-array?</b><i> obj</i></dt>
4302 <dd><p>Returns true iff <var>obj</var> is a vector4f-array or a point4f-array,
4303 respectively.
4304 </p></dd></dl>
4305
4306 <dl>
4307 <dt><a name="index-vector4f_002darray_002dlength"></a><u>Function:</u> <b>vector4f-array-length</b><i> array</i></dt>
4308 <dt><a name="index-point4f_002darray_002dlength"></a><u>Function:</u> <b>point4f-array-length</b><i> array</i></dt>
4309 <dd><p>Returns length (number of vectors/points) in array <var>array</var>.
4310 </p></dd></dl>
4311
4312 <dl>
4313 <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>
4314 <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>
4315 <dd><p>Vector4f-array and point4f-array have external representation
4316 using this SRFI-10 syntax. <var>Len</var> is a length of array,
4317 and each <var>elt</var> is a list of four floats representing
4318 each element of the array.
4319 </p>
4320 <table><tr><td>&nbsp;</td><td><pre class="example">(f32vector-&gt;vector4f-array #f32(1 2 3 4 6 7 4 3))
4321 &rArr; #,(vector4f-array 2 (1 2 3 4) (6 7 4 3) )
4322 </pre></td></tr></table>
4323 </dd></dl>
4324
4325 <dl>
4326 <dt><a name="index-list_002d_003evector4f_002darray"></a><u>Function:</u> <b>list-&gt;vector4f-array</b><i> list</i></dt>
4327 <dt><a name="index-list_002d_003epoint4f_002darray"></a><u>Function:</u> <b>list-&gt;point4f-array</b><i> list</i></dt>
4328 <dd><p>From given list of vector4fs or point4fs, creates and returns
4329 a vector4f-array or point4f-array, respectively.
4330 </p></dd></dl>
4331
4332 <dl>
4333 <dt><a name="index-f32vector_002d_003evector4f_002darray"></a><u>Function:</u> <b>f32vector-&gt;vector4f-array</b><i> v</i></dt>
4334 <dt><a name="index-f32vector_002d_003epoint4f_002darray"></a><u>Function:</u> <b>f32vector-&gt;point4f-array</b><i> v</i></dt>
4335 <dd><p>Converts f32vector <var>v</var> to a vector4f-array or a point4f-array.
4336 The length of <var>v</var> must be multiple of four.
4337 The content of <var>v</var> is copied.
4338 </p>
4339 <table><tr><td>&nbsp;</td><td><pre class="example">(f32vector-&gt;vector4f-array v)
4340 &equiv; (coerce-to &lt;vector4f-array&gt; v)
4341 </pre></td></tr></table>
4342 </dd></dl>
4343
4344 <dl>
4345 <dt><a name="index-f32vector_002d_003evector4f_002darray_002fshared"></a><u>Function:</u> <b>f32vector-&gt;vector4f-array/shared</b><i> v</i></dt>
4346 <dt><a name="index-f32vector_002d_003epoint4f_002darray_002fshared"></a><u>Function:</u> <b>f32vector-&gt;point4f-array/shared</b><i> v</i></dt>
4347 <dd><p>Like above, but the content of <var>v</var> is shared by the result
4348 array, instead of being copied.
4349 So the modification of result array will be visible from original
4350 f32vector <var>v</var> and vice versa.
4351 It will allow efficient handling of large vertex arrays.
4352 </p></dd></dl>
4353
4354 <dl>
4355 <dt><a name="index-vector4f_002darray_002d_003ef32vector"></a><u>Function:</u> <b>vector4f-array-&gt;f32vector</b><i> array</i></dt>
4356 <dt><a name="index-point4f_002darray_002d_003ef32vector"></a><u>Function:</u> <b>point4f-array-&gt;f32vector</b><i> array</i></dt>
4357 <dd><p>Converts a vector4f-array or a point4f-array <var>array</var> to a f32vector.
4358 </p>
4359 <table><tr><td>&nbsp;</td><td><pre class="example">(vector4f-array-&gt;f32vector array)
4360 &equiv; (coerce-to &lt;f32vector&gt; array)
4361 </pre></td></tr></table>
4362 </dd></dl>
4363
4364 <dl>
4365 <dt><a name="index-vector4f_002darray_002dset_0021"></a><u>Function:</u> <b>vector4f-array-set!</b><i> array i vector</i></dt>
4366 <dt><a name="index-point4f_002darray_002dset_0021"></a><u>Function:</u> <b>point4f-array-set!</b><i> array i point</i></dt>
4367 <dd><p>Sets a vector4f <var>vector</var> or a point4f <var>point</var> to
4368 <var>i</var>-th element of vector4f-array or point4f-array <var>array</var>,
4369 respectively.
4370 </p>
4371 <table><tr><td>&nbsp;</td><td><pre class="example">(vector4f-array-set! array i vector)
4372 &equiv; (set! (ref array i) vector)
4373 </pre></td></tr></table>
4374 </dd></dl>
4375
4376 <dl>
4377 <dt><a name="index-vector4f_002darray_002dref"></a><u>Function:</u> <b>vector4f-array-ref</b><i> array i &amp;optional fallback</i></dt>
4378 <dt><a name="index-point4f_002darray_002dref"></a><u>Function:</u> <b>point4f-array-ref</b><i> array i &amp;optional fallback</i></dt>
4379 <dd><p>Returns a vector4f or a point4f which is the <var>i</var>-th element
4380 of array <var>array</var>, respectively.
4381 If <var>k</var> is out of range,
4382 an error is signalled, unless <var>fallback</var> is provided,
4383 in such a case <var>fallback</var> is returned.
4384 </p>
4385 <table><tr><td>&nbsp;</td><td><pre class="example">(vector4f-array-ref array i)
4386 &equiv; (ref array i)
4387
4388 (ref #,(vector4f-array 2 (1 2 3 4) (6 7 4 3)) 1)
4389 &rArr; #,(vector4f 6 7 4 3)
4390 </pre></td></tr></table>
4391 </dd></dl>
4392
4393 <dl>
4394 <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>
4395 <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>
4396 <dd><p>Like above, but the returned vector4f or point4f shares the storage
4397 with the original array. Thus the modification of the result
4398 vector or point will be visible from <var>array</var>, and vice versa.
4399 </p></dd></dl>
4400
4401 <hr size="6">
4402 <a name="Matrices"></a>
4403 <table cellpadding="1" cellspacing="1" border="0">
4404 <tr><td valign="middle" align="left">[<a href="#Vector-arrays-and-point-arrays" title="Previous section in reading order"> &lt; </a>]</td>
4405 <td valign="middle" align="left">[<a href="#Quaternions" title="Next section in reading order"> &gt; </a>]</td>
4406 <td valign="middle" align="left"> &nbsp; </td>
4407 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
4408 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Up section"> Up </a>]</td>
4409 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Next chapter"> &gt;&gt; </a>]</td>
4410 <td valign="middle" align="left"> &nbsp; </td>
4411 <td valign="middle" align="left"> &nbsp; </td>
4412 <td valign="middle" align="left"> &nbsp; </td>
4413 <td valign="middle" align="left"> &nbsp; </td>
4414 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
4415 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
4416 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
4417 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
4418 </tr></table>
4419 <a name="Matrices-1"></a>
4420 <h2 class="section">6.3 Matrices</h2>
4421
4422 <dl>
4423 <dt><a name="index-_003cmatrix4f_003e"></a><u>Class:</u> <b>&lt;matrix4f&gt;</b></dt>
4424 <dd><a name="index-matrix4f"></a>
4425 <p>4x4 matrix. Internally it is represented as an array of 16 floats,
4426 stored in column-major order.
4427 (It is the same order OpenGL uses, so it can be passed to OpenGL
4428 calls without overhead).
4429 </p>
4430 <p>Inherits <code>&lt;sequence&gt;</code> and <code>&lt;collection&gt;</code>.
4431 When a matrix4f is treated as a sequence, it works as if it is
4432 a single sequence of floats in column-major order.
4433 </p></dd></dl>
4434
4435 <dl>
4436 <dt><a name="index-make_002dmatrix4f"></a><u>Function:</u> <b>make-matrix4f</b><i> &amp;optional init</i></dt>
4437 <dd><p>Returns a new matrix4f instance. If <var>init</var> is omitted,
4438 the matrix is a unit matrix. Otherwise, <var>init</var> must be a f32vector
4439 of length 16, and the elements in the matrix is initialized by
4440 ones in f32vector.
4441 </p>
4442 <table><tr><td>&nbsp;</td><td><pre class="example">;; Creates a matrix like this:
4443 ;; 1 2 3 4
4444 ;; 0 1 0 5
4445 ;; 0 0 1 6
4446 ;; 0 0 0 1
4447
4448 (make-matrix4f '#f32vector(1 0 0 0
4449 2 1 0 0
4450 3 0 1 0
4451 4 5 6 1))
4452 </pre></td></tr></table>
4453 </dd></dl>
4454
4455 <dl>
4456 <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>
4457 <dd><p>Creates a new matrix4f instance with give values.
4458 </p></dd></dl>
4459
4460 <dl>
4461 <dt><a name="index-matrix4f_003f"></a><u>Function:</u> <b>matrix4f?</b><i> obj</i></dt>
4462 <dd><p>Returns true iff <var>obj</var> is a matrix4f.
4463 </p></dd></dl>
4464
4465 <dl>
4466 <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>
4467 <dd><p>A matrix4f is represented extrenally using SRFI-10 syntax.
4468 The elements are listed in column-major order.
4469 </p></dd></dl>
4470
4471 <dl>
4472 <dt><a name="index-list_002d_003ematrix4f"></a><u>Function:</u> <b>list-&gt;matrix4f</b><i> l</i></dt>
4473 <dt><a name="index-matrix4f_002d_003elist"></a><u>Function:</u> <b>matrix4f-&gt;list</b><i> m</i></dt>
4474 <dd><p>Converts between list of 16 real numbers and matrix4f.
4475 </p></dd></dl>
4476
4477 <dl>
4478 <dt><a name="index-f32vector_002d_003ematrix4f"></a><u>Function:</u> <b>f32vector-&gt;matrix4f</b><i> v &amp;optional start</i></dt>
4479 <dd><p>Creates a new matrix4f and initializes it with 16 elements in
4480 f32vector <var>v</var>. If optional <var>start</var> is given,
4481 it specifies the start offset in vector <var>v</var> to be used as
4482 initial values. The f32vector <var>v</var> must have enough length.
4483 </p></dd></dl>
4484
4485 <dl>
4486 <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>
4487 <dd><p>Extract 16 flonums in the f32vector <var>v</var> starting from the
4488 index <var>start</var>, and fill the matrix4f <var>m</var> with them.
4489 The f32vector <var>v</var> must have enough length.
4490 </p></dd></dl>
4491
4492 <dl>
4493 <dt><a name="index-matrix4f_002d_003ef32vector"></a><u>Function:</u> <b>matrix4f-&gt;f32vector</b><i> m</i></dt>
4494 <dd><p>Returns a new f32vector that has elements from matrix4f <var>m</var>.
4495 </p></dd></dl>
4496
4497 <dl>
4498 <dt><a name="index-matrix4f_002dcopy"></a><u>Function:</u> <b>matrix4f-copy</b><i> m</i></dt>
4499 <dd><p>Returns a new copy of <var>m</var>.
4500 </p></dd></dl>
4501
4502 <dl>
4503 <dt><a name="index-matrix4f_002dcopy_0021"></a><u>Function:</u> <b>matrix4f-copy!</b><i> dstm srcm</i></dt>
4504 <dd><p>Copies contents of <var>srcm</var> to <var>dstm</var>.
4505 </p></dd></dl>
4506
4507 <dl>
4508 <dt><a name="index-matrix4f_002dset_0021"></a><u>Function:</u> <b>matrix4f-set!</b><i> m i value</i></dt>
4509 <dd><p>Sets a real number <var>value</var> to <var>i</var>-th element of matrix <var>m</var>.
4510 Since the matrix is laid out in column-major order,
4511 the one-dimensional index <code>m{<var>i</var>}</code> and two-dimensional
4512 index <code>m(<var>i</var>,<var>j</var>)</code> corresponds as follows:
4513 </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}
4514 m(1,0) = m{1} m(1,1) = m{5} m(1,2) = m{9} m(1,3) = m{13}
4515 m(2,0) = m{2} m(2,1) = m{6} m(2,2) = m{10} m(2,3) = m{14}
4516 m(3,0) = m{3} m(3,1) = m{7} m(3,2) = m{11} m(3,3) = m{15}
4517 </pre></td></tr></table>
4518 </dd></dl>
4519
4520 <dl>
4521 <dt><a name="index-matrix4f_002dref"></a><u>Function:</u> <b>matrix4f-ref</b><i> m i &amp;optional fallback</i></dt>
4522 <dd><p>Returns the <var>i</var>-th element of matrix <var>m</var>.
4523 If <var>i</var> is out of range, an error is signalled,
4524 unless <var>fallback</var> is provided, in such a case
4525 <var>fallback</var> is returned.
4526 </p></dd></dl>
4527
4528 <dl>
4529 <dt><a name="index-matrix4f_002dset2_0021"></a><u>Function:</u> <b>matrix4f-set2!</b><i> m i j value</i></dt>
4530 <dd><p>Sets <var>value</var> to <code>(<var>i</var>, <var>j</var>)</code> element of matrix <var>m</var>.
4531 </p></dd></dl>
4532
4533 <dl>
4534 <dt><a name="index-matrix4f_002dref2"></a><u>Function:</u> <b>matrix4f-ref2</b><i> m i j</i></dt>
4535 <dd><p>Returns the <code>(<var>i</var>, <var>j</var>)</code> element of matrix <var>m</var>.
4536 </p></dd></dl>
4537
4538 <dl>
4539 <dt><a name="index-matrix4f_002drow"></a><u>Function:</u> <b>matrix4f-row</b><i> m i</i></dt>
4540 <dt><a name="index-matrix4f_002dcolumn"></a><u>Function:</u> <b>matrix4f-column</b><i> m i</i></dt>
4541 <dt><a name="index-matrix4f_002dcolumn_002fshared"></a><u>Function:</u> <b>matrix4f-column/shared</b><i> m i</i></dt>
4542 <dd><p>Returns <var>i</var>-th row vector or <var>i</var>-th column vector
4543 of matrix <var>m</var>, as a vector4f instance.
4544 </p>
4545 <p>Furthermore, the returned vector from <code>matrix4f-column/shared</code>
4546 shares the storage with <code>m</code>.
4547 </p></dd></dl>
4548
4549 <dl>
4550 <dt><a name="index-matrix4f_002dmul"></a><u>Function:</u> <b>matrix4f-mul</b><i> m obj</i></dt>
4551 <dd><p><var>Obj</var> may be a scalar (real number), a vector4f, a point4f, or a matrix4f.
4552 Returns <var>m</var> x <var>obj</var>.
4553 </p></dd></dl>
4554
4555 <dl>
4556 <dt><a name="index-matrix4f_002dmul_0021"></a><u>Function:</u> <b>matrix4f-mul!</b><i> m obj</i></dt>
4557 <dd><p><var>Obj</var> may be a scalar or a matrix4f.
4558 Matrix <var>m</var> is multiplied by <var>obj</var>, and the result is
4559 set to <var>m</var> destructively.
4560 </p></dd></dl>
4561
4562 <dl>
4563 <dt><a name="index-matrix4f_002dtranspose"></a><u>Function:</u> <b>matrix4f-transpose</b><i> m</i></dt>
4564 <dt><a name="index-matrix4f_002dtranspose_0021"></a><u>Function:</u> <b>matrix4f-transpose!</b><i> m</i></dt>
4565 <dd><p>Returns a transposed matrix of <var>m</var>. The destructive version
4566 modifies <var>m</var>.
4567 </p></dd></dl>
4568
4569 <dl>
4570 <dt><a name="index-matrix4f_002ddeterminant"></a><u>Function:</u> <b>matrix4f-determinant</b><i> m</i></dt>
4571 <dd><p>Returns a determinant of <var>m</var>.
4572 </p></dd></dl>
4573
4574 <dl>
4575 <dt><a name="index-matrix4f_002dinverse"></a><u>Function:</u> <b>matrix4f-inverse</b><i> m &amp;optional (error-on-singular? #t)</i></dt>
4576 <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>
4577 <dd><p>Returns a inverse matrix of <var>m</var>. The destructive version
4578 modifies <var>m</var>. If given <var>m</var> is a singular matrix,
4579 an error is signalled by default. However, if <code>#f</code> is given
4580 to the optional <var>error-on-singular?</var> argument,
4581 <code>#f</code> is returned in such a case.
4582 </p></dd></dl>
4583
4584 <dl>
4585 <dt><a name="index-translation_002d_003ematrix4f"></a><u>Function:</u> <b>translation-&gt;matrix4f</b><i> translation-vector</i></dt>
4586 <dt><a name="index-translation_002d_003ematrix4f_0021"></a><u>Function:</u> <b>translation-&gt;matrix4f!</b><i> m translation-vector</i></dt>
4587 <dd><p>Returns a matrix which represents a translation by <var>translation-vector</var>,
4588 which must be either a vector4f, a point4f, or
4589 a f32vector of length 3 or 4. Only the first three elements
4590 in <var>translation-vector</var> is used.
4591 The destructive version updates <var>m</var>.
4592 </p></dd></dl>
4593
4594 <dl>
4595 <dt><a name="index-rotation_002d_003ematrix4f"></a><u>Function:</u> <b>rotation-&gt;matrix4f</b><i> axis angle</i></dt>
4596 <dt><a name="index-rotation_002d_003ematrix4f_0021"></a><u>Function:</u> <b>rotation-&gt;matrix4f!</b><i> m axis angle</i></dt>
4597 <dd><p>Returns a matrix which represents a rotation around
4598 <var>axis</var> by <var>angle</var> radian. <var>Axis</var> must be
4599 a vector4f or a f32vector of length 3 or 4, and must be normalized.
4600 The result is undefined if anormalized vector is passed as <var>axis</var>.
4601 The destructive version updates <var>m</var>.
4602 </p></dd></dl>
4603
4604 <dl>
4605 <dt><a name="index-scale_002d_003ematrix4f"></a><u>Function:</u> <b>scale-&gt;matrix4f</b><i> scale-vector</i></dt>
4606 <dt><a name="index-scale_002d_003ematrix4f_0021"></a><u>Function:</u> <b>scale-&gt;matrix4f!</b><i> m scale-vector</i></dt>
4607 <dd><p>Returns a matrix which represents a scale by <var>scale-vector</var>,
4608 which must be either a vector4f, a point4f, or
4609 a f32vector of length 3 or 4. Only the first three elements
4610 in <var>scale-vector</var> is used. Each element of <var>scale-vector</var>
4611 represents the scale factor along x, y, and z axis.
4612 The destructive version updates <var>m</var>.
4613 </p></dd></dl>
4614
4615 <dl>
4616 <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>
4617 <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>
4618 <dd><p>This combines above three procedure.
4619 Returns a matrix that represents translation, rotation and
4620 scale, specified by <var>translation</var>, <var>rotation-axis</var>,
4621 <var>rotation-angle</var> and <var>scale</var>.
4622 The destructive version updates <var>m</var>.
4623 </p>
4624 <p>If <code><i>T</i></code>, <code><i>R</i></code> and <code><i>S</i></code>, are
4625 the matrices that represent translation, rotation and scale, respectively,
4626 then these procedures effectively calculates
4627 a matrix <code><i>TRS</i></code>.
4628 </p></dd></dl>
4629
4630 <dl>
4631 <dt><a name="index-tqs_002d_003ematrix4f"></a><u>Function:</u> <b>tqs-&gt;matrix4f</b><i> translation rotation-quat scale</i></dt>
4632 <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>
4633 <dd><p>A variation of <code>trs-&gt;matrix4f</code>. Instead of axis and angle,
4634 rotation is represented by a quaternion <var>rotation-quat</var>.
4635 See section <a href="#Quaternions">Quaternions</a>, for more details about quaternions.
4636 </p></dd></dl>
4637
4638 <dl>
4639 <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>
4640 <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>
4641 <dd><p>Returns a matrix that represents rotation along x, y and z axis
4642 by <var>xangle</var>, <var>yangle</var>, and <var>zangle</var>, respectively.
4643 </p>
4644 <p>The order of rotation can be specified by the optional argument
4645 <var>order</var>, which may be one of the symbols <code>xyz</code>, <code>xzy</code>,
4646 <code>yzx</code>, <code>yxz</code>, <code>zxy</code>, or <code>zyx</code>. For example,
4647 symbol <code>xyz</code> means rotation around x-axis, then y-axis, then
4648 z-axis. Thus, if we write each rotation as <i>Rx</i>, <i>Ry</i>, and
4649 <i>Rz</i>, the returned matrix is <i>RzRyRx</i>.
4650 The default value of <var>order</var> is <code>xyz</code>.
4651 </p>
4652 <p>The desrtuctive version modifies <var>m</var>.
4653 </p></dd></dl>
4654
4655 <dl>
4656 <dt><a name="index-matrix4f_002ddecompose"></a><u>Function:</u> <b>matrix4f-decompose</b><i> m</i></dt>
4657 <dd><p>Matrix <var>m</var> is a composition of translation, rotation, shear and
4658 scale. Suppose transformation is applied in the reverse order.
4659 This procedure decompose <var>m</var> into each individual transformation.
4660 </p>
4661 <p>Returns five values.
4662 </p><ul>
4663 <li>
4664 A flag to indicate if <var>m</var> is non-singular.
4665 </li><li>
4666 A translation vector <var>t</var>, in vector4f. The first three elements
4667 of <var>t</var> are for x, y, and z translations.
4668 </li><li>
4669 A rotation matrix <var>r</var>, in matrix4f.
4670 This is an orthogonal matrix represents rotation component.
4671 </li><li>
4672 A shear vector <var>h</var>, in vector4f. The first three elements
4673 of <var>h</var> are for xy, xz and yz shear factors.
4674 </li><li>
4675 A scale vector <var>s</var>, in vector4f. The first three elements
4676 of <var>s</var> are fof x, y, and z scale factors.
4677 </li></ul>
4678
4679 <p>If <var>m</var> is singular, certain part of rotation matrix can&rsquo;t
4680 be recovered. In such a case, <var>r</var> becomes also singular matrix.
4681 </p>
4682 <p>If the original matrix has negative scale factor in any of
4683 x, y, or z scale, the decomposed scale factor will have all negative
4684 components. The signs of elements of <var>r</var> are adjusted accordingly.
4685 </p>
4686 <p>Due to the precision errors,
4687 you will see small values appear in shear component even <var>m</var> is
4688 pure TRS matrix.
4689 </p></dd></dl>
4690
4691 <dl>
4692 <dt><a name="index-matrix4f_002ddecompose_0021"></a><u>Function:</u> <b>matrix4f-decompose!</b><i> m t r h s</i></dt>
4693 <dd><p>Linear update version of <code>matrix4f-decompose</code>.
4694 The result vectors and matrices are stored in <var>t</var>, <var>r</var>, <var>h</var>
4695 and <var>s</var>. The return value is a boolean value indicates
4696 <var>m</var> is non-singular or not.
4697 </p></dd></dl>
4698
4699 <dl>
4700 <dt><a name="index-matrix4f_002d_003etranslation"></a><u>Function:</u> <b>matrix4f-&gt;translation</b><i> m</i></dt>
4701 <dd><p>Extract the translation component from the given TRS matrix <var>m</var>
4702 and returns it as a <code>&lt;vector4f&gt;</code>.
4703 </p></dd></dl>
4704
4705 <dl>
4706 <dt><a name="index-matrix4f_002d_003etranslation_0021"></a><u>Function:</u> <b>matrix4f-&gt;translation!</b><i> v m</i></dt>
4707 <dd><p>Extract the translation component from the given TRS matrix <var>m</var>
4708 and stores the result into a <code>&lt;vector4f&gt;</code> <var>v</var>.
4709 Returns <var>v</var>.
4710 </p></dd></dl>
4711
4712 <dl>
4713 <dt><a name="index-matrix4f_002d_003erotation"></a><u>Function:</u> <b>matrix4f-&gt;rotation</b><i> m</i></dt>
4714 <dd><p>From given orthogonal matrix <var>m</var>, extracts and returns
4715 and rotation axis and angle, as a vector4f and a real number.
4716 </p></dd></dl>
4717
4718 <dl>
4719 <dt><a name="index-matrix4f_002d_003erotation_0021"></a><u>Function:</u> <b>matrix4f-&gt;rotation!</b><i> v m</i></dt>
4720 <dd><p>Same as above, except the storage of vector4f <var>v</var> is reused
4721 to store the result axis.
4722 </p></dd></dl>
4723
4724 <hr size="6">
4725 <a name="Quaternions"></a>
4726 <table cellpadding="1" cellspacing="1" border="0">
4727 <tr><td valign="middle" align="left">[<a href="#Matrices" title="Previous section in reading order"> &lt; </a>]</td>
4728 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Next section in reading order"> &gt; </a>]</td>
4729 <td valign="middle" align="left"> &nbsp; </td>
4730 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
4731 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Up section"> Up </a>]</td>
4732 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Next chapter"> &gt;&gt; </a>]</td>
4733 <td valign="middle" align="left"> &nbsp; </td>
4734 <td valign="middle" align="left"> &nbsp; </td>
4735 <td valign="middle" align="left"> &nbsp; </td>
4736 <td valign="middle" align="left"> &nbsp; </td>
4737 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
4738 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
4739 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
4740 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
4741 </tr></table>
4742 <a name="Quaternions-1"></a>
4743 <h2 class="section">6.4 Quaternions</h2>
4744
4745 <dl>
4746 <dt><a name="index-_003cquatf_003e"></a><u>Class:</u> <b>&lt;quatf&gt;</b></dt>
4747 <dd><a name="index-quatf"></a>
4748 <p>Quaternions. Internally quaternions are represented as just
4749 an array of four floats; the first three are the vector component
4750 and the last is the scalar component.
4751 </p>
4752 <p>Inherits <code>&lt;sequence&gt;</code> and <code>&lt;collection&gt;</code>. When viewed
4753 as sequence, it is just like a vector of four floats.
4754 </p></dd></dl>
4755
4756 <dl>
4757 <dt><a name="index-quatf_003f"></a><u>Function:</u> <b>quatf?</b><i> obj</i></dt>
4758 <dd><p>Returns true iff <var>obj</var> is a quaternion.
4759 </p></dd></dl>
4760
4761 <dl>
4762 <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>
4763 <dd><p>External representation of quaternion
4764 <i>x</i><b>i</b>+<i>y</i><b>j</b>+<i>z</i><b>k</b>+<i>w</i>.
4765 </p></dd></dl>
4766
4767 <dl>
4768 <dt><a name="index-make_002dquatf"></a><u>Function:</u> <b>make-quatf</b><i> &amp;optional axis (angle 0)</i></dt>
4769 <dd><p>Returns a new unit quaternion that represents a rotation
4770 around vector <var>axis</var> by <var>angle</var> radians.
4771 <var>Axis</var> can be a vector4f, a point4f or
4772 a f32vector (only first three component is used).
4773 <var>Axis</var> must be a unit vector; if <var>axis</var> is anormalized,
4774 the result is undefined.
4775 </p>
4776 <p>If both <var>axis</var> and <var>angle</var> is omitted,
4777 <code>#,(quatf 0 0 0 1)</code> is returned.
4778 </p></dd></dl>
4779
4780 <dl>
4781 <dt><a name="index-quatf-1"></a><u>Function:</u> <b>quatf</b><i> x y z w</i></dt>
4782 <dd><p>Returns a new quaternion whose elements are initialized by
4783 <var>x</var>, <var>y</var>, <var>z</var>, <var>w</var>.
4784 </p></dd></dl>
4785
4786 <dl>
4787 <dt><a name="index-list_002d_003equatf"></a><u>Function:</u> <b>list-&gt;quatf</b><i> l</i></dt>
4788 <dt><a name="index-quatf_002d_003elist"></a><u>Function:</u> <b>quatf-&gt;list</b><i> q</i></dt>
4789 <dd><p>Converts between a list of four real numbers and a quaternion.
4790 </p></dd></dl>
4791
4792 <dl>
4793 <dt><a name="index-f32vector_002d_003equatf"></a><u>Function:</u> <b>f32vector-&gt;quatf</b><i> x &amp;optional start</i></dt>
4794 <dd><p>Returns a new quaternion whose elements are initialized by
4795 the first four elements of f32vector <var>x</var>.
4796 If <var>start</var> is given, the initial value is taken
4797 starting from <var>start</var>-th index in <var>x</var>.
4798 </p></dd></dl>
4799
4800 <dl>
4801 <dt><a name="index-quatf_002d_003ef32vector"></a><u>Function:</u> <b>quatf-&gt;f32vector</b><i> q</i></dt>
4802 <dd><p>Returns a new f32vector whose contents is the same as a quaternion <var>q</var>.
4803 </p></dd></dl>
4804
4805 <dl>
4806 <dt><a name="index-quatf_002dcopy"></a><u>Function:</u> <b>quatf-copy</b><i> q</i></dt>
4807 <dd><p>Returns a fresh copy of a quaternion <var>q</var>.
4808 </p></dd></dl>
4809
4810 <dl>
4811 <dt><a name="index-quatf_002dcopy_0021"></a><u>Function:</u> <b>quatf-copy!</b><i> dstq srcq</i></dt>
4812 <dd><p>Copies contents of a quaternion <var>srcq</var> to a quaternion <var>dstq</var>.
4813 </p></dd></dl>
4814
4815 <dl>
4816 <dt><a name="index-rotation_002d_003equatf_0021"></a><u>Function:</u> <b>rotation-&gt;quatf!</b><i> quat axis angle</i></dt>
4817 <dd><p>Sets a quaternion <var>quat</var> so that it represents a rotation
4818 around a unit vector <var>axis</var> by angle <var>angle</var> radians.
4819 <var>Axis</var> can be a vector4f, a point4f or
4820 a f32vector (only first three component is used).
4821 </p></dd></dl>
4822
4823 <dl>
4824 <dt><a name="index-vectors_002d_003equatf"></a><u>Function:</u> <b>vectors-&gt;quatf</b><i> v w</i></dt>
4825 <dt><a name="index-vectors_002d_003equatf_0021"></a><u>Function:</u> <b>vectors-&gt;quatf!</b><i> q v w</i></dt>
4826 <dd><p>Given two unit vectors <var>v</var> and <var>w</var>, calculates and returns
4827 a quaternion that represents a rotation from <var>v</var> to <var>w</var>.
4828 The destructive version <code>vectors-&gt;quatf!</code> modifies <var>q</var>.
4829 </p></dd></dl>
4830
4831 <dl>
4832 <dt><a name="index-axes_002d_003equatf"></a><u>Function:</u> <b>axes-&gt;quatf</b><i> v1 v2 w1 w2</i></dt>
4833 <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>
4834 <dd><p>The arguments must be all unit vectors,
4835 <var>v1</var> and <var>v2</var> must be perpendicular,
4836 and also <var>w1</var> and <var>w2</var> must be perpendicular.
4837 </p>
4838 <p>Calculates and returns a quaternion that represents a rotation
4839 which transforms <var>v1</var> to <var>w1</var>, and <var>v2</var> to <var>w2</var>,
4840 respectively. The destructive version stores the result
4841 into <var>q</var>.
4842 </p></dd></dl>
4843
4844 <dl>
4845 <dt><a name="index-quatf_002dadd"></a><u>Function:</u> <b>quatf-add</b><i> p q</i></dt>
4846 <dt><a name="index-quatf_002dadd_0021"></a><u>Function:</u> <b>quatf-add!</b><i> p q</i></dt>
4847 <dt><a name="index-quatf_002dsub"></a><u>Function:</u> <b>quatf-sub</b><i> p q</i></dt>
4848 <dt><a name="index-quatf_002dsub_0021"></a><u>Function:</u> <b>quatf-sub!</b><i> p q</i></dt>
4849 <dd><p>Addition and subtraction of quaternions. The destructive version
4850 modifies the first argument.
4851 </p></dd></dl>
4852
4853 <dl>
4854 <dt><a name="index-quatf_002dscale"></a><u>Function:</u> <b>quatf-scale</b><i> q s</i></dt>
4855 <dt><a name="index-quatf_002dscale_0021"></a><u>Function:</u> <b>quatf-scale!</b><i> q s</i></dt>
4856 <dd><p>Multiplies a quaternion <var>q</var> by a scalar value <var>s</var>.
4857 The destructive version modifies <var>q</var>.
4858 </p></dd></dl>
4859
4860 <dl>
4861 <dt><a name="index-quatf_002dmul"></a><u>Function:</u> <b>quatf-mul</b><i> p q</i></dt>
4862 <dt><a name="index-quatf_002dmul_0021"></a><u>Function:</u> <b>quatf-mul!</b><i> p q</i></dt>
4863 <dd><p>Multiply two quaternions <var>p</var> and <var>q</var>.
4864 The destructive version modifies <var>p</var> as well.
4865 </p></dd></dl>
4866
4867 <dl>
4868 <dt><a name="index-quatf_002dconjugate"></a><u>Function:</u> <b>quatf-conjugate</b><i> p</i></dt>
4869 <dt><a name="index-quatf_002dconjugate_0021"></a><u>Function:</u> <b>quatf-conjugate!</b><i> q p</i></dt>
4870 <dd><p>Returns a conjugate of a quaternion <var>p</var>.
4871 The destructive version modifies <var>q</var> as well.
4872 </p></dd></dl>
4873
4874 <dl>
4875 <dt><a name="index-quatf_002dtransform"></a><u>Function:</u> <b>quatf-transform</b><i> q p</i></dt>
4876 <dd><p>Transforms a vector or a point <var>p</var> by quaternion <var>q</var>,
4877 that is, returns <var>qpq*</var>, where <var>q*</var> is a conjugate of <var>q</var>.
4878 </p>
4879 <p>This procedure assumes <var>q</var> is normalized.
4880 </p>
4881 <p><var>P</var> can be a vector4f, a point4f or a f32vector
4882 (only first three elements are used).
4883 Returns the same type of object as <var>p</var>.
4884 </p></dd></dl>
4885
4886 <dl>
4887 <dt><a name="index-quatf_002dnorm"></a><u>Function:</u> <b>quatf-norm</b><i> q</i></dt>
4888 <dd><p>Returns norm of <var>q</var>.
4889 </p></dd></dl>
4890
4891 <dl>
4892 <dt><a name="index-quatf_002dnormalize"></a><u>Function:</u> <b>quatf-normalize</b><i> q</i></dt>
4893 <dt><a name="index-quatf_002dnormalize_0021"></a><u>Function:</u> <b>quatf-normalize!</b><i> q</i></dt>
4894 <dd><p>Returns normalized quaternion of <var>q</var>.
4895 The destructive version modifies <var>q</var>.
4896 </p></dd></dl>
4897
4898 <dl>
4899 <dt><a name="index-quatf_002d_003ematrix4f"></a><u>Function:</u> <b>quatf-&gt;matrix4f</b><i> q</i></dt>
4900 <dt><a name="index-quatf_002d_003ematrix4f_0021"></a><u>Function:</u> <b>quatf-&gt;matrix4f!</b><i> m q</i></dt>
4901 <dd><p>Returns a matrix that represents a rotation specified by a unit
4902 quaternion <var>q</var>.
4903 The behavior is undefined if <var>q</var> is not normalized.
4904 The destructive version modifies <var>m</var>.
4905 </p></dd></dl>
4906
4907 <dl>
4908 <dt><a name="index-matrix4f_002d_003equatf"></a><u>Function:</u> <b>matrix4f-&gt;quatf</b><i> m</i></dt>
4909 <dt><a name="index-matrix4f_002d_003equatf_0021"></a><u>Function:</u> <b>matrix4f-&gt;quatf!</b><i> q m</i></dt>
4910 <dd><p>Extracts the rotation component of a matrix <var>m</var> and
4911 returns a quaterion that represents the rotation.
4912 <code>Matrix4f-&gt;quatf!</code> also uses <var>q</var> as the storage
4913 to store the result.
4914 </p></dd></dl>
4915
4916 <dl>
4917 <dt><a name="index-quatf_002dslerp"></a><u>Function:</u> <b>quatf-slerp</b><i> p q t</i></dt>
4918 <dt><a name="index-quatf_002dslerp_0021"></a><u>Function:</u> <b>quatf-slerp!</b><i> r p q t</i></dt>
4919 <dd><p>Returns a quaternion that interpolates between two
4920 unit quaternions <var>p</var> and <var>q</var>, by a scalar value <var>t</var>.
4921 The destructive version modifies <var>r</var>.
4922 </p></dd></dl>
4923
4924 <hr size="6">
4925 <a name="Simple-utilities"></a>
4926 <table cellpadding="1" cellspacing="1" border="0">
4927 <tr><td valign="middle" align="left">[<a href="#Quaternions" title="Previous section in reading order"> &lt; </a>]</td>
4928 <td valign="middle" align="left">[<a href="#Simple-image-handling" title="Next section in reading order"> &gt; </a>]</td>
4929 <td valign="middle" align="left"> &nbsp; </td>
4930 <td valign="middle" align="left">[<a href="#Vectors-and-matrices" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
4931 <td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
4932 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Next chapter"> &gt;&gt; </a>]</td>
4933 <td valign="middle" align="left"> &nbsp; </td>
4934 <td valign="middle" align="left"> &nbsp; </td>
4935 <td valign="middle" align="left"> &nbsp; </td>
4936 <td valign="middle" align="left"> &nbsp; </td>
4937 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
4938 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
4939 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
4940 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
4941 </tr></table>
4942 <a name="Simple-utilities-1"></a>
4943 <h1 class="chapter">7. Simple utilities</h1>
4944
4945 <p>This chapter covers <code>gl.simple.*</code> modules. They are
4946 provided for the convenience of those who wants quick experiment
4947 with Gauche-gl alone, without a hassle to install a bunch of
4948 other modules. Their features are pretty limited, but you
4949 may find them handy when you need to hack up some throwaway
4950 script that need to show some graphics on the screen.
4951 </p>
4952 <table class="menu" border="0" cellspacing="0">
4953 <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">
4954 </td></tr>
4955 <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">
4956 </td></tr>
4957 </table>
4958
4959 <hr size="6">
4960 <a name="Simple-image-handling"></a>
4961 <table cellpadding="1" cellspacing="1" border="0">
4962 <tr><td valign="middle" align="left">[<a href="#Simple-utilities" title="Previous section in reading order"> &lt; </a>]</td>
4963 <td valign="middle" align="left">[<a href="#Simple-viewer" title="Next section in reading order"> &gt; </a>]</td>
4964 <td valign="middle" align="left"> &nbsp; </td>
4965 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
4966 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Up section"> Up </a>]</td>
4967 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Next chapter"> &gt;&gt; </a>]</td>
4968 <td valign="middle" align="left"> &nbsp; </td>
4969 <td valign="middle" align="left"> &nbsp; </td>
4970 <td valign="middle" align="left"> &nbsp; </td>
4971 <td valign="middle" align="left"> &nbsp; </td>
4972 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
4973 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
4974 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
4975 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
4976 </tr></table>
4977 <a name="Simple-image-handling-1"></a>
4978 <h2 class="section">7.1 Simple image handling</h2>
4979
4980 <dl>
4981 <dt><a name="index-gl_002esimple_002eimage"></a><u>Module:</u> <b>gl.simple.image</b></dt>
4982 <dd><a name="index-gl_002esimple_002eimage-1"></a>
4983 <p>OpenGL doesn&rsquo;t provide any means of reading/writing image data, and
4984 it should be covered by other Gauche extensions. However,
4985 it is sometimes handy to have simple means to handle external
4986 image data, so that you can do some experiment with Gauche-gl alone.
4987 </p>
4988 <p>This module provides a minimal support to handle external image
4989 data, so that one can do some experiment in Gauche-gl alone.
4990 </p>
4991 <p>The functionality might be extended over time, but this is never
4992 intended to be a full featured image library. A separate Gauche
4993 extension should be a better place to have it.
4994 </p></dd></dl>
4995
4996 <p>Currently, only reading from 8bit SGI image file is supported.
4997 It is written in pure Scheme, so don&rsquo;t expect the performance.
4998 </p>
4999 <dl>
5000 <dt><a name="index-read_002dsgi_002dimage"></a><u>Function:</u> <b>read-sgi-image</b><i> filename</i></dt>
5001 <dt><a name="index-read_002dsgi_002dimage_002dfrom_002dport"></a><u>Function:</u> <b>read-sgi-image-from-port</b><i> port</i></dt>
5002 <dd><p>Reads an image data in SGI format from the named file or the input port,
5003 respectively.
5004 </p>
5005 <p>Only 8bit-per-channel, direct color mode is supported.
5006 </p>
5007 <p>Returns four values: the image&rsquo;s width in pixels, its height in pixels,
5008 number of channels (e.g. 1 for grayscale, 3 for RGB, 4 for RGBA),
5009 and the image data in u8vector. The pixel data is packed, i.e. there&rsquo;s
5010 no padding between each pixel nor each scanline.
5011 </p>
5012 <p>Warning: be careful to call this function interactively. The
5013 image data vector is usually huge, and you have to wait long
5014 for the REPL to display the entire result.
5015 </p></dd></dl>
5016
5017 <hr size="6">
5018 <a name="Simple-viewer"></a>
5019 <table cellpadding="1" cellspacing="1" border="0">
5020 <tr><td valign="middle" align="left">[<a href="#Simple-image-handling" title="Previous section in reading order"> &lt; </a>]</td>
5021 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Next section in reading order"> &gt; </a>]</td>
5022 <td valign="middle" align="left"> &nbsp; </td>
5023 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
5024 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Up section"> Up </a>]</td>
5025 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Next chapter"> &gt;&gt; </a>]</td>
5026 <td valign="middle" align="left"> &nbsp; </td>
5027 <td valign="middle" align="left"> &nbsp; </td>
5028 <td valign="middle" align="left"> &nbsp; </td>
5029 <td valign="middle" align="left"> &nbsp; </td>
5030 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
5031 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
5032 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
5033 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
5034 </tr></table>
5035 <a name="Simple-viewer-1"></a>
5036 <h2 class="section">7.2 Simple viewer</h2>
5037
5038 <dl>
5039 <dt><a name="index-gl_002esimple_002eviewer"></a><u>Module:</u> <b>gl.simple.viewer</b></dt>
5040 <dd><a name="index-gl_002esimple_002eviewer-1"></a>
5041 <p>This module packages common operations to allow users to
5042 view 3D objects, controlling the camera by the mouse,
5043 and have some interactions with the keyboard.
5044 </p>
5045 <p>A typical way of using the viewer is like the following:
5046 </p>
5047 <table><tr><td>&nbsp;</td><td><pre class="example">(use gl)
5048 (use gl.glut)
5049 (use gl.simple.viewer)
5050
5051 (define (main args)
5052 (glut-init args)
5053 (simple-viewer-display &lt;your-display-thunk&gt;)
5054 (simple-viewer-set-key! &lt;key&gt; &lt;handler&gt; ...)
5055 (simple-viewer-window &lt;name&gt; :title &lt;title&gt; ...)
5056 (simple-viewer-run) ; loop forever. type ESC to exit.
5057 0)
5058 </pre></td></tr></table>
5059
5060 <p>The viewer handles mouse drag (to move the camera),
5061 and also draws reference grid and axes by default for
5062 your convenience. You have to provide a thunk, which
5063 must draw your 3D object.
5064 </p>
5065 <p>For the keyboard events, you can use a convenient API
5066 to associate handler to the key (character for normal keys,
5067 and constants like <code>GL_LEFT_ARROW</code> for special keys).
5068 </p>
5069 <p>The reshape event is handled implicitly, though you can
5070 override it.
5071 </p>
5072 <p>If you call <code>simple-viewer-run</code>, it enters the event
5073 loop and never returns. If you wish to keep REPL and/or
5074 other parts of your application run concurrently,
5075 the convenient way is to run <code>simple-viewer-run</code>
5076 in a separate thread.
5077 </p>
5078 <table><tr><td>&nbsp;</td><td><pre class="example">(use gauche.threads)
5079
5080 (define (run-viewer)
5081 (thread-start! (make-thread simple-viewer-run #f)))
5082 </pre></td></tr></table>
5083
5084 <p>See also the code under &lsquo;<tt>examples/simple</tt>&rsquo; directory
5085 of the source tree for more examples.
5086 </p></dd></dl>
5087
5088 <dl>
5089 <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>
5090 <dd><p>Creates a new GL window with <var>name</var>, which must be a symbol
5091 to identify the window later in the simple viewer framework.
5092 The window won&rsquo;t be shown until <code>simple-viewer-run</code> is called.
5093 </p>
5094 <p>Each window
5095 </p></dd></dl>
5096
5097
5098 <dl>
5099 <dt><a name="index-simple_002dviewer_002ddisplay"></a><u>Function:</u> <b>simple-viewer-display</b><i> &amp;optional display-thunk</i></dt>
5100 <dd><p>Gets/sets the display thunk, which is called every time
5101 the GL window is redrawn. You can change the display thunk
5102 any time, even while the viewer thread is running.
5103 </p>
5104 <p>If no argument is given, returns the current display thunk.
5105 It can be <code>#f</code> if no display thunk is set.
5106 </p>
5107 <p>When the display thunk is called, the matrix mode is
5108 <code>MODELVIEW</code> and the camera transformation is already applied.
5109 The grid and axes are also drawn, unless you&rsquo;ve customized them.
5110 </p>
5111 <p>In the display thunk you can just write your model in the
5112 world coordinate system. It is guaranteed that
5113 the current color is white and line width is 1.0, but
5114 the states of other GL contexts are undefined,
5115 so you have to set them explicitly.
5116 </p></dd></dl>
5117
5118 <dl>
5119 <dt><a name="index-simple_002dviewer_002dreshape"></a><u>Function:</u> <b>simple-viewer-reshape</b><i> &amp;optional reshape-proc</i></dt>
5120 <dd><p>Gets/sets the reshape procedure which is called every
5121 time the GL window configuration is changed. (It is
5122 also called when the GL window is shown first time.)
5123 You can change the reshape procedure any time,
5124 even while the viewer thread is running.
5125 </p>
5126 <p>If no argument is given, returns the current reshape proc.
5127 </p>
5128 <p>A reshape procedure is called with two arguments,
5129 the width and the height (in pixels) of the new GL
5130 window configuration. By default, <code>gl.simple.viewer</code>
5131 sets a procedure that changes viewport and
5132 projection matrix apopropriately; you need to change
5133 it only if you want a different behavior.
5134 </p></dd></dl>
5135
5136 <dl>
5137 <dt><a name="index-simple_002dviewer_002dgrid"></a><u>Function:</u> <b>simple-viewer-grid</b><i> &amp;optional grid-proc</i></dt>
5138 <dt><a name="index-simple_002dviewer_002daxis"></a><u>Function:</u> <b>simple-viewer-axis</b><i> &amp;optional axis-proc</i></dt>
5139 <dd><p>Gets/sets a procedure to draw a grid and axes.
5140 You can change these procedures
5141 any time, even while the viewer thread is running.
5142 </p>
5143 <p>The <var>grid-proc</var> and <var>axis-proc</var> are called with no arguments
5144 every time the GL window is redrawn, before the display thunk
5145 is invoked.
5146 The matrix mode is <code>MODELVIEW</code>, the camera transformation
5147 is already applied, and lighting is disabled.
5148 </p>
5149 <p>The default grid proc draws 10x10 grid
5150 on X-Z plane centered at the origin. The default axis proc
5151 draws a red line from origin to +X, a green line from origin to +Y,
5152 and a blue line from origin to +Z.
5153 </p>
5154 <p>You can pass <code>#f</code> to disable grid and/or axis display.
5155 </p>
5156 <p>If no argument is given, returns the current grid/axis proc,
5157 respectively.
5158 </p></dd></dl>
5159
5160 <dl>
5161 <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>
5162 <dd><p>Even number of arguments must be given; the first of
5163 every two specifies the key, and the next one
5164 specifies the action when the key is pressed.
5165 </p></dd></dl>
5166
5167
5168
5169
5170
5171 <hr size="6">
5172 <a name="g_t_00e7_00b4_00a2_00e5_00bc_0095"></a>
5173 <table cellpadding="1" cellspacing="1" border="0">
5174 <tr><td valign="middle" align="left">[<a href="#Simple-viewer" title="Previous section in reading order"> &lt; </a>]</td>
5175 <td valign="middle" align="left">[<a href="#g_t_00e6_0089_008b_00e7_00b6_009a_00e3_0081_008d_00e3_0081_00a8_00e6_00a7_008b_00e6_0096_0087_00e7_00b4_00a2_00e5_00bc_0095" title="Next section in reading order"> &gt; </a>]</td>
5176 <td valign="middle" align="left"> &nbsp; </td>
5177 <td valign="middle" align="left">[<a href="#Simple-utilities" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
5178 <td valign="middle" align="left">[<a href="#Top" title="Up section"> Up </a>]</td>
5179 <td valign="middle" align="left">[ &gt;&gt; ]</td>
5180 <td valign="middle" align="left"> &nbsp; </td>
5181 <td valign="middle" align="left"> &nbsp; </td>
5182 <td valign="middle" align="left"> &nbsp; </td>
5183 <td valign="middle" align="left"> &nbsp; </td>
5184 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
5185 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
5186 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
5187 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
5188 </tr></table>
5189 <a name="c_00b4_00a2aa_00bc_0095"></a>
5190 <h1 class="appendix">A. 索引</h1>
5191
5192 <table class="menu" border="0" cellspacing="0">
5193 <tr><td align="left" valign="top"><a href="#g_t_00e6_0089_008b_00e7_00b6_009a_00e3_0081_008d_00e3_0081_00a8_00e6_00a7_008b_00e6_0096_0087_00e7_00b4_00a2_00e5_00bc_0095">A.1 手続きと構文索引</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
5194 <tr><td align="left" valign="top"><a href="#g_t_00e3_0083_00a2_00e3_0082_00b8_00e3_0083_00a5_00e3_0083_00bc_00e3_0083_00ab_00e7_00b4_00a2_00e5_00bc_0095">A.2 モジュール索引</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
5195 <tr><td align="left" valign="top"><a href="#g_t_00e3_0082_00af_00e3_0083_00a9_00e3_0082_00b9_00e7_00b4_00a2_00e5_00bc_0095">A.3 クラス索引</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
5196 <tr><td align="left" valign="top"><a href="#g_t_00e5_00a4_0089_00e6_0095_00b0_00e7_00b4_00a2_00e5_00bc_0095">A.4 変数索引</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"></td></tr>
5197 </table>
5198
5199 <hr size="6">
5200 <a name="g_t_00e6_0089_008b_00e7_00b6_009a_00e3_0081_008d_00e3_0081_00a8_00e6_00a7_008b_00e6_0096_0087_00e7_00b4_00a2_00e5_00bc_0095"></a>
5201 <table cellpadding="1" cellspacing="1" border="0">
5202 <tr><td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Previous section in reading order"> &lt; </a>]</td>
5203 <td valign="middle" align="left">[<a href="#g_t_00e3_0083_00a2_00e3_0082_00b8_00e3_0083_00a5_00e3_0083_00bc_00e3_0083_00ab_00e7_00b4_00a2_00e5_00bc_0095" title="Next section in reading order"> &gt; </a>]</td>
5204 <td valign="middle" align="left"> &nbsp; </td>
5205 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
5206 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Up section"> Up </a>]</td>
5207 <td valign="middle" align="left">[ &gt;&gt; ]</td>
5208 <td valign="middle" align="left"> &nbsp; </td>
5209 <td valign="middle" align="left"> &nbsp; </td>
5210 <td valign="middle" align="left"> &nbsp; </td>
5211 <td valign="middle" align="left"> &nbsp; </td>
5212 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
5213 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
5214 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
5215 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
5216 </tr></table>
5217 <a name="ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095"></a>
5218 <h2 class="appendixsec">A.1 手続きと構文索引</h2>
5219 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-A" class="summary-letter"><b>A</b></a>
5220 &nbsp;
5221 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-E" class="summary-letter"><b>E</b></a>
5222 &nbsp;
5223 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-F" class="summary-letter"><b>F</b></a>
5224 &nbsp;
5225 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-G" class="summary-letter"><b>G</b></a>
5226 &nbsp;
5227 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-L" class="summary-letter"><b>L</b></a>
5228 &nbsp;
5229 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-M" class="summary-letter"><b>M</b></a>
5230 &nbsp;
5231 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-P" class="summary-letter"><b>P</b></a>
5232 &nbsp;
5233 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-Q" class="summary-letter"><b>Q</b></a>
5234 &nbsp;
5235 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-R" class="summary-letter"><b>R</b></a>
5236 &nbsp;
5237 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-S" class="summary-letter"><b>S</b></a>
5238 &nbsp;
5239 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-T" class="summary-letter"><b>T</b></a>
5240 &nbsp;
5241 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-V" class="summary-letter"><b>V</b></a>
5242 &nbsp;
5243 </td></tr></table>
5244 <table border="0" class="index-fn">
5245 <tr><td></td><th align="left">Index Entry</th><th align="left"> Section</th></tr>
5246 <tr><td colspan="3"> <hr></td></tr>
5247 <tr><th><a name="ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-A">A</a></th><td></td><td></td></tr>
5248 <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>
5249 <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>
5250 <tr><td colspan="3"> <hr></td></tr>
5251 <tr><th><a name="ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-E">E</a></th><td></td><td></td></tr>
5252 <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>
5253 <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>
5254 <tr><td colspan="3"> <hr></td></tr>
5255 <tr><th><a name="ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-F">F</a></th><td></td><td></td></tr>
5256 <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>
5257 <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>
5258 <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>
5259 <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>
5260 <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>
5261 <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>
5262 <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>
5263 <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>
5264 <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>
5265 <tr><td colspan="3"> <hr></td></tr>
5266 <tr><th><a name="ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-G">G</a></th><td></td><td></td></tr>
5267 <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>
5268 <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>
5269 <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>
5270 <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>
5271 <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>
5272 <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>
5273 <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>
5274 <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>
5275 <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>
5276 <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>
5277 <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>
5278 <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>
5279 <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>
5280 <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>
5281 <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>
5282 <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>
5283 <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>
5284 <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>
5285 <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>
5286 <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>
5287 <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>
5288 <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>
5289 <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>
5290 <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>
5291 <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>
5292 <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>
5293 <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>
5294 <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>
5295 <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>
5296 <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>
5297 <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>
5298 <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>
5299 <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>
5300 <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>
5301 <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>
5302 <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>
5303 <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>
5304 <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>
5305 <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>
5306 <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>
5307 <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>
5308 <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>
5309 <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>
5310 <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>
5311 <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>
5312 <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>
5313 <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>
5314 <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>
5315 <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>
5316 <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>
5317 <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>
5318 <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>
5319 <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>
5320 <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>
5321 <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>
5322 <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>
5323 <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>
5324 <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>
5325 <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>
5326 <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>
5327 <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>
5328 <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>
5329 <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>
5330 <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>
5331 <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>
5332 <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>
5333 <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>
5334 <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>
5335 <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>
5336 <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>
5337 <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>
5338 <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>
5339 <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>
5340 <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>
5341 <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>
5342 <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>
5343 <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>
5344 <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>
5345 <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>
5346 <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>
5347 <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>
5348 <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>
5349 <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>
5350 <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>
5351 <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>
5352 <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>
5353 <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>
5354 <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>
5355 <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>
5356 <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>
5357 <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>
5358 <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>
5359 <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>
5360 <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>
5361 <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>
5362 <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>
5363 <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>
5364 <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>
5365 <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>
5366 <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>
5367 <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>
5368 <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>
5369 <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>
5370 <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>
5371 <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>
5372 <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>
5373 <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>
5374 <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>
5375 <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>
5376 <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>
5377 <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>
5378 <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>
5379 <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>
5380 <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>
5381 <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>
5382 <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>
5383 <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>
5384 <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>
5385 <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>
5386 <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>
5387 <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>
5388 <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>
5389 <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>
5390 <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>
5391 <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>
5392 <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>
5393 <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>
5394 <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>
5395 <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>
5396 <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>
5397 <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>
5398 <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>
5399 <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>
5400 <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>
5401 <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>
5402 <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>
5403 <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>
5404 <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>
5405 <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>
5406 <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>
5407 <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>
5408 <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>
5409 <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>
5410 <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>
5411 <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>
5412 <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>
5413 <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>
5414 <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>
5415 <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>
5416 <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>
5417 <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>
5418 <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>
5419 <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>
5420 <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>
5421 <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>
5422 <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>
5423 <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>
5424 <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>
5425 <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>
5426 <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>
5427 <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>
5428 <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>
5429 <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>
5430 <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>
5431 <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>
5432 <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>
5433 <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>
5434 <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>
5435 <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>
5436 <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>
5437 <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>
5438 <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>
5439 <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>
5440 <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>
5441 <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>
5442 <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>
5443 <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>
5444 <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>
5445 <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>
5446 <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>
5447 <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>
5448 <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>
5449 <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>
5450 <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>
5451 <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>
5452 <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>
5453 <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>
5454 <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>
5455 <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>
5456 <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>
5457 <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>
5458 <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>
5459 <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>
5460 <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>
5461 <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>
5462 <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>
5463 <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>
5464 <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>
5465 <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>
5466 <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>
5467 <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>
5468 <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>
5469 <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>
5470 <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>
5471 <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>
5472 <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>
5473 <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>
5474 <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>
5475 <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>
5476 <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>
5477 <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>
5478 <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>
5479 <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>
5480 <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>
5481 <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>
5482 <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>
5483 <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>
5484 <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>
5485 <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>
5486 <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>
5487 <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>
5488 <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>
5489 <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>
5490 <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>
5491 <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>
5492 <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>
5493 <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>
5494 <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>
5495 <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>
5496 <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>
5497 <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>
5498 <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>
5499 <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>
5500 <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>
5501 <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>
5502 <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>
5503 <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>
5504 <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>
5505 <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>
5506 <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>
5507 <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>
5508 <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>
5509 <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>
5510 <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>
5511 <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>
5512 <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>
5513 <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>
5514 <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>
5515 <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>
5516 <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>
5517 <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>
5518 <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>
5519 <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>
5520 <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>
5521 <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>
5522 <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>
5523 <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>
5524 <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>
5525 <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>
5526 <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>
5527 <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>
5528 <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>
5529 <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>
5530 <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>
5531 <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>
5532 <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>
5533 <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>
5534 <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>
5535 <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>
5536 <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>
5537 <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>
5538 <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>
5539 <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>
5540 <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>
5541 <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>
5542 <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>
5543 <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>
5544 <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>
5545 <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>
5546 <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>
5547 <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>
5548 <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>
5549 <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>
5550 <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>
5551 <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>
5552 <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>
5553 <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>
5554 <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>
5555 <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>
5556 <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>
5557 <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>
5558 <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>
5559 <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>
5560 <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>
5561 <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>
5562 <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>
5563 <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>
5564 <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>
5565 <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>
5566 <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>
5567 <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>
5568 <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>
5569 <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>
5570 <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>
5571 <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>
5572 <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>
5573 <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>
5574 <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>
5575 <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>
5576 <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>
5577 <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>
5578 <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>
5579 <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>
5580 <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>
5581 <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>
5582 <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>
5583 <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>
5584 <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>
5585 <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>
5586 <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>
5587 <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>
5588 <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>
5589 <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>
5590 <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>
5591 <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>
5592 <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>
5593 <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>
5594 <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>
5595 <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>
5596 <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>
5597 <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>
5598 <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>
5599 <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>
5600 <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>
5601 <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>
5602 <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>
5603 <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>
5604 <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>
5605 <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>
5606 <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>
5607 <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>
5608 <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>
5609 <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>
5610 <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>
5611 <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>
5612 <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>
5613 <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>
5614 <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>
5615 <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>
5616 <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>
5617 <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>
5618 <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>
5619 <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>
5620 <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>
5621 <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>
5622 <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>
5623 <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>
5624 <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>
5625 <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>
5626 <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>
5627 <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>
5628 <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>
5629 <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>
5630 <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>
5631 <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>
5632 <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>
5633 <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>
5634 <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>
5635 <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>
5636 <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>
5637 <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>
5638 <tr><td colspan="3"> <hr></td></tr>
5639 <tr><th><a name="ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-L">L</a></th><td></td><td></td></tr>
5640 <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>
5641 <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>
5642 <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>
5643 <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>
5644 <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>
5645 <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>
5646 <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>
5647 <tr><td colspan="3"> <hr></td></tr>
5648 <tr><th><a name="ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-M">M</a></th><td></td><td></td></tr>
5649 <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>
5650 <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>
5651 <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>
5652 <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>
5653 <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>
5654 <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>
5655 <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>
5656 <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>
5657 <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>
5658 <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>
5659 <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>
5660 <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>
5661 <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>
5662 <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>
5663 <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>
5664 <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>
5665 <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>
5666 <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>
5667 <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>
5668 <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>
5669 <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>
5670 <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>
5671 <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>
5672 <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>
5673 <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>
5674 <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>
5675 <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>
5676 <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>
5677 <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>
5678 <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>
5679 <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>
5680 <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>
5681 <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>
5682 <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>
5683 <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>
5684 <tr><td colspan="3"> <hr></td></tr>
5685 <tr><th><a name="ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-P">P</a></th><td></td><td></td></tr>
5686 <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>
5687 <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>
5688 <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>
5689 <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>
5690 <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>
5691 <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>
5692 <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>
5693 <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>
5694 <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>
5695 <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>
5696 <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>
5697 <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>
5698 <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>
5699 <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>
5700 <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>
5701 <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>
5702 <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>
5703 <tr><td colspan="3"> <hr></td></tr>
5704 <tr><th><a name="ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-Q">Q</a></th><td></td><td></td></tr>
5705 <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>
5706 <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>
5707 <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>
5708 <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>
5709 <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>
5710 <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>
5711 <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>
5712 <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>
5713 <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>
5714 <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>
5715 <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>
5716 <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>
5717 <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>
5718 <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>
5719 <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>
5720 <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>
5721 <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>
5722 <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>
5723 <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>
5724 <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>
5725 <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>
5726 <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>
5727 <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>
5728 <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>
5729 <tr><td colspan="3"> <hr></td></tr>
5730 <tr><th><a name="ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-R">R</a></th><td></td><td></td></tr>
5731 <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>
5732 <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>
5733 <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>
5734 <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>
5735 <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>
5736 <tr><td colspan="3"> <hr></td></tr>
5737 <tr><th><a name="ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-S">S</a></th><td></td><td></td></tr>
5738 <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>
5739 <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>
5740 <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>
5741 <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>
5742 <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>
5743 <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>
5744 <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>
5745 <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>
5746 <tr><td colspan="3"> <hr></td></tr>
5747 <tr><th><a name="ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-T">T</a></th><td></td><td></td></tr>
5748 <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>
5749 <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>
5750 <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>
5751 <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>
5752 <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>
5753 <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>
5754 <tr><td colspan="3"> <hr></td></tr>
5755 <tr><th><a name="ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-V">V</a></th><td></td><td></td></tr>
5756 <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>
5757 <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>
5758 <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>
5759 <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>
5760 <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>
5761 <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>
5762 <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>
5763 <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>
5764 <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>
5765 <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>
5766 <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>
5767 <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>
5768 <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>
5769 <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>
5770 <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>
5771 <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>
5772 <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>
5773 <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>
5774 <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>
5775 <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>
5776 <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>
5777 <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>
5778 <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>
5779 <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>
5780 <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>
5781 <tr><td colspan="3"> <hr></td></tr>
5782 </table>
5783 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-A" class="summary-letter"><b>A</b></a>
5784 &nbsp;
5785 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-E" class="summary-letter"><b>E</b></a>
5786 &nbsp;
5787 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-F" class="summary-letter"><b>F</b></a>
5788 &nbsp;
5789 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-G" class="summary-letter"><b>G</b></a>
5790 &nbsp;
5791 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-L" class="summary-letter"><b>L</b></a>
5792 &nbsp;
5793 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-M" class="summary-letter"><b>M</b></a>
5794 &nbsp;
5795 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-P" class="summary-letter"><b>P</b></a>
5796 &nbsp;
5797 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-Q" class="summary-letter"><b>Q</b></a>
5798 &nbsp;
5799 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-R" class="summary-letter"><b>R</b></a>
5800 &nbsp;
5801 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-S" class="summary-letter"><b>S</b></a>
5802 &nbsp;
5803 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-T" class="summary-letter"><b>T</b></a>
5804 &nbsp;
5805 <a href="#ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095_fn_letter-V" class="summary-letter"><b>V</b></a>
5806 &nbsp;
5807 </td></tr></table>
5808
5809 <hr size="6">
5810 <a name="g_t_00e3_0083_00a2_00e3_0082_00b8_00e3_0083_00a5_00e3_0083_00bc_00e3_0083_00ab_00e7_00b4_00a2_00e5_00bc_0095"></a>
5811 <table cellpadding="1" cellspacing="1" border="0">
5812 <tr><td valign="middle" align="left">[<a href="#g_t_00e6_0089_008b_00e7_00b6_009a_00e3_0081_008d_00e3_0081_00a8_00e6_00a7_008b_00e6_0096_0087_00e7_00b4_00a2_00e5_00bc_0095" title="Previous section in reading order"> &lt; </a>]</td>
5813 <td valign="middle" align="left">[<a href="#g_t_00e3_0082_00af_00e3_0083_00a9_00e3_0082_00b9_00e7_00b4_00a2_00e5_00bc_0095" title="Next section in reading order"> &gt; </a>]</td>
5814 <td valign="middle" align="left"> &nbsp; </td>
5815 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
5816 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Up section"> Up </a>]</td>
5817 <td valign="middle" align="left">[ &gt;&gt; ]</td>
5818 <td valign="middle" align="left"> &nbsp; </td>
5819 <td valign="middle" align="left"> &nbsp; </td>
5820 <td valign="middle" align="left"> &nbsp; </td>
5821 <td valign="middle" align="left"> &nbsp; </td>
5822 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
5823 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
5824 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
5825 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
5826 </tr></table>
5827 <a name="a_0083_00a2a_0082_00b8a_0083_00a5a_0083_00bca_0083_00abc_00b4_00a2aa_00bc_0095"></a>
5828 <h2 class="appendixsec">A.2 モジュール索引</h2>
5829 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#a_0083_00a2a_0082_00b8a_0083_00a5a_0083_00bca_0083_00abc_00b4_00a2aa_00bc_0095_md_letter-G" class="summary-letter"><b>G</b></a>
5830 &nbsp;
5831 </td></tr></table>
5832 <table border="0" class="index-md">
5833 <tr><td></td><th align="left">Index Entry</th><th align="left"> Section</th></tr>
5834 <tr><td colspan="3"> <hr></td></tr>
5835 <tr><th><a name="a_0083_00a2a_0082_00b8a_0083_00a5a_0083_00bca_0083_00abc_00b4_00a2aa_00bc_0095_md_letter-G">G</a></th><td></td><td></td></tr>
5836 <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>
5837 <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>
5838 <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>
5839 <tr><td colspan="3"> <hr></td></tr>
5840 </table>
5841 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#a_0083_00a2a_0082_00b8a_0083_00a5a_0083_00bca_0083_00abc_00b4_00a2aa_00bc_0095_md_letter-G" class="summary-letter"><b>G</b></a>
5842 &nbsp;
5843 </td></tr></table>
5844
5845 <hr size="6">
5846 <a name="g_t_00e3_0082_00af_00e3_0083_00a9_00e3_0082_00b9_00e7_00b4_00a2_00e5_00bc_0095"></a>
5847 <table cellpadding="1" cellspacing="1" border="0">
5848 <tr><td valign="middle" align="left">[<a href="#g_t_00e3_0083_00a2_00e3_0082_00b8_00e3_0083_00a5_00e3_0083_00bc_00e3_0083_00ab_00e7_00b4_00a2_00e5_00bc_0095" title="Previous section in reading order"> &lt; </a>]</td>
5849 <td valign="middle" align="left">[<a href="#g_t_00e5_00a4_0089_00e6_0095_00b0_00e7_00b4_00a2_00e5_00bc_0095" title="Next section in reading order"> &gt; </a>]</td>
5850 <td valign="middle" align="left"> &nbsp; </td>
5851 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
5852 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Up section"> Up </a>]</td>
5853 <td valign="middle" align="left">[ &gt;&gt; ]</td>
5854 <td valign="middle" align="left"> &nbsp; </td>
5855 <td valign="middle" align="left"> &nbsp; </td>
5856 <td valign="middle" align="left"> &nbsp; </td>
5857 <td valign="middle" align="left"> &nbsp; </td>
5858 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
5859 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
5860 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
5861 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
5862 </tr></table>
5863 <a name="a_0082_00afa_0083_00a9a_0082_00b9c_00b4_00a2aa_00bc_0095"></a>
5864 <h2 class="appendixsec">A.3 クラス索引</h2>
5865
5866 <p>For readability, the surrounding <code>&lt;</code> and <code>&gt;</code> are stripped off.
5867 </p>
5868 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#a_0082_00afa_0083_00a9a_0082_00b9c_00b4_00a2aa_00bc_0095_cl_letter-G" class="summary-letter"><b>G</b></a>
5869 &nbsp;
5870 <a href="#a_0082_00afa_0083_00a9a_0082_00b9c_00b4_00a2aa_00bc_0095_cl_letter-M" class="summary-letter"><b>M</b></a>
5871 &nbsp;
5872 <a href="#a_0082_00afa_0083_00a9a_0082_00b9c_00b4_00a2aa_00bc_0095_cl_letter-P" class="summary-letter"><b>P</b></a>
5873 &nbsp;
5874 <a href="#a_0082_00afa_0083_00a9a_0082_00b9c_00b4_00a2aa_00bc_0095_cl_letter-Q" class="summary-letter"><b>Q</b></a>
5875 &nbsp;
5876 <a href="#a_0082_00afa_0083_00a9a_0082_00b9c_00b4_00a2aa_00bc_0095_cl_letter-V" class="summary-letter"><b>V</b></a>
5877 &nbsp;
5878 </td></tr></table>
5879 <table border="0" class="index-cl">
5880 <tr><td></td><th align="left">Index Entry</th><th align="left"> Section</th></tr>
5881 <tr><td colspan="3"> <hr></td></tr>
5882 <tr><th><a name="a_0082_00afa_0083_00a9a_0082_00b9c_00b4_00a2aa_00bc_0095_cl_letter-G">G</a></th><td></td><td></td></tr>
5883 <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>
5884 <tr><td colspan="3"> <hr></td></tr>
5885 <tr><th><a name="a_0082_00afa_0083_00a9a_0082_00b9c_00b4_00a2aa_00bc_0095_cl_letter-M">M</a></th><td></td><td></td></tr>
5886 <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>
5887 <tr><td colspan="3"> <hr></td></tr>
5888 <tr><th><a name="a_0082_00afa_0083_00a9a_0082_00b9c_00b4_00a2aa_00bc_0095_cl_letter-P">P</a></th><td></td><td></td></tr>
5889 <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>
5890 <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>
5891 <tr><td colspan="3"> <hr></td></tr>
5892 <tr><th><a name="a_0082_00afa_0083_00a9a_0082_00b9c_00b4_00a2aa_00bc_0095_cl_letter-Q">Q</a></th><td></td><td></td></tr>
5893 <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>
5894 <tr><td colspan="3"> <hr></td></tr>
5895 <tr><th><a name="a_0082_00afa_0083_00a9a_0082_00b9c_00b4_00a2aa_00bc_0095_cl_letter-V">V</a></th><td></td><td></td></tr>
5896 <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>
5897 <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>
5898 <tr><td colspan="3"> <hr></td></tr>
5899 </table>
5900 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#a_0082_00afa_0083_00a9a_0082_00b9c_00b4_00a2aa_00bc_0095_cl_letter-G" class="summary-letter"><b>G</b></a>
5901 &nbsp;
5902 <a href="#a_0082_00afa_0083_00a9a_0082_00b9c_00b4_00a2aa_00bc_0095_cl_letter-M" class="summary-letter"><b>M</b></a>
5903 &nbsp;
5904 <a href="#a_0082_00afa_0083_00a9a_0082_00b9c_00b4_00a2aa_00bc_0095_cl_letter-P" class="summary-letter"><b>P</b></a>
5905 &nbsp;
5906 <a href="#a_0082_00afa_0083_00a9a_0082_00b9c_00b4_00a2aa_00bc_0095_cl_letter-Q" class="summary-letter"><b>Q</b></a>
5907 &nbsp;
5908 <a href="#a_0082_00afa_0083_00a9a_0082_00b9c_00b4_00a2aa_00bc_0095_cl_letter-V" class="summary-letter"><b>V</b></a>
5909 &nbsp;
5910 </td></tr></table>
5911
5912 <hr size="6">
5913 <a name="g_t_00e5_00a4_0089_00e6_0095_00b0_00e7_00b4_00a2_00e5_00bc_0095"></a>
5914 <table cellpadding="1" cellspacing="1" border="0">
5915 <tr><td valign="middle" align="left">[<a href="#g_t_00e3_0082_00af_00e3_0083_00a9_00e3_0082_00b9_00e7_00b4_00a2_00e5_00bc_0095" title="Previous section in reading order"> &lt; </a>]</td>
5916 <td valign="middle" align="left">[ &gt; ]</td>
5917 <td valign="middle" align="left"> &nbsp; </td>
5918 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
5919 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Up section"> Up </a>]</td>
5920 <td valign="middle" align="left">[ &gt;&gt; ]</td>
5921 <td valign="middle" align="left"> &nbsp; </td>
5922 <td valign="middle" align="left"> &nbsp; </td>
5923 <td valign="middle" align="left"> &nbsp; </td>
5924 <td valign="middle" align="left"> &nbsp; </td>
5925 <td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
5926 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
5927 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
5928 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
5929 </tr></table>
5930 <a name="aa_00a4_0089ae_0095_00b0c_00b4_00a2aa_00bc_0095"></a>
5931 <h2 class="appendixsec">A.4 変数索引</h2>
5932 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#aa_00a4_0089ae_0095_00b0c_00b4_00a2aa_00bc_0095_vr_letter-G" class="summary-letter"><b>G</b></a>
5933 &nbsp;
5934 </td></tr></table>
5935 <table border="0" class="index-vr">
5936 <tr><td></td><th align="left">Index Entry</th><th align="left"> Section</th></tr>
5937 <tr><td colspan="3"> <hr></td></tr>
5938 <tr><th><a name="aa_00a4_0089ae_0095_00b0c_00b4_00a2aa_00bc_0095_vr_letter-G">G</a></th><td></td><td></td></tr>
5939 <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>
5940 <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>
5941 <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>
5942 <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>
5943 <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>
5944 <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>
5945 <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>
5946 <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>
5947 <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>
5948 <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>
5949 <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>
5950 <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>
5951 <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>
5952 <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>
5953 <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>
5954 <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>
5955 <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>
5956 <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>
5957 <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>
5958 <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>
5959 <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>
5960 <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>
5961 <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>
5962 <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>
5963 <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>
5964 <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>
5965 <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>
5966 <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>
5967 <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>
5968 <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>
5969 <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>
5970 <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>
5971 <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>
5972 <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>
5973 <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>
5974 <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>
5975 <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>
5976 <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>
5977 <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>
5978 <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>
5979 <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>
5980 <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>
5981 <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>
5982 <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>
5983 <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>
5984 <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>
5985 <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>
5986 <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>
5987 <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>
5988 <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>
5989 <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>
5990 <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>
5991 <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>
5992 <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>
5993 <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>
5994 <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>
5995 <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>
5996 <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>
5997 <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>
5998 <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>
5999 <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>
6000 <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>
6001 <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>
6002 <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>
6003 <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>
6004 <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>
6005 <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>
6006 <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>
6007 <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>
6008 <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>
6009 <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>
6010 <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>
6011 <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>
6012 <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>
6013 <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>
6014 <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>
6015 <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>
6016 <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>
6017 <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>
6018 <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>
6019 <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>
6020 <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>
6021 <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>
6022 <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>
6023 <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>
6024 <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>
6025 <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>
6026 <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>
6027 <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>
6028 <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>
6029 <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>
6030 <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>
6031 <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>
6032 <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>
6033 <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>
6034 <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>
6035 <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>
6036 <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>
6037 <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>
6038 <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>
6039 <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>
6040 <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>
6041 <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>
6042 <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>
6043 <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>
6044 <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>
6045 <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>
6046 <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>
6047 <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>
6048 <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>
6049 <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>
6050 <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>
6051 <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>
6052 <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>
6053 <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>
6054 <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>
6055 <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>
6056 <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>
6057 <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>
6058 <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>
6059 <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>
6060 <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>
6061 <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>
6062 <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>
6063 <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>
6064 <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>
6065 <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>
6066 <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>
6067 <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>
6068 <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>
6069 <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>
6070 <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>
6071 <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>
6072 <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>
6073 <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>
6074 <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>
6075 <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>
6076 <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>
6077 <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>
6078 <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>
6079 <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>
6080 <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>
6081 <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>
6082 <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>
6083 <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>
6084 <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>
6085 <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>
6086 <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>
6087 <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>
6088 <tr><td colspan="3"> <hr></td></tr>
6089 </table>
6090 <table><tr><th valign="top">Jump to: &nbsp; </th><td><a href="#aa_00a4_0089ae_0095_00b0c_00b4_00a2aa_00bc_0095_vr_letter-G" class="summary-letter"><b>G</b></a>
6091 &nbsp;
6092 </td></tr></table>
6093
6094
6095 <hr size="6">
6096 <a name="SEC_Contents"></a>
6097 <table cellpadding="1" cellspacing="1" border="0">
6098 <tr><td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6099 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6100 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
6101 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6102 </tr></table>
6103 <h1>Table of Contents</h1>
6104 <div class="contents">
6105
6106 <ul class="toc">
6107 <li><a name="toc-a_0081_00afa_0081_0098a_0082_0081a_0081_00ab" href="#g_t_00e3_0081_00af_00e3_0081_0098_00e3_0082_0081_00e3_0081_00ab">1. はじめに</a></li>
6108 <li><a name="toc-Installation-1" href="#Installation">2. Installation</a></li>
6109 <li><a name="toc-Getting-Started-1" href="#Getting-Started">3. Getting Started</a>
6110 <ul class="toc">
6111 <li><a name="toc-GL-calls-in-Scheme-1" href="#GL-calls-in-Scheme">3.1 GL calls in Scheme</a></li>
6112 <li><a name="toc-Advanced-GL-features-1" href="#Advanced-GL-features">3.2 Advanced GL features</a></li>
6113 <li><a name="toc-Using-GLUT-1" href="#Using-GLUT">3.3 Using GLUT</a></li>
6114 <li><a name="toc-Performance-tips-1" href="#Performance-tips">3.4 Performance tips</a></li>
6115 </ul></li>
6116 <li><a name="toc-OpenGL-API-1" href="#OpenGL-API">4. OpenGL API</a>
6117 <ul class="toc">
6118 <li><a name="toc-GL-data-types-1" href="#GL-data-types">4.1 GL data types</a></li>
6119 <li><a name="toc-GL-feature-checking-1" href="#GL-feature-checking">4.2 GL feature checking</a></li>
6120 <li><a name="toc-Drawing-functions-1" href="#Drawing-functions">4.3 Drawing functions</a></li>
6121 <li><a name="toc-GL-state-control-1" href="#GL-state-control">4.4 GL state control</a></li>
6122 <li><a name="toc-GL-states-for-drawing-1" href="#GL-states-for-drawing">4.5 GL states for drawing</a></li>
6123 <li><a name="toc-Transformation-1" href="#Transformation">4.6 Transformation</a></li>
6124 <li><a name="toc-Display-lists-1" href="#Display-lists">4.7 Display lists</a></li>
6125 <li><a name="toc-Vertex-arrays-1" href="#Vertex-arrays">4.8 Vertex arrays</a></li>
6126 <li><a name="toc-Lighting-1" href="#Lighting">4.9 Lighting</a></li>
6127 <li><a name="toc-Pixels_002c-bitmaps-and-images" href="#Pixels">4.10 Pixels, bitmaps and images</a></li>
6128 <li><a name="toc-Texture-mapping-1" href="#Texture-mapping">4.11 Texture mapping</a></li>
6129 <li><a name="toc-Framebuffers-1" href="#Framebuffers">4.12 Framebuffers</a></li>
6130 <li><a name="toc-Selection-and-feedback-1" href="#Selection-and-feedback">4.13 Selection and feedback</a></li>
6131 <li><a name="toc-Projection-1" href="#Projection">4.14 Projection</a></li>
6132 <li><a name="toc-Quadrics-1" href="#Quadrics">4.15 Quadrics</a></li>
6133 <li><a name="toc-Nurbs-1" href="#Nurbs">4.16 Nurbs</a></li>
6134 <li><a name="toc-Polygon-tesselation-1" href="#Polygon-tesselation">4.17 Polygon tesselation</a></li>
6135 <li><a name="toc-Programmable-shaders-1" href="#Programmable-shaders">4.18 Programmable shaders</a></li>
6136 </ul></li>
6137 <li><a name="toc-GLUT-API-1" href="#GLUT-API">5. GLUT API</a>
6138 <ul class="toc">
6139 <li><a name="toc-GLUT-window-manipulation-1" href="#GLUT-window-manipulation">5.1 GLUT window manipulation</a></li>
6140 <li><a name="toc-GLUT-overlay-1" href="#GLUT-overlay">5.2 GLUT overlay</a></li>
6141 <li><a name="toc-GLUT-menu-API-1" href="#GLUT-menu-API">5.3 GLUT menu API</a></li>
6142 <li><a name="toc-GLUT-callbacks-1" href="#GLUT-callbacks">5.4 GLUT callbacks</a></li>
6143 <li><a name="toc-GLUT-colormap-1" href="#GLUT-colormap">5.5 GLUT colormap</a></li>
6144 <li><a name="toc-GLUT-state-retrieval-1" href="#GLUT-state-retrieval">5.6 GLUT state retrieval</a></li>
6145 <li><a name="toc-GLUT-font-1" href="#GLUT-font">5.7 GLUT font</a></li>
6146 <li><a name="toc-GLUT-pre_002dbuilt-models-1" href="#GLUT-pre_002dbuilt-models">5.8 GLUT pre-built models</a></li>
6147 </ul></li>
6148 <li><a name="toc-Vectors-and-matrices-1" href="#Vectors-and-matrices">6. Vectors and matrices</a>
6149 <ul class="toc">
6150 <li><a name="toc-Vectors-and-points-1" href="#Vectors-and-points">6.1 Vectors and points</a></li>
6151 <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>
6152 <li><a name="toc-Matrices-1" href="#Matrices">6.3 Matrices</a></li>
6153 <li><a name="toc-Quaternions-1" href="#Quaternions">6.4 Quaternions</a></li>
6154 </ul></li>
6155 <li><a name="toc-Simple-utilities-1" href="#Simple-utilities">7. Simple utilities</a>
6156 <ul class="toc">
6157 <li><a name="toc-Simple-image-handling-1" href="#Simple-image-handling">7.1 Simple image handling</a></li>
6158 <li><a name="toc-Simple-viewer-1" href="#Simple-viewer">7.2 Simple viewer</a></li>
6159 </ul></li>
6160 <li><a name="toc-c_00b4_00a2aa_00bc_0095" href="#g_t_00e7_00b4_00a2_00e5_00bc_0095">A. 索引</a>
6161 <ul class="toc">
6162 <li><a name="toc-ae_0089_008bc_00b6_009aa_0081_008da_0081_00a8ae_00a7_008bae_0096_0087c_00b4_00a2aa_00bc_0095" href="#g_t_00e6_0089_008b_00e7_00b6_009a_00e3_0081_008d_00e3_0081_00a8_00e6_00a7_008b_00e6_0096_0087_00e7_00b4_00a2_00e5_00bc_0095">A.1 手続きと構文索引</a></li>
6163 <li><a name="toc-a_0083_00a2a_0082_00b8a_0083_00a5a_0083_00bca_0083_00abc_00b4_00a2aa_00bc_0095" href="#g_t_00e3_0083_00a2_00e3_0082_00b8_00e3_0083_00a5_00e3_0083_00bc_00e3_0083_00ab_00e7_00b4_00a2_00e5_00bc_0095">A.2 モジュール索引</a></li>
6164 <li><a name="toc-a_0082_00afa_0083_00a9a_0082_00b9c_00b4_00a2aa_00bc_0095" href="#g_t_00e3_0082_00af_00e3_0083_00a9_00e3_0082_00b9_00e7_00b4_00a2_00e5_00bc_0095">A.3 クラス索引</a></li>
6165 <li><a name="toc-aa_00a4_0089ae_0095_00b0c_00b4_00a2aa_00bc_0095" href="#g_t_00e5_00a4_0089_00e6_0095_00b0_00e7_00b4_00a2_00e5_00bc_0095">A.4 変数索引</a></li>
6166 </ul>
6167 </li>
6168 </ul>
6169 </div>
6170 <hr size="1">
6171 <a name="SEC_About"></a>
6172 <table cellpadding="1" cellspacing="1" border="0">
6173 <tr><td valign="middle" align="left">[<a href="#Top" title="Cover (top) of document">Top</a>]</td>
6174 <td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of contents">Contents</a>]</td>
6175 <td valign="middle" align="left">[<a href="#g_t_00e7_00b4_00a2_00e5_00bc_0095" title="Index">Index</a>]</td>
6176 <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
6177 </tr></table>
6178 <h1>About This Document</h1>
6179 <p>
6180 This document was generated on <i>August 9, 2014</i> using <a href="http://www.nongnu.org/texi2html/"><i>texi2html 1.82</i></a>.
6181 </p>
6182 <p>
6183 The buttons in the navigation panels have the following meaning:
6184 </p>
6185 <table border="1">
6186 <tr>
6187 <th> Button </th>
6188 <th> Name </th>
6189 <th> Go to </th>
6190 <th> From 1.2.3 go to</th>
6191 </tr>
6192 <tr>
6193 <td align="center"> [ &lt; ] </td>
6194 <td align="center">Back</td>
6195 <td>Previous section in reading order</td>
6196 <td>1.2.2</td>
6197 </tr>
6198 <tr>
6199 <td align="center"> [ &gt; ] </td>
6200 <td align="center">Forward</td>
6201 <td>Next section in reading order</td>
6202 <td>1.2.4</td>
6203 </tr>
6204 <tr>
6205 <td align="center"> [ &lt;&lt; ] </td>
6206 <td align="center">FastBack</td>
6207 <td>Beginning of this chapter or previous chapter</td>
6208 <td>1</td>
6209 </tr>
6210 <tr>
6211 <td align="center"> [ Up ] </td>
6212 <td align="center">Up</td>
6213 <td>Up section</td>
6214 <td>1.2</td>
6215 </tr>
6216 <tr>
6217 <td align="center"> [ &gt;&gt; ] </td>
6218 <td align="center">FastForward</td>
6219 <td>Next chapter</td>
6220 <td>2</td>
6221 </tr>
6222 <tr>
6223 <td align="center"> [Top] </td>
6224 <td align="center">Top</td>
6225 <td>Cover (top) of document</td>
6226 <td> &nbsp; </td>
6227 </tr>
6228 <tr>
6229 <td align="center"> [Contents] </td>
6230 <td align="center">Contents</td>
6231 <td>Table of contents</td>
6232 <td> &nbsp; </td>
6233 </tr>
6234 <tr>
6235 <td align="center"> [Index] </td>
6236 <td align="center">Index</td>
6237 <td>Index</td>
6238 <td> &nbsp; </td>
6239 </tr>
6240 <tr>
6241 <td align="center"> [ ? ] </td>
6242 <td align="center">About</td>
6243 <td>About (help)</td>
6244 <td> &nbsp; </td>
6245 </tr>
6246 </table>
6247
6248 <p>
6249 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:
6250 </p>
6251
6252 <ul>
6253 <li> 1. Section One
6254 <ul>
6255 <li>1.1 Subsection One-One
6256 <ul>
6257 <li>...</li>
6258 </ul>
6259 </li>
6260 <li>1.2 Subsection One-Two
6261 <ul>
6262 <li>1.2.1 Subsubsection One-Two-One</li>
6263 <li>1.2.2 Subsubsection One-Two-Two</li>
6264 <li>1.2.3 Subsubsection One-Two-Three &nbsp; &nbsp;
6265 <strong>&lt;== Current Position </strong></li>
6266 <li>1.2.4 Subsubsection One-Two-Four</li>
6267 </ul>
6268 </li>
6269 <li>1.3 Subsection One-Three
6270 <ul>
6271 <li>...</li>
6272 </ul>
6273 </li>
6274 <li>1.4 Subsection One-Four</li>
6275 </ul>
6276 </li>
6277 </ul>
6278
6279 <hr size="1">
6280 <p>
6281 <font size="-1">
6282 This document was generated on <i>August 9, 2014</i> using <a href="http://www.nongnu.org/texi2html/"><i>texi2html 1.82</i></a>.
6283 </font>
6284 <br>
6285
6286 </p>
6287 </body>
6288 </html>