<!DOCTYPE linuxdoc system>
<!-- 
Wacom Tablet HOWTO, (C) 1999 by <SR>
------------------------------------

History:
1.0.1 28.10.99: First draft
1.0.2 30.10.99: Keys section written, gimp section: keys written
1.0.3 01.11.99: wacom to Wacom, than to then, gpm section: modified "V1.18.1"
                supports graphire
                added "Getting max values" /
1.0.4 03.11.99: removed typos, checked tex generation
1.0.5 21.11.99: WacomErasor to WacomEraser, Mini-XF86Config: first two lines
                swapped. gpm: mouse type description fixed, added asterix 
                explaination
1.0.6 28.03.00: Problems Section written, gpm and graphire sections updated
                Copyright changed to gpl
 -->
<ARTICLE>
<TITLE>HOW TO Tablette Wacom</TITLE>
<AUTHOR>Stefan Runkel <TT>&lt;runkel@runkeledv.de&gt;</TT>
<NEWLINE>
Traduit de l'anglais par Aurélia Girod <TT>&lt;agirod@lemel.fr&gt;</TT></AUTHOR>
<DATE>Version 1.0.6, 28 Mars 2000</DATE>
<ABSTRACT>
Installation de tablettes graphiques Wacom (et pas seulement) sous Linux en console et/ou sous XFree86
</ABSTRACT>
<TOC>
<SECT>
Copyright
<P>
Copyright (c) 1999,2000 par Stefan Runkel 
<HTMLURL url="mailto:Runkel@runkeledv.de" name="Runkel@runkeledv.de">
<P>
Ce document décrit l'installation de tablettes Wacom sous Linux. 
<NEWLINE>
Vous pouvez le distribuer soit sous les termes de la licence GPL version 2 ou supérieur, soit sous les termes du Projet de Documentation de Linux (LPD). 
Ces licenses devraient être applicables quelque soit l'endroit où vous avez obtenu ce document. 
Dernière remarque, depuis que le LDP n'autorise pas de modifications autre que les traductions, les versions modifiées ne peuvent être distribuées que sous la license GPL. 

<SECT>
Introduction
<P>
 
<LABEL id="_Toc465765693">

Les tablettes graphiques sont aujourd'hui relativement bon marché. Elles sont d'un grand secours pour la retouche d'image. En plus de faire la même chose qu'une souris, elles proposent les caractéristiques suivantes : 

<ITEMIZE>
<ITEM>
la sensibilité à la pression et à l'inclinaison ; 
<ITEM>
une détection du mouvement d'une grande précision ; 
<ITEM>
le positionnement d'une précision inférieure au pixel ; 
<ITEM>
un périphérique qui ressemble et qui se manipule comme un stylo normal. 
</ITEMIZE>

Ce document s'adresse principalement aux produits Wacom, parce que j'en possède trois différents et que ces produits sont assez courants en Europe. 

<P>
Cependant, je pense que ce doit être facile d'adapter ces explications pour d'autres produits. 

<P>
J'ai écrit ce document car je n'en ai pas trouvé sur ce sujet qui contenait tout ce que je voulais savoir. 
J'ai donc rassemblé toutes les parties d'informations trouvées sur le Net dans ce HowTo. 
Considérant les questions de mes lecteurs, je sais que ce document aussi n'est pas complet et qu'il ne le sera jamais, mais je peux dire qu'il aidera beaucoup de gens et chaque nouvelle question complétera ce HowTo. 

<SECT1>Nouvelles versions de ce document 
<P>
 
<LABEL id= "_Toc465765694" >
La dernière version de ce document sera disponible sur 
<HTMLURL url="http://www.runkeledv.de/linux.htm" name="http://www.runkeledv.de/linux.htm">.

<SECT1>Opinions et corrections
<P>
 
<LABEL id="_Toc465765695"  >
Les commentaires, corrections et compléments sont les bienvenus. Contactez-moi à 
<P>
<HTMLURL url="mailto:Runkel@runkeledv.de" name="Runkel@runkeledv.de">
ou à <HTMLURL url="mailto:RunkelEDV@t-online.de" name="RunkelEDV@t-online.de">

<SECT1>Remerciements
<P>
 
<LABEL id="_Toc465765696"  >
Je voudrais remercier tous les auteurs listés sur la section 
<REF id="_Toc465765731" name="Plus d'informations / Documents utilisés">
ainsi que tous ceux qui ont répondu à mes questions par email. Ce HowTo reflète leur travail. 

<SECT>Les indispensables
<P>
 
<LABEL id="_Toc465765697">
Ce chapitre contient ce qui est nécessaire pour faire fonctionner votre tablette.

<SECT1>Matériel supporté
<P>
 
<LABEL id="_Toc465765698">
Premièrement, vous devez bien sûr avoir une tablette graphique. 
Celle-ci doit pouvoir se connecter au port série (RS232) de votre ordinateur car le support USB pour Linux est encore en développement. 
Au moment où ce doument est écrit (mars 2000), le support du noyau est commencé pour les nouveaux produits USB de Graphire et Intuos et cela fonctionne avec XFree. 
Gpm n'est plus maintenu, donc il ne faudra pas s'attendre à un driver USB pour ce logiciel. 

<P>
Les tablettes Wacom suivantes sont supportées : 
<P>

<ITEMIZE>
<ITEM>les séries ArtZ II (connues en Europe sous les séries UltraPad - le même nom était aussi utilisé pour d'anciennes tablettes qui ne marchaient que partiellement) ; 
<ITEM>ArtPad II ;
<ITEM>PL300 (écran LCD et tablettes combinés) ;
<ITEM>Pen Partner ; 
<ITEM>Graphire (souris et stylo, le driver alpha 16 pour un support complet se trouve à 
<HTMLURL url="http://www.lepied.com/xfree86/" name="http://www.lepied.com/xfree86/">) ;
<ITEM> les séries Intuos (support seulement partiel avec le driver livré avec, téléchargez les nouvelles versions alpha à la page Frederic Lepied :
<LABEL id="_driverlepied"><HTMLURL url="http://www.lepied.com/xfree86/" name="http://www.lepied.com/xfree86/">).
</ITEMIZE>
<P>
Les plus anciennes séries SD et HD ne sont pas supportées par XFree86 standard. 
Cependant, un driver modifié qui supporte ces périphériques ainsi que quelques produits OEM avec un écran intégré comme le Thinkpad 360 PE d'IBM et le Toshiba T200 est téléchargeable à l'adresse : 
<HTMLURL url="http://hwr.nici.kun.nl/pen-computing/pen-computing-formats.html" name="http://hwr.nici.kun.nl/pen-computing/pen-computing-formats.html">

<SECT1>Logiciel nécessaire
<P>
 
<LABEL id="_Toc465765699" >
<ITEMIZE>
<ITEM>
<LABEL id="_gpm">
Si vous voulez un driver en mode texte sous Linux, téléchargez la dernière version de gpm à l'adresse
<HTMLURL url="ftp://ftp.prosa.it/pub/gpm" name="ftp://ftp.prosa.it/pub/gpm">
ou 
<HTMLURL url="ftp://animal.unipv.it/pub/gpm"  name="ftp://animal.unipv.it/pub/gpm">
(miroir)
<P>

<ITEM>
<LABEL id="_xfree">
Si vous voulez un driver sous XFree86, utilisez au moins la version 3.3.3.1 ou téléchargez la dernière à  
<HTMLURL url="http://www.xfree.org/"  name="http://www.xfree.org">
</ITEMIZE>

<SECT1>Logiciels supportés
<P>
 
<LABEL id="_Toc465765700"  >
<ITEMIZE>
<ITEM>
Pour le mode texte, je ne connais que Gpm. 
<P>
<ITEM>
Sous XFree, le mot-clé est XInput. Les drivers supportent cette norme qui fournit des informations supplémentaires. Les programmes qui veulent utiliser des périphériques de pointage exotiques devront utiliser XInput. 
</ITEMIZE>
<P>
Il existe un grand nombre de programmes basés sur la bibliothèque GTK. 
XInput est supporté par GTK ce qui le rend facile à utiliser. 
<NEWLINE>
Enfin, les applications suivantes supportent XInput : 
<P>

<ITEMIZE>
<ITEM>The Gimp, un puissant logiciel de retouches d'images dans le style de Photoshop. 
La version 1.1.x en développement (non stable) inclut le support XInput en standard. 
On attend la prochaine version stable, la 1.2.x.
Vous pouvez télécharger Gimp à l'adresse 
<LABEL id="_gimp">
<HTMLURL url="http://www.gimp.org/"  name="http://www.gimp.org">
, ça vaut vraiment le coup !
Je suis sûr que beaucoup le connaisse et c'est pourquoi vous avez acheté une tablette. 

<P>
<ITEM>Gsumi, un logiciel de dessin noir et blanc tout simple qui permet de dessiner ou d'effacer grâce à la sensiblité de la pression et de l'inclinaison. 
Téléchargez le sur la page Gsumi à l'adresse : 
<HTMLURL url="http://www.gtk.org/~otaylor/gsumi/"   name="http://www.gtk.org/~otaylor/gsumi/">

<P>
<ITEM>Xink (par Ralph Levien), un autre programme de dessin rudimentaire pour le mode X. 
<P>
Il est disponible à l'adresse : 
<HTMLURL url="ftp://kiwi.cs.berkeley.edu/pub/raph/xink.tar.gz"   name="ftp://kiwi.cs.berkeley.edu/pub/raph/xink.tar.gz">
<P>
<ITEM>RasMol, un logiciel de visualisation de molécule qui supporte un périphérique pour numéroter utilisant XInput. Regardez à 
<HTMLURL url="http://www.umass.edu/microbio/rasmol/distrib/rasman.htm"   name="http://www.umass.edu/microbio/rasmol/distrib/rasman.htm">
.

<P>
<ITEM>xinput (par Frederic Lepied), un utilitaire très utile pour configurer et tester les périphériques XInput. 
<LABEL id="_XInput">
xinput est disponible à :
<HTMLURL url="ftp://ftp.x.org/contrib/utilities/xinput-1.2.tar.gz"   name="ftp://ftp.x.org/contrib/utilities/xinput-1.2.tar.gz">

</ITEMIZE>

<SECT>Les tablettes qui replacent les souris en console  

<P>
 
<LABEL id="_Toc465765701">

<SECT1>Les tablettes et Gpm

<P>
 
<LABEL id="_Toc46576570a"  >
Le  
<REF id="_gpm" name="gpm">
démon Gpm supporte beaucoup de périphériques d'entrée incluant les tablettes. Si vous voulez avoir la liste du matériel supporté par votre Gpm, tapez : 
<TSCREEN><EM>
	gpm -t help
</EM></TSCREEN>
et vous l'obtiendrez.
<P>
Le driver Wacom de gpm 1.18.0 et inférieur semble aller pour les très vieux modèles artpad, mais la documentation n'en parle pas. Je l'ai testé avec les modèles ultrapad, penpartner, graphire et intuos mais ça ne marchait pas. J'ai réécrit le driver Wacom pour gpm et pour l'utiliser il faut au moins la version 1.18.2 de Gpm. 
Depuis cette version, l'ancien driver Wacom a été remplacé par mon driver Wacom pour les produits graphire, penpartner et ultrapad. 
<P>
Cependant, si vous avez une vieille artpad, utilisez gpm < 1.18.1 et essayez : 
<TSCREEN><EM>
	killall gpm ; gpm -t wacom -m /dev/ttyS0
</EM></TSCREEN>
et ça devrait marcher. 
<p> 
Si vous possédez une graphire, utilisez plutôt gpm > 1.18.1 et pour le mode relatif (comme une souris) : 
<TSCREEN><EM>
	killall gpm ; gpm -t wacom -o relative -m /dev/ttyS0
</EM></TSCREEN>
pour le mode absolu (comme une tablette) :
<TSCREEN><EM>
	killall gpm ; gpm -t wacom -o absolute -m /dev/ttyS0
</EM></TSCREEN>
<P>
Bien sûr, vous n'aurez que les boutons et le mouvement, la pression et la sensibilité ne sont pas implémentées parce qu'elles ne sont pas utiles dans les éditeurs de texte. <newline> 
Il n'y a pas de support pour les boutons de fonction d'ultrapad et la roulette de graphire. 

<P>
Si vous utilisez gpm et XFree86, il se peut que vous ayez des problèmes car normalement un périphérique peut être utilisé par un seul programme à la fois. 
Pour cela, il y a deux solutions : 
<P>

<ITEMIZE>
<ITEM>Le mode repeater de gpm. 
Si vous lancez gpm avec l'option &quot;-R protocol&quot;, cela balancera toutes les données qu'il contient dans le périphérique /dev/gpmdata. Ainsi, si vous avez une souris type ps/2 vous lancez gpm comme ça : 
<EM>
	gpm -t ps2 -Rmman
</EM>
et gpm capture les données de la souris ps/2 et essaie de les traduire en un paquet mman, qui sera dirigé vers  /dev/gpmdata. 
Depuis gpm 1.18.1, les protocoles dans lesquels gpm traduit sont marqués d'une astérisque dans la première colonne. Une fois de plus, faite un 
<EM>
        gpm -t help
</EM> 
pour obtenir la liste. 

<p>
Si vous ne voulez pas de traductions et que vous ne voulez que les données octet par octet, tapez : 
<EM>
	gpm -t ps2 -R raw
</EM>
. 
Vous pouvez ensuite demander à XFree d'utiliser ce second périphérique en ajoutant la ligne 
<EM>
	Device      "/dev/gpmdata"
</EM>
dans XF86Config dans la section pointeur ou dans la section XInput. 

<P>
<ITEM>
Si vous utilisez startx, vous pouvez le modifier avec 
<EM>
	gpm -k
</EM>
avant que le serveur X ne soit lancé. Cette option tue un gpm lancé. 
</ITEMIZE>

<SECT>Tablettes sous XFree
<P>
<LABEL id="_Toc465765702">

<SECT1>Version de XFree requise
<P>
 
<LABEL id="_Toc465765703"  >
Il faut au moins  
<REF id="_xfree" name="XFree">
la version 3.3.3.1 car elle a développé le support de XInput, le deuxième bouton fonctionne et il n'y a plus l'effet bloquant de la souris.

<P>
Si vous devez utiliser une version antérieure, Xinput est supporté depuis la 3.1.2.d.

<P>
Le support de XInput dans XFree est configuré dans un fichier appelé XF86Config. Dans la plupart des cas, ce fichier est placé dans /etc ou dans /etc/X11. 
Je vais présenter une très courte section de configuration et expliquer ce qui peut être changé et pourquoi.

<SECT1>Une partie de XF86Config

<P>
<LABEL id="_Toc465765705"  >
<TSCREEN>
<VERB>
Section "Module"
# Wacom Device Driver
Load "xf86Wacom.so"
EndSection

Section "XInput"
# Settings for Wacom pen
  SubSection "WacomStylus"    # type of input device
    Port "/dev/ttyS0"         # Serial Port
    DeviceName "Pen1"         # Name, choose it free
    Baudrate 9600             # Usable only for intuos
    Mode Absolute             # Map Tablet Area to Screen
    AlwaysCore                # See text
    HistorySize 200           # Buffer size for motion events
  EndSubSection
EndSection
</VERB>
</TSCREEN>

<SECT1>Section Module
<P>
 
<LABEL id="_Toc465765706"  >
XFree supporte XInput grâce à l'utilisation de modules. Le module pour Wacom s'appelle 
<REF id="_driverlepied" name="xf86Wacom.so">.
Il se place dans la section &quot;Module&quot; et ne doit apparaître qu'une seule fois par fichier XF86Config. 

<SECT1>Différents types de dispositifs

<P>
<LABEL id="_Toc465765707"  >
Un dispositif peut être :
<ITEMIZE>
<ITEM>La pointe de votre crayon ;
<ITEM>La gomme de votre crayon ;
<ITEM>Une souris comme le "lens cursor", la souris 4d ou la souris graphire de chez Wacom ; 
<ITEM>l'aérographe.
</ITEMIZE>
<P>
Les produits pentpartner et graphire ne reconnaissent que le type de dispositif mais ne peuvent pas les distinguer. Par exemple, vous ne pouvez pas utilisez deux crayons différents, un configuré en rouge et l'autre configuré en bleu ; tout ce que diront ces produits c'est : "J'ai reconnu une pointe de crayon", ou "J'ai trouvé une gomme", ou "J'ai trouvé une souris".  

<P>
XInput décrit les types de dispositifs aux périphériques. Ces dispositifs sont ensuite spécifiés dans XF86Config comme une sous-section de la section XInput : 
<ITEMIZE>
<ITEM><TT>WacomStylus</TT> Pointe d'un stylo ou aérographe.
<ITEM><TT>WacomEraser</TT> Gomme d'un stylo ou aérographe.
<ITEM><TT>WacomCursor</TT> Souris, par exemple souris graphire, "lens cursor", souris 4d.
</ITEMIZE>


<SECT1>Noms de périphériques
<P>
<LABEL id="_Toc465765708"  >
Vous devez donner un nom à chaque périphérique configuré (vous pouvez choisir n'importe quel nom). Ce nom sera ensuite utilisé dans votre logiciel pour communiquer avec ce dispositif. 

<SECT1>Port

<P>
<LABEL id="_Toc465765709"  >
XInput doit connaître le port série où se trouve votre tablette. Cela me permet d'utiliser deux tablettes différentes en même temps, par exemple une graphire connectée à /dev/ttyS0 et une penpartner connectée à /dev/ttyS1.

<SECT1>Les niveaux de déboggage (DebugLevel)
<P>
<LABEL id="_Toc465765710"  >
Ceci contrôle comment le driver Wacom fonctionne. Le niveau va de 0 à 10. Si cette spécification n'est pas indiquée, le DebugDevel 0 est utilisé, ce qui représente le niveau le plus bas. 

<P>
<bf>Exemple :</bf>
<TSCREEN>
<VERB>
SubSection "WacomStylus" # Pen
  DeviceName "PenRed"    # Name, choose it free
  ...
  DebugLevel 10          # be very verbose
  ...
EndSubSection
</VERB>
</TSCREEN>


<SECT1>
Numéro de série (séries intuos seulement)

<P>
<LABEL id="_Toc465765711"  >
Le produit intuos est plus compétent que les produits penpartner et graphire car il peut distinguer plusieurs dispositifs en même temps. Cela signifie qu'il est maintenant possible d'utiliser deux crayons (un configuré en rouge et l'autre en bleu). Comme on l'a vu, l'utilisation de dispositifs (pointe, gomme, aérographe, souris) n'est pas assez documenté pour manipuler des stylos différents. Cependant, chaque dispositif intuos, que ce soit un stylo, une souris ou autre, a un numéro de série que l'on spécifie à XInput pour savoir ce qui est utilisé. 
Voici la section de configuration :   

<TSCREEN>
<VERB>
Section "XInput"
  SubSection "WacomStylus" # Pen
    DeviceName "PenRed"    # Name, choose it free
    ...
    Serial 2609917443      # Serial Number of that device
    ...
  EndSubSection
  SubSection "WacomStylus" # another Pen
    DeviceName "PenBlue"   # Name, choose it free
    ...
    Serial 2609918664      # Serial Number of that device
    ...
  EndSubSection
EndSection
</VERB>
</TSCREEN>
<P>
Notez que les dispositifs combinés comme les stylos ont seulement un numéro de série. 
Le driver utilise ce numéro de série pour reconnaître un stylo spécifique et le type de dispositif pour distinguer la pointe de ce stylo de sa gomme. 

<P>

<SECT2>Comment trouver le numéro de série d'un dispositif

<LABEL id="_Toc465765712">
<P>
<ENUM>
<ITEM>
Configurer le DebugLevel à 6
<ITEM>
Lancer le serveur X en tapant  
<EM>
	X 2&gt;t
</EM>
<ITEM>
Passer tous les dispositifs (pointe, gomme...) sur la tablette en les notant dans l'ordre où ils sont passés
<ITEM>
Tuer le serveur X (Ctrl + Alt + Backspace)
<ITEM>
Faites un 
<EM>
	grep serial_num t
</EM>
</ENUM>
<P>
Vous devriez obtenir la liste de vos différents numéros de série. 

<P>

<SECT2>Numéro de série - exemple de résultat obtenu

<LABEL id="_Toc465765713">
<P>
<TSCREEN>
<VERB>
BEGIN xf86WcmProc dev=0x8354d60 priv=0x833e3f0 type=stylus flags=9 what=1
xf86WcmProc pWcm=0x8354d60 what=ON
END xf86WcmProc Success what=1 dev=0x8354d60 priv=0x833e3f0
device_id=0x96 serial_num=2595227137 type=cursor
[cursor] abs prox=false x=0 y=0 z=0 button=false buttons=0
</VERB>
</TSCREEN>
(le numéro de série est à la ligne 4, 2e block).<P>

<SECT1>Mode absolu, mode relatif

<P>
<LABEL id="_Toc465765714" >
Si vous configurez un dispositif en mode absolu, cela signifie que la surface active de la tablette représente votre écran. Chaque fois que vous pointez un point sur la tablette avec un dispositif absolu, votre pointeur de souris apparaîtra au même point sur votre écran. 

<P>
Si vous avez configuré le dispositif en mode relatif, le comportement de votre souris sera plus intuitif, c'est-à-dire que si vous décollez la souris de la tablette, la bougez et que vous la remettez, le pointeur de souris n'aura (normalement) pas bougé. 

<P>
<bf>Exemple :</bf>
<NEWLINE>
Mode absolu

<SECT1>Pointeur en modes étendu, natif ou "AlwaysCore"
<P>
 
<LABEL id="_Toc465765715"  >
XFree connait deux pointeurs : un avec seulement les caractéristiques standards (boutons, mouvements), qui est utilisé pour sélectionner les menus, du texte ou pour cliquer sur des boutons. Ceci est le <em>pointeur natif</em> (Core device). 

<P>
L'autre pointeur est utilisé par des applications qui veulent plus d'informations, comme la pression ou l'inclinaison. 
 
<NEWLINE>
Ceci est le pointeur étendu (Extension device).
<P>
Avec la version 3.3.3.1, l'expression "AlwaysCore" indique au driver qu'il doit envoyer les deux types d'événements. 
<P>
Si vous ne spécifiez pas "AlwaysCore" dans votre XF86Config, alors le pointeur est initialement utilisé comme pointeur étendu, c'est-à-dire qu'il n'est utilisable qu'avec des applications et que vous ne pouvez pas l'utiliser pour sélectionner des menus dans votre gestionnaire de fenêtre.  

<P>
Sinon (si "AlwaysCore" est spécifié), votre pointeur réagit comme un pointeur natif (en plus de la souris) et donne des informations sur la pression et l'inclinaison aux applications qui ouvrent le pointeur en mode étendu.

<P>
Vous pouvez configurer deux pointeurs logiques, un en mode natif et un en mode étendu, pour un même pointeur physique. 
<newline>
Pour ce faire, tapez tout simplement deux sections identiques, seule la désignation du DeviceName doit changer, puis spécifiez "AlwaysCore" dans la dernière section seulement.   

<P>
<bf>Exemple :</bf>
<NEWLINE>
AlwaysCore

<SECT1>La taille de l'historique (HistorySize)
<P>
 
<LABEL id="_Toc465765716"  >
Ceci configure la taille du buffer qui est utilisé pour le cache des mouvements. 


<SECT1>Dissimulation (Suppress)

<P>
 
<LABEL id="_Toc465765717"  >
Ceci spécifie de combien d'unités le dispositif doit bouger avant que le driver bouge le pointeur. 
Ce peut être nécessaire quand de grandes résolutions sont utilisées.  

<P>
<bf>Exemple :</bf>
<NEWLINE>
Suppress 6


<SECT1>Le mode inclinaison (intuos seulement) (Tilt Mode)

<P>
 
<LABEL id="_Toc465765718"  >
Le mode inclinaison permet l'envoi d'informations sur l'inclinaison pour les pointeurs intuos. 
Si cette déclaration est omise, seule l'information sur la pression est transmise.  

<P>

<SECT1>Les spécifications TopX, TopY, BottomX, BottomY 

<P>
 
<LABEL id="_Toc465765719"  >
Ces quatre spécifications permettent de réduire la surface active de la tablette. Mon énorme tablette intuos A4, par exemple, est tellement grande que l'on ne peut pas l'utiliser pour un travail de peinture car les passages du stylo sont trop longs. J'utilise donc ces quatre spécifications pour indiquer au driver que l'écran sera représenté sur le quart en bas à gauche de la tablette. 
<newline>
Il est possible de définir plus d'une surface active sur la même tablette : 
définissez autant de sous sections que vous avez besoin avec la même spécification du Port mais avec des spécifications Top, Bottom... différents, ainsi que les noms de périphériques.
Ceci définit de multiples pointeurs logiques ayant chacun leurs limites individuelles. 
De même, vous pouvez utiliser un pointeur en mode absolu et un autre en mode relatif. 
  
<P>
<bf>Exemple :</bf>
<TSCREEN>
<VERB>TopX        0 #coordonnees du coin en haut a gauche
TopY     5000
BottomX  5000 #coordonnees du coin en bas a droite
BottomY 10000</VERB>
</TSCREEN>
<P>

<SECT2>
Obtenir les valeurs X,Y maximales, la configuration courante et la résolution

<P>
Si vous utilisez les quatre spécifications ci-avant, vous voulez parfois faire des calculs sur la taille et la position d'un rectangle qui doit être défini, et souvent les coordonnées maximales de la tablette et la résolution sont utiles. Pour obtenir ces valeurs, lancer votre serveur : 
 <EM>
	X 2&gt;t
</EM>.
Tuer le serveur X (Ctrl+Alt+Backspace)
et faites un 
<EM>
	grep &dquot;X=&dquot; t
</EM>
. Vous devriez récupérer les valeurs en question.
<P>

<SECT2>Obtenir la résolution - exemple de résultat <P>
<TSCREEN>
<VERB>
(--) Wacom IV tablet maximum X=5103 maximum Y=3711 X 
     resolution=1000 Y resolution=1000 suppress=6
(--) Wacom tablet top X=0 top Y=0 bottom X=5103 bottom Y=3711
(--) Wacom tablet top X=0 top Y=0 bottom X=5103 bottom Y=3711
(--) Wacom tablet top X=0 top Y=0 bottom X=5103 bottom Y=3711
</VERB>
</TSCREEN>
<P>


<SECT1>Conservation de la forme
<P>
 
<LABEL id="_Toc465765720">
Cette option utilise les spécifications TopX, TopY (ou leurs valeurs par défaut, si rien n'est indiqué) et ajuste les valeurs BottomX et BottomY, ainsi :

<ITEMIZE>
<ITEM>
La proportion hauteur / largeur de l'écran est la même que pour la tablette ;
<ITEM>
la surface active commençant à HautX, HautY de la tablette est aussi grande que cela peut l'être avec les conditions ci-avant. 
</ITEMIZE>

<P>
Les spécifications BottomX, BottomY sont ignorées, car ces valeurs seront calculées. 

<P>

<SECT1>Seuil de pression

<P>
Ceci est disponible depuis la version alpha 16 et est utilisé pour contrôler la pression minimum requise pour détecter qu'un outil est pressé sur la tablette. Cela fonctionne avec les gammes intuos et graphire. Notez que la valeur entière doit être codée comme une chaîne de caractère, contrairement à toutes les autres valeurs entières. <P>
   
<bf>Exemple :</bf>
<TSCREEN>
<VERB>
Threshold "5"
</VERB>
</TSCREEN>

<SECT>Changer la configuration avec un serveur X lancé

<P>
 
<LABEL id="_Toc465765721">
<SECT1>
Configurer The Gimp pour utiliser les périphériques XInput
<P>
 
<LABEL id="_Toc465765722"  >
<REF id="_gimp" name="Gimp">
a été compilé avec le support XInput depuis la version 1.1.x.
<P>
Gimp doit connaître les périphériques qu'il peut utiliser et dans quel mode. Vous devez ouvrir la boite de dialogue 
<EM>
	Fichier/Dialogues/Périphériques d'Acquisition 
</EM>
pour le configurer. Vous trouverez deux listes déroulantes en haut de cette fenêtre appelée <EM>Périphérique</EM> et <EM>Mode</EM>. Choisissez le périphérique à configurer dans la liste des
<EM>
	Périphériques
</EM>
et choisissez un mode dans la liste
<EM>
	Mode
</EM>
.
<P>
Les modes sont :

<ITEMIZE>
<ITEM>
désactivé (disabled) : Gimp n'utilise pas ce périphérique ;
<ITEM>
fenêtre (window) : Gimp utilise ce périphérique. (Le curseur est dessiné par l'application) ;
<ITEM>
écran (screen) : Gimp utilise ce périphérique. (Le curseur est dessiné par le serveur X). 
</ITEMIZE>

<P>
Si vous avez deux curseurs liés à votre périphérique, vous avez deux solutions : 

<ITEMIZE>
<ITEM>
Utilisez le mode écran mais il se peut que vous perdiez les curseurs spéciaux de Gimp ; si tel est le cas, tous les curseurs seront remplacés par celui du stylo.  
<ITEM>
Configurez deux périphériques différents dans le fichier XF86Config, un
<EM>
	AlwaysCore
</EM>
et un autre différent. Dites à Gimp d'utiliser le dernier en mode fenêtre. Si vous le faites et avez une des quatres spécifications 
<EM>
TopX, TopY, BottomX, BottomY
</EM>
dans votre XF86Config, faites attention d'utiliser les mêmes ajustements pour ces spécifications dans les deux périphériques logiques. 
Si vous ne le faites pas, tout est confus car le serveur X dessine le curseur d'un périphérique tandis que l'autre est actif. Ceci aura pour effet d'afficher un curseur, très loin du point d'action (hotspot).  
</ITEMIZE>

<P>
Sous les deux listes déroulantes, se trouve un tableau avec deux registres 
<EM>Axes</EM> et <EM>Touches</EM>.
<EM>Axes</EM> assigne un axe a une fonction, ce n'est généralement pas nécessaire de le changer. Mais dans le cas d'un peripherique tactile construit dans une tablette qui bouge a 90 degres, vous pourrez echanger les axes x et y. 

<P>
Certaines tablettes ont des touches programmables permettant d'appeler des fonctions souvent utilisées. La <LABEL id="_macrokeys"> partie <EM>Touches</EM> vous permet d'associer un caractere à une touche de fonction. Par exemple, vous pouvez associer Ctrl+Shift+R a une touche de fonction. Si vous activez cette touche, elle remplace Ctrl+Shift+R. <newline>
Le driver actuel de Wacom supporte seulement les touches de fonction de la serie ultrapad et la partie macro des produits intuos n'est pas encore utilisable.
<P>
Maintenant, nous allons vois commment les peripheriques peuvent être utilisés. Ouvrez la boite de dialogue dans <EM>Fichier/Dialogues/Device Status</EM>. Ouvrez une image.
<P>
Vous configurez chaque peripherique les uns indépendemment des autres dans Gimp.
<P>
Si vous utilisez le curseur avec plusieurs peripheriques dans la fenetre où se trouve l'image, vous verrez que les périphériques de la boite de dialogue Device Status changent. Si vous choisissez un outil, pinceau, couches ou couleur avec un périphérique, une fois encore les changements sont visibles dans la boite de dialogue. Vous pouvez sauvegarder les parametres de la boite de dialogue Status, pour qu'ils soient restorés a la prochaine session. 
<P>

<SECT1>The Switch Device
<P>
 
<LABEL id="_Toc465765723"  >
C'est un périphérique spécial toujours présent. Il génère un événement chaque fois qu'un nouveau périphérique devient un pointeur natif. Cela s'appelle &dquot;axes&dquot;, sa valeur est l'identificateur du périphérique de pointage natif. Je ne sais pas comment un utilisateur peut l'utiliser, c'est principalement utile pour une usage interne.

<SECT1>Boutons
<P>
 
<LABEL id="_Toc465765724">
Les boutons des périphériques sont aussi différents que les périphériques le sont : 
<NEWLINE>
Un stylo a au moins une pointe, mais il peut avoir un ou deux côtés et une gomme. Une souris peut avoir jusqu'a 32 boutons (mais habituellement 3).Les boutons sont numerotés de 1 au nombre de boutons. Avec les deux prochaines "astuces" vous pouvez changer cette numerotation.

<SECT1>Bouton configuré avec xmodmap pour les périphériques en mode natif

<P>
 
<LABEL id="_Toc465765725"  >
xmodmap ne change que le pointeur natif. Comme il n'y a qu'un pointeur natif a la fois, il ne fait pas de différence entre les périphériques physiques pouvant devenir un pointeur natif. Pour le moment, oublions tout ce qu'on a dit sur XInput et pensez au gaucher qui veut simplement échanger les boutons gauche et droit de la souris. Vous allez exécuter <EM>xmodmap -pp</EM> pour voir quel est le pointeur natif courant. Vous allez obtenir le tableau suivant : 
<TSCREEN>
<VERB>
Physical        Button
Button          Code
1              1      # ( Left   Button )
2              2      # ( Right  Button )
3              3      # ( Middle Button )
</VERB>
</TSCREEN>

<P>
Pour échanger les boutons, tapez <EM>xmodmap -e &dquot;pointer = 2 1 3&dquot;</EM> et pour revenir a l'état d'origine <EM>xmodmap -e &dquot;pointer = default&dquot;</EM>. Ceci marche avec chaque périphérique avec au moins 2 boutons. Notez que l'expression <EM>&dquot;pointer = x x x&dquot;</EM> doit être accompagnée de guillemets pour éviter que cela soit changé par le shell.


<SECT1>Bouton configuré avec xinput pour les périphériques en mode extension

<P>
 
<LABEL id="_Toc465765726"  >
Revenons a XInput. Si vous utilisez Gimp, vous voulez sans doute changer la configuration du bouton pour chaque périphérique séparément (échanger les deux côtés du crayon). Frederic Lepied ecrit un utilitaire, appelé 
<REF id="_XInput" name="xinput">.
<P>
Pour échanger les deux côtés, faites un <EM>xinput list</EM> pour avoir la liste des peripheriques et leur configuration actuelle. L'echange est fait avec <EM>xinput set-button-map Pen1 1 3 2</EM> ou <EM>Pen1</EM> est le périphérique à changer.
<P>
Lancez avec XFree 3.3.2, cela marche aussi avec les périphériques configurés avec <EM>AlwaysCore</EM> dans XF86Config.

<SECT1>xsetmode - changer le mode absolu / relatif

<P>
 
<LABEL id="_Toc465765727">

<P>
Avec xsetmode vous pouvez changer le mode d'un périphérique entre absolu et relatif.
<P>
<bf>Exemple :</bf><newline>
<EM>
	xsetmode GraphireMouse ABSOLUTE
</EM>
.


<SECT1>xsetpointer - configure le peripherique natif par défaut 
<P>
 
<LABEL id="_Toc465765728"  >
Si aucun des périphériques n'est configuré en <EM>AlwaysCore</EM> et que vous voulez en configurer un, utilisez xsetpointer.
<P>
Faites un <EM>xsetpointer Devicename</EM>. 
L'ancien périphérique natif (souvent une souris) n'est plus utilisable et celui specifié sera active. Par exemple, on peut configurer une souris graphire en périphérique natif standard avec un XFree lancé.
<P>
<EM>xsetpointer -l</EM> liste tous les peripheriques et le mode dans lequel ils sont. 

<SECT1>Touches

<P>
<LABEL id="_Toc465765729"  >
Certains périphériques ont les boutons ou pads programmables pour lesquels un scancode ou une chaine peuvent etre associés. Cela ne fonctionne qu'avec des périphériques en mode extension et est fait pour l'application dans laquelle vous voulez utiliser ces touches. 
<p>
<EM>xinput -l</EM> donne des informations à propos du numéros des touches et autre comme le premier scancode. 
<p>
 
<SECT1>Utilitaires pour utiliser plus d'une tablette 
<P>
 
<LABEL id="_Toc465765730"  >
Je possède trois tablettes Wacom et je les utilise sur mon portable. Quand aucune tablette n'est connectée et que je lance le mode X, je dois attendre longtemps jusqu'à ce que le driver abandonne. Si xdm est utilisé, cela augmente le nombre d'essais.
<P>
J'ai écrit deux utilitaires qui devrait faciliter ceci : 

<ITEMIZE>
<ITEM>
Le script shell <BF>sx</BF> pour ceux qui utilisent startx.
sx utilise un joli menu permettant à l'utilisateur de choisir :
<ITEMIZE>
<ITEM>
un des 10 peripheriques (tablette, joystick...) ;
<ITEM>
pour les portables, l'écran a utiliser (interne ou externe) ;
<ITEM>
le gestionnaire de fenêtre à utiliser.
</ITEMIZE>

<P>
<ITEM>
La petite application écrite en gtk <BF>xinput-chooser</BF> pour ceux qui utilisent xdm.
xinput-chooser utilise un menu quand l'écran de connexion xdm s'affiche, où une parmi les 10 configurations peut être choisie.
</ITEMIZE>

<P>
Ceci est basé sur le fait qu'un fichier XF86Config est séparé en au moins un fichier XF86Config.bare, qui contient les informations communes à toutes les configurations et de nombreux exemples, chacun d'eux présentant une information spéciale d'une configuration particulière. 
<P>
Les deux utilitaires sont mis ensemble pour une configuration qui marche. 
<P>
Vous pouvez télécharger ce paquet à l'adresse <HTMLURL url="http://www.runkeledv.de/download" name="http://www.runkeledv.de/download">, il se nomme xinput_chooser_sr.


<SECT>FAQ XFree - problèmes et questions

<P>
<LABEL id="_xfreefaq">

<SECT1>Gnome et Gimp ne travaillent qu'avec une souris normale, sans la pression, ni l'inclinaison. La boîte de dialogue des périphériques d'entrée de Gimp indique  &dquot;No input devices&dquot; ou  &dquot;Pas de périphérique d'entrée&dquot;. 

<P>
Il semble que vous n'avez pas compilé votre gtk avec le support XInput. 
Recompilez gtk et utilisez <em>./configure --with-xinput=xfree</em> pour compiler le Makefile, puis faites un <em>make && make install</em>. Enfin, recompilez votre Gimp pour qu'il utilise ce gtk étendu. 

<SECT1>Est-ce que la roulette de la souris (curseur) est supportée ? 
<P>
Oui, cela génère les événements bouton 4 et bouton 5.

<SECT1>Comment puis-je trouver le numéro de série intuos de mon outil ?

<P>
Lisez la section à propos des <REF id="_Toc465765712" name="Numéros de série">. 

<SECT1>Comment puis-je changer l'utilisation des boutons de mon outil ?
<P>
Reportez vous à la section à propos des <REF id="_Toc465765724" name="boutons">.

<SECT1>Comment puis-je utiliser des macros sur intuos/artpad/ultrapad ?

<P>
Désolé, vous ne pouvez pas utiliser les macros de l'intuos. <newline>
Seules les macros artpad/ultrapad fonctionnent. 
Lisez la section à propos des <REF id="_macrokeys" name="Clés de Gimp">.

<SECT1>Est-ce possible de définir plusieurs surfaces actives sur la même tablette ?

<P>
Oui, lisez la section à propos des <REF id="_Toc465765719" name="Spécifications Haut...">

<SECT1>Puis-je utiliser plus d'une tablette en même temps ?
<P>
Oui, lisez la section à propos des <REF id="_Toc465765709" name="Spécification de port">.

<SECT>FAQ Gpm - problèmes et questions
<P>
<LABEL id="_gpmfaq">

<SECT1> 
Les programmes NCurses ne supportent que couper / coller avec mon nouveau gpm 
 
<P>
Vous avez probablement mélangé un nouveau gpm avec une ancienne bibliothèque gpm,  
ou vous utilisez un ancien client qui cherche la socket gpmctl dans /var/run au lieu de /dev. 
Dans le dernier cas, vous avez deux options : récupérer de nouveaux clients et les recompiler ou changer gpm.h pour qu'il utilise /var/run au lieu de /dev et recompiler gpm et libgpm. 

<P>  

<SECT>Plus d'informations / documents utilisés 
<P>
 
<LABEL id="_Toc465765731">

<P>
gpm :
<NEWLINE>
page de manuel gpm, FAQ gpm, code souce du fichier mice.c
<P>
XInput :
<NEWLINE>
HOWTO XInput de Owen Taylor
<P>
XFree et Wacom :
<NEWLINE>
page de manuel XF86Config
<P>
site de Frederic Lepied
<P>
beaucoup, beaucoup d'e-mails ...
</ARTICLE>
