home *** CD-ROM | disk | FTP | other *** search
/ Enter 1999 April - Disc 1 / enter_04_1999_1.iso / OS2 / XFREE86 / XDOC.ZIP / XFree86 / lib / X11 / doc / xinput < prev   
Encoding:
Text File  |  1999-01-09  |  6.4 KB  |  463 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.              Information about the XInput extension in XFree86[tm]
  11.  
  12.                                 Frdric Lepied
  13.  
  14.                                 2 November 1998
  15.  
  16.  
  17.  
  18. 1.  Introduction
  19.  
  20. This document provides  some information  about  the XInput  extension imple-
  21. mented in XFree86[tm].
  22.  
  23. If  you have any suggestions,  comments, fixes  or ideas regarding the XInput
  24. extension in XFree86[tm] or about this document, send e-mail to
  25.  
  26. lepied@XFree86.Org
  27.  
  28. Bug Reports should be sent to
  29.  
  30. XFree86@XFree86.Org
  31.  
  32. Questions or anything else should be posted to the NewsGroup
  33.  
  34. comp.windows.x.i386unix
  35.  
  36.  
  37. 2.  Description
  38.  
  39. The XInput extension is a standard X Consortium extension. The goal of this
  40. extension is to allow additional input  devices management to the X Window Sys-
  41. tem. The documentation could  be found in the X Consortium distribution under
  42. xc/doc/hardcopy/Xi.
  43.  
  44.  
  45. 3.  XFree86 implementation
  46.  
  47. The XFree86 implementation contains 2 parts : the server part and two clients
  48. (xsetpointer and xsetmode).
  49.  
  50. 3.1  Server side
  51.  
  52. The server supports the following extended devices :
  53.  
  54.    o Joystick (only on  supported systems ie. Linux, FreeBSD and NetBSD). Fea-
  55.      tures :
  56.  
  57.         o Relative mode.
  58.  
  59.         o 2 valuators (x and y axis).
  60.  
  61.  
  62.  
  63.  
  64.  Information about the XInput extension in XFree86[tm]                        1
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  Information about the XInput extension in XFree86[tm]                        2
  71.  
  72.  
  73.  
  74.         o 2 buttons.
  75.  
  76.  
  77.    o Elographics touchscreen. Features :
  78.  
  79.         o Absolute mode.
  80.  
  81.         o 2 valuators (x and y axis).
  82.  
  83.         o 1 button.
  84.  
  85.  
  86.    o Stylus on MicroTouch touchscreen. Features :
  87.  
  88.         o Absolute mode.
  89.  
  90.         o 2 valuators (x and y axis).
  91.  
  92.         o 1 button.
  93.  
  94.  
  95.    o Finger on MicroTouch touchscreen. Features :
  96.  
  97.         o Absolute mode.
  98.  
  99.         o 2 valuators (x and y axis).
  100.  
  101.         o 1 button.
  102.  
  103.  
  104.    o Mouse. Features :
  105.  
  106.         o Relative mode.
  107.  
  108.         o 2 valuators (x and y axis).
  109.  
  110.         o up to 4 buttons.
  111.  
  112.  
  113.    o Wacom stylus. Features :
  114.  
  115.         o Absolute or relative modes.
  116.  
  117.         o 5 valuators :
  118.  
  119.             1.  X axis.
  120.  
  121.             2.  Y axis.
  122.  
  123.             3.  pressure.
  124.  
  125.             4.  X tilt.
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  Information about the XInput extension in XFree86[tm]                        3
  137.  
  138.  
  139.  
  140.             5.  Y tilt.
  141.  
  142.         o 3 buttons.
  143.  
  144.         o Proximity report.
  145.  
  146.         o Motion history capability.
  147.  
  148.         o Macro/function buttons are reported as keys.
  149.  
  150.  
  151.    o Wacom eraser. Features :
  152.  
  153.         o Absolute or relative modes.
  154.  
  155.         o 5 valuators :
  156.  
  157.             1.  X axis.
  158.  
  159.             2.  Y axis.
  160.  
  161.             3.  pressure.
  162.  
  163.             4.  X tilt.
  164.  
  165.             5.  Y tilt.
  166.  
  167.         o 1 button.
  168.  
  169.         o Proximity report.
  170.  
  171.         o Motion history capability.
  172.  
  173.         o Macro/function buttons are reported as keys.
  174.  
  175.  
  176.    o Wacom cursor. Features :
  177.  
  178.         o Absolute or relative modes.
  179.  
  180.         o 5 valuators :
  181.  
  182.             1.  X axis.
  183.  
  184.             2.  Y axis.
  185.  
  186.             3.  pressure.
  187.  
  188.             4.  X tilt.
  189.  
  190.             5.  Y tilt.
  191.  
  192.         o 16 buttons.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  Information about the XInput extension in XFree86[tm]                        4
  203.  
  204.  
  205.  
  206.         o Proximity report.
  207.  
  208.         o Motion history capability.
  209.  
  210.         o Macro/function buttons are reported as keys.
  211.  
  212.  
  213.    o SummaSketch tablet. Features :
  214.  
  215.         o Absolute or relative modes.
  216.  
  217.         o 2 valuators (x and y axis).
  218.  
  219.         o 2 button stylus or 4 button puck.
  220.  
  221.         o Proximity report.
  222.  
  223.         o Motion history capability.
  224.  
  225.  
  226.    o AceCad tablet. Features :
  227.  
  228.         o Absolute or relative modes.
  229.  
  230.         o 2 valuators (x and y axis).
  231.  
  232.         o 2 button stylus or 4 button puck.
  233.  
  234.         o Proximity report.
  235.  
  236.         o Motion history capability.
  237.  
  238.  
  239.    o SWITCH virtual device. Features :
  240.  
  241.         o Absolute mode.
  242.  
  243.         o 1 valuator (device id) which reports the id of the device controlling
  244.           the core pointer (works with the AlwaysCore feature see bellow).
  245.  
  246.  
  247.    o SGI button box. Features :
  248.  
  249.         o Absolute or relative modes.
  250.  
  251.         o 8 valuators.
  252.  
  253.         o 32 buttons.
  254.  
  255.         o Motion history capability.
  256.  
  257.  
  258.  
  259. To  enable  an   extended  device, you  must   add   en  entry  in the
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  Information about the XInput extension in XFree86[tm]                        5
  269.  
  270.  
  271.  
  272. XF86Config file.   Consult   to  the XF86Config  man pages to see the details.
  273.  
  274. The  XFree86 implementation supports  a  non  standard feature  called
  275. AlwaysCore which enables an  XInput device to send both  core and extended
  276. events at the same time. To enable it you have to add the AlwaysCore keyword to
  277. the  subsection describing your  device in the XF86Config  file.  The  SWITCH
  278. virtual device reports a Motion event when another  device takes over the con-
  279. trol of the core pointer. The id of the new device is reported in the first
  280. valuator of the event.
  281.  
  282. 3.2  Clients
  283.  
  284. xsetpointer is used to  change the device controlling the core pointer and to
  285. list available extended devices.
  286.  
  287. xsetmode is used to change the mode (absolute or relative) of an extended
  288. device. The device  has to  support relative and  absolute modes and the device
  289. must not control the core pointer.
  290.  
  291. Consult the man pages for details.
  292.  
  293.      Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/xinput.sgml,v 3.6.2.1 1998/11/04 15:19:07 hohndel Exp $
  294.  
  295.  
  296.  
  297.  
  298.      $XConsortium: xinput.sgml /main/3 1996/10/27 11:06:13 kaleb $
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  Information about the XInput extension in XFree86[tm]                        6
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.                                    CONTENTS
  405.  
  406.  
  407.  
  408. 1. Introduction  ............................................................ 1
  409.  
  410. 2. Description  ............................................................. 1
  411.  
  412. 3. XFree86 implementation  .................................................. 1
  413.    3.1 Server side  ......................................................... 1
  414.    3.2 Clients  ............................................................. 5
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                                        i
  461.  
  462.  
  463.