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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
|
/*
Psychtoolbox-3/PsychSourceGL/Source/Common/Eyelink/EyelinkGetFloatData.c
PROJECTS: Eyelink
AUTHORS:
f.w.cornelissen@rug.nl fwc
E.Peters@ai.rug.nl emp
e_flister@yahoo.com edf
PLATFORMS: All
HISTORY:
29/05/2001 emp created it (OS9 version)
30/10/06 fwc Adapted from early alpha version.
19/02/09 edf added GetFloatDataRaw
23/03/09 edf adapted to handle LOST_DATA_EVENT and added eye argument to GetFloatDataRaw
*/
#include "PsychEyelink.h"
#define ERR_BUFF_LEN 1000
static char useString[] = "item = Eyelink('GetFloatData', type)";
static char synopsisString[] =
" Makes a copy of the last item."
" You have to supply the type (returned from Eyelink('GetNextDatatype'))."
" Returns the item.";
static char seeAlsoString[] = "";
/*
ROUTINE: EyelinkGetFloatData.c
PURPOSE:
uses INT16 CALLTYPE eyelink_get_float_data(void FARTYPE *buf);
makes copy of last item from getnextdatatype
You have to supply the type (returned from eyelink('getnextdatatype')).
Returns the item.*/
PsychError EyelinkGetFloatData(void)
{
FSAMPLE fs;
FEVENT fe;
int type = 0;
mxArray **mxpp;
//all sub functions should have these two lines
PsychPushHelp(useString, synopsisString, seeAlsoString);
if(PsychIsGiveHelp()){PsychGiveHelp();return(PsychError_none);};
//check to see if the user supplied superfluous arguments
PsychErrorExit(PsychCapNumInputArgs(1));
PsychErrorExit(PsychRequireNumInputArgs(1));
PsychErrorExit(PsychCapNumOutputArgs(1));
// Verify eyelink is up and running
EyelinkSystemIsConnected();
EyelinkSystemIsInitialized();
PsychCopyInIntegerArg(1, TRUE, &type);
mxpp = PsychGetOutArgMxPtr(1);
switch(type) {
case SAMPLE_TYPE:
if (eyelink_get_float_data((ALLF_DATA*) &fs) != type) {
PsychErrorExitMsg(PsychError_user, "Eyelink: GetFloatData: eyelink_get_float_data did not return sample type as user said it would.");
}
(*mxpp) = CreateMXFSample(&fs);
break;
case LOST_DATA_EVENT: // queue overflowed, we are not supposed to call eyelink_get_float_data on this
(*mxpp) = (mxArray*) mxCreateDoubleMatrix(1,1,mxREAL); //no data
mxGetPr((*mxpp))[0] = 0;
break;
case 0:
(*mxpp) = (mxArray*) mxCreateDoubleMatrix(1,1,mxREAL); //no data
mxGetPr((*mxpp))[0] = 0;
break;
default: // else it is an event
if (eyelink_get_float_data((ALLF_DATA*) &fe) != type) {
PsychErrorExitMsg(PsychError_user, "Eyelink: GetFloatDataRaw: eyelink_get_float_data did not return event type as user said it would.");
}
(*mxpp) = CreateMXFEvent(&fe);
}
return(PsychError_none);
}
static char useStringRaw[] = "[item, raw] = Eyelink('GetFloatDataRaw', type [, eye])";
static char synopsisStringRaw[] =
"Same as Eyelink('GetFloatData') but additionally returns raw sample data.\n"
"If type is not SAMPLE_TYPE, identical to GetFloatData (raw will be returned as 0).\n"
"Specify the eye for which raw values are desired as LEFT_EYE or RIGHT_EYE as returned by EyelinkInitDefaults. Omission of this argument is deprecated.\n"
"Normal samples do not contain the corneal reflection data, but some (non-saccade-based) calibration methods require this information.\n"
"The Eyelink 1000 can be configured to send this information as part of 'raw' samples.\n"
"Sol Simpson at SR-Research emphasizes that this is not officially supported or guaranteed.\n"
"1. You may need to install Eyelink.dll from the latest software developer kit at https://www.sr-support.com/forums/showthread.php?t=6 (windows) or https://www.sr-support.com/forums/showthread.php?t=15 (osx)\n"
"2. Issue the commands:\n"
"\t Eyelink('command','link_sample_data = LEFT,RIGHT,GAZE,AREA,GAZERES,HREF,PUPIL,STATUS,INPUT,HMARKER');\n"
"\t Eyelink('command','inputword_is_window = ON');\n"
"More info:\n"
"\t HMARKER (originally for Eyelink2's infrared head tracking markers) and INPUT (originally for the TTL lines) are jury-rigged to hold the extra data.\n"
"\t You can also set file_sample_data to collect raw samples in the .edf file.\n"
"Raw structure fields:\n"
"\t raw_pupil raw x, y sensor position of the pupil\n"
"\t raw_cr raw x, y sensor position of the corneal reflection\n"
"\t pupil_area raw pupil area\n"
"\t cr_area raw cornela reflection area\n"
"\t pupil_dimension width, height of raw pupil\n"
"\t cr_dimension width, height of raw cr\n"
"\t window_position x, y position of tracking window on sensor\n"
"\t pupil_cr calculated pupil-cr from the raw_pupil and raw_cr fields\n"
"\t cr_area2 raw area of 2nd corneal reflection candidate\n"
"\t raw_cr2 raw x, y sensor position of 2nd corneal reflection candidate\n"
"CAUTION: It may or may not work on your setup with your tracker.\n\n";
/*
ROUTINE: EyelinkGetFloatDataRaw.c
PURPOSE: As EyelinkGetFloatData, but additionally returns raw sample data.
*/
PsychError EyelinkGetFloatDataRaw(void)
{
FSAMPLE fs;
FSAMPLE_RAW fr;
FEVENT fe;
int type = 0;
mxArray **mxpp[2];
int eye;
int err;
char errmsg[ERR_BUFF_LEN]="";
//all sub functions should have these two lines
PsychPushHelp(useStringRaw, synopsisStringRaw, seeAlsoString);
if (PsychIsGiveHelp()) {PsychGiveHelp(); return(PsychError_none); };
// Check to see if the user supplied superfluous arguments
PsychErrorExit(PsychCapNumInputArgs(2));
PsychErrorExit(PsychRequireNumInputArgs(1));
PsychErrorExit(PsychCapNumOutputArgs(2));
// Verify eyelink is up and running
EyelinkSystemIsConnected();
EyelinkSystemIsInitialized();
PsychCopyInIntegerArg(1, TRUE, &type);
mxpp[0] = PsychGetOutArgMxPtr(1);
mxpp[1] = PsychGetOutArgMxPtr(2);
switch(type) {
case SAMPLE_TYPE:
if (eyelink_get_float_data((ALLF_DATA*) &fs) != type) {
PsychErrorExitMsg(PsychError_user, "Eyelink: GetFloatDataRaw: eyelink_get_float_data did not return sample type as user said it would.");
}
(*mxpp)[0] = CreateMXFSample(&fs);
if (PsychCopyInIntegerArg(2, kPsychArgOptional, &eye)) {
if (eye!=LEFT_EYE && eye!=RIGHT_EYE) {
PsychErrorExitMsg(PsychErorr_argumentValueOutOfRange, "EyeLink: GetFloatDataRaw: eye argument must be LEFT_EYE or RIGHT_EYE as returned by EyelinkInitDefaults\n");
}
TrackerOKForRawValues();
memset(&fr, 0, sizeof(fr));
if((err = eyelink_get_extra_raw_values_v2(&fs, eye, &fr))){
snprintf(errmsg, ERR_BUFF_LEN, "Eyelink: GetFloatDataRaw: eyelink_get_extra_raw_values_v2 returned error code %d: %s", err, eyelink_get_error(err,"eyelink_get_extra_raw_values_v2"));
PsychErrorExitMsg(PsychError_internal, errmsg);
}
} else {
mexPrintf("EYELINK: WARNING! Omission of the eye argument to GetFloatDataRaw is deprecated.\n");
if((err = eyelink_get_extra_raw_values(&fs, &fr))){ //deprecated as of Dec 1, 2006 (see eyelink sdk core_expt.h)
snprintf(errmsg, ERR_BUFF_LEN, "Eyelink: GetFloatDataRaw: eyelink_get_extra_raw_values returned error code %d: %s", err, eyelink_get_error(err,"eyelink_get_extra_raw_values"));
PsychErrorExitMsg(PsychError_internal, errmsg);
}
}
(*mxpp)[1] = (mxArray *)CreateMXFSampleRaw(&fr); //assumes there is always a raw sample...
break;
case LOST_DATA_EVENT: // queue overflowed, we are not supposed to call eyelink_get_float_data on this
(*mxpp)[0] = (mxArray*) mxCreateDoubleMatrix(1,1,mxREAL); //no data
mxGetPr((*mxpp)[0])[0] = 0;
(*mxpp)[1] = (mxArray*) mxCreateDoubleMatrix(1,1,mxREAL); //no raw
mxGetPr((*mxpp)[0])[1] = 0;
break;
case 0:
(*mxpp)[0] = (mxArray*) mxCreateDoubleMatrix(1,1,mxREAL); //no data
mxGetPr((*mxpp)[0])[0] = 0;
(*mxpp)[1] = (mxArray*) mxCreateDoubleMatrix(1,1,mxREAL); //no raw
mxGetPr((*mxpp)[0])[1] = 0;
break;
default: // else it is an event
if (eyelink_get_float_data((ALLF_DATA*) &fe) != type) {
PsychErrorExitMsg(PsychError_user, "Eyelink: GetFloatDataRaw: eyelink_get_float_data did not return event type as user said it would.");
}
(*mxpp)[0] = CreateMXFEvent(&fe);
(*mxpp)[1] = (mxArray*) mxCreateDoubleMatrix(1,1,mxREAL); //no raw
mxGetPr((*mxpp)[0])[1] = 0;
}
return(PsychError_none);
}
|
