Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
mouse_setwrap(3)	      Svgalib User Manual	      mouse_setwrap(3)

       mouse_setwrap - set what	happens	at the mouse boundaries

       #include	<vgamouse.h>

       void mouse_setwrap(int state);

       This  routine  determines  what	to  do if the mouse position reaches a

       state should be either MOUSE_WRAP, MOUSE_NOWRAP,	or  a  bitwise	or  of
       MOUSE_WRAPRZ.  These define if all or the respective  coordinates  wrap
       or are clipped at the ends.

       This  variable  has  been  overloaded for the case of multi-dimensional
       mice that support rotations and can be used to  select  the  coordinate
       system used to return the current position of the mouse.

       If the above value of state is also ored	with MOUSE_ROT_RX_RY_RZ, rota-
       tional information will be returned as  the  angular  position  as  ex-
       pressed	by the total angle wound around	the X, Y, and Z	axes.  This is
       the simplest coordinate system to use, but it's also the	least  useful,
       since  angular rotations	about perpendicular axes don't commute.	 There
       are situations where this system	might be useful, for controlling truly
       independent  quantities,	 such  as  color, with each axis being used to
       dial a level of red, green, or blue, but	for modeling the actual	orien-
       tation of a physical object, it's utterly hopeless.

       If  state is instead ored with MOUSE_ROT_INFINITESIMAL, the angular po-
       sitions returned	are expressed as differences from the  previously  re-
       ported  position.  If the differences are sufficiently small, the angu-
       lar displacements will commute with each	other and can be used to track
       the  motion  of	a  physical object.  Other coordinate systems, such as
       yaw, pitch, and roll, could be defined, but haven't been	 done  due  to
       lack  of	 time.	 If  you feel you need this feature, send mail to Eric
       Sharkey <> and he just might  consider
       coding it up.

       MOUSE_WRAP  and	MOUSE_ROT_COORDS can be	used to	mask out the bits used
       for wrap	and coordinate states, respectively.

       svgalib(7), vgagl(7), libvga.config(5),	eventtest(6),  mouse_close(3),
       mouse_init(3),	   mouse_getposition_6d(3),	 mouse_setposition(3),
       mouse_setscale(3), mouse_getx(3), mouse_setxrange(3),  mouse_update(3),
       mouse_waitforupdate(3),	    vga_setmousesupport(3),	mouse_seteven-
       thandler(3), vga_waitevent(3)

       This manual page	was edited by Michael Weller  <eowmob@exp-math.uni-es->.	 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 <>.

       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_setwrap(3)


Want to link to this manual page? Use this URL:

home | help