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

NAME

6       mouse_getposition_6d, mouse_setposition_6d, mouse_setrange_6d - provide
7       an interface to 3d mice
8

SYNOPSIS

10       #include <vgamouse.h>
11
12       void mouse_getposition_6d(int *x, int *y, int *z, int *rx  ,  int  *ry,
13       int *rz);
14       void mouse_setposition_6d(int x, int y, int z, int rx , int ry, int rz,
15       int dim_mask);
16       void mouse_setrange_6d(int x1, int x2, int y1, int y2, int z1 , int z2,
17       int rx1, int rx2, int ry1, int ry2 , int rz1, int rz2, int dim_mask);
18
19

DESCRIPTION

21       These   routines   provide   the   same   function   as  mouse_getx(3),
22       mouse_gety(3), mouse_setxrange(3),  mouse_setyrange(3),  mouse_setposi‐
23       tion(3),  and  mouse_getx(3),  except  that they work in all six dimen‐
24       sions, x, y, z, and rotations about those axes.
25
26       For mouse_getposition_6d(), NULL pointers may be passed for any coordi‐
27       nate you don't care to know about.  Those dimensions will be ignored.
28
29       mouse_setposition_6d() and mouse_setrange_6d() take an additional argu‐
30       ment called dim_mask, which should be an logical or of  the  following:
31       MOUSE_XDIM,   MOUSE_YDIM,   MOUSE_ZDIM,  MOUSE_RXDIM,  MOUSE_RYDIM,  or
32       MOUSE_RZDIM.  MOUSE_2DIM, MOUSE_3DIM, MOUSE_6DIM can be used as  short‐
33       hand  for the XY, XYZ, or XYZRxRyRz dimensions.  The position or ranges
34       will only be set if that dimension is included in dim_mask.
35
36       The 6d mouse routines can be used safely with any mouse type, including
37       standard 2D mice.
38
39       When used with mice that support fewer than six axes, the other coordi‐
40       nates will always return zero (or whatever value you set them to).
41
42

SEE ALSO

44       svgalib(7), vgagl(7), libvga.config(5),  eventtest(6),  mouse_close(3),
45       mouse_init(3),  mouse_setposition(3), mouse_getx(3), mouse_setscale(3),
46       mouse_setwrap(3), mouse_setxrange(3), mouse_update(3), mouse_waitforup‐
47       date(3),  vga_setmousesupport(3),  mouse_seteventhandler(3),  vga_wait‐
48       event(3)
49

AUTHOR

51       This manual page was edited  by  Michael  Weller  <eowmob@exp-math.uni-
52       essen.de>.  The  exact  source of the referenced function as well as of
53       the original documentation is unknown.
54
55       It is very likely that both are at least to some extent are due to Harm
56       Hanemaayer <H.Hanemaayer@inter.nl.net>.
57
58       Occasionally  this  might be wrong. I hereby asked to be excused by the
59       original author and will happily accept any additions or corrections to
60       this first version of the svgalib manual.
61
62
63
64Svgalib (>= 1.2.11)              27 July 1997          mouse_getposition_6d(3)
Impressum