2.33 KB
Newer Older
Thiago Santini's avatar
Thiago Santini committed
1 2 3 4 5 6 7 8 9 10 11 12 13

	EyeRec is a data acquisition software for head-mounted eye trackers. Its
	main raison d'être is to provide an open platform to replace the data
	acquisition functionality from eye-tracker vendors software, which typically
	are expensive and closed-source. Thus, if something is not working properly,
	you can fix it yourself instead of relying on the vendor to fix it; for
	instance, if the pupil detection algorithm does not suit your needs.

	For a replacement for the data analysis functionality, we recommend
	Eyetrace, which can be downloaded at:

Thiago Santini's avatar
Thiago Santini committed
14 15 16
	Why the name? It's a phonetical play on words and the eye-related
	functionality as in **I rec**(ord)

Thiago Santini's avatar
Thiago Santini committed
17 18 19 20 21 22 23 24 25 26 27 28 29

	Officially, the Dikablis Pro and Dikablis Essential because these are the
	ones we have access to.
	Theoretically, as long as your cameras are accesible through Microsoft
	DirectShow and at least one of them has a callback functionality, everything
	should work out of the box.
	If you are building your own eye tracker out of web cameras, we have
	succesfully tested EyeRec with the Microsoft Lifecam VX-1000.


	Prior to running, make sure you have the Visual C++ 2012 x86 run-time
Thiago Santini's avatar
Thiago Santini committed
	components installed. If not, you can install them by running
Thiago Santini's avatar
Thiago Santini committed
31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62
	vcredist_x86.exe or downloading the installer directly from Microsoft at:

	Additionally, you may need to install drivers to access your eye tracker
	cameras. For instance, Dikablis eye trackers require the VRMagic drivers,
	which can be downloaded at:

	Make sure you have the 32-bits version of the drivers!


	Currently, the building is in the form of a QtCreator project (

	The particulars of the test build system we use are:
	- QtCreator 3.3.2
	- Qt 5.4.1 (MSVC 2010, 32bit)
	- Visual Studio 2012

	For the 32-bits version, building should be as simple as installing Visual
	Studio and QtCreator, opening the project, running qmake, and building. All
	the dlls that EyeRec requires are already packed in the ./deps directory.

	64-bits builds are not officially supported at the moment. If one is needed,
	you will need to compile the dependencies for 64 bits a priori.


	Qt >= 5.4
	OpenCV >= 3.0.0
	VideoMan 1.1