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
|
/*
/osxptb/trunk/PsychSourceGL/Source/OSX/Eyelink/EyelinkMessage.c
PROJECTS: Eyelink
AUTHORS:
f.w.cornelissen@rug.nl fwc
E.Peters@ai.rug.nl emp
PLATFORMS: All.
HISTORY:
15/06/06 fwc Adapted from early alpha version by emp.
19-06-11 mk Refactored to share parser with other functions.
TARGET LOCATION:
Eyelink.mexmac resides in:
EyelinkToolbox
*/
#include "PsychEyelink.h"
static char useString[] = "[status =] Eyelink('Message', 'formatstring', [...])";
static char synopsisString[] =
"link message formatting use just like printf()\n"
" Only chars and ints allowed in arguments!\n"
"returns any send error";
static char seeAlsoString[] = "";
/*
ROUTINE: EYELINKmessage
PURPOSE:
uses int eyemsg_printf(char *fmt, ...)
This sends a text message to the Eyelink tracker, which
timestamps it and writes it to the EDF data file. Messages
are useful for recording trail conditions, subject responses.
or the time of important events. This function is used with
the same formatting methods as printf(), allowing numbers to be
included. Avoid"\n" at end of messages.
RETURNS: 0 if OK, else errorcode. */
PsychError EyelinkMessage(void)
{
int status = -1;
// 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(PsychRequireNumInputArgs(1));
PsychErrorExit(PsychCapNumOutputArgs(1));
// Verify eyelink is up and running
EyelinkSystemIsConnected();
EyelinkSystemIsInitialized();
status = eyemsg_printf(PsychEyelinkParseToString(1));
/* if there is an output variable available, assign eyecmd_printf status to it. */
PsychCopyOutDoubleArg(1, FALSE, status);
return(PsychError_none);
}
|
