glViewport.3gl







Name

  glViewport - set the viewport





C Specification

  void glViewport( GLint x,

		   GLint y,

		   GLsizei width,

		   GLsizei height )





Parameters



  x, y Specify the lower left corner of	the viewport rectangle,	in pixels.

       The default is (0,0).



  width, height

       Specify the width and height, respectively, of the viewport.  When a

       GL context is first attached to a window, width and height are set to

       the dimensions of that window.



Description

  glViewport specifies the affine transformation of x and y from normalized

  device coordinates to	window coordinates.  Let (x  , y  ) be normalized

                                                   nd   nd

  device coordinates.  Then the	window coordinates x , y ) are computed as

  follows:					    w	w



                                        width

			    x  = (x  +1)----- + x

			     w	   nd	  2  



                                        height

			    y  = (y  +1)------ + y

			     w	   nd	   2  



  Viewport width and height are	silently clamped to a range that depends on

  the implementation.  This range is queried by	calling	glGet with argument

  GL_MAX_VIEWPORT_DIMS.



Errors

  GL_INVALID_VALUE is generated	if either width	or height is negative.



  GL_INVALID_OPERATION is generated if glViewport is executed between the

  execution of glBegin and the corresponding execution of glEnd.



Associated Gets

  glGet	with argument GL_VIEWPORT

  glGet	with argument GL_MAX_VIEWPORT_DIMS



See Also

  glDepthRange


Introduction | Alphabetic | Specification

Last Edited: Fri, May 26, 1995

AFV