# Gamgi Config

- Usability
- Precision
- Color

### sound

To disable/enable the internal computer sound, used in GAMGI, for example, to signal that an object has been recognized.

    Example: <gamgi sound="yes"/> (defined in GAMGI_GTK_BEEP) (default)
    Allowed values: yes, no (optional)

### tolerance

When selecting objects with the mouse, the sampled area is defined by the pixel where the user clicked the mouse, plus a tolerance given by the number of neighbour shells that should be considered. Thus a tolerance of 0 means that only the chosen pixel should be considered, while a tolerance of 1 means that the 8 pixels around should also be taken into account.

Small tolerances demand precision when pointing to the object, but large tolerances make it too easy to select more than one object, in which case GAMGI considers the object selection as unsucessfull.

    Example: <gamgi tolerance="3"/> (default)
    (defined in GAMGI_MESA_PICK_TOLERANCE)
    Allowed values: 0 - 5 (defined in GAMGI_MESA_PICK_TOLERANCE_MAX) (optional)

### button1, button2, button3

GAMGI expects to work with a 3-button mouse, where button1 handles operations such as rotating and menu selection, button2 handles operations such as moving and object selection, and button3 handles operations such as scaling. By default, these logical buttons point to the physical buttons left (1), middle (2) and right (3), respectively, but this can be changed, by pointing button1, button2, button3 to different combinations of values 1, 2 and 3, prodiving 6 possible sequences.

This should be usefull for left-hand users and when handling a 2-button mouse, to link the most important tasks to the two buttons available.

    Example: <gamgi button1="1" button2="2" button3="3"/>) (default)
    Allowed values: 1, 2, 3 (optional, coupled)

Home