1mjoytest(3)                   Svgalib User Manual                  mjoytest(3)
2
3
4

NAME

6       mjoytest - test the svgalib joystick package in graphics mode
7

SYNOPSIS

9       mjoytest [-j joystick] [[-m] video mode]
10
11

DESCRIPTION

13       This demo program utilizes joysticks 0 and 1 in graphics mode.
14
15       If you specify a joystick number, only this is used. The demo separates
16       the screen in two parts where you can move a  cursor  around  with  the
17       resp.  joystick. Pressing button 2 changes the color, pressing button 1
18       draws.
19
20       It also prints the current joystick position to the screen.
21
22       Internally the demo also shows the use of custom joystick handlers  and
23       how  to  recalibrate a joystick in graphics mode (press key <1> and <2>
24       respectively.
25
26       After the demo runs and the joysticks are initialized it is possible to
27       share  the  joysticks  with another application (as long as it releases
28       the joysticks upon a VC switch as well).
29
30       Pressing <Q> exits.
31
32

BUGS

34       After a vc switch the demo occasionally hangs in  vga_waitevent(3)  not
35       timing out (hence the joysticks block). It is not clear if it is a con‐
36       ceptional problem or bug in vga_waitevent(3)  or  the  kernel.   Simply
37       press any key to revive the demo.
38
39

NOTES

41       This  demo  is part of svgalib and can be found in the demos/ subdirec‐
42       tory of the original svgalib distribution. However, it is not installed
43       in  the  system by default, s.t. it is unclear where you can find it if
44       your svgalib was installed by some linux distribution. Even then,  when
45       you  have  the demo on your system, you probably won't have the sources
46       s.t. it is only of limited use for you.
47
48       In case of any such problem, simply get an  svgalib  distribution  from
49       the  net.  You  even  don't need to install it. Just make in the demos/
50       subdirecty. As of this writing, svgalib-1.3.0.tar.gz is the latest ver‐
51       sion   and   can   be   retrieved   by   ftp  from  sunsite.unc.edu  at
52       /pub/Linux/libs/graphics and tsx-11.mit.edu at  /pub/linux/sources/libs
53       which will most probably be mirrored by a site close to you.
54
55

CAVEATS

57       The  functions  used by this demo are only available in ELF versions of
58       svgalib. Due to backwards compatibility issues it cannot be  used  with
59       shared a.out libs.
60
61

SEE ALSO

63       svgalib(7),    vgagl(7),    libvga.config(5),    threed(6),   accel(6),
64       bg_test(6),  eventtest(6),  forktest(6),  fun(6),  keytest(6),  scroll‐
65       test(6), speedtest(6), spin(6), testaccel(6), testgl(6), testlinear(6),
66       vgatest(6),  plane(6),  wrapdemo(6),   vgatest(6),   joytest(6),   joy‐
67       stick_init(3),      joystick_close(3),     joystick_update(3),     joy‐
68       stick_sethandler(3),   joystick_setdefaulthandler(3),   joystick_getnu‐
69       maxes(3), joystick_getnumbuttons(3), joystick_getaxis(3), joystick_get‐
70       button(3), joystick_button1(3), joystick_getb1(3), joystick_x(3),  joy‐
71       stick_getx(3).
72
73

AUTHOR

75       The  svgalib  joystick  handler  was  mostly  done by Daniel Engstr\"om
76       <daniel.engstrom@riksnett.no>.  Multiple joystick, VC switching support
77       and  code  to  glue  it  into  svgalib  by  Michael Weller <eowmob@exp-
78       math.uni-essen.de>. Part of the code is based on code from C. Smith and
79       Vojtech Pavlik.
80
81
82
83Svgalib 1.3.0                    14 April 1998                     mjoytest(3)
Impressum