rest25/library/gl.rst => rest262/library/gl.rst
f1
2:mod:`gl` --- *Graphics Library* interface
3==========================================
4
5.. module:: gl
6   :platform: IRIX
7   :synopsis: Functions from the Silicon Graphics Graphics Library.
n8+   :deprecated:
9+ 
10+ 
11+.. deprecated:: 2.6
12+    The :mod:`gl` module has been deprecated for removal in Python 3.0.
8
9
10This module provides access to the Silicon Graphics *Graphics Library*. It is
11available only on Silicon Graphics machines.
12
13.. warning::
14
15   Some illegal calls to the GL library cause the Python interpreter to dump core.
23* All (short, long, unsigned) int values are represented by Python integers.
24
25* All float and double values are represented by Python floating point numbers.
26  In most cases, Python integers are also allowed.
27
28* All arrays are represented by one-dimensional Python lists. In most cases,
29  tuples are also allowed.
30
n31-*  All string and character arguments are represented by Python strings, for
n36+* All string and character arguments are represented by Python strings, for
32  instance, ``winopen('Hi There!')`` and ``rotate(900, 'z')``.
33
34* All (short, long, unsigned) integer arguments or return values that are only
35  used to specify the length of an array argument are omitted. For example, the C
36  call ::
37
38     lmdef(deftype, index, np, props)
39
60
61   Equivalent to but faster than a number of ``v3d()`` calls. The *argument* is a
62   list (or tuple) of points. Each point must be a tuple of coordinates ``(x, y,
63   z)`` or ``(x, y)``. The points may be 2- or 3-dimensional but must all have the
64   same dimension. Float and int values may be mixed however. The points are always
65   converted to 3D double precision points by assuming ``z = 0.0`` if necessary (as
66   indicated in the man page), and for each point ``v3d()`` is called.
67
n68-   .. % JHXXX the argument-argument added
n73+   .. XXX the argument-argument added
69
70
71.. function:: nvarray()
72
73   Equivalent to but faster than a number of ``n3f`` and ``v3f`` calls. The
74   argument is an array (list or tuple) of pairs of normals and points. Each pair
75   is a tuple of a point and a normal for that point. Each point or normal must be
76   a tuple of coordinates ``(x, y, z)``. Three coordinates must be given. Float and
84   second.
85
86
87.. function:: nurbssurface(s_k, t_k, ctl, s_ord, t_ord, type)
88
89   Defines a nurbs surface. The dimensions of ``ctl[][]`` are computed as follows:
90   ``[len(s_k) - s_ord]``, ``[len(t_k) - t_ord]``.
91
n92-   .. % XXX s_k[], t_k[], ctl[][]
n97+   .. XXX s_k[], t_k[], ctl[][]
93
94
95.. function:: nurbscurve(knots, ctlpoints, order, type)
96
97   Defines a nurbs curve. The length of ctlpoints is ``len(knots) - order``.
98
99
100.. function:: pwlcurve(points, type)
145.. seealso::
146
147   `PyOpenGL: The Python OpenGL Binding <http://pyopengl.sourceforge.net/>`_
148      .. index::
149         single: OpenGL
150         single: PyOpenGL
151
152      An interface to OpenGL is also available; see information about the **PyOpenGL**
n153-      project online at `<http://pyopengl.sourceforge.net/>`_.  This may be a better
n158+      project online at http://pyopengl.sourceforge.net/.  This may be a better option
154-      option if support for SGI hardware from before about 1996 is not required.
159+      if support for SGI hardware from before about 1996 is not required.
155
156
157:mod:`DEVICE` --- Constants used with the :mod:`gl` module
158==========================================================
159
160.. module:: DEVICE
161   :platform: IRIX
162   :synopsis: Constants used with the gl module.
n168+   :deprecated:
169+ 
170+ 
171+.. deprecated:: 2.6
172+    The :mod:`DEVICE` module has been deprecated for removal in Python 3.0.
163
164
165This modules defines the constants used by the Silicon Graphics *Graphics
166Library* that C programmers find in the header file ``<gl/device.h>``. Read the
167module source file for details.
168
169
170:mod:`GL` --- Constants used with the :mod:`gl` module
171======================================================
172
173.. module:: GL
174   :platform: IRIX
175   :synopsis: Constants used with the gl module.
n186+   :deprecated:
176
t188+ 
189+.. deprecated:: 2.6
190+    The :mod:`GL` module has been deprecated for removal in Python 3.0.
177
178This module contains constants used by the Silicon Graphics *Graphics Library*
179from the C header file ``<gl/gl.h>``. Read the module source file for details.
180
Legends
Colors
 Added 
Changed
Deleted
Links
(f)irst change
(n)ext change
(t)op