Gaze Meta Data
This page specifies the meta-data for gaze-parameter recordings (e.g., from an eye tracker).
If a stream has the content-type Gaze, we recommend that meta-data about the stream adheres to the structure and naming laid out in the following. While all meta-data is optional, we recommend that any stream should describe at least for each channel the label, eye, type and unit parameters.
<channels> # specification of the channel layout <channel> # information about a single channel (repeated for each) <label> # label of the channel <eye> # which eye the channel is referring to (can be left, right, or both) <type> # type of data in this channel, can be an of the following values: # ** ScreenX, ScreenY: screen coordinates of the gaze cursor (can also refer to a scene image), usually in pixels, # ** DirectionX,DirectionY,DirectionZ: 3d gaze vector in some coordinate system # ** PositionX,PositionY,PositionZ: 3d position of the eye center in some coordinate system # ** IntersectionX, IntersectionY, IntersectionZ: 2d or 3d position of the intersection point with a plane (in some coordinate system) # ** HeadX, HeadY, HeadZ: 3d location of the head center in some coordinate system, # ** PupilX, PupilY, PupilZ: 2d or 3d location of the pupil center in some coordinate system, # ** ReflexX, ReflexY, ReflexZ: 2d or 3d location of the illuminator's reflection point in some coordinate system, # ** Radius or Diameter: the overall pupil radius or diameter (usually in mm or pixels), # ** RadiusX,RadiusY: horizontal and vertical pupil radius # ** DiameterX,DiameterY: horizontal and vertical pupil diameter # ** Confidence for confidence information (preferred unit: normalized) # ** FrameNumber: frame number that the parameters were calculated from # * PlaneNumber or ObjectId: number or identifier of the object that was intersected by the gaze vector <unit> # measurement unit (e.g., pixels, mm, normalized) <coordinate_system> # coordinate system of the respective parameter, can be world-space, object-space, camera-space, or image-space </channel> </channels> <acquisition> # information about the acquisition system <manufacturer> # manufacturer of the device <model> # model name of the device <serial_number> # serial number of the device </acquisition>