Revert "update upstream sources"
[clinton/guile-figl.git] / doc / glu.texi
1 @c This is part of the Figl Reference Manual.
2 @c Copyright (C) 2013 Andy Wingo and others
3 @c See the file figl.texi for copying conditions.
4
5 @node GLU
6 @chapter GLU
7
8 @menu
9 * GLU API:: The high-level interface to GLU.
10 * Low-Level GLU:: Primitive interface to ``glu'' functionality.
11 @end menu
12
13 @node GLU API
14 @section GLU API
15
16 Import the GLU module to have access to these procedures:
17
18 @example
19 (use-modules (figl glu))
20 @end example
21
22 The GLU specification is available at
23 @uref{http://www.opengl.org/registry/doc/glu1.3.pdf}.
24
25 @menu
26 * Initialization::
27 * Mipmapping::
28 * Matrix Manipulation::
29 * Polygon Tesselation::
30 * Quadrics::
31 * NURBS::
32 * Errors::
33 @end menu
34
35 @node Initialization
36 @subsection Initialization
37
38 @node Mipmapping
39 @subsection Mipmapping
40
41 @node Matrix Manipulation
42 @subsection Matrix Manipulation
43
44 @defun glu-perspective fov-y aspect z-near z-far
45 Set up a perspective projection matrix.
46
47 @var{fov-y} is the field of view angle, in degrees, in the Y
48 direction. @var{aspect} is the ratio of width to height.
49 @var{z-near} and @var{z-far} are the distances from the viewer to the
50 near and far clipping planes, respectively.
51
52 The resulting matrix is multiplied against the current matrix.
53 @end defun
54
55 @node Polygon Tesselation
56 @subsection Polygon Tesselation
57
58 @node Quadrics
59 @subsection Quadrics
60
61 @node NURBS
62 @subsection NURBS
63
64 @node Errors
65 @subsection Errors
66
67 @node Low-Level GLU
68 @section Low-Level GLU
69 @include low-level-glu.texi
70
71