Lecture 10: Input, Interaction & callbacks CITS 3003 Graphics & Animation Slides: E. Angel and D. Shreiner: Interactive Computer Graphics 6E Addison-Wesley 2012
Objectives Introduce the basic input devices Physical Devices Logical Devices Input Modes Event-driven input Programming event input with GLUT An introduction to callbacks 2
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 3
Input Devices User inputs control the program through input devices Input devices can be viewed as o o Physical devices: described by their physical properties, e.g., mouse, keyboard, trackball, etc. Logical devices: characterized by how they influence the application program, e.g., what is returned to the program via the API An x, y position on the screen? An object identifier for a menu item chosen? Both are performed by the same physical device (the mouse, in this case) but what is returned to the program is different. 4
Physical Devices mouse trackball light pen data tablet joy stick space ball 5
Logical Input Devices Consider the C and C++ code o C++: cin >> x; o C: scanf( %d, &x); What is the input physical device? o Can t tell from the code o Could be keyboard, file, output from another program The code provides logical input o A number (an int) is returned to the program regardless of the physical device 6
Logical Input Devices (cont.) Older APIs (GKS, PHIGS, not OpenGL) defined six specific types of logical input: Locator: return a position, e.g., clicked at by a mouse pointer Choice: return one of n discrete items, e.g., a menu item String: return strings of characters, e.g., via key presses Stroke: return array of positions Valuator: return floating point number Pick: return ID of an object OpenGL and GLUT provide functions to handle all these 7
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 o 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 8
Input Modes Input devices contain a trigger which can be used to send a signal to the operating system o Button on mouse o Pressing or releasing a key When triggered, input devices return information (their measure) to the system o Mouse returns position information o Keyboard returns ASCII code 9
Input Modes (cont.) Input modes concern how and when input is obtained There are two types of input modes: o Request mode o Event mode 10
Request Mode For request mode input, the input value is provided to program only when user triggers the device A typical example is keyboard input: o The application program request a keyboard input from the user o The user can type, erase (backspace), correct. The application program hangs there until the enter (return) key (the trigger) is depressed 11
Event Mode Request mode is not suitable for programs that need to interact with the user. Most systems have more than one input device, each of which can be triggered at an arbitrary time by a user 12
Event Mode (cont.) In event mode input, the program specifies a number of input events that are of interest. The program gets into an event handling loop to deal with the events when they occur Each trigger generates an event whose measure is put in an event queue which can be examined by the user program 13
Event Types in event mode input Window event: resize, expose, iconify Mouse event: click one or more buttons Motion event: this refers to the mouse move event (when the cursor is inside the window of the application program) Keyboard: press or release a key Idle: non-event o Define what should be done if no other event is in the event queue 14
Callbacks We can program to handle event mode input We can define a callback function for each type of event that the graphics system recognizes This user-supplied function is executed when the event occurs GLUT example: glutmousefunc(mymouse) mouse callback function 15
GLUT callbacks GLUT recognizes a subset of the events recognized by any particular window system (Windows, X, Macintosh) o o o o o o o o glutdisplayfunc glutcreatemenu glutmousefunc glutreshapefunc glutkeyboardfunc glutidlefunc glutmotionfunc glutpassivemotionfunc 16
% usage glutmousefunc void glutmousefunc(void (*func)(int button, int state, int x, int y)); Example: glutmousefunc(mymousefun); % defined in the main() % the function definition void mymousefun(int button, int state, int x, int y) { % this is where you write code for what you want to do % when a mouse event happens } 17
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 1. looks at the events in the queue 2. for each event in the queue, GLUT executes the appropriate callback function if one is defined 3. if no callback is defined for the event, the event is ignored 18
The display callback The display callback is executed whenever GLUT determines that the window should be refreshed, for example o When the window is first opened o When the window is reshaped o When a window is exposed o When the user program decides it wants to change the display In main() o glutdisplayfunc(mydisplay) identifies the function to be executed o Every GLUT program must have a display callback 19
Posting redisplays Many events may invoke the display callback function o 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 20
Mid-Semester Test When Tuesday 10 April during the lecture 12:00-12:45PM Where In ENCM [G04] i.e. where Tuesday lectures are held What is included Everything from Lecture 1 to Lecture 10 What to bring to the test A pen to write with (no pencils, no books, no notes) See unit website for sample test from 2016 http://teaching.csse.uwa.edu.au/units/cits3003/index.php?fna me=lectures
Further Reading Interactive Computer Graphics A Top-Down Approach with Shader-Based OpenGL by Edward Angel and Dave Shreiner, 6 th Ed, 2012 Sec. 1.2.4-1.2.7 Input Devices, Physical Input Devices, Logical Devices, Input Modes Sec. 2.1 The Sierpinski Gasket; immediate mode graphics vs retained mode graphics C++ code in the Chapter02 to Chapter04 folders 22