gluproject(3g) [redhat man page]

GLUPROJECT(3G)															    GLUPROJECT(3G)

NAME

       gluProject - map object coordinates to window coordinates

C SPECIFICATION

       GLint gluProject( GLdouble objX,
			 GLdouble objY,
			 GLdouble objZ,
			 const GLdouble *model,
			 const GLdouble *proj,
			 const GLint *view,
			 GLdouble* winX,
			 GLdouble* winY,
			 GLdouble* winZ )

PARAMETERS

       objX, objY, objZ
		       Specify the object coordinates.

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

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

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

       winX, winY, winZ
		       Return the computed window coordinates.

DESCRIPTION

       gluProject  transforms  the specified object coordinates into window coordinates using model, proj, and view. The result is stored in winX,
       winY, and winZ. A return value of GL_TRUE indicates success, a return value of GL_FALSE indicates failure.

       To compute the coordinates, let v=(objX,objY,objZ,1.0) represented as a matrix with 4 rows and 1 column.  Then gluProject  computes  v'	as
       follows:

       v'=PxMxv

       where  P  is  the current projection matrix proj, M is the current modelview matrix model (both represented as 4x4 matrices in column-major
       order) and 'x' represents matrix multiplication.

       The window coordinates are then computed as follows:

       winX=view(0)+view(2)*(v'(0)+1)/2

																    GLUPROJECT(3G)

GLUPROJECT(3G)							   OpenGL Manual						    GLUPROJECT(3G)

NAME

       gluProject - map object coordinates to window coordinates

C SPECIFICATION

       GLint gluProject(GLdouble objX, GLdouble objY, GLdouble objZ, const GLdouble * model, const GLdouble * proj, const GLint * view,
			GLdouble* winX, GLdouble* winY, GLdouble* winZ);

PARAMETERS

       objX, objY, objZ
	   Specify the object coordinates.

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

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

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

       winX, winY, winZ
	   Return the computed window coordinates.

DESCRIPTION

       gluProject transforms the specified object coordinates into window coordinates using model, proj, and view. The result is stored in winX,
       winY, and winZ. A return value of GLU_TRUE indicates success, a return value of GLU_FALSE indicates failure.

       To compute the coordinates, let v = objX objY objZ 1.0 represented as a matrix with 4 rows and 1 column. Then gluProject computes v '' as
       follows:

       v '' = P x M x v

       where P is the current projection matrix proj and M is the current modelview matrix model (both represented as 4 x 4 matrices in
       column-major order).

       The window coordinates are then computed as follows:

       winX = view  0 + view  2 x v ''	0 + 1 2.PP winY = view	1 + view  3 x v ''  1 + 1 2.PP winZ = v ''  2 + 1 2

SEE ALSO

       gluUnProject(), glGet()

COPYRIGHT

       Copyright (C) 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							    06/10/2014							    GLUPROJECT(3G)