filter-mouse

Langue: en

Version: 303303 (debian - 07/07/09)

Section: 7 (Divers)

NAME

filter-mouse - Generic mouse event translator

SYNOPSIS

 filter-mouse: [<file>]
 

DESCRIPTION

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

OPTIONS

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

CONFIGURATION

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

EXAMPLE

A set of mouse translation rules:
 # Syntax is:
 # incoming-type [type-specifics] TO outgoing type [type-specifics]
 
 #
 # Simulated mouse buttons on the keyboard
 #
 #KEY modmask modvalue button label  symbol TO BUT buttonnumber
 KEY 0x0004  0x0004   0xffff 0x000d 0xffff TO BUT 1            # Alt-Enter
 KEY 0x0004  0x0004   0xffff 0x0020 0xffff TO BUT 2            # Alt-Space
 KEY 0x0004  0x0004   0xffff 0x0008 0xffff TO BUT 3            # Alt-BackSpace
 
 #
 # Keyboard-Mouse on the Cursors
 #
 #KEY modmask modval button label  symbol TO REL axis value
 KEY 0x0004  0x0004 0xffff 0xe034 0xffff TO REL X    -5        # Alt-Left
 KEY 0x0004  0x0004 0xffff 0xe035 0xffff TO REL X     5        # Alt-Right
 KEY 0x0004  0x0004 0xffff 0xe032 0xffff TO REL Y    -5        # Alt-Up
 KEY 0x0004  0x0004 0xffff 0xe033 0xffff TO REL Y     5        # Alt-Down
 
 #
 # Keyboard mouse on the Numpad
 #
 KEY 0x0004 0x0004 0xffff 0xe231 0xffff TO REL X -5    # Alt-Num1
 KEY 0x0004 0x0004 0xffff 0xe231 0xffff TO REL Y  5    # Alt-Num1
 KEY 0x0004 0x0004 0xffff 0xe232 0xffff TO REL Y  5    # Alt-Num2
 KEY 0x0004 0x0004 0xffff 0xe233 0xffff TO REL X  5    # Alt-Num3
 KEY 0x0004 0x0004 0xffff 0xe233 0xffff TO REL Y  5    # Alt-Num3
 KEY 0x0004 0x0004 0xffff 0xe234 0xffff TO REL X -5    # Alt-Num4
 KEY 0x0004 0x0004 0xffff 0xe235 0xffff TO BUT 1               # Alt-Num5 - Button
 KEY 0x0004 0x0004 0xffff 0xe236 0xffff TO REL X  5    # Alt-Num6
 KEY 0x0004 0x0004 0xffff 0xe237 0xffff TO REL X -5    # Alt-Num7
 KEY 0x0004 0x0004 0xffff 0xe237 0xffff TO REL Y -5    # Alt-Num7
 KEY 0x0004 0x0004 0xffff 0xe238 0xffff TO REL Y -5    # Alt-Num8
 KEY 0x0004 0x0004 0xffff 0xe239 0xffff TO REL X  5    # Alt-Num9
 KEY 0x0004 0x0004 0xffff 0xe239 0xffff TO REL Y -5    # Alt-Num9
 
 #
 # Home the cursor ...
 #
 KEY 0x0004 0x0004 0xffff 0xE038 0xffff TO ABS X 0     # Alt-Home
 KEY 0x0004 0x0004 0xffff 0xE038 0xffff TO ABS Y 0     # Alt-Home
 
 #
 # Invert mouse axis
 #
 #REL modmsk modval axis TO REL axis multiplier
 REL 0x0004 0x0004 X    TO REL Y    -1
 REL 0x0004 0x0004 Y    TO REL X    -1
 
 #
 # Accelerate mouse
 #
 #                             multiplier treshold higher-speed
 REL 0x0004 0x0004 X TO REL X 1          5        4
 REL 0x0004 0x0004 Y TO REL Y 1          5        4
 
 #
 #
 # Invert mouse buttons
 BUT 0x0004 0x0004 1 TO BUT 2
 BUT 0x0004 0x0004 2 TO BUT 1