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

« back to all changes in this revision

Viewing changes to unix/xc/doc/man/GL/gl/isenabled.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:
 
1
'\" et
 
2
'\"! eqn|tbl | mmdoc
 
3
'\"macro stdmacro
 
4
.ds Vn Version 1.2
 
5
.ds Dt 24 September 1999
 
6
.ds Re Release 1.2.1
 
7
.ds Dp Jan 14 18:30
 
8
.ds Dm 01 isenabled
 
9
.ds Xs 14538 7 isenabled.gl
 
10
.TH GLISENABLED 3G
 
11
.SH NAME
 
12
.B "glIsEnabled
 
13
\- test whether a capability is enabled
 
14
 
 
15
.SH C SPECIFICATION
 
16
GLboolean \f3glIsEnabled\fP(
 
17
GLenum \fIcap\fP )
 
18
.nf
 
19
.fi
 
20
 
 
21
.SH PARAMETERS
 
22
.TP \w'\f2cap\fP\ \ 'u 
 
23
\f2cap\fP
 
24
Specifies a symbolic constant indicating a GL capability.
 
25
.SH DESCRIPTION
 
26
\%\f3glIsEnabled\fP returns \%\f3GL_TRUE\fP if \f2cap\fP is an enabled capability
 
27
and returns \%\f3GL_FALSE\fP otherwise.
 
28
Initially all capabilities except \%\f3GL_DITHER\fP are disabled;
 
29
\%\f3GL_DITHER\fP is initially enabled.
 
30
.P
 
31
The following capabilities are accepted for \f2cap\fP:
 
32
.P
 
33
 
 
34
.TS
 
35
lb lb
 
36
l l.
 
37
_
 
38
Constant        See
 
39
_
 
40
\%\f3GL_ALPHA_TEST\fP   \%\f3glAlphaFunc\fP
 
41
\%\f3GL_AUTO_NORMAL\fP  \%\f3glEvalCoord\fP
 
42
\%\f3GL_BLEND\fP        \%\f3glBlendFunc\fP, \%\f3glLogicOp\fP
 
43
\%\f3GL_CLIP_PLANE\fP\f2i\fP    \%\f3glClipPlane\fP
 
44
\%\f3GL_COLOR_ARRAY\fP  \%\f3glColorPointer\fP
 
45
\%\f3GL_COLOR_LOGIC_OP\fP       \%\f3glLogicOp\fP
 
46
\%\f3GL_COLOR_MATERIAL\fP       \%\f3glColorMaterial\fP
 
47
\%\f3GL_COLOR_TABLE\fP  \%\f3glColorTable\fP
 
48
\%\f3GL_CONVOLUTION_1D\fP       \%\f3glConvolutionFilter1D\fP
 
49
\%\f3GL_CONVOLUTION_2D\fP       \%\f3glConvolutionFilter2D\fP
 
50
\%\f3GL_CULL_FACE\fP    \%\f3glCullFace\fP
 
51
\%\f3GL_DEPTH_TEST\fP   \%\f3glDepthFunc\fP, \%\f3glDepthRange\fP
 
52
\%\f3GL_DITHER\fP       \%\f3glEnable\fP
 
53
\%\f3GL_EDGE_FLAG_ARRAY\fP      \%\f3glEdgeFlagPointer\fP
 
54
\%\f3GL_FOG\fP  \%\f3glFog\fP
 
55
\%\f3GL_HISTOGRAM\fP    \%\f3glHistogram\fP
 
56
\%\f3GL_INDEX_ARRAY\fP  \%\f3glIndexPointer\fP
 
57
\%\f3GL_INDEX_LOGIC_OP\fP       \%\f3glLogicOp\fP
 
58
\%\f3GL_LIGHT\fP\f2i\fP \%\f3glLightModel\fP, \%\f3glLight\fP
 
59
\%\f3GL_LIGHTING\fP     \%\f3glMaterial\fP, \%\f3glLightModel\fP, \%\f3glLight\fP
 
60
\%\f3GL_LINE_SMOOTH\fP  \%\f3glLineWidth\fP
 
61
\%\f3GL_LINE_STIPPLE\fP \%\f3glLineStipple\fP
 
62
\%\f3GL_MAP1_COLOR_4\fP \%\f3glMap1\fP
 
63
\%\f3GL_MAP1_INDEX\fP   \%\f3glMap1\fP
 
64
\%\f3GL_MAP1_NORMAL\fP  \%\f3glMap1\fP
 
65
\%\f3GL_MAP1_TEXTURE_COORD_1\fP \%\f3glMap1\fP
 
66
\%\f3GL_MAP1_TEXTURE_COORD_2\fP \%\f3glMap1\fP
 
67
\%\f3GL_MAP1_TEXTURE_COORD_3\fP \%\f3glMap1\fP
 
68
\%\f3GL_MAP1_TEXTURE_COORD_4\fP \%\f3glMap1\fP
 
69
\%\f3GL_MAP2_COLOR_4\fP \%\f3glMap2\fP
 
70
\%\f3GL_MAP2_INDEX\fP   \%\f3glMap2\fP
 
71
\%\f3GL_MAP2_NORMAL\fP  \%\f3glMap2\fP
 
72
\%\f3GL_MAP2_TEXTURE_COORD_1\fP \%\f3glMap2\fP
 
73
\%\f3GL_MAP2_TEXTURE_COORD_2\fP \%\f3glMap2\fP
 
74
\%\f3GL_MAP2_TEXTURE_COORD_3\fP \%\f3glMap2\fP
 
75
\%\f3GL_MAP2_TEXTURE_COORD_4\fP \%\f3glMap2\fP
 
76
\%\f3GL_MAP2_VERTEX_3\fP        \%\f3glMap2\fP
 
77
\%\f3GL_MAP2_VERTEX_4\fP        \%\f3glMap2\fP
 
78
\%\f3GL_MINMAX\fP       \%\f3glMinmax\fP
 
79
\%\f3GL_NORMAL_ARRAY\fP \%\f3glNormalPointer\fP
 
80
\%\f3GL_NORMALIZE\fP    \%\f3glNormal\fP
 
81
\%\f3GL_POINT_SMOOTH\fP \%\f3glPointSize\fP
 
82
\%\f3GL_POLYGON_SMOOTH\fP       \%\f3glPolygonMode\fP
 
83
\%\f3GL_POLYGON_OFFSET_FILL\fP  \%\f3glPolygonOffset\fP
 
84
\%\f3GL_POLYGON_OFFSET_LINE\fP  \%\f3glPolygonOffset\fP
 
85
\%\f3GL_POLYGON_OFFSET_POINT\fP         \%\f3glPolygonOffset\fP
 
86
\%\f3GL_POLYGON_STIPPLE\fP      \%\f3glPolygonStipple\fP
 
87
\%\f3GL_POST_COLOR_MATRIX_COLOR_TABLE\fP        \%\f3glColorTable\fP
 
88
\%\f3GL_POST_CONVOLUTION_COLOR_TABLE\fP \%\f3glColorTable\fP
 
89
\%\f3GL_RESCALE_NORMAL\fP       \%\f3glNormal\fP
 
90
\%\f3GL_SCISSOR_TEST\fP \%\f3glScissor\fP
 
91
\%\f3GL_SEPARABLE_2D\fP \%\f3glSeparableFilter2D\fP
 
92
\%\f3GL_STENCIL_TEST\fP \%\f3glStencilFunc\fP, \%\f3glStencilOp\fP
 
93
\%\f3GL_TEXTURE_1D\fP   \%\f3glTexImage1D\fP
 
94
\%\f3GL_TEXTURE_2D\fP   \%\f3glTexImage2D\fP
 
95
\%\f3GL_TEXTURE_3D\fP   \%\f3glTexImage3D\fP
 
96
\%\f3GL_TEXTURE_COORD_ARRAY\fP  \%\f3glTexCoordPointer\fP
 
97
\%\f3GL_TEXTURE_GEN_Q\fP        \%\f3glTexGen\fP
 
98
\%\f3GL_TEXTURE_GEN_R\fP        \%\f3glTexGen\fP
 
99
\%\f3GL_TEXTURE_GEN_S\fP        \%\f3glTexGen\fP
 
100
\%\f3GL_TEXTURE_GEN_T\fP        \%\f3glTexGen\fP
 
101
\%\f3GL_VERTEX_ARRAY\fP \%\f3glVertexPointer\fP
 
102
_
 
103
.TE
 
104
 
 
105
.SH NOTES
 
106
If an error is generated,
 
107
\%\f3glIsEnabled\fP returns 0.
 
108
.P
 
109
\%\f3GL_COLOR_LOGIC_OP\fP, 
 
110
\%\f3GL_COLOR_ARRAY\fP,
 
111
\%\f3GL_EDGE_FLAG_ARRAY\fP,
 
112
\%\f3GL_INDEX_ARRAY\fP,
 
113
\%\f3GL_INDEX_LOGIC_OP\fP,
 
114
\%\f3GL_NORMAL_ARRAY\fP,
 
115
\%\f3GL_POLYGON_OFFSET_FILL\fP,  
 
116
\%\f3GL_POLYGON_OFFSET_LINE\fP,
 
117
\%\f3GL_POLYGON_OFFSET_POINT\fP,
 
118
\%\f3GL_TEXTURE_COORD_ARRAY\fP, and
 
119
\%\f3GL_VERTEX_ARRAY\fP
 
120
are available only
 
121
if the GL version is 1.1 or greater
 
122
.P
 
123
\%\f3GL_RESCALE_NORMAL\fP, and \%\f3GL_TEXTURE_3D\fP are available only if the GL
 
124
version is 1.2 or greater.
 
125
.P
 
126
\%\f3GL_COLOR_TABLE\fP, \%\f3GL_CONVOLUTION_1D\fP, \%\f3GL_CONVOLUTION_2D\fP,
 
127
\%\f3GL_HISTOGRAM\fP, \%\f3GL_MINMAX\fP,
 
128
\%\f3GL_POST_COLOR_MATRIX_COLOR_TABLE\fP,
 
129
\%\f3GL_POST_CONVOLUTION_COLOR_TABLE\fP, and
 
130
\%\f3GL_SEPARABLE_2D\fP are available only if \%\f3GL_ARB_imaging\fP is
 
131
returned when \%\f3glGet\fP is called with \%\f3GL_EXTENSIONS\fP.
 
132
.P
 
133
When the \%\f3GL_ARB_multitexture\fP extension is supported, the following
 
134
parameters return the associated value for the active texture unit.
 
135
\%\f3GL_TEXTURE_1D\fP, \%\f3GL_TEXTURE_BINDING_1D\fP,
 
136
\%\f3GL_TEXTURE_2D\fP, \%\f3GL_TEXTURE_BINDING_2D\fP,
 
137
\%\f3GL_TEXTURE_3D\fP, \%\f3GL_TEXTURE_BINDING_3D\fP,
 
138
\%\f3GL_TEXTURE_GEN_S\fP,
 
139
\%\f3GL_TEXTURE_GEN_T\fP,
 
140
\%\f3GL_TEXTURE_GEN_R\fP,
 
141
\%\f3GL_TEXTURE_GEN_Q\fP,
 
142
\%\f3GL_TEXTURE_MATRIX\fP, and
 
143
\%\f3GL_TEXTURE_STACK_DEPTH\fP.
 
144
Likewise, the following parameters return the associated value for the
 
145
active client texture unit:
 
146
\%\f3GL_TEXTURE_COORD_ARRAY\fP,
 
147
\%\f3GL_TEXTURE_COORD_ARRAY_SIZE\fP,
 
148
\%\f3GL_TEXTURE_COORD_ARRAY_STRIDE\fP,
 
149
\%\f3GL_TEXTURE_COORD_ARRAY_TYPE\fP.
 
150
.SH ERRORS
 
151
\%\f3GL_INVALID_ENUM\fP is generated if \f2cap\fP is not an accepted value.
 
152
.P
 
153
\%\f3GL_INVALID_OPERATION\fP is generated if \%\f3glIsEnabled\fP
 
154
is executed between the execution of \%\f3glBegin\fP
 
155
and the corresponding execution of \%\f3glEnd\fP.
 
156
.SH SEE ALSO
 
157
\%\f3glEnable(3G)\fP,
 
158
\%\f3glEnableClientState(3G)\fP,
 
159
\%\f3glGet(3G)\fP
 
160