glTranslate.3gl

Name

  glTranslated,	glTranslatef - multiply	the current matrix by a	translation

  matrix

C Specification

  void glTranslated( GLdouble x,

		     GLdouble y,

		     GLdouble z	)

  void glTranslatef( GLfloat x,

		     GLfloat y,

		     GLfloat z )

Parameters

  x, y,	z

	 Specify the x,	y, and z coordinates of	a translation vector.

Description

  glTranslate moves the	coordinate system origin to the	point specified	by

  (x,y,z).  The translation vector is used to compute a	4x4 translation

  matrix:



			    | 1	   0	0    x	 |

			    |			 |

			    | 0	   1	0    y	 |

			    |			 |

			    | 0	   0	1    z	 |

			    |			 |

			    | 0	   0	0    1	 |



  The current matrix (see glMatrixMode)	is multiplied by this translation

  matrix, with the product replacing the current matrix.  That is, if M	is

  the current matrix and T is the translation matrix, then M is	replaced with

  M · T.



  If the matrix	mode is	either GL_MODELVIEW or GL_PROJECTION, all objects

  drawn	after glTranslate is called are	translated.  Use glPushMatrix and

  glPopMatrix to save and restore the untranslated coordinate system.

Errors

  GL_INVALID_OPERATION is generated if glTranslate is executed between the

  execution of glBegin and the corresponding execution of glEnd.

Associated Gets

  glGet	with argument GL_MATRIX_MODE

  glGet	with argument GL_MODELVIEW_MATRIX

  glGet	with argument GL_PROJECTION_MATRIX

  glGet	with argument GL_TEXTURE_MATRIX

See Also

  glMatrixMode,	glMultMatrix, glPushMatrix, glRotate, glScale

Introduction | Alphabetic | Specification

Last Edited: Tue, May 23, 1995

AFV