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.