1filter-mouse(7)                       GGI                      filter-mouse(7)
2
3
4

NAME

6       filter-mouse : Generic mouse event translator
7

SYNOPSIS

9       filter-mouse: [<file>]
10
11

DESCRIPTION

13       This  filter  translates mouse events according to a set of translation
14       rules.
15

OPTIONS

17       file   The name of the configuration file. If none  given,  the  filter
18              will first look for the file filter/mouse in the user GGI direc‐
19              tory ($HOME/.ggi/ on UNIX), then in the base  GGI  directory  if
20              not found.
21
22

CONFIGURATION

24       The  translation  rules  are  specified through a simple text file. The
25       following example gives a good idea of the  mouse  filter  usage.  A  #
26       marks the rest of the line as a comment.
27

EXAMPLE

29       A set of mouse translation rules:
30
31       # Syntax is:
32       # incoming-type [type-specifics] TO outgoing type [type-specifics]
33
34       #
35       # Simulated mouse buttons on the keyboard
36       #
37       #KEY modmask modvalue button label  symbol TO BUT buttonnumber
38       KEY 0x0004  0x0004   0xffff 0x000d 0xffff TO BUT 1            # Alt-Enter
39       KEY 0x0004  0x0004   0xffff 0x0020 0xffff TO BUT 2            # Alt-Space
40       KEY 0x0004  0x0004   0xffff 0x0008 0xffff TO BUT 3            # Alt-BackSpace
41
42       #
43       # Keyboard-Mouse on the Cursors
44       #
45       #KEY modmask modval button label  symbol TO REL axis value
46       KEY 0x0004  0x0004 0xffff 0xe034 0xffff TO REL X    -5        # Alt-Left
47       KEY 0x0004  0x0004 0xffff 0xe035 0xffff TO REL X     5        # Alt-Right
48       KEY 0x0004  0x0004 0xffff 0xe032 0xffff TO REL Y    -5        # Alt-Up
49       KEY 0x0004  0x0004 0xffff 0xe033 0xffff TO REL Y     5        # Alt-Down
50
51       #
52       # Keyboard mouse on the Numpad
53       #
54       KEY 0x0004 0x0004 0xffff 0xe231 0xffff TO REL X -5    # Alt-Num1
55       KEY 0x0004 0x0004 0xffff 0xe231 0xffff TO REL Y  5    # Alt-Num1
56       KEY 0x0004 0x0004 0xffff 0xe232 0xffff TO REL Y  5    # Alt-Num2
57       KEY 0x0004 0x0004 0xffff 0xe233 0xffff TO REL X  5    # Alt-Num3
58       KEY 0x0004 0x0004 0xffff 0xe233 0xffff TO REL Y  5    # Alt-Num3
59       KEY 0x0004 0x0004 0xffff 0xe234 0xffff TO REL X -5    # Alt-Num4
60       KEY 0x0004 0x0004 0xffff 0xe235 0xffff TO BUT 1               # Alt-Num5 - Button
61       KEY 0x0004 0x0004 0xffff 0xe236 0xffff TO REL X  5    # Alt-Num6
62       KEY 0x0004 0x0004 0xffff 0xe237 0xffff TO REL X -5    # Alt-Num7
63       KEY 0x0004 0x0004 0xffff 0xe237 0xffff TO REL Y -5    # Alt-Num7
64       KEY 0x0004 0x0004 0xffff 0xe238 0xffff TO REL Y -5    # Alt-Num8
65       KEY 0x0004 0x0004 0xffff 0xe239 0xffff TO REL X  5    # Alt-Num9
66       KEY 0x0004 0x0004 0xffff 0xe239 0xffff TO REL Y -5    # Alt-Num9
67
68       #
69       # Home the cursor ...
70       #
71       KEY 0x0004 0x0004 0xffff 0xE038 0xffff TO ABS X 0     # Alt-Home
72       KEY 0x0004 0x0004 0xffff 0xE038 0xffff TO ABS Y 0     # Alt-Home
73
74       #
75       # Invert mouse axis
76       #
77       #REL modmsk modval axis TO REL axis multiplier
78       REL 0x0004 0x0004 X    TO REL Y    -1
79       REL 0x0004 0x0004 Y    TO REL X    -1
80
81       #
82       # Accelerate mouse
83       #
84       #                             multiplier treshold higher-speed
85       REL 0x0004 0x0004 X TO REL X 1          5        4
86       REL 0x0004 0x0004 Y TO REL Y 1          5        4
87
88       #
89       #
90       # Invert mouse buttons
91       BUT 0x0004 0x0004 1 TO BUT 2
92       BUT 0x0004 0x0004 2 TO BUT 1
93
94
95
96
97libgii-1.0.x                      2003-08-11                   filter-mouse(7)