68 lines
2.0 KiB
Plaintext
68 lines
2.0 KiB
Plaintext
'\" e
|
|
'\"! eqn | mmdoc
|
|
'\"macro stdmacro
|
|
.ds Vn Version 1.2
|
|
.ds Dt 6 March 1997
|
|
.ds Re Release 1.2.0
|
|
.ds Dp May 02 11:53
|
|
.ds Dm 37 tessnorma
|
|
.ds Xs 47097 4 tessnormal.gl
|
|
.TH GLUTESSNORMAL 3G
|
|
.SH NAME
|
|
.B "gluTessNormal
|
|
\- specify a normal for a polygon
|
|
|
|
.SH C SPECIFICATION
|
|
void \f3gluTessNormal\fP(
|
|
GLUtesselator* \fItess\fP,
|
|
.nf
|
|
.ta \w'\f3void \fPgluTessNormal( 'u
|
|
GLdouble \fIvalueX\fP,
|
|
GLdouble \fIvalueY\fP,
|
|
GLdouble \fIvalueZ\fP )
|
|
.fi
|
|
|
|
.EQ
|
|
delim $$
|
|
.EN
|
|
.SH PARAMETERS
|
|
.TP \w'\fIvalueX\fP\ \ 'u
|
|
\f2tess\fP
|
|
Specifies the tessellation object (created with \%\f3gluNewTess\fP).
|
|
.TP
|
|
\f2valueX\fP
|
|
Specifies the first component of the normal.
|
|
.TP
|
|
\f2valueY\fP
|
|
Specifies the second component of the normal.
|
|
.TP
|
|
\f2valueZ\fP
|
|
Specifies the third component of the normal.
|
|
.SH DESCRIPTION
|
|
\%\f3gluTessNormal\fP describes a normal for a polygon that the program is defining.
|
|
All input data will be projected onto a plane perpendicular to one of
|
|
the three coordinate axes before tessellation and all output triangles
|
|
will be oriented CCW with
|
|
respect to the normal (CW orientation can be obtained by reversing the
|
|
sign of the supplied normal). For example, if you know that all polygons
|
|
lie in the x-y plane, call \%\f3gluTessNormal\fP(tess, 0.0, 0.0, 1.0)
|
|
before rendering any polygons.
|
|
.P
|
|
If the supplied normal is (0.0, 0.0, 0.0) (the initial value), the normal is
|
|
determined as follows. The direction of the normal, up to its sign, is
|
|
found by fitting a plane to the vertices, without regard to how the
|
|
vertices are connected. It is expected that the input data lies approximately
|
|
in the plane; otherwise, projection perpendicular to one of the three
|
|
coordinate axes may substantially change the geometry. The sign of the
|
|
normal is chosen so that the sum of the signed areas of all input
|
|
contours is nonnegative (where a CCW contour has positive area).
|
|
.P
|
|
The supplied normal persists until it is changed by another call to
|
|
\%\f3gluTessNormal\fP.
|
|
.SH SEE ALSO
|
|
\%\f3gluTessBeginPolygon(3G)\fP,
|
|
\%\f3gluTessEndPolygon(3G)\fP
|
|
|
|
|
|
|