gluProject()gluProject()NAMEgluProject - map object coordinates to window coordinates
SYNOPSIS
GLint gluProject(
GLdouble objX,
GLdouble objY,
GLdouble objZ,
const GLdouble *model,
const GLdouble *proj,
const GLint *view,
GLdouble* winX,
GLdouble* winY,
GLdouble* winZ );
PARAMETERS
Specify the object coordinates. Specifies the current modelview matrix
(as from a glGetDoublev() call). Specifies the current projection
matrix (as from a glGetDoublev() call). Specifies the current viewport
(as from a glGetIntegerv() call). Return the computed window coordi‐
nates.
DESCRIPTIONgluProject() 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^prime as follows: V^prime = P times M times v
where P is the current projection matrix proj, M is the current mod‐
elview matrix model (both represented as 4 times 4 matrices in column-
major order) and 'times' represents matrix multiplication.
The window coordinates are then computed as follows: winX = view(0) +
view(2) * (v^prime(0) + 1) / 2 winY = view(1) + view(3) * (v^prime(1) +
1) / 2 winZ = (v^prime(2) + 1) / 2
SEE ALSOglGet(3), gluUnProject(3)gluProject()