Download: 1. Tarball from http://www.inference.phy.cam.ac.uk/opengazer/ 2. Or from sourceforge http://sourceforge.net/projects/opengazer $ svn co https://opengazer.svn.sourceforge.net/svnroot/opengazer Requirements: vxl >= 1.5.1 http://vxl.sourceforge.net/ opencv >= 0.9.7 http://sourceforge.net/projects/opencvlibrary gtkmm-2.4 >= 2.8.0 http://www.gtkmm.org/ cairomm-1.0 >= 0.6.0 http://cairographics.org/cairomm/ boost >= 1.32.0 http://www.boost.org/ Under Debian testing: # apt-get install libcv-dev libhighgui-dev libcvaux-dev \ libgtkmm-2.4-dev libcairomm-1.0-dev libboost-dev (vxl must be installed from the source) Important: in vxl's ccmake, set BUILD_SHARED_LIBS to ON. Compilation: > tar xzf opengazer-0.1.tar.gz > cd opengazer-0.1 Edit the VXLDIR variable in the Makefile to point to your vxl include headers > make Define the variable LD_LIBRARY_PATH to point to your vxl shared libraries > export LD_LIBRARY_PATH=$VXLDIR/lib Instructions: 0. Make sure that you have read access to webcam device file (/dev/video0). In Debian/Ubuntu you can achieve that by adding yourself to the video group > sudo addgroup $USER video Then logout and login again (important). 1. Set up the drivers to your camera correctly. Put the camera into 640x480 mode. With pwc drivers you have to say > sudo rmmod pwc > sudo modprobe pwc size=vga 2. Put the camera centrally under you monitor, so that the height of your face in the image is about half of the height of the image, and close to the centre of the image. Make sure the background light level is reasonably constant across the image. 3. Make VXLDIR point to your vxl libraries, for example > export VXLDIR=/opt Define the variable LD_LIBRARY_PATH to point to your vxl shared libraries > export LD_LIBRARY_PATH=$VXLDIR/lib:$LD_LIBRARY_PATH Start the opengazer program > ./opengazer 4. While keeping your head still, use the mouse to select points on your face that will be used to track your head. The first two points much be eye corners. Select at least two other salient points (recommended 7-8 in total). Double-clicking on an existing point removes it. The first two points (corresponding to eye corners) will be blue, the other will be green. When a point becomes red, it means that it lost track. When you are happy with your selection, click "Save points". You need at least four points in total, but I recommend 7-8. Once they have been selected, the position of your head will be tracked and the rotation estimates displayed as white and blue lines from the center of the screen. The blue line indicates the difference in head position between the first frame and the current position: make sure that it is as short as possible at all times! 5. Now you can exit the program, run it again, click "load points", and the points you selected in point 3 should appear. You have probably noted a white and blue line in the center of the image; they indicate the current rotation of your head. The shorter the blue line, the closer your head position is to the original. While using the gaze tracker, try to orient your head so that the length of the blue line is as small as possible. 6. The next step is calibration. Remember, in order for this gaze tracker to work, you must keep your head absolutely still. Press "Calibrate". You will now be asked to look at various points on the screen, indicated by a red circle. Remember: do not move your head, only your eyes! 7. During the calibration and afterwards, a small blue will indicate the estimated position of your gaze focus. DEVELOPING OPENGAZER 1. The coordinates of the calibration points are stored in "calpoints.txt". Feel free to change them. For example, by having only two calibration points: one on the left of the screen, and the other on the right, you can use opengazer as a binary switch. 2. Opengazer shows the current estimate of the gaze point as a small purle circle on the screen. It also outputs this information to the standard output. Each line has the format Xcoordinate Ycoordinate -> IDoftheclosestcalibrationpoint Opengazer also opens a local UDP socket at port 20230 to which it sends the current estimates X and Y. To add more output methods, or to change the existing one, take a look at files "OutputMethods.cpp" and "OutputMethods.h". 3. Other files used by opengazer calpoints.txt Coordinates calibration points (as fraction of the screen) points.txt Coordinates of the tracking points on the user face, in pixels. This file is saved when the user clicks "Save points"