1
Content-type: text/html
3
1
<HTML><HEAD><TITLE>Manpage of IMWheel</TITLE>
6
Section: User Commands (1)<BR>Updated: November 4 2000<BR><A HREF="#index">Index</A>
7
<A HREF="http://jonatkins.org/cgi-bin/man2html.cgi">Return to Main Contents</A><HR>
4
Section: User Commands (1)<BR>Updated: September 8 2002<BR><A HREF="#index">Index</A>
5
<A HREF="http://jcatki.dhs.org/cgi-bin/man2html.cgi">Return to Main Contents</A><HR>
10
8
<A NAME="lbAB"> </A>
38
36
Flips the mouse buttons so that 4 is 5 and 5 is 4, reversing
39
37
the Up and Down actions. This would make 4 buttons somewhat useful!
40
38
This is the similar to using "-b 54678", see the <B>-b</B> option.
41
See also <A HREF="http://jonatkins.org/cgi-bin/man2html.cgi?1+xmodmap">xmodmap</A>(1).
39
See also <A HREF="http://jcatki.dhs.org/cgi-bin/man2html.cgi?1+xmodmap">xmodmap</A>(1).
42
40
<DT><B>-b, --buttons</B> <I>button-spec</I><DD>
43
41
Remap buttons in <I>button-spec</I> to interpreted wheel/thumb input.
44
42
Also limits the button grab to the specified buttons when using the ZAxis method.
76
76
the <I>button-spec</I> for something that doesn't exist on your mouse.
79
A <I>button-spec</I> of "45006" may be for normal wheel up/down and a thumb button, but
79
A <I>button-spec</I> of "45006" may be for normal wheel up/down and a thumb button 1, but
80
80
no horizontal wheel axis.
83
The default <I>button-spec</I> is "45678".
83
The default <I>button-spec</I> is "456789".
86
See also <A HREF="http://jonatkins.org/cgi-bin/man2html.cgi?1+xmodmap">xmodmap</A>(1).
86
See also <A HREF="http://jcatki.dhs.org/cgi-bin/man2html.cgi?1+xmodmap">xmodmap</A>(1).
89
<DT><B>-c, --config</B><DD>
90
Popup to configuration helper window imediately.
93
See also <B>CONFIGURATION HELPER</B>
89
94
<DT><B>-D, --debug</B><DD>
90
95
Show all possible debug info while running. This spits out alot and I also
91
96
suggest using the <B>-d</B> option to prevent imwheel from detaching from the
157
162
(see "STICK SENSITIVITY SETTINGS" below)
158
163
<DT><B>-W, --wheel-fifo</B> <I>fifo</I><DD>
159
Use the gpm wheel fifo instead of XGrabMouse. See GPM Wheel FIFO Method
164
Use the gpm/jamd wheel fifo instead of XGrabMouse. See <B>GPM/JAMD WHEEL FIFO METHOD</B>
160
165
section. This method allows only one X display to be used. This is required
161
166
for the gpm method to work. This method only works with the imwheel version
162
of gpm and with jam. To find out if you are running the imwheel version of gpm
167
of gpm and with jamd. To find out if you are running the imwheel version of gpm
163
168
use the following command and look for "(imwheel)" in the title:
164
169
<DL COMPACT><DT><DD>
165
170
<DL COMPACT><DT><DD>
174
179
<I>fifo</I> names the named pipe (FIFO) created by gpm. It defaults to
175
"/dev/gpmwheel". (for <B>--wheel-fifo</B> only) The FIFO must exist before
176
running imwheel in this mode.
180
"/dev/gpmwheel" (for <B>--wheel-fifo</B> only). The FIFO must exist before
181
running imwheel in this mode. using jamd requires you to name the correct fifo
182
because it doesn't use /dev/gpmwheel, but rather one of the /dev/jam_imwheel:0.0
183
named fifos created by jamd's imwheel module.
179
186
<B>@Exclude</B> commands in the rc file are unused in this mode.
226
233
<DL COMPACT><DT><DD>
229
<DL COMPACT><DT><DD>Buttons 6
236
<DL COMPACT><DT><DD>Buttons 7
230
237
ZAxisMapping 4 5 6 7
233
<DL COMPACT><DT><DD>Option "Buttons" "6"
240
<DL COMPACT><DT><DD>Option "Buttons" "7"
234
241
Option "ZAxisMapping" "4 5 6 7"
272
279
<A NAME="lbAG"> </A>
273
<H2>GPM/JAM WHEEL FIFO METHOD</H2>
280
<H2>GPM/JAMD WHEEL FIFO METHOD</H2>
275
282
This method is REQUIRED for any X Windows server without wheel
276
283
mouse support built in. This method will currently support mice as supported
280
287
In the Pointer section of your XF86Config (or the equivalent configuration file
281
288
for your X server) change your mouse Protocol to be "MouseSystems"
282
289
(or the equivelant...), also change the Device file that the mouse is read from
283
290
to "/dev/gpmdata", then restart X Windows if it is running.
291
jamd will replicate to /dev/jam_ps2:0.0 or some other devices as well,
292
make sure to use the right X Mouse protocol in this case,
293
like the jamd_ps2 device is X mouse protocol PS/2,
294
and the jamd_imps2 device is X mouse protocol IMPS/2.
286
297
Before starting X Windows (re)start gpm with the <B>-W</B> option. Make sure
290
301
After starting X Windows run imwheel as follows adding options as desired:
304
for gpm you can use the following option to imwheel
310
jamd requires you specify the fifo name as one of the /dev/jamd_imwheel:0.0
314
<B>ls -al /dev/jam_imwheel*</B>
317
to see what is available.
318
In this example I would use
321
<B>-W /dev/jam_imwheel:0.0</B>
324
as the option to imwheel.
296
327
I usually add the <B>-k</B> option to kill off any old imwheel processes left
300
331
<B>--display</B> variables connected imwheel to a now defunct X server.
303
gpm and/or imwheel can be restarted at any time, imwheel can sense when gpm is
304
not there, and gpm doesn't give a hoot about imwheel being up or not.
334
gpm or jamd, and/or imwheel can be restarted at any time, imwheel can sense when
335
gpm of jamd is not there, and gpm nor jamd doesn't give a hoot about imwheel
353
385
<A NAME="lbAI"> </A>
354
386
<H2>IMWHEELRC</H2>
356
IMWheel uses, optionally, two configuration files. One called /etc/imwheelrc,
388
IMWheel uses, optionally, two configuration files. One called /etc/X11/imwheelrc,
357
389
which is used for everybody. The other is $HOME/.imwheelrc, used only for one
358
390
user. One is supplied and should have been installed automatically in /etc
359
391
if not also in the installing users $HOME as well. All whitespace is ignored
381
413
Window Class Name
382
414
Window Resource Name
415
(null) which matches "\(null\)" in the imwheelrc
388
420
Most of these are probe-able using fvwm2's FvwmIdent module or the configurator
389
(see the Configuration Helper section). Other window managers may have their
421
(see the <B>CONFIGURATION HELPER</B> section). Other window managers may have their
390
422
own method of identifying windows' attributes.
629
For FIFO users, it is possible to send a real mouse button event, using
630
the special <B>Button#</B> syntax. An imwheelrc keysym of Button1 would
631
send a real Mouse button 1 (left mouse button) event. Mouse4 is what you'd want
632
for a MouseWheelUp type event. Mouse5 is what you want to MouseWheelDown event.
633
Many applications will understand the meaning of mouse button 4 and 5, but most don't
634
go beyond that. So <I>Mouse6 and greater have no "standardized" meaning</I>. The Button# syntax
635
can be combined with regular keysyms, to send keys and mouse buttons at the same time.
642
- meaning left shift and wheel up.
644
- meaning wheel down.
651
Other button to imwheel meaniful references:
654
KeySym IMWheel Input Real Mouse
655
------ ------------- ----------
656
Button1 (none) Left Mouse Button
657
Button2 (none) Middle Mouse Button
658
Button3 (none) Right Mouse Button
659
Button4 Up Mouse Wheel Up
660
Button5 Down Mouse Wheel Down
661
Button6 Left Mouse Wheel Left
662
Button7 Right Mouse Wheel Right
663
Button8 Thumb1 Side Mouse Button 1 (left/up)
664
Button9 Thumb2 Side Mouse Button 2 (right/down)
596
667
Common Modifier Keysym names used in X:
599
669
Control_L Control_R
673
743
xmodmap -e "pointer = 3 2 1 4 5 6 7"
675
xmodmap -e "pointer = 3 2 1 4 5 6 7 8"
745
xmodmap -e "pointer = 3 2 1 4 5 6 7 8 9"
747
NOTE: most of these are NOT going to work, because of all the limits in X.
695
767
imwheel doesn't get along with itself on the same X display or using the same
696
gpmwheel FIFO. - This will always be your fault :|
768
gpmwheel FIFO. - This will always be your fault :-/
699
771
Stick mice are still a pain in the butt to use. - This is the manufacturer's fault.
703
775
Keyboard focus isn't changed automatically to input keys into Window mouse is
704
776
over. This only occurs with Click-to-Focus type focus managment in window managers.
705
777
I use sloppy focus in fvwm2, which always works for me. - Whose fault <I>is</I> this?
706
(Switch focus modes and/or window managers)
778
(Switch focus modes and/or window managers, or try the <B>-f</B> option on imwheel)
709
781
Configuration file is not validated for correctness nicely...although it does
738
810
The users configuration file.
741
813
The global location for the configuration
742
814
file, it is always loaded. Overided by
743
815
the users configuration file.
746
818
The default wheel FIFO from gpm, if used.
748
/dev/jam_imwheel:0 (or other higher numbers...)
749
A wheel FIFO from jam, if used, must be specified.
750
jam allows more than on FIFO, and thus allows more than
820
/dev/jam_imwheel:0.0 (or other numbers...)
821
A wheel FIFO from jamd, if used, must be specified.
822
jamd allows more than on FIFO, and thus allows more than
751
823
one instance of imwheel to be running on the same computer
752
824
when running imwheel on multiple displays
753
825
using the Wheel FIFO method.
766
838
<H2>SEE ALSO</H2>
769
<B><A HREF="http://jonatkins.org/cgi-bin/man2html.cgi?1+jam">jam</A>(1)</B>
770
Jon Atkins Mouse - a replacement/augmentation for/to GPM.
771
<B><A HREF="http://jonatkins.org/cgi-bin/man2html.cgi?1x+xwheel">xwheel</A>(1x)</B>
772
The new replacement for imwheel. Uses jam instead of GPM or ZAxis.
773
<B><A HREF="http://jonatkins.org/cgi-bin/man2html.cgi?1x+xdpyinfo">xdpyinfo</A>(1x)</B>
841
<B><A HREF="http://jcatki.dhs.org/cgi-bin/man2html.cgi?1+jamd">jamd</A>(1)</B>
842
Jon Atkins Mouse - a replacement/augmentation for/to gpm.
843
<B><A HREF="http://jcatki.dhs.org/cgi-bin/man2html.cgi?1x+xwheel">xwheel</A>(1x)</B>
844
The new replacement for imwheel. Uses jamd instead of gpm or ZAxis.
845
(may not be available yet)
846
<B><A HREF="http://jcatki.dhs.org/cgi-bin/man2html.cgi?1x+xdpyinfo">xdpyinfo</A>(1x)</B>
774
847
X Display information, including extensions.
775
<B><A HREF="http://jonatkins.org/cgi-bin/man2html.cgi?8+gpm">gpm</A>(8)</B>
848
<B><A HREF="http://jcatki.dhs.org/cgi-bin/man2html.cgi?8+gpm">gpm</A>(8)</B>
776
849
General Purpose Mouse, imwheel edition required.
777
<B><A HREF="http://jonatkins.org/cgi-bin/man2html.cgi?1x+FvwmIdent">FvwmIdent</A>(1x)</B>
850
<B><A HREF="http://jcatki.dhs.org/cgi-bin/man2html.cgi?1x+FvwmIdent">FvwmIdent</A>(1x)</B>
778
851
FVWM2's Identify module, for probing windows.
779
<B><A HREF="http://jonatkins.org/cgi-bin/man2html.cgi?7+regex">regex</A>(7)</B>
852
<B><A HREF="http://jcatki.dhs.org/cgi-bin/man2html.cgi?7+regex">regex</A>(7)</B>
780
853
POSIX 1003.2 Regular Expressions.
781
<B><A HREF="http://jonatkins.org/cgi-bin/man2html.cgi?1x+xmodmap">xmodmap</A>(1x)</B>
854
<B><A HREF="http://jcatki.dhs.org/cgi-bin/man2html.cgi?1x+xmodmap">xmodmap</A>(1x)</B>
782
855
Utility for modifying keymap & button mappings in X.
783
<B><A HREF="http://jonatkins.org/cgi-bin/man2html.cgi?1x+xev">xev</A>(1x)</B>
856
<B><A HREF="http://jcatki.dhs.org/cgi-bin/man2html.cgi?1x+xev">xev</A>(1x)</B>
784
857
Print contents of X events.
785
858
<B>/usr/include/X11/keysymdef.h</B>
786
859
X11 KeySym definitions.
798
871
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
799
872
<DT><A HREF="#lbAE">COMMAND LINE OPTIONS</A><DD>
800
873
<DT><A HREF="#lbAF">X WINDOWS ZAXIS METHOD</A><DD>
801
<DT><A HREF="#lbAG">GPM/JAM WHEEL FIFO METHOD</A><DD>
874
<DT><A HREF="#lbAG">GPM/JAMD WHEEL FIFO METHOD</A><DD>
802
875
<DT><A HREF="#lbAH">STICK SENSITIVITY SETTINGS</A><DD>
803
876
<DT><A HREF="#lbAI">IMWHEELRC</A><DD>
804
877
<DT><A HREF="#lbAJ">IMWHEELRC WINDOW SECTION HEADERS</A><DD>