54 lines
1.5 KiB
Plaintext
54 lines
1.5 KiB
Plaintext
|
'\" e
|
||
|
'\"! eqn | mmdoc
|
||
|
'\"macro stdmacro
|
||
|
.ds Vn Version 1.2
|
||
|
.ds Dt 24 September 1999
|
||
|
.ds Re Release 1.2.1
|
||
|
.ds Dp Jan 14 18:30
|
||
|
.ds Dm 01 getclippl
|
||
|
.ds Xs 48616 4 getclipplane.gl
|
||
|
.TH GLGETCLIPPLANE 3G
|
||
|
.SH NAME
|
||
|
.B "glGetClipPlane
|
||
|
\- return the coefficients of the specified clipping plane
|
||
|
|
||
|
.SH C SPECIFICATION
|
||
|
void \f3glGetClipPlane\fP(
|
||
|
GLenum \fIplane\fP,
|
||
|
.nf
|
||
|
.ta \w'\f3void \fPglGetClipPlane( 'u
|
||
|
GLdouble \fI*equation\fP )
|
||
|
.fi
|
||
|
|
||
|
.EQ
|
||
|
delim $$
|
||
|
.EN
|
||
|
.SH PARAMETERS
|
||
|
.TP \w'\fIequation\fP\ \ 'u
|
||
|
\f2plane\fP
|
||
|
Specifies a clipping plane.
|
||
|
The number of clipping planes depends on the implementation,
|
||
|
but at least six clipping planes are supported.
|
||
|
They are identified by symbolic names of the form \%\f3GL_CLIP_PLANE\fP$i$
|
||
|
where 0 \(<= $ i $ < \%\f3GL_MAX_CLIP_PLANES\fP.
|
||
|
.TP
|
||
|
\f2equation\fP
|
||
|
Returns four double-precision values that are the coefficients of the plane equation of \f2plane\fP in eye coordinates.
|
||
|
The initial value is (0, 0, 0, 0).
|
||
|
.SH DESCRIPTION
|
||
|
\%\f3glGetClipPlane\fP returns in \f2equation\fP the four coefficients of the plane equation
|
||
|
for \f2plane\fP.
|
||
|
.SH NOTES
|
||
|
It is always the case that \%\f3GL_CLIP_PLANE\fP$i$ = \%\f3GL_CLIP_PLANE0\fP + $i$.
|
||
|
.P
|
||
|
If an error is generated,
|
||
|
no change is made to the contents of \f2equation\fP.
|
||
|
.SH ERRORS
|
||
|
\%\f3GL_INVALID_ENUM\fP is generated if \f2plane\fP is not an accepted value.
|
||
|
.P
|
||
|
\%\f3GL_INVALID_OPERATION\fP is generated if \%\f3glGetClipPlane\fP
|
||
|
is executed between the execution of \%\f3glBegin\fP
|
||
|
and the corresponding execution of \%\f3glEnd\fP.
|
||
|
.SH SEE ALSO
|
||
|
\%\f3glClipPlane(3G)\fP
|