MirOS Manual: gluProject(3)


GLUPROJECT(3G)      UNIX Programmer's 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 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' = P x M x v

     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:

MirOS BSD #10-current   Printed 20.2.2012                       1

GLUPROJECT(3G)      UNIX Programmer's Manual       GLUPROJECT(3G)

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

     winY = view(1) + view(3) * (v'(1) + 1) / 2

     winZ = (v'(2) + 1) / 2

SEE ALSO

     glGet(3G), gluUnProject(3G)

MirOS BSD #10-current   Printed 20.2.2012                       2

Generated on 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2011 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.