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.

Svgalib (>= 1.2.11)                               27 July 1997                           mouse_getposition_6d(3)