--- /X11R6.8.1/xc/programs/Xserver/hw/xfree86/input/wacom/wacom.man 2004-04-23 12:54:06.000000000 -0700 +++ wacom.man 2004-11-23 16:54:03.000000000 -0800 @@ -22,8 +22,10 @@ driver functions as a pointer input device, and may be used as the X server's core pointer. .SH SUPPORTED HARDWARE -This driver supports the Wacom IV and Wacom V protocols. -Preliminary support is available for USB devices on some Linux platforms. +This driver supports the Wacom IV and Wacom V protocols. Serial tablets only +need this driver. USB tablet support is available on some Linux platforms. +USB tablets needs wacom kernel driver being loaded before this driver starts. +Please check linuxwacom.sf.net for latest updates of Wacom X and kernel drivers. .SH CONFIGURATION DETAILS Please refer to __xconfigfile__(__filemansuffix__) for general configuration details and for options that can be used with all input drivers. This @@ -34,8 +36,10 @@ supports the following entries: .RS 8 .TP 4 -.B Option \fI"Type"\fP \fI"stylus"|"eraser"|"cursor"\fP -sets the type of tool the device represent. This option is mandatory. +.B Option \fI"Type"\fP \fI"stylus"|"eraser"|"cursor"|"pad"\fP +sets the type of tool the device represent. This option is mandatory. "pad" is +for Intuos 3 Tablet Menu Strip only. Since all Intuos3 has Menu Strip(s), "pad" +is mandatory for Intuos 3 if your application uses Menu Strip features. .TP 4 .B Option \fI"Device"\fP \fI"path"\fP sets the path to the special file which represents serial line where @@ -47,14 +51,15 @@ tells the driver to dialog with the tablet the USB way. This option is only available on some Linux platforms. .TP 4 -.B Option \fI"DeviceName"\fP \fI"name"\fP -sets the name of the X device. +.B Option \fI"ForceDevice"\fP \fI"ISDV4"\fP +tells the driver to dialog with the tablet the Tablet PC way. Tablet PC is a +serial tablet using a special Wacom IV protocol, called ISDV4 protocol. .TP 4 .B Option \fI"Suppress"\fP \fI"Inumber"\fP sets the position increment under which not to transmit coordinates. This entry must be specified only in the first Wacom subsection if you have -multiple devices for one tablet. If you don't specify this entry, the default value -is computed to +multiple devices for one tablet. If you don't specify this entry, the default value, +which is 2, will be used. To disable suppression, the entry should be specified as 0. .TP 4 .B Option \fI"Mode"\fP \fI"Relative"|"Absolute"\fP sets the mode of the device. @@ -63,17 +68,6 @@ enables tilt report if your tablet supports it (ROM version 1.4 and above). If this is enabled, multiple devices at the same time will not be reported. .TP 4 -.B Option \fI"HistorySize"\fP \fI"number"\fP -sets the motion history size. By default the value is zero. -.TP 4 -.B Option \fI"AlwaysCore"\fP \fI"on"\fP -enables the sharing of the core pointer. When this feature is enabled, the -device will take control of the core pointer (and thus will emit core events) -and at the same time will be able, when asked so, to report extended events. -You can use the last available integer feedback to control this feature. When -the value of the feedback is zero, the feature is disabled. The feature is -enabled for any other value. -.TP 4 .B Option \fI"TopX"\fP \fI"number"\fP X coordinate of the top corner of the active zone. .TP 4 @@ -86,6 +80,53 @@ .B Option \fI"BottomY"\fP \fI"number"\fP Y coordinate of the bottom corner of the active zone. .TP 4 +.B Option \fI"ButtonsOnly"\fP \fI"on"\fP +disables the device's motion events. +.TP 4 +.B Option \fI"ButtonM"\fP \fI"N"\fP +reports a button N click when button M is pressed, where M is one of the +wacom supported button numbers, it can be 1 to 16 and N can be an integer +between 1 and 19. The default value for button M is M. When N is less than 17, +button M is assigned to the function of button N. When N is 17, button M is +a left-double-click. When N is 18, button M is ignored, i.e., no button event +will be reported when clicking on button M. When N is 19, button M is assigned +to Mode Toggle, switching between relative and absolute mode, which is especially +useful to switch windows in a multi-monitor environment. +.TP 4 +.B Option \fI"TPCButton"\fP \fI"on"\fP +enables the stylus buttons as Tablet PC buttons, i.e., reports stylus button +event only when its tip is pressed. +.TP 4 +.B Option \fI"Speed"\fP \fI"Rspeed"\fP +sets the cursor's relative movement speed to Rspeed. The default value is 1.0. +A Rspeed greater than 1.0 will speed up the cursor's relative movement. A Rspeed +less than 1.0 but greater than 0 will slow down the cursor's relative movement. +A Rspeed too close to 0 is not recommanded. +.TP 4 +.B Option \fI"Twinview"\fP \fI"horizontal"|"vertical"|"none"\fP +sets the orientation of TwinView to map the tablet to the whole desktop or a +specific screen if "ScreenNo" option is added. If you want to map the tablet to +only one screen but freely move from one screen to the other, you should NOT add +this option. The default is "none". +.TP 4 +.B Option \fI"TVResolution"\fP \fI"res1,res2"\fP +specifies different resolutions for the two screens in TwinView setup. For example, +if the resolution of screen 1 (res1) is 1024x768 and screen 2 (res2) is 1280x1024, +the option will be set to: + Option "TVResolution" "1024x768,1280x1024" +It is unnecessary to add this option if your screens are displaying in the same resolutions. +.TP 4 +.B Option \fI"ScreenNo"\fP \fI"n"\fP +In a multi-monitor environment, specifies the screen number in which the cursor can move. +.TP 4 +.B Option \fI"Rotate"\fP \fI"CW"|"CCW"|"NONE"\fP +rotates the Tablet PC's screen orientation, clockwise or counterclockwise. The default is "NONE". +.TP 4 +.B Option \fI"PressCurve"\fP \fI"x1,y1,x2,y2"\fP +sets pressure curve by control points x1, y1, x2, and y2. Their values are in range +from 0..100. The input for linear curve (default) is "0,0,100,100"; slightly depressed curve +(firmer) might be "5,0,100,95"; slightly raised curve (softer) might be "0,5,95,100". +.TP 4 .B Option \fI"KeepShape"\fP \fI"on"\fP When this option is enabled, the active zone begins according to TopX and TopY. The bottom corner is adjusted to keep the ratio width/height @@ -93,11 +134,8 @@ described by TopX, TopY, BottomX, BottomY. .TP 4 .B Option \fI"DebugLevel"\fP \fInumber \fP -sets the level of debugging info reported. -.TP 4 -.B Option \fI"BaudRate"\fP \fI"38400"\fP, \fI"19200"\fP or \fI"9600"\fP (default) -changes the serial link speed. This option is only available for -wacom V models (Intuos). +sets the level of debugging info reported. There are 11 levels, specified by +the integers between 1 and 11. .TP 4 .B Option \fI"Serial"\fP \fI"number"\fP sets the serial number associated with the physical device. This allows @@ -113,4 +151,4 @@ .SH "SEE ALSO" __xservername__(__appmansuffix__), __xconfigfile__(__filemansuffix__), xorgconfig(__appmansuffix__), Xserver(__appmansuffix__), X(__miscmansuffix__). .SH AUTHORS -Frederic Lepied +Frederic Lepied , Ping Cheng , John E. Joganic