NAME
====
  vg_mouse_speed() - set mouse-speed


SYNOPSIS
========
  int vg_mouse_speed(int speedindex)


DESCRIPTION
===========
  If setting the mouse-speed is supported, you can set it
  to slow, middle and fast.
  Set the argument speedindex to
   - 1 to set the speed of the mouse to slow
   - 2 to set the speed of the mouse to middle
   - 3 to set the speed of the mouse to fast
   - 0 to not set the speed, but only get the return value

  There is also a menu in the VgaGames-system-menu (when pressed ESCAPE-key)
  for setting the mouse-speed, using this function.


RETURN VALUE
============
  It returns the previous speed-index (1,2 or 3)
  or 0=speed cannot be changed.


SEE ALSO
========
  Index
  Understanding window and key
  vg_key_discard()
  vg_key_update()
  vg_key_pressed()
  vg_mouse_found()
  vg_mouse_x()
  vg_mouse_y()
  vg_mouse_pressed()