Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   29550 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

GLUUNPROJECT4(3G)		 OpenGL Manual		     GLUUNPROJECT4(3G)

NAME
       gluUnProject4 - map window and clip coordinates to object coordinates

C SPECIFICATION
       GLint gluUnProject4(GLdouble winX, GLdouble winY, GLdouble winZ,
			   GLdouble clipW, const GLdouble * model,
			   const GLdouble * proj, const GLint * view,
			   GLdouble nearVal, GLdouble farVal, GLdouble* objX,
			   GLdouble* objY, GLdouble* objZ, GLdouble* objW);

PARAMETERS
       winX, winY, winZ
	   Specify the window coordinates to be mapped.

       clipW
	   Specify the clip w coordinate to be mapped.

       model
	   Specifies the modelview matrix (as from a glGetDoublev() call).

       proj
	   Specifies the projection matrix (as from a glGetDoublev() call).

       view
	   Specifies the viewport (as from a glGetIntegerv() call).

       nearVal, farVal
	   Specifies the near and far planes (as from a glGetDoublev() call).

       objX, objY, objZ, objW
	   Returns the computed object coordinates.

DESCRIPTION
       gluUnProject4 maps the specified window coordinatesi: winX, winY, and
       winZ and its clip w coordinate clipW into object coordinates objX objY
       objZ objW using model, proj, and view.  clipW can be other than 1 as
       for vertices in glFeedbackBuffer() when data type GLU_4D_COLOR_TEXTURE
       is returned. This also handles the case where the nearVal and farVal
       planes are different from the default, 0 and 1, respectively. A return
       value of GLU_TRUE indicates success; a return value of GLU_FALSE
       indicates failure.

       To compute the coordinates objX objY objZ objW, gluUnProject4
       multiplies the normalized device coordinates by the inverse of model *
       proj as follows:

       objX objY objZ objW = INV ⁡ P ⁢ M ⁢ 2 ⁡ winX - view ⁡ 0 view ⁡ 2 - 1 2
       ⁡ winY - view ⁡ 1 view ⁡ 3 - 1 2 ⁡ winZ - nearVal farVal - nearVal - 1
       clipW

       INV denotes matrix inversion.

       gluUnProject4 is equivalent to gluUnProject() when clipW is 1, nearVal
       is 0, and farVal is 1.

NOTES
       gluUnProject4 is available only if the GLU version is 1.3 or greater.

SEE ALSO
       gluProject(), gluUnProject(), glFeedbackBuffer(), glGet()

COPYRIGHT
       Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed
       under the SGI Free Software B License. For details, see
       http://oss.sgi.com/projects/FreeB/.

AUTHORS
       opengl.org

opengl.org			  03/16/2013		     GLUUNPROJECT4(3G)

Vote for polarhome