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

NAME

6       filter-key, filter-keytrans : Generic key event translator
7

SYNOPSIS

9       filter-key: [<file>]
10
11       filter-keytrans: [<file>]
12
13

DESCRIPTION

15       This  filter  translates  key  events according to a set of translation
16       rules. This can be used to remap a keyboard.
17

OPTIONS

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

CONFIGURATION

26       The  mapping is specified through a simple text file, each line being a
27       translation rule. A line starting with a # is a comment. Each line must
28       contain 10 values in the following order:
29
30       modifier_mask
31              Consider only the bits set here.
32
33
34       modifier_value
35              The bits set above must match this value.
36
37
38       button_in, label_in, symbol_in
39              If  this is not KEY_UNMAPPED==0xffff, the button/label/symbol of
40              the incoming key must match these fields.
41
42
43       modifier_changemask
44              Change these bits from the original modifiers...
45
46
47       modifier_ormask
48
49
50       button_out, label_out, symbol_out
51              The data that is then sent by the keymapper. Any fields  set  to
52              KEY_UNMAPPED==0xffff will be copied from the incoming event.
53
54

EXAMPLE

56       Mapping a symbol:
57
58       # Take any key that produces a symbol of 0x41 ('A') map it to ESC
59       #
60       # modmsk modval buttin lablin symin  modchg modor  butout labout symout
61       0x0000 0x0000 0xffff 0xffff 0x0041 0x0000 0x0000 0xffff 0xffff 0x001b
62
63
64
65
66libgii-1.0.x                      2003-08-11                     filter-key(7)
Impressum