# Manual del Mousetweaks

## Introducció

El Mousetweaks proporciona millores d'accessibilitat del ratolí per a l'escriptori del GNOME. Aquest ofereix les funcions següents a l'usuari:

- Clic secundari simulat: permet a l'usuari realitzar un clic secundari (clic de menú) en mantenir premut el botó primari del ratolí mentre es manté el punter sense moure'l.

- Clic en pausa: permet a l'usuari realitzar diversos clics sense prémer cap botó de maquinari.

- Captura del punter: permet a l'usuari bloquejar el punter a una àrea determinada del quadre fins que l'usuari l'alliberi amb la pulsació d'una tecla predeterminada o d'un botó del ratolí.

Since version 2.31.3, mousetweaks does not depend any more on the AT-SPI accessibility framework.

## Com iniciar les funcions

El clic secundari simulat i el clic en pausa depenen del procés del Mousetweaks. De tota manera, la miniaplicació de captura del punter depèn del quadre del GNOME. En conseqüència, els mètodes per a iniciar-los són diferents.

### Com iniciar la funció de clic secundari simulat

Podeu iniciar la funció de clic secundari simulat de dues maneres:

- Des de la interfície gràfica d'usuari

- Des de la línia d'ordres

#### Com iniciar des de la interfície gràfica d'usuari

La interfície gràfica d'usuari per a iniciar el clic secundari simulat està ubicada a la pestanya d'accessibilitat del quadre de control del ratolí. Per a obrir-la, trieu al menú Sistema Preferències Centre de control i s'obrirà el Centre de control. En fer clic a Ratolí al Centre de control, s'obrirà el quadre de control del ratolí i després de fer clic a la pestanya Accessibilitat veureu els paràmetres següents:

Imatge del quadre de control del ratolí

Per a iniciar la funció de clic secundari simulat, marqueu la casella de selecció següent:

Activa el clic secundari simulat en mantenir premut el botó primari

Imatge de la casella de selecció per a iniciar el clic secundari simulat

#### Com iniciar des de la línia d'ordres

Per a iniciar el clic secundari simulat des de la línia d'ordres, obriu el Terminal i introduïu el següent:

`mousetweaks `--ssc``

### Com iniciar la funció de clic en pausa

Podeu iniciar la funció de clic en pausa de tres maneres:

- Des de la pestanya d'accessibilitat del quadre de control del ratolí

- Des de la línia d'ordres

- Des del botó Actiu/Apagat a la miniaplicació del quadre de clic en pausa

#### Com iniciar des de la pestanya d'accessibilitat del quadre de control del ratolí

La interfície gràfica d'usuari per a iniciar el clic en pausa està ubicada a la pestanya d'accessibilitat del quadre de control del ratolí. Per a obrir-la, trieu al menú Sistema Preferències Centre de control i s'obrirà el Centre de control. En fer clic a Ratolí al Centre de control, s'obrirà el quadre de control del ratolí i després de fer clic a la pestanya Accessibilitat veureu els paràmetres següents:

Imatge del quadre de control del ratolí

Per a iniciar la funció de clic en pausa, marqueu la casella de selecció següent:

Inicia el clic quan s'aturi el moviment del punter

Imatge de la casella de selecció per a iniciar la funció de clic en pausa

#### Com iniciar des de la línia d'ordres

Per a iniciar la funció de clic en pausa i mostrar la finestra del tipus de clic des de la línia d'ordres, obriu el Terminal i introduïu el següent:

`mousetweaks `--dwell --show-ctw``

The starting parameters --login and --daemonize were added to allow GDM to start and quit mousetweaks: the first disables the check for the Assistive Technologies framework at the start of mousetweaks; by not passing the second, mousetweaks will keep the pid that it got when it started, allowing GDM to shut it down by using the pid.

#### Com iniciar des del botó Actiu/Apagat a la miniaplicació del quadre de clic en pausa

It is possible to start the Dwell Click by simply resting (dwelling) for a little delay with the pointer on the mouse icon displayed by the Dwell Click panel applet. In fact, this mouse icon is a dwellable On/Off button that provides feedback of the passing dwell time by filling its frame with another colour. When the frame is completely filled, the button displays its active state and the dwell click gets started.

Imatge que mostra la miniaplicació de tipus de clic a la dreta dels menús del GNOME

For instructions about how to install the Dwell Click applet on the GNOME panel, please have a look at Starting The Pointer Capture Function where you can see how it is done for the Pointer Capture panel applet. The procedure for the Dwell Click panel applet is similar.

### Com iniciar la funció de captura del punter

Com que la miniaplicació de captura del punter és una miniaplicació del quadre, el mètode per a iniciar-la ha de seguir les regles establertes per al quadre del GNOME. Per això, per a iniciar la funció de captura del punter, només heu d'instal·lar-la al quadre i s'executarà automàticament.

Per a poder-la afegir al quadre, procediu de la mateixa manera que ho faríeu amb qualsevol miniaplicació del quadre: realitzeu un clic amb el botó secundari al quadre per a obrir el menú contextual, trieu Afegeix al quadre i obtindreu una finestra que mostra totes les miniaplicacions que es poden instal·lar al quadre del GNOME.

En fer doble clic a l'element Captura del punter a la finestra d'Afegeix al quadre, s'afegirà la miniaplicació de captura del punter al quadre i s'executarà fins que sigui suprimit del quadre del GNOME.

## Com aturar les funcions

De manera similar a com iniciar les funcions, la manera d'aturar-les depèn de la funció que voleu aturar.

### Com aturar el clic secundari simulat

És possible sortir del clic secundari simulat de dues maneres:

- En suprimir la marca de la casella de selecció corresponent al quadre de control del Mousetweaks.

  Imatge de la casella de selecció per a iniciar la funció de clic secundari simulat

  Vegeu Com iniciar el clic secundari simulat des de la interfície gràfica d'usuari per a veure on és la casella de selecció.

- Introduint l'ordre següent a la línia d'ordres:

  `mousetweaks` `--shutdown`

### Com suprimir el clic en pausa

És possible suprimir el clic en pausa de tres maneres:

- En suprimir la marca de la casella de selecció corresponent al quadre de control del Mousetweaks.

  Imatge de la casella de selecció per a iniciar la funció de fer clic sense botó

  Vegeu Com iniciar el clic en pausa des de la interfície gràfica d'usuari per a ubicar la casella de selecció.

- Introduint l'ordre següent a la línia d'ordres:

  `mousetweaks` `--shutdown`

- Si la miniaplicació de clic en pausa s'ha instal·lat al quadre del GNOME, es pot inhabilitar el clic en pausa en fer un clic en pausa amb el punter al botó Actiu/Apagat.

  Imatge que mostra la miniaplicació de tipus de clic a la dreta dels menús del GNOME

### Com suprimir la funció de captura del punter

Com que la funció de captura del punter té la forma de miniaplicació del quadre, heu de suprimir-la de la mateixa manera que ho feu amb les altres miniaplicacions: heu de suprimir-la del quadre del GNOME. Per a fer-ho, realitzeu un clic amb el botó secundari al gestor de la miniaplicació i trieu Suprimeix del quadre en el seu menú contextual.

Imatge que mostra l'àrea de captura del punter (verd) amb el seu menú contextual

Quan s'utilitza el tema predeterminat del GNOME, el gestor de la miniaplicació de captura del punter són dues línies verticals puntejades a l'esquerra de l'àrea de captura del punter.

## Descripció de les funcions

El Mousetweaks ofereix tres funcions d'accessibilitat del punter a l'usuari. En aquesta secció trobareu la descripció de les tres funcions:

### Descripció del clic secundari simulat

Quan l'usuari activa aquesta funció, podrà realitzar clics secundaris utilitzant el botó primari del ratolí. Això és especialment útil per als usuaris que només tenen un botó del ratolí a la seva disposició.

Imatge que mostra els paràmetres que pertanyen al clic secundari simulat.

#### Com funciona?

Assumim que l'usuari ha habilitat la funció de clic secundari simulat.

To perform a simulated secondary click, the user has to keep the primary mouse button pressed without moving the pointer for the time determined by the delay slider of the Simulated Secondary Click feature. While the primary mouse button is kept pressed, the arrow of the pointer will be filled with a different color to give feedback about the passing time.

If the user releases the primary mouse button before the arrow of the pointer has been completely filled with the new color, the system will only receive the information of the primary mouse button press and release.

If the user releases the primary mouse button after the arrow of pointer has been completely filled with the new color, the primary mouse button events will be followed by a secondary mouse button click. In fact, mousetweaks creates this simulated secondary mouse button click as soon as the user releases the the primary mouse button.

The explanations above assumed that the pointer did not move between the primary mouse button press and release. If the pointer gets moved before the primary mouse button is released, no simulated secondary click will be created. Consequently, to cancel an initiated secondary click, the user only has to move the pointer before releasing the primary mouse button.

Moreover, the fact that the simulated secondary click is immediately preceded by a left click makes it behave differently than expected when the preceding left click has an incidence on the object that is to receive the simulated secondary click. Please, have a look at the section about the Differences To The Normal Secondary Click for more details.

#### El lliscador de retard

El temps que l'usuari ha de mantenir premut el botó primari del ratolí el determina el lliscador Retard ubicat sota la casella de selecció d'activació. En utilitzar aquest lliscador, l'usuari pot triar el retard més apropiat per a ell.

#### Llindar de moviment

Aquells qui tinguin problemes per a mantenir el punter completament sense moviment poden utilitzar el lliscador de llindar de moviment de la funció de clic en pausa. Aquest paràmetre fa que el Mousetweaks ignori els petits moviments del ratolí, de manera que el clic secundari simulat s'activa encara que el punter no estigui completament sense moviment. Per a obtenir-ne més informació, vegeu la secció Lliscador de llindar de moviment de la funció de clic en pausa.

El lliscador de Llindar de moviment que està ubicat sota la funció de Clic en pausa també és efectiu per a la funció Clic secundari simulat, encara que la funció Clic en pausa estigui inhabilitada.

#### Diferències amb el clic secundari normal

As the Simulated Secondary Click does not discard the primary mouse button press and release, the resulting primary click occurs just before the secondary click created by mousetweaks. Consequently, the simulated secondary click behaves a bit differently than the normal secondary click, because the latter is usually not preceded immediately by a primary mouse button click. For example:

- No és possible realitzar un clic secundari a diversos elements perquè el clic primari activat abans del clic secundari cancel·la la selecció dels elements.

- When performing a simulated secondary click on a link in a web page, the primary click, that precedes the simulated secondary click, opens the referenced page before the simulated secondary click has a chance to open the contextual menu of the link.

  The contextual menu of a link in a web page can be opened by performing a simulated secondary click while keeping the Ctrl modifier pressed. This works because the referenced page opens in a new tab when the link receives a primary click in conjunction with a pressed Ctrl modifier; which is also what happens as a side effect when opening the contextual menu of a link by using the simulated secondary click in conjunction with the Ctrl modifier.

  However the browser has to be configured to not automatically switch to the new tab when it opens; otherwise the page with the link disappears as the new tab becomes visible and the contextual menu does not appear.

- When the simulated secondary click is performed on the trash icon in the panel, not only does the contextual menu appear, but the trash folder also opens. (The former is caused by the secondary click, the latter by the primary click preceding the secondary click.)

No és possible proporcionar una llista de tots els comportaments divergents, perquè això depèn de la reacció de l'aplicació que rebi el clic secundari precedit per un clic primari.

Looking at it the other way, it is not possible to perform a long motionless primary mouse button press without also triggering the secondary click, unless the pointer is moved before the primary mouse button release. This may also have unexpected consequences for some users. For example:

- When releasing the primary button after keeping it pressed on the arrow of a scrollbar for more than the delay time, the scrollbar jumps to the bottom. This is in fact the normal behaviour of a secondary click on an arrow of a scrollbar.

  To avoid that the scrollbar jumps to the bottom, simply move the pointer away from the arrow of the scrollbar before releasing the primary button; this way, the initiated simulated secondary click gets cancelled.

### Descripció del clic en pausa

Hi ha usuaris que no poden utilitzar cap botó de maquinari. En activar el Clic en pausa podran fer que el ratolí realitzi els diversos clics sense prémer cap botó del ratolí. Els tipus de clic que es poden realitzar són: un sol clic primari, doble clic, clic d'arrossegament i clic secundari.

When the dwell click is active, the mouse buttons remain functional and it is still possible to click with the mouse buttons. Moreover, If the user performs a click with a mouse button while a dwell click is in progress, the dwell click gets stopped and no dwell click is generated; to initiate a new dwell click, the user has to move and stop moving the mouse as usual for the dwell click.

#### Com funciona?

Cada cop que el punter s'aturi, s'iniciarà un clic en pausa. Per a mostrar l'acció a l'usuari, el Mousetweaks omplirà la fletxa del punter amb un altre color mentre es realitza el compte enrere abans de que es realitzi el clic.

De quina manera es completa el clic i com es tria el tipus de clic depèn del mode de clic en pausa que l'usuari hagi seleccionat. Els dos modes disponibles són:

- Selecciona el tipus de clic per avançat

- Selecciona el tipus de clic amb gestos del ratolí

Imatge que mostra els botons d'opció per a seleccionar el mode del clic en pausa

Per a seleccionar el mode, l'usuari només ha de fer clic al botó d'opció que correspon a la seva opció.

##### Completat automàtic del clic amb tria de tipus de clic per avançat

Aquest mode està actiu quan l'usuari selecciona Selecciona el tipus de clic per avançat. De fet, després que el ratolí estigui sense moviment durant un temps definit pel lliscador Retard, el sistema automàticament realitzarà el tipus de clic que s'ha seleccionat a la finestra del tipus de clic que es mostra:

Imatge que mostra la finestra del tipus de clic

Per a mostrar la finestra Tipus de clic a la pantalla, l'usuari ha de marcar la casella de selecció anomenada Mostra la finestra del tipus de clic:

Imatge amb la casella de selecció per a mostrar la finestra del tipus de clic

Després de que s'hagi realitzat el clic, es restaurarà automàticament al tipus de clic senzill. Per a poder triar un altre tipus de clic, l'usuari ha de realitzar un clic automàtic al botó a la finestra Tipus de clic que correspon al seu tipus de clic triat.

Enlloc de la finestra de tipus de clic, alguns usuaris poden preferir utilitzar la miniaplicació del quadre Clic en pausa, la qual ofereix certs avantatges:

Imatge que mostra la miniaplicació de tipus de clic a la dreta dels menús del GNOME

En utilitzar la miniaplicació del quadre Clic en pausa:

- A l'usuari no li cal la finestra Tipus de clic, la qual pot ser que tapi altres finestres de l'escriptori.

- L'usuari té una manera directa per a iniciar i aturar el clic en pausa en utilitzar el botó Actiu/Apagat de la miniaplicació Clic en pausa. Això és especialment útil quan es vol inhabilitar el clic en pausa una estona per a llegir algun text sense la interferència d'un clic en pausa.

Per a mostrar la miniaplicació Clic en pausa al quadre del GNOME, l'usuari ha de seguir el procediment normal per a afegir miniaplicacions al quadre del GNOME. Podeu trobar un exemple de com fer-ho a la secció Com iniciar la funció de captura del punter.

La finestra Tipus de clic en pausa i la miniaplicació Clic en pausa es poden utilitzar a la vegada o cada una per separat

##### Compleció del clic i tria de tipus de clic amb gestos del ratolí

Aquest mode s'activa quan l'usuari selecciona Selecciona el tipus de clic amb gestos del ratolí. De fet, després de que el ratolí hagi estat sense moviment pel retard definit pel lliscador de retard, la forma del punter canviarà durant un curt període. Anomenarem a aquesta forma la forma del gest.

- Si l'usuari mou el punter mentre es mostra la forma del gest, es realitzarà un clic a la ubicació on el punter estava sense moviment. Finalment el punter tornarà a la seva forma normal. El tipus de clic realitzat depèn de la direcció del moviment del ratolí. Durant el moviment del punter, es dibuixarà una línia seguint el moviment del punter per a mostrar el moviment a l'usuari.

- Si l'usuari manté el punter sense moviment fins que retorna a la seva forma normal, l'usuari podrà moure el ratolí sense que s'hagi realitzat un clic. El següent clic en pausa es realitzarà el següent cop que s'aturi el ratolí.

L'usuari també té la possibilitat de vincular el tipus de clic amb la direcció del moviment en utilitzar els 4 menús emergents disponibles:

Imatge que mostra les opcions de configuració per a vincular el tipus de clic a la direcció del moviment

També hi ha l'element de menú Inhabilitat a cada menú emergent. L'usuari pot seleccionar-lo si no vol que alguns tipus de clic es realitzin automàticament. Això és especialment interessant per als usuaris que només tenen problemes amb certs tipus de clic.

#### Paràmetres del clic amb retard

Amb el lliscador de Retard, l'usuari pot configurar quant de temps el punter ha d'estar sense moviment abans d'activar el clic.

Imatge que mostra el lliscador de retard del clic en pausa

El retard del clic en pausa només funciona en el context del clic en pausa.

#### Paràmetre del llindar de moviment

Per a aquells qui tenen problemes per a mantenir el ratolí sense moviment hi ha el lliscador Llindar del moviment.

Imatge que mostra el lliscador de llindar del moviment del clic en pausa

Quan el lliscador està establert a baix, fins i tot es té en consideració els petits moviments del ratolí. No obstant, en establir un llindar alt, el ratolí ha de travessar una distància major abans que es consideri com a moviment.

El paràmetres del llindar de moviment no només funciona per al clic en pausa, sinó que també per al clic secundari simulat, encara que el clic en pausa estigui inhabilitat.

### Descripció del bloqueig del punter

Certes persones han d'utilitzar el seu dispositiu de punter no només per a l'ordinador. Per a aquests usuaris serà útil tenir una manera per a bloquejar el punter a una àrea de la pantalla, de manera que puguin utilitzar el dispositiu de punter per a altres tasques.

De fet, la miniaplicació del quadre de captura del punter crea una àrea al quadre on l'usuari pot bloquejar el punter fins que l'alliberi d'una manera determinada.

Have a look at Starting The Pointer Capture Function for instructions about how to install the pointer capture applet on the GNOME panel.

Imatge que mostra l'àrea de captura del punter (verd) amb el seu menú contextual

Imatge de l'àrea de captura del punter quan el punter s'ha capturat

En triar Preferències al menú contextual de la miniaplicació de Captura del punter, l'usuari obtindrà una finestra amb les opcions de la miniaplicació de Captura del punter:

Imatge que mostra les preferències de la miniaplicació de captura del punter

La finestra de Preferències de la miniaplicació de Captura del punter té tres seccions:

- A la secció Captura el punter l'usuari pot especificar sota quines circumstàncies el punter es captura quan aquest es mogui cap a dins de l'àrea de captura. Per exemple, si el modificador de control està activat, el punter es capturarà quan estigui a l'àrea de captura i l'usuari premi la tecla modificadora Control. Si no s'ha activat cap modificador i s'estableix el botó del ratolí a 0, el punter només s'haurà de moure a l'àrea de captura per a bloquejar-lo.

  També és possible especificar una combinació de modificadors i el botó del ratolí.

- A la secció Allibera el punter, l'usuari pot especificar quin modificador o botó del ratolí alliberarà el punter.

  També és possible especificar una combinació de modificadors i el botó del ratolí.

- A la secció Mida de l'àrea de captura, l'usuari pot especificar l'amplada de l'àrea de captura al quadre del GNOME.

## Quant al Mousetweaks

### Autors i lloc d'hostatge

El Mousetweaks està basat en una especificació hostatjada al Launchpad. En Gerd Kohlberger ( gerdk@svn.gnome.org ) l'ha implementat, i en Francesco Fumanti ( frfumanti@svn.gnome.org ) ha ajudat amb les proves i la logística.

Podeu obtenir més informació sobre el Mousetweaks al Launchpad i al GNOME Live.

### Comentaris

Per a informar d'un error o fer algun suggeriment sobre el mòdul Mousetweaks, la seva interfície d'usuari o el seu manual, utilitzeu les eines proporcionades pel Bugzilla del GNOME. Si afectà al format de la pestanya d'accessibilitat del quadre de control del ratolí, informeu de l'error al mòdul gnome-control-center; per a qualsevol altra cosa relacionada amb el Mousetweaks, informeu de l'error al mòdul mousetweaks.

### Llicència

El Mousetweaks es distribueix sota els termes de la Llicència pública general de GNU tal com publica la Free Software Foundation; tant en la versió 3 de la llicència, o (a la vostra opció) una versió posterior. Es pot trobar una còpia d'aquesta llicència en aquest enllaç, o en el fitxer COPYING.GPL inclòs amb el codi font d'aquest programa.

Aquest manual es distribueix sota els termes de la Llicència de documentació lliure de GNU tal com publica la Free Software Foundation; tant en la versió 1.3 de la llicència, o (a la vostra opció) una versió posterior. Es pot trobar una còpia d'aquesta llicència en aquest enllaç, o en el fitxer COPYING.FDL inclòs amb el codi font d'aquest programa.