[][src]Function libeyelink_sys::eyelink_eye_available

pub unsafe extern "C" fn eyelink_eye_available() -> INT16

@ingroup messaging After calling \c eyelink_wait_for_block_start(), or after at least one sample or eye event has been read, can be used to check which eyes data is available for.

@return One of these constants, defined in EYE_DATA.H: \c LEFT_EYE if left eye data. \c RIGHT_EYE if right eye data. \c BINOCULAR if both left and right eye data. \c -1 if no eye data is available.

\b Example:

\code

#include 

int eye_used = 0;      // indicates which eye's data to display

eye_used = eyelink_eye_available();

switch(eye_used)
{
case RIGHT_EYE:
eyemsg_printf("EYE_USED 1 RIGHT");
break;
case BINOCULAR:   // both eye's data present: use left eye only
eye_used = LEFT_EYE;
case LEFT_EYE:
eyemsg_printf("EYE_USED 0 LEFT");
break;
}
\endcode

\b Output:

\code
MSG	22157314 EYE_USED 0 LEFT
\endcode

\sa \c eyelink_wait_for_block_start()