Function libeyelink_sys::eyelink_cal_message

pub unsafe extern "C" fn eyelink_cal_message(msg: *mut c_char) -> INT16

@ingroup setup_eyelink Returns text associated with result of last calibration, validation, or drift correction. This usually specifies errors or other statistics.

@param msg Buffer to return back the message. @return \c 0 if no message since last command sent, else length of string.

\b Example:

\code
#include 
char message[256];

while(1)
{   // Check link often so we can exit if tracker stopped
if(!eyelink_is_connected()) return ABORT_EXPT;

error = do_drift_correct(SCRWIDTH/2, SCRHEIGHT/2, 1, 1);

if(error!=27) break;
}
eyelink_cal_message(message);
eyemsg_printf(message);
\endcode

\b Output:

\code
MSG	1896559 DRIFTCORRECT R RIGHT at 320,40  OFFSET 0.11 deg.  -1.0,-4.0 pix.
MSG	1896560 drift_correction: 0.11 -1.00 -4.00
\endcode

\sa \c eyelink_accept_trigger(), \c eyelink_apply_driftcorr() and \c eyelink_cal_result()