README.md 2.23 KB
Newer Older
Thiago Santini's avatar
Thiago Santini committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 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
WHAT IS EYEREC?

	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:
	http://www.ti.uni-tuebingen.de/Eyetrace.1751.0.html

WHICH EYE TRACKERS ARE SUPPORTED?

	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.

RUNNING:

	Prior to running, make sure you have the Visual C++ 2012 x86 run-time
	components installed. If not, you can install them with by running
	vcredist_x86.exe or downloading the installer directly from Microsoft at:
	https://www.microsoft.com/en-us/download/details.aspx?id=30679

	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:
	https://www.vrmagic.com/imaging/downloads/

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

BUILDING:

	Currently, the building is in the form of a QtCreator project (EyeRec.pro)

	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.

DEPENDENCIES:

	Qt >= 5.4
	OpenCV >= 3.0.0
	VideoMan 1.1