On Mon, Aug 15, 2011 at 8:03 PM, Peter Hutterer <peter.hutte...@who-t.net> wrote: > Signed-off-by: Peter Hutterer <peter.hutte...@who-t.net> > --- > man/wacom.man | 124 > +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ > 1 files changed, 124 insertions(+), 0 deletions(-) > > diff --git a/man/wacom.man b/man/wacom.man > index d45be1e..7bcdc27 100644 > --- a/man/wacom.man > +++ b/man/wacom.man > @@ -246,6 +246,130 @@ If > is enabled, this option specifies the minimum time between taps for a right > click tap. > .RE > +.SH DEVICE PROPERTIES > +The wacom driver supports the following properties: > +.TP 4 > +.B \*qWacom Tablet Area\*q x1, y1, x2, y2 > +Four 32-bit values restricting the valid area on the physical tablet. Values > +are x/y of top-left coordinate, x/y of bottom-right coordinate. See > +.B Option \*qTopX\*q, > +.B Option \*qTopY\*q, > +.B Option \*qBottomX\*q, > +and > +.B Option \*qBottomY\*q. > +.TP 4 > +.B \*qWacom Rotation\*q [0 | 1 | 2 | 3] > +One 8-bit value in the range of 0-3, with 0 for no rotation, 1 for > +90 degrees clockwise, 2 for 90 degrees counter-clockwise, 3 for 180 > +degree (upside-down) rotation. See > +.B Option \*qRotation\*q.
The definition of rotation has always seemed backwards to me, so it may be a good idea to clarify just *what* is rotating. I'm eternally choosing the wrong option for both the Wacom driver and the Gnome monitor preferences because I think "clockwise rotation" refers to the device, not the transformation. > +.TP 4 > +.B \*qWacom Serial IDs\*q tablet ID, old serial, old hw id, current serial > +Four 32-bit values describing the current tablet and tool. The tablet ID is > +the ID of the physical tablet. Old serial and current serial are the serial > +numbers of the most recently tool or the currently used tool, respectively. > +The number 0 is equivalent to "unknown" or "no tool". > +FIXME: what's the hw id? > +This is a read-only property. > +.TP 4 > +.B \*qWacom Serial ID binding\*q id > +One 32-bit value with the serial ID this device should respond to. See > +.B Option \*qSerial\*q. > +.TP 4 > +.B \*qWacom Strip Buttons\*q left-up, left-down, right-up, right-down > +Four values. If the values are 8 bit integers, the values correspond to the > logical > +button mappings of the strip actions for the left and right strip, > +respectively. If the values are 32 bit Atoms, the values correspond to the > +complex button mapping sequence defined in the respective atom. See section > +.B Complex Button Mappings. > +.TP 4 > +.B \*qWacom Wheel Buttons\*q rel wheel up, rel wheel down, abs wheel up, abs > wheel down > +Four values, corresponding to the up/down movement of the relative wheel (if > +any) and the absolute wheel (if any). See > +.B Wacom Strip Buttons > +for a description of the values. > +.TP 4 > +.B \*qWacom Proximity Threshold\*q threshold > +One 32-bit value. See > +.B Option \*qCursorProx\*q. > +.TP 4 > +.B \*qWacom Pressure Threshold\*q threshold > +One 32-bit value. See > +.B Option \*qThreshold\*q. > +.TP 4 > +.B \*qWacom Sample and Suppress\*q sample,suppress > +Two 32-bit values. See > +.B Option \*qRawSample\*q > +and > +.B Option \*qSuppress\*q. > +.TP 4 > +.B \*qWacom Enable Touch\*q bool > +One 8-bit boolean value. See > +.B Option \*qTouch\*q. > +.TP 4 > +.B \*qWacom Enable Touch Gesture\*q bool > +One 8-bit boolean value. See > +.B Option \*qGesture\*q. > +.TP 4 > +.B \*qWacom Enable Touch Gesture Parameters\*q zoom, rotate, tap parameters > +Three 32-bit values. See > +.B Option \*qZoomDistance\*q, > +.B Option \*qScrollDistance\*q, > +and > +.B Option \*qTapTime\*q. > +.TP 4 > +.B \*qWacom Hover Click\*q bool > +One 8-bit boolean value. If enabled, the stylus tip does not have to touch > +the tablet to allow for button clicks on the stylus. If disabled, button > +clicks are only sent when the tip is touching the tablet. > +See > +.B Option \*qTPCButton\*q. > +Note: the behaviour of this property is the inverse of the "TPCButton" > +option. > +.TP 4 > +.B \*qWacom Tool Type\*q > +One 32-bit Atom. The value is the Atom which's name describes the tool type s/which's/whose/ > +of this device. Currently used tool types are "STYLUS", "CURSOR", "ERASER", > +"PAD", and "TOUCH". > +This property is read-only. > +.TP 4 > +.B \*qWacom Button Actions\*q action 1, action 2, ... > +X 32-bit Atoms where X is the number of physical buttons on this device. > +The first value maps to the first button, the second value to the second > +button, etc. Each value corresponds to an action sequence as described in > +.B Complex Button Mappings. > +If an action is None, no action is performed for this button. This can easily be misunderstood since the word "action" is overloaded here. Reading through this without knowledge of the overloaded meaning would indicate that none of the buttons on my tablet should work since all of their actions are 'None' :) Not sure of the best way to reword it though... Jason --- Day xee-nee-svsh duu-'ushtlh-ts'it; nuu-wee-ya' duu-xan' 'vm-nvshtlh-ts'it. Huu-chan xuu naa~-gha. > +.TP 4 > +.B \*qWacom Debug Levels\*q tool, tablet > +Two 8-bit values specifying the debug level for tool-specific messages and > +tablet-specific messages, respectively. See > +.B Option \*qDebugLevel\*q > +and > +.B Option \*qCommonDBG\*q. > +The presence of this option depends on a compiler flag. > + > +.SS Deprecated Properties > +The following properties are deprecated and do not work in this driver > +version. > +.TP 4 > +.B \*qWacom TwinView Resolution\*q > +.TP > +.B \*qWacom Display Options\*q > +.TP > +.B \*qWacom Screen Area\*q > +.TP > +.B \*qWacom Capacity\*q > + > +.SS Complex Button Mappings > +This driver supports button mappings that go beyond simple physical button - > +logical button mapping. If defined, a button, strip or wheel event may > +generate a sequence of button or key events. These 32-bit action sequences > +are stored properties referenced by the respective configuration property. > +Each value's low 16 bit specify the event code, the high 16 bit specify the > +event type. For an event type of AC_KEY, the lower 16 bit specify the > +key code. For an event type of AC_BUTTON, the lower 16 bit > +specify the logical button number. See Xwacom.h for more details. > + > .SH "SEE ALSO" > __xservername__(__appmansuffix__), xorg.conf(__filemansuffix__), > xorg.conf.d(__filemansuffix__), X(__miscmansuffix__) > -- > 1.7.6 > ------------------------------------------------------------------------------ uberSVN's rich system and user administration capabilities and model configuration take the hassle out of deploying and managing Subversion and the tools developers use with it. Learn more about uberSVN and get a free download at: http://p.sf.net/sfu/wandisco-dev2dev _______________________________________________ Linuxwacom-devel mailing list Linuxwacom-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/linuxwacom-devel
