GLLOADMATRIX(3G) UNIX Programmer's Manual GLLOADMATRIX(3G)
NAME
glLoadMatrixd, glLoadMatrixf - replace the current matrix
with the specified matrix
C SPECIFICATION
void glLoadMatrixd( const GLdouble *m )
void glLoadMatrixf( const GLfloat *m )
PARAMETERS
m Specifies a pointer to 16 consecutive values, which are
used as the elements of a 4 x 4 column-major matrix.
DESCRIPTION
glLoadMatrix replaces the current matrix with the one whose
elements are specified by m. The current matrix is the pro-
jection matrix, modelview matrix, or texture matrix, depend-
ing on the current matrix mode (see glMatrixMode).
The current matrix, M, defines a transformation of coordi-
nates. For instance, assume M refers to the modelview
matrix. If v = (v[0],v[1],v[2],v[3]) is the set of object
coordinates of a vertex, and m points to an array of 16
single- or double-precision floating-point values
m[0],m[1],...,m[15], then the modelview transformation M(v)
does the following:
|
|
M(v) = | m[0]
|m[1]
|m[2] m[4]
|m[3] m[5]
m[6] m[8]
m[7] m[9]
m[10] m[12] |
m[11] m[13] | |
m[14] | |
m[15] | x | v[0] |
| | v[1] |
| | v[2] |
| v[3] |
|
|
Where ``x'' denotes matrix multiplication.
Projection and texture transformations are similarly
defined.
NOTES
While the elements of the matrix may be specified with sin-
gle or double precision, the GL implementation may store or
operate on these values in less than single precision.
ERRORS
GL_INVALID_OPERATION is generated if glLoadMatrix is exe-
cuted between the execution of glBegin and the corresponding
execution of glEnd.
MirBSD #10-current Printed 2021-12-07 1
GLLOADMATRIX(3G) UNIX Programmer's Manual GLLOADMATRIX(3G)
ASSOCIATED GETS
glGet with argument GL_MATRIX_MODE
glGet with argument GL_COLOR_MATRIX
glGet with argument GL_MODELVIEW_MATRIX
glGet with argument GL_PROJECTION_MATRIX
glGet with argument GL_TEXTURE_MATRIX
SEE ALSO
glLoadIdentity(3G), glMatrixMode(3G), glMultMatrix(3G),
glPushMatrix(3G)
MirBSD #10-current Printed 2021-12-07 2