redefine recording data format about pupil HOT 8 CLOSED

Gaze and pupil pos are now separated.
Need to decide and test video file container and codec

from pupil.

Video Format: Matroska: http://matroska.org/technical/whatis/index.html

Pros:

• open source
• modern
• supported by Windows10, Android and Ubuntu
• Everywhere else it will play with VLC

Cons:

• does not play on Apple Quicktime player.

from pupil.

Codec should be left unspecified but all used codecs should be supported by our media backend.

from pupil.

timestamps should be called world_timestamps

from pupil.

For instance, about the cons, this is from the matroska FAQ list:

Q: How can i play Matroska files on my PC ?
A: On the download page you will always find the link to the very latest DirectShow parser filter, that way you will be able to play your .mkv files on a DirectShow based player such as Windows Mediaplayer. For Linux PCs, as well as for MacOSX and the X-Box emulation you have to get the newest version of VLC or mplayer. On OS X you can also install Perian which will add Matroska support in Quicktime.

from pupil.

@cpicanco according to recent news .mkv files will be natively supported on Windows 8.1. So to me the only 'con' regarding non-native playback would be on MacOS as @mkassner listed above - which can be worked around by using VLC. See also this wikipedia page comparing container formats.

from pupil.

I would also like to use something more widespread and common as .mp4 the problem is however that its not open and ill supported by gstreamer (which is used by opencv).

from pupil.

The format as it stands now is:

• info.csv
• pupil_positions.npy
• gaze_positions.npy
• world.mkv
• world_timestamps.npy
• eye.mkv (optional)
• eye_timestamps.npy (optional)

If there are issues and requests please re-open this issue or raise a new one with reference to #21

from pupil.