1. Computer Graphics Lecture 34

2. OpenGL Programming II Taqdees A. Siddiqi cs602@vu.edu.pk

3. We will start with a simple program; source code is provided in notes; here we will discuss it to get a better understanding of OpenGL programming.

4. This program first sets perspective projection matrix and then renders a triangle in the “idle” function.

5. glMatrixMode

6. glMatrixMode function specifies which matrix is the current matrix. void glMatrixMode( GLenum mode); The matrix stack that is the target for resulting matrix operations. The mode parameter can:

7. ValueMeaning GL_MODELVIEWApplies subsequent matrix GL_PROJECTIONApplies subsequent matrix operations to the projection matrix stack. GL_TEXTUREApplies subsequent matrix operations to the texture matrix stack.

8. glMatrixMode function sets the current matrix mode. The following function retrieves information related to glMatrixMode:

9. Error codeCondition GL_INVALID_EN UM mode was not an accepted value GL_INVALID_OPE RATION glMatrixMode was called between a call to glBegin and the corresponding call to glEnd Following are the error codes generated and conditions.

10. glLoadIdentity

11. void glLoadIdentity( void ); glLoadIdentity function replaces the current matrix with the identity matrix. It is semantically equivalent to calling glLoadMatrix with the identity matrix.

12. The following is the error code and its condition.

13. Error codeCondition GL_INVALID_OPE RATION glLoadIdentity was called between a call to glBegin and the corresponding call to glEnd.

14. glTranslated, glTranslatef

15. glTranslated and glTranslatef functions multiply the current matrix by a translation matrix. void glTranslated( GLdouble, GLdouble y, GLdouble z); void glTranslatef( GLfloat x, GLfloat y, GLfloat z );

16. glTranslate function produces the translation specified by (x, y, z). The translation vector is used to compute a 4x4 translation matrix:

18. The current matrix is multiplied by translation matrix, with the product replacing the current matrix. MT

19. 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.

20. The following is the error code and its condition. Error codeCondition GL_INVALID_O PERATION glTranslate was called between a call to glBegin and the corresponding call to glEnd.

21. gluPerspective

22. The gluPerspective is the function of gl utility library. This function sets up a perspective projection matrix.

23. void gluPerspective( GLdouble fovy, GLdouble aspect, GLdouble zNear, GLdouble zFar);

24. The field of view angle, in degrees, in the y-direction. The aspect ratio that determines the field of view in the x-direction. The aspect ratio is the ratio of x (width) to y (height).

25. The distance from the viewer to the near clipping plane (always positive). The distance from the viewer to the far clipping plane (always positive).

26. The gluPerspective function specifies a viewing frustum into the world coordinate system. In general, the aspect ratio in gluPerspective should match the aspect ratio of the associated viewport.

27. For example, aspect = 2.0 means the viewer's angle of view is twice as wide in x as it is in y. If the viewport is twice as wide as it is tall, it displays the image without distortion.

28. The matrix generated by gluPerspective is multiplied by the current matrix, just as if glMultMatrix were called. To load the perspective matrix onto the current matrix stack instead, precede the call to gluPerspective with a call to glLoadIdentity.

29. glRotated, glRotatef

30. The glRotated and glRotatef functions multiply the current matrix by a rotation matrix.

31. void glRotated( GLdouble angle, GLdouble x, GLdouble y, GLdouble z); void glRotatef( GLfloat angle, GLfloat x, GLfloat y, GLfloat z);

32. The glRotate function computes a matrix that performs a counter- clockwise rotation of angle degrees about the vector from the origin through the point.

33. The current matrix is multiplied by rotation matrix, with the product replacing the current matrix. MR

34. The following is the error code and its condition. Error codeCondition GL_INVALID_OP ERATION glRotate was called between a call to glBegin and the corresponding call to glEnd.

35. glClearColor

36. The glClearColor function specifies clear values for the color buffers. void glClearColor( GLclampf red, GLclampf green, GLclampf blue, GLclampf alpha);

37. The glClearColor function specifies the red, green, blue, and alpha values used by glClear to clear the color buffers. Values specified by glClearColor are clamped to the range [0,1].

38. The following is the error code generated and its condition. Error codeCondition GL_INVALID_O PERATION glClearColor was called between a call to glBegin and the corresponding call to glEnd.

39. glColor

40. glColor3b, glColor3d, glColor3f, glColor3i, glColor3s, glColor3ub, glColor3ui, glColor3us, glColor4b, glColor4d. There are variety of color functions some of them given below, however complete list is provided in the notes.

41. void glColor3b( GLbyte red, GLbyte green, GLbyte blue); void glColor3f( GLfloat red, GLfloat green, GLfloat blue); A new alpha value for the current color. Included only in the four-argument glColor4 function.

42. OpenGL stores both a current single-valued color index and a current four-valued RGBA color. The glColor function sets a new four-valued RGBA color.

43. There are two major variants to glColor:  glColor3  glColor4

44. The glColor3b, glColor4b, glColor3s, glColor4s, glColor3i, and glColor4i functions take three or four signed byte, short, or long integers as arguments. When you append v to the name, the color functions can take a pointer to an array of such values.

45. Current color values stored in floating-point format, with unspecified mantissa and exponent sizes. Unsigned integer color components are linearly mapped to floating-point values such that the largest value maps to 1.0 and zero maps to 0.0

46. Signed integer color components are linearly mapped to floating-point values such that the most positive value maps to 1.0 and the most negative value maps to 0.0.

47. Neither floating-point nor signed integer values are clamped to the range [0,1] before updating the current color. However, color components are clamped to this range before interpolation.

48. You can update the current color at any time. In particular, you can call glColor between a call to glBegin and the corresponding call to glEnd.

49. glClear

50. The glClear function clears buffers to preset values. void glClear(GLbitfield mask); Bitwise OR operators of masks that indicate the buffers to be cleared. The four masks are as follows.

51. MaskBuffer to be Cleared GL_COLOR_BUF FER_BIT The buffers currently enabled for color writing. GL_DEPTH_BUF FER_BIT The depth buffer. GL_ACCUM_BUF FER_BIT The accumulation buffer. GL_STENCIL_BU FFER_BIT The stencil buffer.

52. The glClear function sets the bitplane area of the window to values previously selected by glClearColor, glClearIndex, glClearDepth, glClearStencil, and glClearAccum.

53. You can clear multiple color buffers simultaneously using glDrawBuffer.

54. The glClear function ignores the alpha function, blend function, logical operation, stenciling, texture mapping, and z- buffering.

55. The glClear function takes a single argument (mask) that is the bitwise OR of several values indicating which buffer is to be cleared. If a buffer is not present, a glClear call directed at that buffer has no effect.

56. Following are the error codes generated and their conditions. Error codeCondition GL_INVALID_ VALUE Any bit other than the four defined bits was set in mask.

57. Error codeCondition GL_INVALID_ OPERATION glClear was called between a call to glBegin and the corresponding call to glEnd.

58. glBegin, glEnd

59. The glBegin and glEnd functions delimit the vertices of a primitive or a group of like primitives. void glBegin( GLenum mode); void glEnd( void);

60. The following are accepted symbolic constants and their meanings: GL_POINTS: treats each vertex as a single point. Vertex n: defines point n. N points are drawn.

61. GL_LINES treats each pair of vertices as an independent line segment. Vertices 2n-1 and 2n define line n. N/2 lines are drawn. GL_LINE_STRIP draws a connected group of line segments from the first vertex to the last. Vertices n and n+1 define line n. N-1 lines are drawn.

62. GL_LINE_LOOP draws a connected group of line segments from the first vertex to the last, then back to the first. Vertices n and n+1 define line n. The last line, however, is defined by vertices N and 1. N lines are drawn.

63. GL_TRIANGLES treats each triplet of vertices as an independent triangle. Vertices 3n-2, 3n-1, and 3n define triangle n. N/3 triangles are drawn.

64. GL_TRIANGLE_STRIP draws a connected group of triangles. One triangle is defined for each vertex presented after the first two vertices. For odd n, vertices n, n + 1, and n + 2 define triangle n. For even n, vertices n + 1, n, and n + 2 define triangle n. N-2 triangles are drawn.

65. GL_TRIANGLE_FAN draws a connected group of triangles. One triangle is defined for each vertex presented after the first two vertices. Vertices 1, n + 1, and n + 2 define triangle n. N-2 triangles are drawn.

66. GL_QUADS treats each group of four vertices as an independent quadrilateral. Vertices 4n-3, 4n-2, 4n-1, and 4n define quadrilateral n. N/4 quadrilaterals are drawn.

67. GL_QUAD_STRIP draws a connected group of quadrilaterals. One quadrilateral is defined for each pair of vertices presented after the first pair. Vertices 2n-1, 2n, 2n + 1, and 2n + 2 define quadrilateral n. N quadrilaterals are drawn.

68. GL_POLYGON draws a single, convex polygon. Vertices 1 through N define this polygon.

69. The glBegin and glEnd functions delimit the vertices that define a primitive or a group of like primitives. Taking n as an integer count starting at one, and N as the total number of vertices specified, the interpretations are as follows:

70. You can use only a subset of OpenGL functions between glBegin and glEnd. The functions you can use are: glVertex glColor glIndex glNormal glMaterial

71. You can also use glCallList or glCallLists to execute display lists that include only the preceding functions. If any other OpenGL function is called between glBegin and glEnd, the error flag is set and the function is ignored.

72. Regardless of the value chosen for mode in glBegin, there is no limit to the number of vertices you can define between glBegin and glEnd. Lines, triangles, quadrilaterals, and polygons that are incompletely specified are not drawn.

73. The minimum specification of vertices for each primitive is: Minimum number of vertices Type of primitive 1Point 2Line 3Triangle 4Quadrilateral 3Polygon

74. Modes that require a certain multiple of vertices are GL_LINES (2), GL_TRIANGLES (3), GL_QUADS (4), and GL_QUAD_STRIP (2).

75. The following are the error codes generated and their conditions. Error codeCondition GL_INVALI D_ENUM mode was set to an unaccepted value. GL_INVALI D_OPERATI ON A function other than glVertex, glColor, glIndex, glNormal, glTexCoord, glEvalCoord, glEvalPoint, glMaterial, glEdgeFlag, glCallList, or glCallLists was called between glBegin and the corresponding glEnd.

76. The following are the error codes generated and their conditions. Error codeCondition GL_INVALID_O PERATION The function glEnd was called before the corresponding glBegin was called, or glBegin was called within a glBegin/glEnd sequence.

77. glVertex

78. There are variety of vertex functions some of them given below, however complete list is provided in the notes. glVertex2d, glVertex2f, glVertex2i, glVertex2s, glVertex3d, glVertex3f, glVertex3i, glVertex3s, glVertex4d.

79. void glVertex3f( GLfloat x, GLfloat y, GLfloat z); Consult notes to see for the other functions of the same nature.

80. The glVertex function commands are used within glBegin/glEnd pairs to specify point, line, and polygon vertices. The current color, normal, and texture coordinates are associated with the vertex when glVertex is called.

81. When only x and y are specified, z defaults to 0.0 and w defaults to 1.0. When x, y, and z are specified, w defaults to 1.0. Invoking glVertex outside of a glBegin/glEnd pair results in undefined behavior.

82. Computer Graphics Lecture 34