GLSCALE

NAME

glScaled, glScalef - multiply the current matrix by a general scaling matrix

C SPECIFICATION

void f3glScaledfP( GLdouble fIxfP,

   GLfloat fIyfP,
   GLfloat fIzfP )

delim $$

PARAMETERS

f2xfP, f2yfP, f2zfP: Specify scale factors along the f2xfP, f2yfP, and f2zfP axes, respectively.

DESCRIPTION

%f3glScalefP produces a nonuniform scaling along the f2xfP, f2yfP, and f2zfP axes. The three parameters indicate the desired scale factor along each of the three axes. The current matrix (see %f3glMatrixModefP) is multiplied by this scale matrix, and the product replaces the current matrix as if %f3glScalefP were called with the following matrix as its argument:

left ( ~ down 20 matrix {
   ccol { ~"x" above ~0 above ~0 above ~0 }
   ccol { ~0 above ~"y" above ~0 above ~0 }
   ccol { ~0 above ~0 above ~"z" above ~0 }
   ccol { ~0 above ~0 above ~0 above ~1} } ~~ right )

If the matrix mode is either %f3GL_MODELVIEWfP or %f3GL_PROJECTIONfP, all objects drawn after %f3glScalefP is called are scaled. Use %f3glPushMatrixfP and %f3glPopMatrixfP to save and restore the unscaled coordinate system.

NOTES

If scale factors other than 1 are applied to the modelview matrix and lighting is enabled, lighting often appears wrong. In that case, enable automatic normalization of normals by calling %f3glEnablefP with the argument %f3GL_NORMALIZEfP.

ERRORS

%f3GL_INVALID_OPERATIONfP is generated if %f3glScalefP is executed between the execution of %f3glBeginfP and the corresponding execution of %f3glEndfP.

ASSOCIATED GETS

%f3glGetfP with argument %f3GL_MATRIX_MODEfP
%f3glGetfP with argument %f3GL_COLOR_MATRIXfP
%f3glGetfP with argument %f3GL_MODELVIEW_MATRIXfP
%f3glGetfP with argument %f3GL_PROJECTION_MATRIXfP
%f3glGetfP with argument %f3GL_TEXTURE_MATRIXfP