[][src]Function libeyelink_sys::echo_key

pub unsafe extern "C" fn echo_key() -> UINT16

Calls getkey(), also sends keys to tracker for remote control * User implementation allows filtering of keys before sending * returns same codes as getkey() * Checks for Windows keystroke events and dispatches messages; similar to \c getkey(), but also sends keystroke to tracker.

@remarks Warning: Under Windows XP, this call will not work in realtime mode at all, and will take several seconds to respond if graphics are being drawn continuously. This function works well in realtime mode under Windows 2000. @return \c 0 if no key pressed, else key code.\n \c TERMINATE_KEY if CTRL-C held down or program has been terminated.

\b Example:

\code
#include 

eyelink_flush_keybutton();
while(getkey());

while(eyelink_current_mode() & IN_SETUP_MODE)
{
int i = eyelink_current_mode();

if(i & IN_TARGET_MODE)
{
...
}
else if(i & IN_IMAGE_MODE)
{
...
}

echo_key();
}
\endcode

\sa \c eyelink_read_keybutton(), \c eyelink_send_keybutton() and \c getkey()