'\" 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
.\"
.\" Copyright (c) 2001 The X Japanese Documentation Project.
.\"
.\" Permission is hereby granted, free of charge, to any person obtaining a
.\" copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish, dis-
.\" tribute, sublicense, and/or sell copies of the Software, and to permit
.\" persons to whom the Software is furnished to do so, subject to the fol-
.\" lowing conditions:
.\" 
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
.\" ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT
.\" SHALL  THE X JAPANESE DOCUMENTATION PROJECT  BE  LIABLE  FOR  ANY CLAIM,
.\" DAMAGES OR OTHER LIABILITY,  WHETHER IN AN ACTION OF CONTRACT,  TORT OR
.\" OTHERWISE,  ARISING FROM,  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of The X Japanese
.\" Documentation Project shall not be used in advertising or otherwise to
.\" promote the sale, use or other dealings in this Software without prior
.\" written authorization from The X Japanese Documentation Project.
.\"
.\" X Window System is a trademark of The Open Group.
.\"
.\" Translated Fri Sep 28 19:42:22 JST 2001
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.TH GLUTESSNORMAL 3G
.SH 名前
.B "gluTessNormal
.\"0 \- specify a normal for a polygon
\- ポリゴンに対して法線を指定する

.SH 書式
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 引き数
.TP \w'\fIvalueX\fP\ \ 'u 
\f2tess\fP
.\"0 Specifies the tessellation object (created with \%\f3gluNewTess\fP).
テセレーションオブジェクト(\%\f3gluNewTess\fP を使って作る)
を指定する。
.TP
\f2valueX\fP
.\"0 Specifies the first component of the normal.
法線の最初の成分を指定する。
.TP
\f2valueY\fP
.\"0 Specifies the second component of the normal.
法線の 2 番目の成分を指定する。
.TP
\f2valueZ\fP
.\"0 Specifies the third component of the normal.
法線の 3 番目の成分を指定する。
.SH 説明
.\"0 \%\f3gluTessNormal\fP describes a normal for a polygon that the program is defining.
\%\f3gluTessNormal\fP は、プログラムで定義しようとしている
ポリゴンに対して法線を記述する。
.\"0 All input data will be projected onto a plane perpendicular to one of 
.\"0 the three coordinate axes before tessellation and all output triangles
.\"0 will be oriented CCW with 
.\"0 respect to the normal (CW orientation can be obtained by reversing the
.\"0 sign of the supplied normal). For example, if you know that all polygons
.\"0 lie in the x-y plane, call \%\f3gluTessNormal\fP(tess, 0.0, 0.0, 1.0)
.\"0 before rendering any polygons.
全ての入力データは、テセレーション処理の前に 3 つの座標軸のどれかに
垂直な平面に投影される。
また、出力される全ての三角形は、法線について反時計回りの向きを持つ
(指定する法線の符号を反転させることにより、時計回りに向けることができ
る)。
例えば、全てのポリゴンが X-Y 平面上にあることが分かっていれば、
ポリゴンをレンダリングする前に \%\f3gluTessNormal\fP(tess, 0.0, 0.0, 1.0)
を呼ぶこと。
.P
.\"0 If the supplied normal is (0.0, 0.0, 0.0) (the initial value), the normal is
.\"0 determined as follows. The direction of the normal, up to its sign, is
.\"0 found by fitting a plane to the vertices, without regard to how the
.\"0 vertices are connected. It is expected that the input data lies approximately
.\"0 in the plane; otherwise, projection perpendicular to one of the three
.\"0 coordinate axes may substantially change the geometry. The sign of the
.\"0 normal is chosen so that the sum of the signed areas of all input
.\"0 contours is nonnegative (where a CCW contour has positive area).
法線として (0.0, 0.0, 0.0) (初期値)を指定すると、法線は次のように
決められる。
まず、法線の向き(符号も含む)は、平面を頂点群にフィッティングすることに
よって決められる。
その際には頂点同士がどのように繋がっているのかは考慮されない。
ここでは、入力データはほぼ平面上にあることが期待されている。
そうでない場合は、3 つ座標軸のどれかに垂直な投影は、実質的に
形状が変わることがある。
法線の符号は、入力された全ての経路の符号付き面積の和が負にならない方向
に決められる(反時計回りが正の面積を持つ)。
.P
.\"0 The supplied normal persists until it is changed by another call to 
.\"0 \%\f3gluTessNormal\fP.
指定された法線は、次に \%\f3gluTessNormal\fP が呼び出されて変更される
までは残る。
.SH 関連項目
\%\f3gluTessBeginPolygon\fP, 
\%\f3gluTessEndPolygon\fP