glRotated, glRotatef

[New - Windows 95, OEM Service Release 2]

The glRotated and glRotatef functions multiply the current matrix by a rotation matrix.

void glRotated(

    GLdouble angle,

 

    GLdouble x,

 

    GLdouble y,

 

    GLdouble z

 

   );

 

 

void glRotatef(

    GLfloat angle,

 

    GLfloat x,

 

    GLfloat y,

 

    GLfloat z

 

   );

 

 

Parameters

angle

The angle of rotation, in degrees.

x, y, z

The x, y, and z coordinates of a vector, respectively.

 

Remarks

The glRotate function computes a matrix that performs a counterclockwise rotation of angle degrees about the vector from the origin through the point (x, y, z).

The current matrix (see glMatrixMode20CZ15) is multiplied by this rotation matrix, with the product replacing the current matrix. That is, if M is the current matrix and R is the translation matrix, then M is replaced with M R.

If the matrix mode is either GL_MODELVIEW or GL_PROJECTION, all objects drawn after glRotate is called are rotated. Use glPushMatrix1MYNI2H and glPopMatrix to save and restore the unrotated coordinate system.

The following functions retrieve information related to glRotate:

glGet8KNKTW with argument GL_RENDER_MODE

glGet8KNKTW with argument GL_MATRIX_MODE

glGet with argument GL_MODELVIEW_MATRIX

glGet with argument GL_PROJECTION_MATRIX

glGet with argument GL_TEXTURE_MATRIX

 

Error Codes

The following are the error codes generated and their conditions.

Error Code

Condition

GL_INVALID_OPERATION

glRotate was called between a call to glBegin and the corresponding call to glEnd.

 

See Also

glBegin, glEnd, glMatrixMode, glMultMatrix, glPushMatrix, glScale, glTranslate