NAME
glTranslated, glTranslatef
- multiply the current matrix by a translation matrix
C SPECIFICATION
void ggllTTrraannssllaatteedd(
GLdouble _x,
GLdouble _y,
GLdouble _z )
void ggllTTrraannssllaatteeff(
GLfloat _x,
GLfloat _y,
GLfloat _z )
delim $$
PARAMETERS
-
_x, _y, _z
-
Specify the _x, _y, and _z coordinates of a translation vector.
DESCRIPTION
ggllTTrraannssllaattee produces a translation by
$("x","y","z")$.
The current matrix
(see
ggllMMaattrriixxMMooddee)
is multiplied by this translation matrix,
with the product replacing the current matrix, as if
ggllMMuullttMMaattrriixx were called with the following matrix
for its argument:
left ( ~ down 20 matrix {
ccol { 1~~ above 0~~ above 0~~ above 0~~ }
ccol { 0~~ above 1~~ above 0~~ above 0~~ }
ccol { 0~~ above 0~~ above 1~~ above 0~~ }
ccol { "x"~ above "y"~ above "z"~ above 1}
} ~~right )
If the matrix mode is either GGLL__MMOODDEELLVVIIEEWW or GGLL__PPRROOJJEECCTTIIOONN,
all objects drawn after a call to ggllTTrraannssllaattee are translated.
Use ggllPPuusshhMMaattrriixx and
ggllPPooppMMaattrriixx to save and restore
the untranslated coordinate system.
ERRORS
GGLL__IINNVVAALLIIDD__OOPPEERRAATTIIOONN is generated if ggllTTrraannssllaattee
is executed between the execution of ggllBBeeggiinn
and the corresponding execution of ggllEEnndd.
ASSOCIATED GETS
ggllGGeett with argument GGLL__MMAATTRRIIXX__MMOODDEE
ggllGGeett with argument GGLL__CCOOLLOORR__MMAATTRRIIXX
ggllGGeett with argument GGLL__MMOODDEELLVVIIEEWW__MMAATTRRIIXX
ggllGGeett with argument GGLL__PPRROOJJEECCTTIIOONN__MMAATTRRIIXX
ggllGGeett with argument GGLL__TTEEXXTTUURREE__MMAATTRRIIXX
SEE ALSO
ggllMMaattrriixxMMooddee((33GG)),
ggllMMuullttMMaattrriixx((33GG)),
ggllPPuusshhMMaattrriixx((33GG)),
ggllRRoottaattee((33GG)),
ggllSSccaallee((33GG))