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