'\" 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 unproject
.ds Xs 63442 4 unproject.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 Thu Sep 27 18:37:59 JST 2001
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.TH GLUUNPROJECT 3G
.SH 名前
.B "gluUnProject
.\"0 \- map window coordinates to object coordinates
\- ウィンドウ座標をオブジェクト座標にマップする

.SH 書式
GLint \f3gluUnProject\fP(
GLdouble \fIwinX\fP,
.nf
.ta \w'\f3GLint \fPgluUnProject( 'u
	GLdouble \fIwinY\fP,
	GLdouble \fIwinZ\fP,
	const GLdouble \fI*model\fP,
	const GLdouble \fI*proj\fP,
	const GLint \fI*view\fP,
	GLdouble* \fIobjX\fP,
	GLdouble* \fIobjY\fP,
	GLdouble* \fIobjZ\fP )
.fi

.EQ
delim $$
.EN
.SH 引き数
.TP \w'\f2winX\fP\ \f2winY\fP\ \f2winZ\fP\ \ 'u 
\f2winX\fP, \f2winY\fP, \f2winZ\fP
.\"0 Specify the window coordinates to be mapped.
マップされるウィンドウ座標を指定する。
.TP
\f2model\fP
.\"0 Specifies the modelview matrix (as from a \f3glGetDoublev\fP call).
モデルビュー行列を指定する(\f3glGetDoublev\fP の呼び出しで得られる形式)。
.TP
\f2proj\fP
.\"0 Specifies the projection matrix (as from a \f3glGetDoublev\fP call).
射影行列を指定する(\f3glGetDoublev\fP の呼び出しで得られる形式)。
.TP
\f2view\fP
.\"0 Specifies the viewport (as from a \f3glGetIntegerv\fP call).
ビューポートを指定する(\f3glGetIntegerv\fP の呼び出しで得られる形式)。
.TP
\f2objX\fP, \f2objY\fP, \f2objZ\fP
.\"0 Returns the computed object coordinates.
算出されたオブジェクト座標が返される。
.SH 説明
.\"0 \%\f3gluUnProject\fP maps the specified window coordinates into object 
.\"0 coordinates using \f2model\fP, \f2proj\fP, and \f2view\fP.
\%\f3gluUnProject\fP は、\f2model\fP, \f2proj\fP, \f2view\fP を使って、
指定されたウィンドウ座標をオブジェクト座標にマップする。
.\"0 The result is stored in \f2objX\fP, \f2objY\fP, and \f2objZ\fP. A return value of 
.\"0 \%\f3GL_TRUE\fP indicates success; a return value of \%\f3GL_FALSE\fP
.\"0 indicates failure.
マップされた結果は \f2objX\fP, \f2objY\fP, \f2objZ\fP に格納される。
返り値が \%\f3GL_TRUE\fP なら成功を示し、返り値が \%\f3GL_FALSE\fP なら
失敗を示す。
.P
.\"0 To compute the coordinates (\f2objX\fP, \f2objY\fP, and \f2objZ\fP),
.\"0 \%\f3gluUnProject\fP multiplies the normalized device coordinates by the inverse of
.\"0 \f2model\fP*\f2proj\fP as follows:
座標 (\f2objX\fP, \f2objY\fP, \f2objZ\fP) を計算するために、
\%\f3gluUnProject\fP は正規化されたデバイス座標に
\f2model\fP*\f2proj\fP の逆行列を掛ける。
計算は以下のように行われる:

.P
.ce
.EQ
left ( down 70 {cpile { ~"objX" above ~"objY" above ~"objZ"
above ~W}} ~~ right ) ~=~ INV(P M) 
left ( down 140 {cpile { 
{ {2("winX" ~-~ "view"[0])} over {"view" [2]} ~-~ 1 }
above 
{ {2("winY" ~-~ "view"[1])} over {"view"[3]} ~-~ 1 }
above 
{ 2("winZ") ~-~ 1 }
above 
1}} ~~ right )
.EN
.bp
.\"0 $INV()$ denotes matrix inversion. 
$INV()$ は逆行列の計算を表す。
.\"0 W is an unused variable, included for consistent matrix notation.
W は使われない変数であり、行列の表記に一貫性を持たせるために含めている。
.SH 関連項目
\f3glGet\fP, \%\f3gluProject\fP