  Wacom Tablet HOWTO
  Autor: Stefan Runkel runkel@runkeledv.de
  v1.0.4, listopad 1999
  WWeerrssjjaa ppoollsskkaa:: MMaarreekk GGuueevvaarraa BBrraauunn mmaarreekk@@aattmm..ccoomm..ppll
  v1.0, 2 kwietnia 2000


  Instalacja graficznych tabletw (nie tylko) Wacoma pod Linuksem i/lub
  XFree86.
  ______________________________________________________________________

  Spis treci






















































  1. Prawa autorskie

  2. Wprowadzenie

     2.1 Nowe wersje dokumentu
     2.2 Uwagi i Poprawki
     2.3 Podzikowania

  3. Wymagania

     3.1 Jaki sprzt jest obsugiwany
     3.2 Jakiego oprogramowania potrzebujemy
     3.3 Jakie oprogramowanie jest obsugiwane

  4. Tablety jako zamiennik myszy dla konsoli Linuksa

     4.1 Tablety i gpm

  5. Tablety w XFree

     5.1 Wymagana wersja XFree
     5.2 Przykadowy wycinek XF86Config (prosty)
     5.3 Sekcja moduu
     5.4 Rodzaje urzdze
     5.5 Nazwa urzdzenia
     5.6 Port
     5.7 Poziom DebugLevel
     5.8 Numer seryjny (tylko dla tabletw Intuos)
        5.8.1 Jak uzyka numer seryjny danego urzdzenia
        5.8.2 Numer seryjny - przykad tego co zostao zalogowane
     5.9 Tryby pracy bezwzgldny (absolute) i wzgldny (relative)
     5.10 Tryby pracy urzdze Extension, Core oraz AlwaysCore
     5.11 Parametr HistorySize
     5.12 Parametr Suppress
     5.13 Parametr TiltMode (tylko Intuos)
     5.14 Ustawienia TopX, TopY, BottomX, BottomY
        5.14.1 Okrelanie maksymalnych wartoci X, Y, aktualnej konfiguracji oraz rozdzielczoci
        5.14.2 Okrelanie rozdzielczoci - przykad tego co zostao zalogowane
     5.15 Ustawienie KeepShape

  6. Zmiany konfiguracji pod dziaajcymi X-ami

     6.1 Konfigurowanie Gimpa w celu wykorzystania urzdze XInput
     6.2 Urzdzenie przecznika (SWITCH)
     6.3 Przyciski
     6.4 Przyporzdkowywanie przyciskw przy uyciu xmodmap dla urzdze pracujcych w trybie podstawowym
     6.5 Przyporzdkowywanie przyciskw przy uyciu xinput dla urzdze pracujcych w trybie rozszerzonym
     6.6 xsetmode - zmiany trybu pracy na wzgldny oraz bezwzgldny
     6.7 xsetpointer - ustawianie domylnego urzdzenia podstawowego
     6.8 Klawisze
     6.9 Narzdzia do korzystania z wicej ni jednego tableta oraz do wczania i wyczania obsugi

  7. Dalsze informacje/wykorzystane dokumenty

  8. Od tumacza



  ______________________________________________________________________

  11..  PPrraawwaa aauuttoorrsskkiiee

  Prawa autorskie nale do Stefana Runkela (c) 1999 Runkel@runkeledv.de

  Dokument ten opisuje proces instalacji tabletw Wacoma pod systemem
  Linux.
  Nieskrpowane uywanie, rozpowszechnianie oraz reprodukowanie tego
  dokumentu jest moliwe pod nastpujcymi warunkami:

    Nie wolno pomija lub modyfikowa informacji o prawach autorskich
     do tego dokumentu.

    Nie wolno pomija lub modyfikowa numeru wersji oraz daty tego
     dokumentu.

    Nie wolno pomija lub modyfikowa wskazania do aktualnej wersji WWW
     dokumentu.

    Naley jednoznacznie oznacza wszelkie skrcone, poprawione lub
     zmodyfikowane wersje tego dokumentu.


  22..  WWpprroowwaaddzzeenniiee



  Tablety graficzne s obecnie niezbyt drogie i mog by bardzo pomocne
  przy obrbce obrazw. Obok tego czego moemy dokona przy uyciu myszy
  tablety cechuje dodatkowa funkcjonalno:


    moliwo okrelenie poziomu nacisku i nachylenia

    precyzyjna kontrola ruchw

    okrelanie pooenia kursora z dokadnoci do jednego punktu
     (pixela)

    podobne do pirka i jak ono obsugiwane urzdzenie wejciowe

  Dokument ten opisuje gwnie produkty firmy Wacom. Powodem tego jest
  fakt posiadania przeze mnie trzech rnych urzdze tego producenta
  oraz to, e s one bardzo popularne w Europie.

  Niemniej jednak, sdz e zaadaptowanie nakrelonej koncepcji do
  innych produktw nie powinno by rzecz trudn.

  Powodem napisania tego dokumentu byo to, i nigdzie w Sieci nie
  mogem znale niczego podobnego. Zamiast tego miaem bardzo duo
  dokumentw opisujcych temat tylko czciowo. Po ich przeczytaniu,
  wci pozostaway (i nadal pozostaj) otwarte pytania, na ktre nie
  znaem odpowiedzi. Zmusio mnie to do zadawania pyta wielu rnym
  ludziom.

  Po tym wszystkim co zostao zrobione, nadal jestem przekonany, e
  dokument ten by tego wart.



  22..11..  NNoowwee wweerrssjjee ddookkuummeennttuu



  Orygina tego dokumentu znajduje si pod adresem:
  http://www.runkeledv.de/linux.htm


  22..22..  UUwwaaggii ii PPoopprraawwkkii



  Mile widziane s wszelkie komentarze, poprawki oraz uzupenienia.
  Skontaktowa si mona ze mn pod adresem:

  Runkel@runkeledv.de


  22..33..  PPooddzziikkoowwaanniiaa



  Chciabym podzikowa wszystkim autorom wymienionym w sekcji ``Dalsze
  informacje/wykorzystane dokumenty'' oraz wszystkim osobom, ktre
  odpowiedziay na moje pytania poczt elektroniczn.  Ten dokument jest
  odzwierciedleniem ich pracy.


  33..  WWyymmaaggaanniiaa



  Ten rozdzia mwi co jest potrzebne aby tablet zacz dziaa

  33..11..  JJaakkii sspprrzztt jjeesstt oobbssuuggiiwwaannyy



  Na pocztek powiniene zdoby tablet. Poniewa obsuga USB pod
  Linuksem jest wci w fazie rozwoju, a ADB najprawdopodobniej dugo
  ju nie pocignie, powinien to by model wyposaony w port szeregowy
  (RS232)


  Obsugiwane s nastpujce tablety Wacoma:



    seria ArtZ II (znana w Europie jako UltraPad - ta sama nazwa
     uywana bya przez czciowo obsugiwane wczeniejsze modele)


    ArtPad II

    PL300 (poczenie tableta i wywietlacza LCD)

    Pen Partner

    Graphire (mysz i rysik, do ich obsugi musisz mie sterownik
     przynajmniej w wersji alpha 11 - szczegy poniej)

    seria Intuos (sterowniki zawarte w biecych dystrybucjach XFree86
     mog obsugiwa je tylko czciowo, aktualn wersj alpha mona
     znale na

     stronie Frederica Lepieda: http://www.lepied.com/xfree86/)

  Pomimo, i starsze tablety Wacoma z serii SD oraz HD nie s
  standardowo obsugiwane przez sterowniki XFree86, istnieje
  zmodyfikowany sterownik obsugujcy zarwno te, jak i inne urzdzenia
  (np. produkty OEM ze zintegrowanymi wywietlaczami, takie jak IBM
  Thinkpad 360 PE oraz Toshiba T200). Wspomniany sterownik znajduje si
  pod adresem: http://hwr.nici.kun.nl/pen-computing/pen-computing-
  formats.html





  33..22..  JJaakkiieeggoo oopprrooggrraammoowwaanniiaa ppoottrrzzeebbuujjeemmyy




     Jeli potrzebujesz obsugi tableta pod linuksow konsol, cignij
     najnowsz wersj programu gpm spod adresu
     ftp://ftp.prosa.it/pub/gpm lub z ftp://animal.unipv.it/pub/gpm
     (kopia)



     Jeli chcesz korzysta z tableta pod XFree86, musisz posiada to
     oprogramowanie przynajmniej w wersji 3.3.3.1. Najnowsze
     aktualizacje znajduj si pod adresem http://www.xfree.org


  33..33..  JJaakkiiee oopprrooggrraammoowwaanniiee jjeesstt oobbssuuggiiwwaannee




    Jedynym programem jaki znam dla konsoli linuksowej jest gpm.



    Dla XFree sowem kluczowym jest XInput. Po pierwsze specyfikacja ta
     musi by obsugiwana przez sterownik urzdzenia, ktry dostarcza
     dodatkowe informacje.  Po drugie programy, ktre chc uywa
     alternatywnych urzdze wskazujcych, musz rozumie XInput.


  Wiele programw bazuje na bibliotece gtk. Gtk posiada obsug
  specyfikacji XInput dziki czemu atwo jest z niej skorzysta.


  Wsparcie dla XInput zawieraja ponisze aplikacje:



    The Gimp - potny program do przetwarzania obrazw w stylu pakietu
     Photoshop.  Niestabilna wersja rozwojowa 1.1.x standardowo
     obsuguje XInput. W chwili pisania niniejszego dokumentu (10/99)
     Gimp 1.1.x znajdowa sie w fazie zamraania funkcjonalnoci. Mam
     nadziej e do koca roku 1999 wydana zostanie stabilna wersja 1.2.

     Gimpa mona cign spod adresu http://www.gimp.org, naprawd na
     to zasuguje! Jestem pewny, e wikszo z Was zna ten program i e
     to wanie on by powodem kupna tableta.



    gsumi - prosty, czarno-biay program do rysowania obsugujcy
     zmiany nacisku i nachylenia podczas krelenia/wycierania. Dostpny
     na stronie: http://www.gtk.org/~otaylor/gsumi/



    xink (autorstwa Ralpha Leviena) - kolejny prosty program graficzny
     dla X.


     xink mona cign z serwera plikw:
     ftp://kiwi.cs.berkeley.edu/pub/raph/xink.tar.gz


    RasMol - program do wizualizacji molekularnej obsugujcy
     specjalistyczne urzdzenie wejciowe (dial box) przy uyciu XInput.
     Zajyj na stron
     http://www.umass.edu/microbio/rasmol/distrib/rasman.htm.



    xinput (autorstwa Frederica Lepieda) - bardzo przydatne narzdzie
     do konfigurowania i testowania urzdze XInput.

     xinput jest dostpny pod adresem:
     ftp://ftp.x.org/contrib/utilities/xinput-1.2.tar.gz


  44..  TTaabblleettyy jjaakkoo zzaammiieennnniikk mmyysszzyy ddllaa kkoonnssoollii LLiinnuukkssaa




  44..11..  TTaabblleettyy ii ggppmm



  Demon ``gpm'' obsuguje cakiem spor liczb urzdze wejciowych, w
  tym tablety. Jeeli chciaby otrzyma list obsugiwanych przez Twoj
  wersj gpm urzdze wykonaj nastpujce polecenie:

  _g_p_m _-_t _h_e_l_p


  Pomimo tego, e nie znalazem nic na ten temat w dokumentacji, wydaje
  mi si e zawarty w gpm-ie sterownik do Wacoma zosta napisany dla
  bardzo starych modeli UltraPad. Testowaem go z modelami PenPartner,
  Graphire oraz Intuos ale nie dziaa.  Dopisaem obsug Graphire dla
  gpm, aby jej uy potrzebna jest przynajmniej wersja 1.18.1 programu
  gpm.


  Jeeli posiadasz starego ArtPada, sprbuj wykona: _k_i_l_l_a_l_l _g_p_m _; _g_p_m
  _-_t _w_a_c_o_m _-_m _/_d_e_v_/_t_t_y_S_0 powinno zadziaa.
  Jeli uywasz modelu Graphire, polecenie powinno wyglda nastpujco:
  _k_i_l_l_a_l_l _g_p_m _; _g_p_m _-_t _g_r_a_p_h_i_r_e _-_m _/_d_e_v_/_t_t_y_S_0

  Oczywicie, uzyskasz dostp wycznie do funkcji ruchu i klawiszy,
  nacisk i pochylenie nie bd obsugiwane, gdy tak naprawd nie s to
  zbyt przydatne funkcje  w aplikacjach tekstowych.


  Jeeli rwnoczenie korzystasz z gpm i XFree86 to moesz, cho nie
  musisz, popa w kopoty w zwizku z tym, e w tym samym czasie
  urzdzenie zwykle moe by uywane tylko przez jeden program. Istniej
  dwa rozwizania tego problemu:


    Tryb powtarzania gpm. Jeeli uruchomisz serwis gpm z opcj "-R
     protok" to wszystkie otrzymane dane bd przesyane do urzdzenia
     /dev/gpmdata. Powiedzmy, e masz mysz typu ps2 i twoje wywoanie
     gpm wyglda nastpujco: _g_p_m _-_t _p_s_2 _-_R_m_m_a_n.  Serwis gpm otrzymuje
     dane od myszy ps2 i prbuje przetumaczy je na pakiety mman, ktre
     z kolei s przesyane do /dev/gpmdata. Niestety w chwili pisania
     tego dokumentu gpm potrafi przetumaczy dane tylko dla kilku
     protokow. Jeeli chcia(a)by pomin proces tumaczenia i
     przesya dane bajt po bajcie, wywoaj po prostu _g_p_m _-_t _p_s_2 _-_R _r_a_w.
     Nastpnie, umieszczajc linie _D_e_v_i_c_e      _"_/_d_e_v_/_g_p_m_d_a_t_a_" w sekcji
     pointer lub Xinput pliku XF86Config umoliwiamy XFree korzystanie z
     tego drugiego urzdzenia.
    Jeeli uywasz startx, moesz zmodyfikowa to polecenie tak by
     wykonywao _g_p_m _-_k przed uruchomieniem serwera X. Ta opcja usuwa
     dziaajcy serwis gpm.


  55..  TTaabblleettyy ww XXFFrreeee



  55..11..  WWyymmaaggaannaa wweerrssjjaa XXFFrreeee



  Minimaln wersj ``XFree'' powinna by 3.3.3.1. Jest to zwizane z
  rozszerzon obsug XInput, dziaaniem drugiego przecznika oraz
  zlikwidowaniem efektu blokowania myszy.

  Jeeli musisz korzysta z wersji wczeniejszej, obsuga XInput powinna
  by dostpna od 3.1.2.d.


  Obsuga XInput w XFree jest zwykle konfigurowana w pliku XF86Config.
  W wikszoci wypadkw plik XF86Config umieszczony jest w katalogu /etc
  lub /etc/x11. Poka teraz bardzo krtk sekcj konfiguracyn i
  wyjani co moe by zmienione i dlaczego jest to potrzebne.


  55..22..  PPrrzzyykkaaddoowwyy wwyycciinneekk XXFF8866CCoonnffiigg ((pprroossttyy))





       Section "Module"
       # sterownik urzdzenia Wacom
       Load "xf86Wacom.so"
       EndSection

       Section "Xinput"
       # ustawienia dla rysika Wacoma
         SubSection "WacomStylus"    # typ urzdzenia wejciowego
           DeviceName "Pen1"         # nazwa, wybierz dowoln
           Port "/dev/ttyS0"         # port szeregowy
           Baudrate 9600             # uyteczne tylko dla Intuosa
           Mode Absolute             # mapuj obszar tableta na ekran
           AlwaysCore                # patrz opis
           HistorySize 200           # rozmiar bufora dla ruchu
         EndSubSection
       EndSection





  55..33..  SSeekkccjjaa mmoodduuuu



  Obsuga XInput w XFree jest osigana przez uycie moduw. Modu
  sterownika urzdzenia dla Wacoma nosi nazw ``xf86Wacom.so''.  Jego
  wywoanie umieszczamy w sekcji "Module" pliku XF86Config tylko jeden
  raz.




  55..44..  RRooddzzaajjee uurrzzddzzee



  Urzdzeniem fizycznym moe by:

    czubek rysika

    gumka umieszczona na rysiku

    myszka - kursor z "celownikiem" Wacoma, mysz 4d, mysz Graphire

    rozpylacz (airbrush)

  PenPartner oraz Graphire rozpoznaja typ urzdzenia ale nie potrafi
  ich rozrni. Dla przykadu, nie moesz uy dwch rnych rysikw,
  skonfigurowanych powiedzmy, jeden na czerwono, drugi na niebiesko -
  wszystko co te urzdzenia rozpoznaj to: "Znalazem czubek rysika na
  mojej powierzchni", lub "Znalazem gumk na mojej powierzchni", lub
  "znalazem myszk na mojej powierzchni".


  XInput przypisuje urzdzeniom ich rodzaj, ktre z kolei zostan
  pniej opisane w pliku XF86Config w podsekcjach sekcji Xinput:

    WacomStylus czubek rysika lub rozpylacza

    WacomErasor gumka na rysiku lub rozplaczu

    WacomCursor myszy takie jak mysz Graphire, kursor "z celownikiem",
     mysz 4d

  55..55..  NNaazzwwaa uurrzzddzzeenniiaa



  Kademu skonfigurowanemu urzdzeniu musisz nada unikaln nazw. Nazwa
  ta bdzie pniej uywana w Twoim programie do komunikacji z tym
  urzdzeniem.  Wybr nazwy zaley od ciebie.


  55..66..  PPoorrtt



  XInput chce wiedzie do ktrego portu szeregowego podczone jest
  nasze urzdzenie.  Pozwala mi to na uywanie dwch rnych tabletw w
  tym samym czasie, na przykad Graphire podczonego do /dev/ttyS0 i
  PenPartnera podczonego do /dev/ttyS01.


  55..77..  PPoozziioomm DDeebbuuggLLeevveell



  Dziki ustawieniu poziomu DebugLevel moemy kontrolowa poziom
  "gadatliwoci" sterownika Wacoma do logw. Poziomy mog przybiera
  wartoci od 0 do 10.  Jeeli pominiemy to ustawienie przyjta zostanie
  warto domylna DebugLevel rwna 0, co odpowiada bardzo skpemu
  logowaniu.

  PPrrzzyykkaadd::




  SubSection "WacomStylus" # rysik
    DeviceName "PenRed"    # nazwa, wybie dowoln
    ...
    DebugLevel 10          # generuj bardzo duo komunikatw
    ...
  EndSubSection





  55..88..  NNuummeerr sseerryyjjnnyy ((ttyyllkkoo ddllaa ttaabblleettww IInnttuuooss))



  Tablety Intuos s bardziej wydajne ni PenPartner i Graphire poniewa
  potrafi rozrni wiele urzdze tego samego rodzaju. Znaczy to tyle,
  e moemy ju uywa dwa rysiki, jeden skonfigurowany jako czerwony,
  drugi skonfigurowany jako niebieski. Jak wida rozrnianie wycznie
  rodzajw urzdze nie daje wystarczajcej informacji do obsugi
  rnych rysikw. Dlatego, kade urzdzenie Intuosa, niech bdzie to
  rysik, pirko, mysz lub cokolwiek, posiada numer seryjny, ktry moesz
  wyspecyfikowa by umoliwi rozpoznanie konkretnego urzdzenia przez
  XInput. Wyglda to nastpujco:



       Section "Xinput"
         SubSection "WacomStylus" # rysik
           DeviceName "PenRed"    # nazwa, wybierz dowoln
           ...
           Serial 2609917443      # numer seryjny tego urzdzenia
           ...
         EndSubSection
         SubSection "WacomStylus" # inny rysik
           DeviceName "PenBlue"   # nazwa, wybierz dowoln
           ...
           Serial 2609918664      # numer seryjny tego urzdzenia
           ...
         EndSubSection
       EndSection




  Chciabym zaznaczy e zoone urzdzenia wejciowe posiadaj tylko
  jeden mumer seryjny. Sterownik uywa otrzymany numer seryjny do
  rozpoznania specyficznego rysika, natomiast czubek rysika od gumki
  jest rozpoznawany na podstawie rodzaju urzdzenia.



  55..88..11..  JJaakk uuzzyykkaa nnuummeerr sseerryyjjnnyy ddaanneeggoo uurrzzddzzeenniiaa


  1. Ustaw DebugLevel na  6

  2. Uruchom serwer X wypisujc polecenie _X _2_>_t

  3. Dotknij powierzchni tableta po kolei wszystkimi urzdzeniami,
     zapamitujc kolejnos.

  4. Usu proces serwera X (zwykle Ctrl+Alt+Backspace)

  5. Uruchom _g_r_e_p _s_e_r_i_a_l___n_u_m _t

  Powiniene otrzyma list z rnicymi si numerami.



  55..88..22..  NNuummeerr sseerryyjjnnyy -- pprrzzyykkaadd tteeggoo ccoo zzoossttaaoo zzaallooggoowwaannee



       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





  55..99..  TTrryybbyy pprraaccyy bbeezzwwzzggllddnnyy ((aabbssoolluuttee)) ii wwzzggllddnnyy ((rreellaattiivvee))



  Jeeli ustawisz tablet do pracy w trybie bezwzgldnym, caa
  powierzchnia urzdzenia bdzie odpowiadaa ekranowi komputera. Za
  kadym razem gdy opucisz rysik na ten sam punkt tableta wskanik
  pojawi si w odpowiadajcym mu tym samym punkcie ekranu.


  Jeeli ustawisz urzdzenie do pracy w trybie wzgldnym, uzyskasz
  dobrze Ci znane zachowanie myszy. Jeli podniesiesz myszk z
  powierzchni, przesuniesz j i ponownie opucisz, wskanik (idealnie)
  nie poruszy si.


  PPrrzzyykkaadd::
  Mode Absolute


  55..1100..  TTrryybbyy pprraaccyy uurrzzddzzee EExxtteennssiioonn,, CCoorree oorraazz AAllwwaayyssCCoorree



  XFree zna dwa rodzaje wskanikw: pierwszy, posiadajcy tylko
  podstawow funkcjonalno (klawisze, moliwo ruchu), wykorzystywany
  jest do wybierania pozycji menu, zaznaczania tekstu, naciskania
  guzikw i tym podobnych rzeczy.  Jest to urzdzenie podstawowe _C_o_r_e.

  Drugi rodzaj wskanika wykorzystuj aplikacje potrzebujce dodatkowych
  informacji, takich jak poziom nacisku czy nachylenia.
  Urzdzenie to nazywamy rozszerzonym - _E_x_t_e_n_s_i_o_n.


  Poczwszy od wersji 3.3.3.1, ustawienie _A_l_w_a_y_s_C_o_r_e mwi sterownikowi
  by powinien osugiwa obydwa rodzaje zdarze.

  Jeeli w pliku XF86Config nie zostanie wyspecyfikowane ustawienie
  AlwaysCore, wskanik zostanie zainicjowany w trybie rozszerzonym -
  bdzie mona z niego skorzysta wewntrz aplikacji, ale ju nie do
  kontroli pozycji menu systemu zarzdzania oknem.


  Jeeli pozycja AlwaysCore zostaa wpisana, urzdzenie (obok myszy)
  bdzie dziaa jako wskanik podstawowy wysyajc dodatkowo informacje
  na temat nachylenia i nacisku do wszystkich programw, ktre uzyskay
  dostp do wskanika w trybie rozszerzonym.

  Dziki uyciu dwch rnych urzdze logicznych moemy tak
  skonfigurowa jedno fizycznie urzdzenie, by pracowao zarwno w
  trybie podstawowym jak i rozszerzonym.
  Aby tego dokona musimy stworzy dwie identyczne sekcje rnice si
  jedynie ustawieniem nazwy urzdzenia DeviceName. Nastpnie musimy
  doda wpis AlwaysCore od ostatniej z tych sekcji.

  PPrrzzyykkaadd::
  AlwaysCore


  55..1111..  PPaarraammeettrr HHiissttoorryySSiizzee



  Ustawienie HistorySize okrela rozmiar bufora uywanego do
  przechowywania informacji o zdarzeniach ruchu.


  55..1122..  PPaarraammeettrr SSuupppprreessss



  Ustawienie to okrela liczb jednostek, o ktre urzdzenie musi by
  przesunite zanim sterownik poruszy wskanikiem. Jest ono zwykle
  niezbdne przy uyciu wysokich rozdzielczoci.

  PPrrzzyykkaadd::
  Suppress 6


  55..1133..  PPaarraammeettrr TTiillttMMooddee ((ttyyllkkoo IInnttuuooss))



  TiltMode umoliwia wysyanie informacji na temat pochylenia dla
  urzdze wejciowych tableta Intuos. Jeeli pominiemy ten parametr,
  przesyana zostanie jedynie informacja o nacisku.



  55..1144..  UUssttaawwiieenniiaa TTooppXX,, TTooppYY,, BBoottttoommXX,, BBoottttoommYY



  Te cztery parametry pozwalaj na zredukowanie aktywnego obszaru
  tableta.  Dla przykadu, mj Intuos A4 oversize jest tak wielki, e
  nie da si na nim normalnie malowa, gdy ruchy rysika musz by zbyt
  due. Uywam tych parametrw aby tak poinstruowa sterownik by
  przypisa do ekranu tylko lew doln wiartk tableta.

  PPrrzzyykkaadd::


       TopX        0 # wsprzdne lewego grnego punktu
       TopY     5000
       BottomX  5000 # wsprzdne prawego dolnego punktu
       BottomY 10000








  55..1144..11..  OOkkrreellaanniiee mmaakkssyymmaallnnyycchh wwaarrttooccii XX,, YY,, aakkttuuaallnneejj kkoonnffiigguurraaccjjii
  oorraazz rroozzddzziieellcczzooccii

  Jeli uywasz powyszych ustawie, najprawdopodobniej bdziesz chcia
  obliczy rozmiar oraz pooenie definiowanego prostokta. Zwykle
  potrzebne s do tego maksymalne wsprzdne oraz rozdzielczo. Aby
  pozna te wartoci uruchom swj serwer: _X _2_>_t.  Nastpnie usu proces
  serwera X (zwykle Ctrl+Alt+Backspace) i wykonaj _g_r_e_p _"_X_=_" _t.  W
  odpowiedzi powiniene otrzyma wartoci ktre Ci interesoway.



  55..1144..22..  OOkkrreellaanniiee rroozzddzziieellcczzooccii -- pprrzzyykkaadd tteeggoo ccoo zzoossttaaoo zzaalloo
  ggoowwaannee



       (--) 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






  55..1155..  UUssttaawwiieenniiee KKeeeeppSShhaappee



  Opcja ta korzysta ze zmiennych TopX i TopY (lub wbudowanych wartoci
  domylnych, jeli je pominelimy) do ustawienia parametrw BottomX i
  BottomY tak aby


    wspczynnik wysoko/szeroko ekranu by identyczny z tabletem

    aktywny obszar tableta, poczwszy od punktu TopX, TopY, by jak
     najwikszy z uwzgldnieniem powyszego warunku.

  Jakiekolwiek wczeniejsze ustawienia BottomX i BottomY s ignorowane,
  gdy wartoci tych zmiennych zostan obliczone.



  66..  ZZmmiiaannyy kkoonnffiigguurraaccjjii ppoodd ddzziiaaaajjccyymmii XX--aammii



  66..11..  KKoonnffiigguurroowwaanniiee GGiimmppaa ww cceelluu wwyykkoorrzzyyssttaanniiaa uurrzzddzzee XXIInnppuutt



  Poczwszy od wersji 1.1.x ``Gimp'' posiada wbudowan obsug XInput.

  Aplikacja musi jednak wiedzie, ktrego urzdzenia powinna uy i w
  jakim trybie. Aby to ustawi powiniene otworzy okno dialogowe
  _P_l_i_k_/_O_k_n_a _d_a_l_o_g_o_w_e_/_U_r_z__d_z_e_n_i_a _w_e_j__c_i_o_w_e (w wersji angielskiej
  _F_i_l_e_/_D_i_a_l_o_g_s_/_I_n_p_u_t _D_e_v_i_c_e_s).  U gry okna znajdziesz dwie rozwijane
  listy z etykietami _U_r_z__d_z_e_n_i_e (_D_e_v_i_c_e) oraz _T_r_y_b (_M_o_d_e).  Z pierwszej
  wybierz urzdzenie z drugiej tryb obsugi.

  Tryby te to:

    Wyczone (disabled): Gimp nie wykorzystuje danego urzdzenia.

    Okno (window): Gimp korzysta z urzdzenia. (Kursor jest rysowany
     przez t apliakcje ???)

    Ekran (screen): Gimp korzysta z urzdzenia. (Kursor jest rysowany
     przez serwer X ???)


  Jeeli widzimy, e znaszym urzdzeniem zwizane s dwa kursory, mamy
  dwa rozwizania:

    Moemy uy trybu ekranu, ale moe to (cho nie musi) spowodowa
     utrate specjalnych kursorw gimp-tool. Jeli tak si stanie,
     wszystkie kursory zostan zastpione przez kursor-owek.

     Moemy te w pliku XF86Config skonfigurowa dwa rne urzdzenia,
     jedno jako _A_l_w_a_y_s_C_o_r_e a drugie bez tej opcji. Musimy jeszcze
     powiadomi gimpa by drugie z urzdze wykorzystywa w trybie okna.
     Jeli tak uczynimy, a w naszym pliku XF86Config uywamy jednego z
     ustawie _T_o_p_X_, _T_o_p_Y_, _B_o_t_t_o_m_X _o_r_a_z _B_o_t_t_o_m_Y_, musimy zadba by obydwa
     urzdzenia logiczne miay te same ustawienia dla tych parametrw. W
     przeciwnym wypadku moemy by zaskoczeni, tym e X-y wyswietl
     kursor jednego z urzdze podczas gdy aktywne bdzie drugie.
     Efektem tego bdzie kursor znacznie odsunity od punktu akcji.


  Poniej obydwu rozwijanych list znajduj si pola kontrolne z
  zakadkami _O_s_i_e _(_A_x_e_s_) oraz _K_l_a_w_i_s_z_e _(_K_e_y_s_).  _O_s_i_e przypisuj osiom
  funkcje. W wikszoci przypadkw nie potrzeba zmienia tych ustawie,
  ale moesz zastanowi si nad ekranem dotykowym, ktry zosta
  zamontowany w pozycji obrconej o 90 stopni. W tym przypadku
  moglibymy chcie zamieni ze sob osie x i y.


  Niektre tablety posiadaj umieszczone u gry specjalne klawisze
  makropolece (makro), krym mog by przypisane czsto uywane
  funkcje. Zakadka _K_l_a_w_i_s_z_e pozwala na przypisanie do klawisza makro
  pwnego znaku. Na przykad do klawisza makro mona przypisa kombinacj
  Ctrl+Shift+R. Jeeli zostanie on nacinity, wywoana zostanie funkcja
  wczenia/wyczenia linijki.
  Obecne sterowniki do tabletw Wacoma obsuguj klawisze makro jedynie
  w UltraPadach, pola klawiszy w tabletach Intuos nie s wykorzystane w
  ten sposob.


  Powinnimy teraz omwi jak moemy korzysta z naszych urzdze.
  Otwrz okno dialogowe _P_l_i_k_/_O_k_n_a _d_i_a_l_o_g_o_w_e_/_S_t_a_n _u_r_z__d_z_e_n_i_a
  _(_F_i_l_e_/_D_i_a_l_o_g_s_/_D_e_v_i_c_e _S_t_a_t_u_s_).  Otwrz dowolny plik z rysunkiem.

  Kade urzdzenie wejciowe w gimpie jest konfigurowane osobno.

  Jeeli bdziesz porusza kursorem w oknie rysunku przy uyciu rnych
  urzdze zauwaysz zmian urzdze w oknie dialogowym Stan urzdzenia.
  Jeli wybierzesz dowolne narzdzie, pdzel, wzr lub kolor zmiana
  take zostanie uwzgldniona.  Aby wybrane ustawienia zostay
  odtworzone przy nastpnej sesji gimpa mona je tam zapisa.



  66..22..  UUrrzzddzzeenniiee pprrzzeecczznniikkaa ((SSWWIITTCCHH))



  Jest to, cay czas aktywne, urzdzenie specjalne. Generuje ono
  zdarzenia za kadym razem gdy nowe urzdzenie przejmuje wskanik w
  trybie podstawowym. Posiada ono pseudo "o". "Warto" na tej osi jest
  identyfikatorem urzdzenia bdcego wskanikiem podstawowym. Nie mam
  pojcia co uytkownik mgby zrobi z urzdzeniem przecznika -
  gwnie jest ono przydatne dla programistw.


  66..33..  PPrrzzyycciisskkii



  Przyciski, w ktre s wyposaone urzdzenia wejciowe mog by tak
  zrnocowane jak same urzdzenia:
  Rysik posiada przynajmniej czubek, ale moe te mie jeden lub dwa
  przyciski na boku oraz gumke na drugim kocu. Myszy mog mie do 32
  klawiszy (cho zwykle maj ich 3). Przyciski ponumerowane s od 1 do
  liczby klawiszy. Opisane poniej dwa programy pozwalaj na modyfikacje
  liczby wykorzystywanych klawiszy.


  66..44..  PPrrzzyyppoorrzzddkkoowwyywwaanniiee pprrzzyycciisskkww pprrzzyy uuyycciiuu xxmmooddmmaapp ddllaa uurrzzddzzee
  pprraaccuujjccyycchh ww ttrryybbiiee ppooddssttaawwoowwyymm



  xmodmap bdzie modyfikowa jedynie wskanik podstawowy (Core Pointer).
  Jako e w danym momencie istnieje tylko jeden wskanik podstawowy, nie
  maj znaczenia rnice pomidzy fizycznymi urzdzeniami, ktre mog
  sta si takim wskanikiem.  Na jaki czas zapomnijmy o caym tym
  XInput i pomylmy o osobie leworcznej, ktra chciaaby zamieni
  znaczenie prawego i lewego przycisku myszy. Aby pozna stan aktualny
  mona wykona polecenie _x_m_o_d_m_a_p _-_p_p. W odpowiedzi powinnimy otrzyma
  nastpujc tabel:


       Physical        Button
       Button          Code
       1              1      # ( lewy     przycisk )
       2              2      # ( prawy    przycisk )
       3              3      # ( rodkowy przycisk )





  Aby zamieni klawisze naley wykona polecenie _x_m_o_d_m_a_p _-_e _"_p_o_i_n_t_e_r _= _2
  _1 _3_", oraz _x_m_o_d_m_a_p _-_e _"_p_o_i_n_t_e_r _= _d_e_f_a_u_l_t_" aby przywrci poprzednie
  przypisanie. Powinno to dziaa dla dowolnych urzdze posiadajcych
  przynajmniej dwa przyciski. Naley zaznaczy, e wyraenie _"_p_o_i_n_t_e_r _=
  _x _x _x_" musi by zawarte w cudzysowach by zapobiec jego modyfikacji ze
  strony powoki.


  66..55..  PPrrzzyyppoorrzzddkkoowwyywwaanniiee pprrzzyycciisskkww pprrzzyy uuyycciiuu xxiinnppuutt ddllaa uurrzzddzzee
  pprraaccuujjccyycchh ww ttrryybbiiee rroozzsszzeerrzzoonnyymm



  Wrmy ponownie do XInput. Jeli uywasz gimpa, moesz chcie zmieni
  przyporzdkowanie klawiszy dla kadego urzdzenia osobno (moesz by
  zadowolony z myszy, ale chciaby zamieni znaczenia dwch bocznych
  przyciskw rysika). Frederic Lepied napisa w tym celu program o
  nazwie ``xinput''.

  Aby zamieni boczne przyciski powiniene wykona polecenie _x_i_n_p_u_t _l_i_s_t
  w celu uzyskania listy urzdze wraz z ich aktualnymi ustawieniami.
  Zamiana realizowana jest przez wykonanie _x_i_n_p_u_t _s_e_t_-_b_u_t_t_o_n_-_m_a_p _P_e_n_1 _1
  _3 _2 gdzie _P_e_n_1 jest urzdzeniem, ktre chcemy zmieni.

  Poczwszy od XFree 3.3.2 rozwizanie to dziaa dla urzdze
  skonfigurowanych (w pliku XF86Config) jako _A_l_w_a_y_s_C_o_r_e.


  66..66..  xxsseettmmooddee -- zzmmiiaannyy ttrryybbuu pprraaccyy nnaa wwzzggllddnnyy oorraazz bbeezzwwzzggllddnnyy



  Przy pomocy xsetmode moliwe jest przeczanie urzdzenia pomidzy
  trybem bezwzgldnym (absolute) a wzgldnym (relative) trybem pracy.

  PPrrzzyykkaadd::
  _x_s_e_t_m_o_d_e _G_r_a_p_h_i_r_e_M_o_u_s_e _A_B_S_O_L_U_T_E


  66..77..  xxsseettppooiinntteerr -- uussttaawwiiaanniiee ddoommyyllnneeggoo uurrzzddzzeenniiaa ppooddssttaawwoowweeggoo



  Jeeli adne z naszych urzdze nie zostao skonfigurowane jako
  _A_l_w_a_y_s_C_o_r_e a chcielibymy by jedno z nich zostao wskanikiem
  podstawowym musimy uy programu xsetpointer.

  Wykonaj polecenie _x_s_e_t_p_o_i_n_t_e_r _N_a_z_w_a_U_r_z__d_z_e_n_i_a.  Stare urzdzenie
  podstawowe (zwykle jest to mysz) nie bdzie ju duej wykorzystywane,
  jego miejsce zajmie urzdzenie wyspecyfikowane w naszym poleceniu.
  Dla przykadu moliwe jest przypisanie funkcji wskanika podstawowego
  myszy Graphire w uruchomionych wczesniej XFree.

  _x_s_e_t_p_o_i_n_t_e_r _-_l wypisuje list wszystkich urzdze oraz ich trybw
  pracy.


  66..88..  KKllaawwiisszzee


  Niektre urzdzena posiadaj klawisze makro lub specjalne pola, ktrym
  mona przypisa pojedyncze znaki sterujace lub te ich cigi. Dziaa
  to wycznie dla urzdze pracujcych w trybie rozszerzonym, a co za
  tym idzie, realizowane jest przez te aplikacje, ktre chcielibymy by
  wykorzystyway klawisze.

  _x_i_n_p_u_t _-_l daje nam informacje na temat liczby klawiszy czy te
  wysyanych znakw sterujcych.



  66..99..  NNaarrzzddzziiaa ddoo kkoorrzzyyssttaanniiaa zz wwiicceejj nnii jjeeddnneeggoo ttaabblleettaa oorraazz ddoo
  wwcczzaanniiaa ii wwyycczzaanniiaa oobbssuuggii



  Posiadam 3 tablety Wacoma, ktre uywam wraz z moim notebookiem. Za
  kadym razem gdy uruchamiam X-y, a aden z tabletw nie jest
  podczony do komputera, musi upyn sporo czasu nim sterowniki si
  poddadz. Jeeli uruchamiany jest xdm okres oczekiwania znacznie si
  wydua.

  Stworzyem dwa narzdzia, ktre powinny uatwi ycie wszystkim ktrzy
  s w takiej samej sytuacji:


    Skrypt powoki ssxx dla tych, ktrzy uywaj startx.  sx korzysta z
     pola dialogowego do prezentacji cakiem adnego menu pozwalajcego
     na wybr:

    jednego z 10 urzdze (tablet, joystick, ...)

    wykorzystywanego wywietlacza dla notebookw (ekran wewntrzny lub
     zewntrzny)

    uywanego window managera



    Maa aplikacja gtk xxiinnppuutt--cchhoooosseerr dla tych, ktrzy uywaj xdm.  Za
     kadym razem, gdy wywietlany jest ekran logowania xdm, xinput-
     chooser prezentuje uytkownikowi list menu, z ktrej mona wybra
     jedn z dziesiciu rnych konfiguracji.


  Koncepcj, ktra ley u podstaw dziaania obu programw, jest podzia
  pliku XF86Config na plik XF86Config.bare, zawierajcy informacje
  wsplne dla wszystkich konfiguracji, oraz szereg maych plikw
  zawierajcych specyficzne informacje na temat poszczeglnych
  konfiguracji.

  Obydwa narzdzia cz te czci w dziaajc cao.


  Pakiet ten jest dostpny na stronie http://www.runkeledv.de/download,
  pod nazw xinput_chooser_sr.


  77..  DDaallsszzee iinnffoorrmmaaccjjee//wwyykkoorrzzyyssttaannee ddookkuummeennttyy



  gpm:
  strona podrcznika (man) gpm, FAQ gpm, kod rdowy pliku mice.c

  XInput:
  dokument XInput HOWTO autorstwa Owena Taylora

  XFree oraz Wacom:
  podrcznik XF86Config

  strona Web Frederica Lepieda

  duo, duo listw...


  88..  OOdd ttuummaacczzaa


  Dokument ten zosta napisany w standardzie ISO-8859-2.

  Tumaczenie to jest chronione prawami autorskimi (c) Marka Guevara
  Braun.  Dozwolone jest rozprowadzanie i dystrybucja na prawach takich
  samych jak dokument oryginalny.

  Jeeli znalaze(a) jakie bdy ortograficzne, gramatyczne,
  skadniowe lub techniczne to napisz do mnie na adres marek@atm.com.pl

  Oficjaln stron tumacze HOWTO jest http://www.jtz.org.pl/

  Aktualne wersje przetumaczonych dokumentw znajduj si na teje
  stronie.  Dostpne s take poprzez anonimowe ftp pod adresem
  ftp://www.jtz.org.pl/pub/Linux/JTZ/

  Zmiany wprowadzone przez tumacza w stosunku do oryginau to odnoniki
  do polskich serwerw ftp i WWW oraz zmiana pisowni nazw produktw
  Wacoma (Intuos zamiast intuos, Graphire zamiast graphire, itp.)































































