1. 1 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Programming with OpenGL Part 1: Background

2. 2 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Objectives Development of the OpenGL API OpenGL Architecture ­OpenGL as a state machine Functions ­Types ­Formats Simple program

3. 3 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 OpenGL The success of OpenGL (1992), a platform-independent API that was ­Easy to use ­Close enough to the hardware to get excellent performance ­Focus on rendering ­Omitted windowing and input to avoid window system dependencies

4. 4 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 GLUT OpenGL Utility Toolkit (GLUT) ­Provides functionality common to all window systems Open a window Get input from mouse and keyboard Menus Event-driven ­Code is portable but GLUT lacks the functionality of a good toolkit for a specific platform No slide bars

5. 5 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Software Organization GLUT GLU GL GLX, AGL or WGL X, Win32, Mac O/S software and/or hardware application program OpenGL Motif widget or similar

6. 6 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 OpenGL Architecture Immediate Mode Display List Polynomial Evaluator Per Vertex Operations & Primitive Assembly Rasterization Per Fragment Operations Texture Memory CPU Pixel Operations Frame Buffer geometry pipeline

7. 7 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 OpenGL Functions Primitives ­Points ­Line Segments ­Polygons Attributes Transformations ­Viewing ­Modeling Control (GLUT) Input (GLUT) Query

8. 8 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 OpenGL State OpenGL is a state machine OpenGL functions are of two types ­Primitive generating Can cause output if primitive is visible How vertices are processed and appearance of primitive are controlled by the state ­State changing Transformation functions Attribute functions

9. 9 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Lack of Object Orientation OpenGL is not object oriented so that there are multiple functions for a given logical function ­glVertex3f ­glVertex2i ­glVertex3dv Underlying storage mode is the same Easy to create overloaded functions in C++ but issue is efficiency

10. 10 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 OpenGL function format glVertex3f(x,y,z) belongs to GL library function name x,y,z are floats glVertex3fv(p) p is a pointer to an array dimensions

11. 11 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 OpenGL #defines Most constants are defined in the include files gl.h, glu.h and glut.h ­Note #include should automatically include the others ­Examples ­glBegin(GL_POLYGON) ­glClear(GL_COLOR_BUFFER_BIT) include files also define OpenGL data types: GLfloat, GLdouble,….

12. 12 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 A Simple Program Generate a square on a solid background

13. 13 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 simple.c #include void mydisplay(){ glClear(GL_COLOR_BUFFER_BIT); glBegin(GL_POLYGON); glVertex2f(-0.5, -0.5); glVertex2f(-0.5, 0.5); glVertex2f(0.5, 0.5); glVertex2f(0.5, -0.5); glEnd(); glFlush(); } int main(int argc, char** argv){ glutCreateWindow("simple"); glutDisplayFunc(mydisplay); glutMainLoop(); }

14. 14 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Event Loop Note that the program defines a display callback function named mydisplay ­Every glut program must have a display callback ­The display callback is executed whenever OpenGL decides the display must be refreshed ­The display callback is executed whenever OpenGL decides the display must be refreshed, for example when the window is opened ­The main function ends with the program entering an event loop

15. 15 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Compilation on Windows Visual C++ ­Get glut.h, glut32.lib and glut32.dll from web ­Create a console application ­Add opengl32.lib, glut32.lib, glut32.lib to project settings (under link tab) Borland C similar Cygwin (linux under Windows) ­Can use gcc and similar makefile to linux ­Use –lopengl32 –lglu32 –lglut32 flags

16. 16 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Programming with OpenGL Part 2: Complete Programs

17. 17 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Objectives Refine the first program ­Alter the default values ­Introduce a standard program structure Simple viewing ­Two-dimensional viewing as a special case of three-dimensional viewing Fundamental OpenGL primitives Attributes

18. 18 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Program Structure Most OpenGL programs have a similar structure that consists of the following functions ­main() : defines the callback functions opens one or more windows with the required properties enters event loop (last executable statement) ­init() : sets the state variables Viewing Attributes ­callbacks Display function Input and window functions

19. 19 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 simple.c revisited In this version, we shall see the same output but we have defined all the relevant state values through function calls using the default values In particular, we set ­Colors ­Viewing conditions ­Window properties

20. 20 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 main.c #include int main(int argc, char** argv) { glutInit(&argc,argv); glutInitDisplayMode(GLUT_SINGLE|GLUT_RGB); glutInitWindowSize(500,500); glutInitWindowPosition(0,0); glutCreateWindow("simple"); glutDisplayFunc(mydisplay); init(); glutMainLoop(); } includes gl.h define window properties set OpenGL state enter event loop display callback

21. 21 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 GLUT functions glutInit allows application to get command line arguments and initializes system gluInitDisplayMode requests properties for the window (the rendering context) ­RGB color ­Single buffering ­Properties logically ORed together glutWindowSize in pixels glutWindowPosition from top-left corner of display glutCreateWindow create window with title “simple” glutDisplayFunc display callback glutMainLoop enter infinite event loop

22. 22 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 init.c void init() { glClearColor (0.0, 0.0, 0.0, 1.0); glColor3f(1.0, 1.0, 1.0); glMatrixMode (GL_PROJECTION); glLoadIdentity (); glOrtho(-1.0, 1.0, -1.0, 1.0, -1.0, 1.0); } black clear color opaque window fill/draw with white viewing volume

23. 23 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 OpenGL Camera OpenGL places a camera at the origin in object space pointing in the negative z direction The default viewing volume is a box centered at the origin with a side of length 2

24. 24 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Orthographic Viewing z=0 In the default orthographic view, points are projected forward along the z axis onto the plane z=0

25. 25 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Transformations and Viewing In OpenGL, projection is carried out by a projection matrix (transformation) There is only one set of transformation functions so we must set the matrix mode first glMatrixMode (GL_PROJECTION) Transformation functions are incremental so we start with an identity matrix and alter it with a projection matrix that gives the view volume glLoadIdentity(); glOrtho(-1.0, 1.0, -1.0, 1.0, -1.0, 1.0);

26. 26 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Two- and three- dimensional viewing nearfar fromIn glOrtho(left, right, bottom, top, near, far) the near and far distances are measured from the camera Two-dimensional vertex commands place all vertices in the plane z=0 If the application is in two dimensions, we can use the function gluOrtho2D(left, right,bottom,top) In two dimensions, the view or clipping volume becomes a clipping window

27. 27 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 mydisplay.c void mydisplay() { glClear(GL_COLOR_BUFFER_BIT); glBegin(GL_POLYGON); glVertex2f(-0.5, -0.5); glVertex2f(-0.5, 0.5); glVertex2f(0.5, 0.5); glVertex2f(0.5, -0.5); glEnd(); glFlush(); }

28. 28 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 OpenGL Primitives GL_QUAD_STRIP GL_POLYGON GL_TRIANGLE_STRIP GL_TRIANGLE_FAN GL_POINTS GL_LINES GL_LINE_LOOP GL_LINE_STRIP GL_TRIANGLES

29. 29 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Polygon Issues OpenGL will only display polygons correctly that are ­Simple: edges cannot cross ­Convex: All points on line segment between two points in a polygon are also in the polygon ­Flat: all vertices are in the same plane User program can check if above true ­OpenGL will produce output if these conditions are violated but it may not be what is desired Triangles satisfy all conditions nonsimple polygon nonconvex polygon

30. 30 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Attributes Attributes are part of the OpenGL state and determine the appearance of objects ­Color (points, lines, polygons) ­Size and width (points, lines) ­Stipple pattern (lines, polygons) ­Polygon mode Display as filled: solid color or stipple pattern Display edges Display vertices

31. 31 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Color and State The color as set by glColor becomes part of the state and will be used until changed ­Colors and other attributes are not part of the object but are assigned when the object is rendered We can create conceptual vertex colors by code such as glColor glVertex glColor glVertex

32. 32 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Smooth Color Default is smooth shading ­OpenGL interpolates vertex colors across visible polygons Alternative is flat shading ­Color of first vertex determines fill color glShadeModel (GL_SMOOTH) or GL_FLAT

33. 33 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Viewports Do not have use the entire window for the image: glViewport(x,y,w,h) Values in pixels (screen coordinates)

34. 34 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Programming with OpenGL Part 3: Three Dimensions

35. 35 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Objectives Develop a more sophisticated three- dimensional example ­Sierpinski gasket: a fractal Introduce hidden-surface removal

36. 36 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Three-dimensional Applications In OpenGL, two-dimensional applications are a special case of three-dimensional graphics Going to 3D ­Not much changes ­Use glVertex3*( ) ­Have to worry about the order in which polygons are drawn or use hidden-surface removal ­Polygons should be simple, convex, flat

37. 37 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Sierpinski Gasket (2D) Start with a triangle Connect bisectors of sides and remove central triangle Repeat

38. 38 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Example Five subdivisions

39. 39 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 The gasket as a fractal Consider the filled area (black) and the perimeter (the length of all the lines around the filled triangles) As we continue subdividing ­the area goes to zero ­but the perimeter goes to infinity This is not an ordinary geometric object ­It is neither two- nor three-dimensional It is a fractal (fractional dimension) object

40. 40 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Gasket Program #include /* initial triangle */ GLfloat v[3][2]={{-1.0, -0.58}, {1.0, -0.58}, {0.0, 1.15}}; int n; /* number of recursive steps */

41. 41 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Draw one triangle void triangle( GLfloat *a, GLfloat *b, GLfloat *c) /* display one triangle */ { glVertex2fv(a); glVertex2fv(b); glVertex2fv(c); }

42. 42 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Triangle Subdivision void divide_triangle(GLfloat *a, GLfloat *b, GLfloat *c, int m) { /* triangle subdivision using vertex numbers */ point2 v0, v1, v2; int j; if(m>0) { for(j=0; j<2; j++) v0[j]=(a[j]+b[j])/2; for(j=0; j<2; j++) v1[j]=(a[j]+c[j])/2; for(j=0; j<2; j++) v2[j]=(b[j]+c[j])/2; divide_triangle(a, v0, v1, m-1); divide_triangle(c, v1, v2, m-1); divide_triangle(b, v2, v0, m-1); } else(triangle(a,b,c)); /* draw triangle at end of recursion */ }

43. 43 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 display and init Functions void display() { glClear(GL_COLOR_BUFFER_BIT); glBegin(GL_TRIANGLES); divide_triangle(v[0], v[1], v[2], n); glEnd(); glFlush(); } void myinit() { glMatrixMode(GL_PROJECTION); glLoadIdentity(); gluOrtho2D(-2.0, 2.0, -2.0, 2.0); glMatrixMode(GL_MODELVIEW); glClearColor (1.0, 1.0, 1.0,1.0) glColor3f(0.0,0.0,0.0); }

44. 44 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 main Function int main(int argc, char **argv) { n=4; glutInit(&argc, argv); glutInitDisplayMode(GLUT_SINGLE|GLUT_RGB); glutInitWindowSize(500, 500); glutCreateWindow(“2D Gasket"); glutDisplayFunc(display); myinit(); glutMainLoop(); }

45. 45 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Efficiency Note By having the glBegin and glEnd in the display callback rather than in the function triangle and using GL_TRIANGLES rather than GL_POLYGON in glBegin, we call glBegin and glEnd only once for the entire gasket rather than once for each triangle

46. 46 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Moving to 3D We can easily make the program three- dimensional by using GLfloat v[3][3] glVertex3f glOrtho But that would not be very interesting Instead, we can start with a tetrahedron

47. 47 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 3D Gasket We can subdivide each of the four faces Appears as if we remove a solid tetrahedron from the center leaving four smaller tetrahedra

48. 48 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Example after 5 iterations

49. 49 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 triangle code void triangle( GLfloat *a, GLfloat *b, GLfloat *c) { glVertex3fv(a); glVertex3fv(b); glVertex3fv(c); }

50. 50 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 subdivision code void divide_triangle(GLfloat *a, GLfloat *b, GLfloat *c, int m) { GLfloat v1[3], v2[3], v3[3]; int j; if(m>0) { for(j=0; j<3; j++) v1[j]=(a[j]+b[j])/2; for(j=0; j<3; j++) v2[j]=(a[j]+c[j])/2; for(j=0; j<3; j++) v3[j]=(b[j]+c[j])/2; divide_triangle(a, v1, v2, m-1); divide_triangle(c, v2, v3, m-1); divide_triangle(b, v3, v1, m-1); } else(triangle(a,b,c)); }

51. 51 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 tetrahedron code void tetrahedron( int m) { glColor3f(1.0,0.0,0.0); divide_triangle(v[0], v[1], v[2], m); glColor3f(0.0,1.0,0.0); divide_triangle(v[3], v[2], v[1], m); glColor3f(0.0,0.0,1.0); divide_triangle(v[0], v[3], v[1], m); glColor3f(0.0,0.0,0.0); divide_triangle(v[0], v[2], v[3], m); }

52. 52 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Almost Correct Because the triangles are drawn in the order they are defined in the program, the front triangles are not always rendered in front of triangles behind them get this want this

53. 53 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Hidden-Surface Removal We want to see only those surfaces in front of other surfaces OpenGL uses a hidden-surface method called the z-buffer algorithm that saves depth information as objects are rendered so that only the front objects appear in the image

54. 54 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Using the z-buffer algorithm The algorithm uses an extra buffer, the z-buffer, to store depth information as geometry travels down the pipeline It must be ­Requested in main.c glutInitDisplayMode (GLUT_SINGLE | GLUT_RGB | GLUT_DEPTH) ­Enabled in init.c glEnable(GL_DEPTH_TEST) ­Cleared in the display callback glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT)

55. 55 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Surface vs Volume Subdvision In our example, we divided the surface of each face We could also divide the volume using the same midpoints The midpoints define four smaller tetrahedrons, one for each vertex Keeping only these tetrahedrons removes a volume in the middle See text for code

56. 56 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Volume Subdivision

57. 57 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Input and Interaction Ed Angel Professor of Computer Science, Electrical and Computer Engineering, and Media Arts University of New Mexico

58. 58 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Objectives Introduce the basic input devices ­Physical Devices ­Logical Devices ­Input Modes Event-driven input Introduce double buffering for smooth animations Programming event input with GLUT

59. 59 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Project Sketchpad Ivan Sutherland (MIT 1963) established the basic interactive paradigm that characterizes interactive computer graphics: ­User sees an object on the display ­User points to (picks) the object with an input device (light pen, mouse, trackball) ­Object changes (moves, rotates, morphs) ­Repeat

60. 60 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Graphical Input Devices can be described either by ­Physical properties Mouse Keyboard Trackball ­Logical Properties What is returned to program via API –A position –An object identifier Modes ­How and when input is obtained Request or event

61. 61 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Physical Devices mousetrackball light pen data tablet joy stick space ball

62. 62 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Incremental (Relative) Devices Devices such as the data tablet return a position directly to the operating system Devices such as the mouse, trackball, and joy stick return incremental inputs (or velocities) to the operating system ­Must integrate these inputs to obtain an absolute position Rotation of cylinders in mouse Roll of trackball Difficult to obtain absolute position Can get variable sensitivity

63. 63 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Logical Devices Consider the C and C++ code ­C++: cin >> x; ­C: scanf (“%d”, &x); What is the input device? ­Can’t tell from the code ­Could be keyboard, file, output from another program The code provides logical input ­A number (an int ) is returned to the program regardless of the physical device

64. 64 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Graphical Logical Devices Graphical input is more varied than input to standard programs which is usually numbers, characters, or bits Two older APIs (GKS, PHIGS) defined six types of logical input ­Locator: return a position ­Pick: return ID of an object ­Keyboard: return strings of characters ­Stroke: return array of positions ­Valuator: return floating point number ­Choice: return one of n items

65. 65 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 X Window Input The X Window System introduced a client-server model for a network of workstations ­Client: OpenGL program ­Graphics Server: bitmap display with a pointing device and a keyboard

66. 66 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Input Modes Input devices contain a trigger which can be used to send a signal to the operating system ­Button on mouse ­Pressing or releasing a key When triggered, input devices return information (their measure) to the system ­Mouse returns position information ­Keyboard returns ASCII code

67. 67 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Request Mode Input provided to program only when user triggers the device Typical of keyboard input ­Can erase (backspace), edit, correct until enter (return) key (the trigger) is depressed

68. 68 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Event Mode Most systems have more than one input device, each of which can be triggered at an arbitrary time by a user Each trigger generates an event whose measure is put in an event queue which can be examined by the user program

69. 69 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Event Types Window: resize, expose, iconify Mouse: click one or more buttons Motion: move mouse Keyboard: press or release a key Idle: nonevent ­Define what should be done if no other event is in queue

70. 70 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Callbacks Programming interface for event-driven input Define a callback function for each type of event the graphics system recognizes This user-supplied function is executed when the event occurs GLUT example: glutMouseFunc(mymouse) mouse callback function

71. 71 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 GLUT callbacks GLUT recognizes a subset of the events recognized by any particular window system (Windows, X, Macintosh) ­glutDisplayFunc ­glutMouseFunc ­glutReshapeFunc ­glutKeyboardFunc ­glutIdleFunc ­glutMotionFunc, glutPassiveMotionFunc

72. 72 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 GLUT Event Loop Recall that the last line in main.c for a program using GLUT must be glutMainLoop(); which puts the program in an infinite event loop In each pass through the event loop, GLUT ­looks at the events in the queue ­for each event in the queue, GLUT executes the appropriate callback function if one is defined ­if no callback is defined for the event, the event is ignored

73. 73 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 The display callback The display callback is executed whenever GLUT determines that the window should be refreshed, for example ­When the window is first opened ­When the window is reshaped ­When a window is exposed ­When the user program decides it wants to change the display In main.c ­glutDisplayFunc(mydisplay) identifies the function to be executed ­Every GLUT program must have a display callback

74. 74 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Posting redisplays Many events may invoke the display callback function ­Can lead to multiple executions of the display callback on a single pass through the event loop We can avoid this problem by instead using glutPostRedisplay(); which sets a flag. GLUT checks to see if the flag is set at the end of the event loop If set then the display callback function is executed

75. 75 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Animating a Display When we redraw the display through the display callback, we usually start by clearing the window ­glClear() then draw the altered display Problem: the drawing of information in the frame buffer is decoupled from the display of its contents ­Graphics systems use dual ported memory Hence we can see partially drawn display ­See the program single_double.c for an example with a rotating cube

76. 76 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Double Buffering Instead of one color buffer, we use two ­Front Buffer: one that is displayed but not written to ­Back Buffer: one that is written to but not displayed Program then requests a double buffer in main.c ­glutInitDisplayMode(GL_RGB | GL_DOUBLE) ­At the end of the display callback buffers are swapped void mydisplay() { glClear(GL_COLOR_BUFFER_BIT|….). /* draw graphics here */. glutSwapBuffers() }

77. 77 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Using the idle callback The idle callback is executed whenever there are no events in the event queue ­glutIdleFunc(myidle) ­Useful for animations void myidle() { /* change something */ t += dt glutPostRedisplay(); } Void mydisplay() { glClear(); /* draw something that depends on t */ glutSwapBuffers(); }

78. 78 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Using globals The form of all GLUT callbacks is fixed ­void mydisplay() ­void mymouse(GLint button, GLint state, GLint x, GLint y) Must use globals to pass information to callbacks float t; /*global */ void mydisplay() { /* draw something that depends on t }

79. 79 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Working with Callbacks Ed Angel Professor of Computer Science, Electrical and Computer Engineering, and Media Arts University of New Mexico

80. 80 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Objectives Learn to build interactive programs using GLUT callbacks ­Mouse ­Keyboard ­Reshape Introduce menus in GLUT

81. 81 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 The mouse callback glutMouseFunc(mymouse) void mymouse(GLint button, GLint state, GLint x, GLint y) Returns ­which button ( GLUT_LEFT_BUTTON, GLUT_MIDDLE_BUTTON, GLUT_RIGHT_BUTTON ) caused event ­state of that button ( GLUT_UP, GLUT_DOWN ) ­Position in window

82. 82 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Positioning The position in the screen window is usually measured in pixels with the origin at the top-left corner Consequence of refresh done from top to bottom OpenGL uses a world coordinate system with origin at the bottom left Must invert y coordinate returned by callback by height of window y = h – y; (0,0) h w

83. 83 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Obtaining the window size To invert the y position we need the window height ­Height can change during program execution ­Track with a global variable ­New height returned to reshape callback that we will look at in detail soon ­Can also use query functions glGetIntv glGetFloatv to obtain any value that is part of the state

84. 84 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Terminating a program In our original programs, there was no way to terminate them through OpenGL We can use the simple mouse callback void mouse(int btn, int state, int x, int y) { if(btn==GLUT_RIGHT_BUTTON && state==GLUT_DOWN) exit(0); }

85. 85 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Using the mouse position In the next example, we draw a small square at the location of the mouse each time the left mouse button is clicked This example does not use the display callback but one is required by GLUT; We can use the empty display callback function mydisplay(){}

86. 86 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Drawing squares at cursor location void mymouse(int btn, int state, int x, int y) { if(btn==GLUT_RIGHT_BUTTON && state==GLUT_DOWN) exit(0); if(btn==GLUT_LEFT_BUTTON && state==GLUT_DOWN) drawSquare(x, y); } void drawSquare(int x, int y) { y=w-y; /* invert y position */ glColor3ub( (char) rand()%256, (char) rand )%256, (char) rand()%256); /* a random color */ glBegin(GL_POLYGON); glVertex2f(x+size, y+size); glVertex2f(x-size, y+size); glVertex2f(x-size, y-size); glVertex2f(x+size, y-size); glEnd(); }

87. 87 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Using the motion callback We can draw squares (or anything else) continuously as long as a mouse button is depressed by using the motion callback ­glutMotionFunc(drawSquare) We can draw squares without depressing a button using the passive motion callback ­glutPassiveMotionFunc(drawSquare)

88. 88 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Using the keyboard glutKeyboardFunc(mykey) void mykey(unsigned char key, int x, int y) ­Returns ASCII code of key depressed and mouse location void mykey() { if(key == ‘Q’ | key == ‘q’) exit(0); }

89. 89 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Special and Modifier Keys GLUT defines the special keys in glut.h ­Function key 1: GLUT_KEY_F1 ­Up arrow key: GLUT_KEY_UP if(key == ‘GLUT_KEY_F1’ …… Can also check of one of the modifiers ­GLUT_ACTIVE_SHIFT ­GLUT_ACTIVE_CTRL ­GLUT_ACTIVE_ALT is depressed by glutGetModifiers() ­Allows emulation of three-button mouse with one- or two-button mice

90. 90 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Reshaping the window We can reshape and resize the OpenGL display window by pulling the corner of the window What happens to the display? ­Must redraw from application ­Two possibilities Display part of world Display whole world but force to fit in new window –Can alter aspect ratio

91. 91 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Reshape possiblities original reshaped

92. 92 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 The Reshape callback glutReshapeFunc(myreshape) void myreshape( int w, int h) ­Returns width and height of new window (in pixels) ­A redisplay is posted automatically at end of execution of the callback ­GLUT has a default reshape callback but you probably want to define your own The reshape callback is good place to put viewing functions because it is invoked when the window is first opened

93. 93 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Example Reshape This reshape preserves shapes by making the viewport and world window have the same aspect ratio void myReshape(int w, int h) { glViewport(0, 0, w, h); glMatrixMode(GL_PROJECTION); /* switch matrix mode */ glLoadIdentity(); if (w <= h) gluOrtho2D(-2.0, 2.0, -2.0 * (GLfloat) h / (GLfloat) w, 2.0 * (GLfloat) h / (GLfloat) w); else gluOrtho2D(-2.0 * (GLfloat) w / (GLfloat) h, 2.0 * (GLfloat) w / (GLfloat) h, -2.0, 2.0); glMatrixMode(GL_MODELVIEW); /* return to modelview mode */ }

94. 94 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Toolkits and Widgets Most window systems provide a toolkit or library of functions for building user interfaces that use special types of windows called widgets Widget sets include tools such as ­Menus ­Slidebars ­Dials ­Input boxes But toolkits tend to be platform dependent GLUT provides a few widgets including menus

95. 95 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Menus GLUT supports pop-up menus ­A menu can have submenus Three steps ­Define entries for the menu ­Define action for each menu item Action carried out if entry selected ­Attach menu to a mouse button

96. 96 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Defining a simple menu In main.c menu_id = glutCreateMenu(mymenu); glutAddmenuEntry(“clear Screen”, 1); gluAddMenuEntry(“exit”, 2); glutAttachMenu(GLUT_RIGHT_BUTTON); entries that appear when right button depressed identifiers clear screen exit

97. 97 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Menu actions ­Menu callback ­Note each menu has an id that is returned when it is created ­Add submenus by glutAddSubMenu(char *submenu_name, submenu id) void mymenu(int id) { if(id == 1) glClear(); if(id == 2) exit(0); } entry in parent menu

98. 98 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Other functions in GLUT Dynamic Windows ­Create and destroy during execution Subwindows Multiple Windows Changing callbacks during execution Timers Portable fonts ­glutBitmapCharacter ­glutStrokeCharacter

99. 99 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Better Interactive Programs Ed Angel Professor of Computer Science, Electrical and Computer Engineering, and Media Arts University of New Mexico

100. 100 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Objectives Learn to build more sophisticated interactive programs using ­Picking Select objects from the display Three methods ­Rubberbanding Interactive drawing of lines and rectangles ­Display Lists Retained mode graphics

101. 101 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Picking Identify a user-defined object on the display In principle, it should be simple because the mouse gives the position and we should be able to determine to which object(s) a position corresponds Practical difficulties ­Pipeline architecture is feed forward, hard to go from screen back to world ­Complicated by screen being 2D, world is 3D ­How close do we have to come to object to say we selected it?

102. 102 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Three Approaches Hit list ­Most general approach but most difficult to implement Use back or some other buffer to store object ids as the objects are rendered Rectangular maps ­Easy to implement for many applications ­See paint program in text

103. 103 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Rendering Modes OpenGL can render in one of three modes selected by glRenderMode(mode) ­GL_RENDER : normal rendering to the frame buffer (default) ­GL_FEEDBACK : provides list of primitives rendered but no output to the frame buffer ­GL_SELECTION : Each primitive in the view volume generates a hit record that is placed in a name stack which can be examined later

104. 104 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Selection Mode Functions glSelectBuffer() : specifies name buffer glInitNames() : initializes name buffer glPushName(id) : push id on name buffer glPopName() : pop top of name buffer glLoadName(id) : replace top name on buffer id is set by application program to identify objects

105. 105 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Using Selection Mode Initialize name buffer Enter selection mode (using mouse) Render scene with user-defined identifiers Reenter normal render mode ­This operation returns number of hits Examine contents of name buffer (hit records) ­Hit records include id and depth information

106. 106 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Selection Mode and Picking As we just described it, selection mode won’t work for picking because every primitive in the view volume will generate a hit Change the viewing parameters so that only those primitives near the cursor are in the altered view volume ­Use gluPickMatrix (see text for details)

107. 107 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Using Regions of the Screen Many applications use a simple rectangular arrangement of the screen ­Example: paint/CAD program Easier to look at mouse position and determine which area of screen it is in than using selection mode picking drawing area too ls menus

108. 108 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Using another buffer and colors for picking For a small number of objects, we can assign a unique color (often in color index mode) to each object We then render the scene to a color buffer other than the front buffer so the results of the rendering are not visible We then get the mouse position and use glReadPixels() to read the color in the buffer we just wrote at the position of the mouse The returned color gives the id of the object

109. 109 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Writing Modes frame buffer application ‘ bitwise logical operation

110. 110 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 XOR write Usual (default) mode: source replaces destination (d’ = s) ­Cannot write temporary lines this way because we cannot recover what was “under” the line in a fast simple way Exclusive OR mode (XOR) (d’ = d  s) ­x  y  x =y ­Hence, if we use XOR mode to write a line, we can draw it a second time and line is erased!

111. 111 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Rubberbanding Switch to XOR write mode Draw object ­For line can use first mouse click to fix one endpoint and then use motion callback to continuously update the second endpoint ­Each time mouse is moved, redraw line which erases it and then draw line from fixed first position to to new second position ­At end, switch back to normal drawing mode and draw line ­Works for other objects: rectangles, circles

112. 112 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Rubberband Lines initial display draw line with mouse in XOR mode mouse moved to new position first point second point original line redrawn with XOR new line drawn with XOR

113. 113 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 XOR in OpenGL There are 16 possible logical operations between two bits All are supported by OpenGL ­Must first enable logical operations glEnable(GL_COLOR_LOGIC_OP) ­Choose logical operation glLogicOp(GL_XOR) glLogicOp(GL_COPY) (default)

114. 114 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Immediate and Retained Modes Recall that in a standard OpenGL program, once an object is rendered there is no memory of it and to redisplay it, we must re-execute the code for it ­Known as immediate mode graphics ­Can be especially slow if the objects are complex and must be sent over a network Alternative is define objects and keep them in some form that can be redisplayed easily ­Retained mode graphics ­Accomplished in OpenGL via display lists

115. 115 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Display Lists Conceptually similar to a graphics file ­Must define (name, create) ­Add contents ­Close In client-server environment, display list is placed on server ­Can be redisplayed without sending primitives over network each time

116. 116 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Display List Functions Creating a display list GLuint id; void init() { id = glGenLists( 1 ); glNewList( id, GL_COMPILE ); /* other OpenGL routines */ glEndList(); } Call a created list void display() { glCallList( id ); }

117. 117 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Display Lists and State Most OpenGL functions can be put in display lists State changes made inside a display list persist after the display list is executed Can avoid unexpected results by using glPushAttrib and glPushMatrix upon entering a display list and glPopAttrib and glPopMatrix before exiting

118. 118 Angel: Interactive Computer Graphics 5E © Addison-Wesley 2009 Hierarchy and Display Lists Consider model of a car ­Create display list for chassis ­Create display list for wheel glNewList( CAR, GL_COMPILE ); glCallList( CHASSIS ); glTranslatef( … ); glCallList( WHEEL ); glTranslatef( … ); glCallList( WHEEL ); … glEndList(); Consider model of a car ­Create display list for chassis ­Create display list for wheel glNewList( CAR, GL_COMPILE ); glCallList( CHASSIS ); glTranslatef( … ); glCallList( WHEEL ); glTranslatef( … ); glCallList( WHEEL ); … glEndList();