glFrontFace.3gl







Name

  glFrontFace -	define front- and back-facing polygons





C Specification

  void glFrontFace( GLenum mode	)





Parameters



  mode	Specifies the orientation of front-facing polygons.  GL_CW and GL_CCW

	are accepted.  The default value is GL_CCW.





Description

  In a scene composed entirely of opaque closed	surfaces, back-facing

  polygons are never visible.  Eliminating these invisible polygons has	the

  obvious benefit of speeding up the rendering of the image.  Elimination of

  back-facing polygons is enabled and disabled with glEnable and glDisable

  using	argument GL_CULL_FACE.



  The projection of a polygon to window	coordinates is said to have clockwise

  winding if an	imaginary object following the path from its first vertex,

  its second vertex, and so on,	to its last vertex, and	finally	back to	its

  first	vertex,	moves in a clockwise direction about the interior of the

  polygon.  The	polygon's winding is said to be	counterclockwise if the

  imaginary object following the same path moves in a counterclockwise

  direction about the interior of the polygon.	glFrontFace specifies whether

  polygons with	clockwise winding in window coordinates, or counterclockwise

  winding in window coordinates, are taken to be front-facing.	Passing

  GL_CCW to mode selects counterclockwise polygons as front-facing; GL_CW

  selects clockwise polygons as	front-facing.  By default, counterclockwise

  polygons are taken to	be front-facing.



Errors

  GL_INVALID_ENUM is generated if mode is not an accepted value.



  GL_INVALID_OPERATION is generated if glFrontFace is executed between the

  execution of glBegin and the corresponding execution of glEnd.



Associated Gets

  glGet	with argument GL_FRONT_FACE



See Also

  glCullFace, glLightModel








Introduction | Alphabetic | Specification

Last Edited: Mon, May 22, 1995

AFV