← Back to branch summary

~ubuntu-branches/ubuntu/gutsy/vnc4/gutsy

« back to all changes in this revision

Viewing changes to unix/xc/doc/man/GL/gl/calllist.3gl

  • Committer: Bazaar Package Importer
  • Author(s): Ola Lundqvist
  • Date: 2006-05-15 20:35:17 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20060515203517-l4lre1ku942mn26k
Tags: 4.1.1+X4.3.0-10
* Correction of critical security issue. Thanks to Martin Kogler
  <e9925248@student.tuwien.ac.at> that informed me about the issue,
  and provided the patch.
  This flaw was originally found by Steve Wiseman of intelliadmin.com.
* Applied patch from Javier Kohen <jkohen@users.sourceforge.net> that
  inform the user that only 8 first characters of the password will
  actually be used when typing more than 8 characters, closes:
  #355619.

Show diffs side-by-side

added added

removed removed

Lines of Context:
unix/xc/doc/man/GL/gl/calllist.3gl
 
1
'\"macro stdmacro
 
2
.ds Vn Version 1.2
 
3
.ds Dt 24 September 1999
 
4
.ds Re Release 1.2.1
 
5
.ds Dp Jan 14 18:30
 
6
.ds Dm 01 calllist.
 
7
.ds Xs 42225 4 calllist.gl
 
8
.TH GLCALLLIST 3G
 
9
.SH NAME
 
10
.B "glCallList
 
11
\- execute a display list
 
12
 
 
13
.SH C SPECIFICATION
 
14
void \f3glCallList\fP(
 
15
GLuint \fIlist\fP )
 
16
.nf
 
17
.fi
 
18
 
 
19
.SH PARAMETERS
 
20
.TP \w'\f2list\fP\ \ 'u 
 
21
\f2list\fP
 
22
Specifies the integer name of the display list to be executed.
 
23
.SH DESCRIPTION
 
24
\%\f3glCallList\fP causes the named display list to be executed.
 
25
The commands saved in the display list are executed in order,
 
26
just as if they were called without using a display list.
 
27
If \f2list\fP has not been defined as a display list,
 
28
\%\f3glCallList\fP is ignored.
 
29
.P
 
30
\%\f3glCallList\fP can appear inside a display list.
 
31
To avoid the possibility of infinite recursion resulting from display lists
 
32
calling one another,
 
33
a limit is placed on the nesting level of display
 
34
lists during display-list execution.
 
35
This limit is at least 64, and it depends on the implementation.
 
36
.P
 
37
GL state is not saved and restored across a call to \%\f3glCallList\fP.
 
38
Thus,
 
39
changes made to GL state during the execution of a display list
 
40
remain after execution of the display list is completed.
 
41
Use \%\f3glPushAttrib\fP,
 
42
\%\f3glPopAttrib\fP,
 
43
\%\f3glPushMatrix\fP,
 
44
and \%\f3glPopMatrix\fP to preserve GL state across \%\f3glCallList\fP calls.
 
45
.SH NOTES
 
46
Display lists can be executed between a call to \%\f3glBegin\fP
 
47
and the corresponding call to \%\f3glEnd\fP,
 
48
as long as the display list includes only commands that are allowed
 
49
in this interval.
 
50
.SH ASSOCIATED GETS
 
51
\%\f3glGet\fP with argument \%\f3GL_MAX_LIST_NESTING\fP
 
52
.br
 
53
\%\f3glIsList\fP
 
54
.SH SEE ALSO
 
55
\%\f3glCallLists(3G)\fP,
 
56
\%\f3glDeleteLists(3G)\fP,
 
57
\%\f3glGenLists(3G)\fP,
 
58
\%\f3glNewList(3G)\fP,
 
59
\%\f3glPushAttrib(3G)\fP, 
 
60
\%\f3glPushMatrix(3G)\fP