Provided by: libsvga1-dev_1.4.3-31_i386 bug

NAME

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

SYNOPSIS

       #include <vgamouse.h>

       void mouse_getposition_6d(int *x, int *y, int *z, int *rx  ,  int  *ry,
       int *rz);
       void mouse_setposition_6d(int x, int y, int z, int rx , int ry, int rz,
       int dim_mask);
       void mouse_setrange_6d(int x1, int x2, int y1, int y2, int z1 , int z2,
       int rx1, int rx2, int ry1, int ry2 , int rz1, int rz2, int dim_mask);

DESCRIPTION

       These   routines   provide   the   same   function   as  mouse_getx(3),
       mouse_gety(3),         mouse_setxrange(3),          mouse_setyrange(3),
       mouse_setposition(3),  and  mouse_getx(3), except that they work in all
       six dimensions, x, y, z, and rotations about those axes.

       For  mouse_getposition_6d(),  NULL  pointers  may  be  passed  for  any
       coordinate  you  don't  care  to  know about.  Those dimensions will be
       ignored.

       mouse_setposition_6d()  and  mouse_setrange_6d()  take  an   additional
       argument  called  dim_mask,  which  should  be  an  logical  or  of the
       following:    MOUSE_XDIM,    MOUSE_YDIM,    MOUSE_ZDIM,    MOUSE_RXDIM,
       MOUSE_RYDIM, or MOUSE_RZDIM.  MOUSE_2DIM, MOUSE_3DIM, MOUSE_6DIM can be
       used as shorthand for  the  XY,  XYZ,  or  XYZRxRyRz  dimensions.   The
       position  or  ranges  will only be set if that dimension is included in
       dim_mask.

       The 6d mouse routines can be used safely with any mouse type, including
       standard 2D mice.

       When  used  with  mice  that  support  fewer  than  six axes, the other
       coordinates will always return zero (or whatever  value  you  set  them
       to).

SEE ALSO

       svgalib(7),  vgagl(7),  libvga.config(5), eventtest(6), mouse_close(3),
       mouse_init(3), mouse_setposition(3), mouse_getx(3),  mouse_setscale(3),
       mouse_setwrap(3),          mouse_setxrange(3),         mouse_update(3),
       mouse_waitforupdate(3),                         vga_setmousesupport(3),
       mouse_seteventhandler(3), vga_waitevent(3)

AUTHOR

       This  manual  page  was  edited by Michael Weller <eowmob@exp-math.uni-
       essen.de>. The exact source of the referenced function as  well  as  of
       the original documentation is unknown.

       It is very likely that both are at least to some extent are due to Harm
       Hanemaayer <H.Hanemaayer@inter.nl.net>.

       Occasionally this might be wrong. I hereby asked to be excused  by  the
       original author and will happily accept any additions or corrections to
       this first version of the svgalib manual.