NAME
====
  vg_nw_recvkeys() - only master: get keystrokes from client


SYNOPSIS
========
  int vg_nw_recvkeys(int plno)


DESCRIPTION
===========
  As mentioned in Understanding network, the
  master player does all the work (examinating keystrokes and mouse
  events, moving players, ...), where the clients just send their key and
  mouse requests to the master and receive from the master all data to be
  displayed on screen.

  The clients send their keystrokes and mouse events automatically when
  calling vg_key_update().

  plno is the number of a client-player.

  The master player uses vg_nw_recvkeys() to
   - check whether a client has sent a keystroke
   - receive these keystrokes and mouse events

  Only if a client has sent a keystroke (return value 1), the master may
  call vg_nw_keypressed() or vg_nw_mousepressed() to check whether a key
  or a mouse button is pressed.
  vg_nw_mousex() and vg_nw_mousey(), the position of the mouse of a client,
  may be called always by the master.

  Refer to Understanding network.


RETURN VALUE
============
  Returns 1 if the client has sent key and mouse requests,
  or 0 if there is no new network packet from the client


SEE ALSO
========
  Index
  Understanding network
  vg_nw_setplayer()
  vg_nw_startserver()
  vg_nw_connect()
  vg_nw_waitforconnects()
  vg_nw_setvar()
  vg_nw_getvar()
  vg_nw_setcommon()
  vg_nw_getcommon()
  vg_nw_dumppacket()
  vg_nw_sendinit()
  vg_nw_recvinit()
  vg_nw_myplayer()
  vg_nw_maxplayer()
  vg_nw_virtualplayer()
  vg_nw_isalive()
  vg_nw_keypressed()
  vg_nw_mousepressed()
  vg_nw_mousex()
  vg_nw_mousey()
  vg_nw_senddata()
  vg_nw_sendcommon()
  vg_nw_setdead()
  vg_nw_dumpsprite()
  vg_nw_undumpsprite()
  vg_nw_close()