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
|
/*
/osxptb/trunk/PsychSourceGL/Source/Common/Eyelink/EyelinkNewestFloatSample.c
PROJECTS: Eyelink
AUTHORS:
cburns@berkeley.edu cdb
E.Peters@ai.rug.nl emp
f.w.cornelissen@med.rug.nl fwc
e_flister@yahoo.com edf
PLATFORMS: All
HISTORY:
2003 emp first version
11/23/05 cdb adapted.
31-10-06 fwc added EyelinkNewestFloatSampleRaw function
19-02-09 edf elaborated doc for EyelinkNewestFloatSampleRaw
23-03-09 edf added eye argument to EyelinkNewestFloatSampleRaw
TARGET LOCATION:
Eyelink.mexmac resides in:
EyelinkToolbox
*/
#include "PsychEyelink.h"
static char useString[] = "sample = Eyelink('NewestFloatSample')";
static char synopsisString[] =
"makes copy of most recent float sample received"
"returns -1 if no new sample or error";
static char seeAlsoString[] = "";
/*
ROUTINE: EYELINKnewestfloatsample
PURPOSE:
uses INT16 CALLTYPE eyelink_newest_float_sample(void FARTYPE *buf);
makes copy of most recent float sample received
makes FSAMPLE copy of most recent sample
returns -1 if none or error, 0 if old, 1 if new
*/
PsychError EyelinkNewestFloatSample(void)
{
FSAMPLE structFloatSample;
mxArray **mxOutArg;
int iSampleType;
// Add help strings
PsychPushHelp(useString, synopsisString, seeAlsoString);
// Output help if asked
if(PsychIsGiveHelp()) {
PsychGiveHelp();
return(PsychError_none);
}
// Check arguments
PsychErrorExit(PsychCapNumInputArgs(0));
PsychErrorExit(PsychRequireNumInputArgs(0));
PsychErrorExit(PsychCapNumOutputArgs(1));
// Verify eyelink is up and running
EyelinkSystemIsConnected();
//mexPrintf("EyelinkSystemIsConnected\n");
EyelinkSystemIsInitialized();
//mexPrintf("EyelinkSystemIsInitialized\n");
// Grab the sample
iSampleType=eyelink_newest_float_sample(&structFloatSample);
//mexPrintf("iSampleType is %d\n", iSampleType);
mxOutArg = PsychGetOutArgMxPtr(1);
if( iSampleType==1 || iSampleType==0 )
{
// mexPrintf("old or new sample\n");
*mxOutArg = (mxArray *)CreateMXFSample(&structFloatSample);
}
else
{
// mexPrintf("error or no new sample\n");
*mxOutArg = mxCreateDoubleMatrix(1,1,mxREAL);
mxGetPr(*mxOutArg)[0]=iSampleType;
}
return(PsychError_none);
}
/*
Special Raw function
ON request of e_flister@yahoo.com
http://tech.groups.yahoo.com/group/psychtoolbox/message/5156
http://tech.groups.yahoo.com/group/psychtoolbox/message/5336
*/
static char useStringRaw[] = "[sample, raw] = Eyelink('NewestFloatSampleRaw' [, eye])";
static char synopsisStringRaw[] =
"Same as Eyelink('NewestFloatSample') but additionally returns raw sample data.\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";
//forgive the repeated code here, feel free to write a helper
PsychError EyelinkNewestFloatSampleRaw(void)
{
FSAMPLE structFloatSample;
FSAMPLE_RAW structFloatSampleRaw;
mxArray **mxOutArg[2];
int iSampleType;
int eye;
// Add help strings
PsychPushHelp(useStringRaw, synopsisStringRaw, seeAlsoString);
// Output help if asked
if(PsychIsGiveHelp()) {
PsychGiveHelp();
return(PsychError_none);
}
// Check arguments
PsychErrorExit(PsychCapNumInputArgs(1));
PsychErrorExit(PsychRequireNumInputArgs(0));
PsychErrorExit(PsychCapNumOutputArgs(2));
// Verify eyelink is up and running
EyelinkSystemIsConnected();
EyelinkSystemIsInitialized();
mxOutArg[0] = PsychGetOutArgMxPtr(1);
mxOutArg[1] = PsychGetOutArgMxPtr(2);
// Grab the sample
iSampleType=eyelink_newest_float_sample(&structFloatSample);
if( iSampleType==1 || iSampleType==0 )
{
// mexPrintf("old or new sample\n");
*mxOutArg[0] = (mxArray*) CreateMXFSample(&structFloatSample);
if (PsychCopyInIntegerArg(1, kPsychArgOptional, &eye)) {
if (eye!=LEFT_EYE && eye!=RIGHT_EYE) {
PsychErrorExitMsg(PsychErorr_argumentValueOutOfRange, "EyeLink: NewestFloatSampleRaw: eye argument must be LEFT_EYE or RIGHT_EYE as returned by EyelinkInitDefaults\n");
}
TrackerOKForRawValues();
memset(&structFloatSampleRaw, 0, sizeof(structFloatSampleRaw));
eyelink_get_extra_raw_values_v2(&structFloatSample, eye, &structFloatSampleRaw);
} else {
mexPrintf("EYELINK: WARNING! Omission of the eye argument to NewestFloatSampleRaw is deprecated.\n");
eyelink_get_extra_raw_values(&structFloatSample, &structFloatSampleRaw); //deprecated as of Dec 1, 2006 (see eyelink sdk core_expt.h)
}
// Can we assume that there is always a raw sample?
(*mxOutArg)[1] = (mxArray *)CreateMXFSampleRaw(&structFloatSampleRaw);
}
else
{
// mexPrintf("error or no new sample\n");
*mxOutArg[0] = mxCreateDoubleMatrix(1,1,mxREAL);
mxGetPr((*mxOutArg[0]))[0]=iSampleType;
*mxOutArg[1] = mxCreateDoubleMatrix(1,1,mxREAL);
mxGetPr((*mxOutArg[1]))[0]=iSampleType;
}
return(PsychError_none);
}
|
