On Sun, Aug 21, 2011 at 4:17 PM, Peter Hutterer
<[email protected]> wrote:
> On Tue, Aug 16, 2011 at 10:36:17AM -0700, Jason Gerecke wrote:
>> On Mon, Aug 15, 2011 at 8:03 PM, Peter Hutterer
>> <[email protected]> wrote:
>> > Signed-off-by: Peter Hutterer <[email protected]>
>> > ---
>> > 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.
>
> uhmm, how embarrassing, I never noticed that. is this a bug recently
> introduced or was this always there? looking at some old linuxwacom code I
> think this is the traditional behaviour.
>
Yeah, this has been around for a long time. I'm not sure if it's ever
been "correct", though I only started using the rotation settings
shortly after joining.
> fixes to bring this in-line with gnome's behaviour which as you said is the
> more intuitive one:
Actually, Gnome behaves the same way as xsetwacom currently does. I
need to set both to "clockwise", despite my Cintiq being physically
rotated 90 degrees to the left. Its for that reason I thought it might
just be me that is backwards :)
Looking at some man pages, it seems that xrandr defines rotation in
terms of the transformation ("This causes the output contents to be
rotated in the specified direction"). I imagine that Gnome is simply
pulling the normal/left/right/inverted value and rewording it to their
circular cousins normal/clockwise/anti-clockwise/180-degrees. I'd
suspect Gnome did some usability analysis, but it could also simply be
an oversight on their part. Perhaps they should be pinged as well?
> - update the documentation for the property to simply state it the other way
> round
> - update the in-driver defines
> - add new rotation parameters to xsetwacom for "clockwise" and
> "counterclockwise", while leaving the old ones as-is (for now, anyway)
> - display a warning message for the old ones
>
> makes sense?
>
That sounds reasonable to me, though it may be confusing that "CW" and
"clockwise" do different things :) I suppose there's not much that can
be done about it though... I'd be sure to change the xsetwacom man
page definition of CW/CCW while these are both around to make it clear
that the "old" way referred to the transformation (despite what the
docs indicated before) and the new way to the physical rotation (this
time for real).
Jason
---
Day xee-nee-svsh duu-'ushtlh-ts'it;
nuu-wee-ya' duu-xan' 'vm-nvshtlh-ts'it.
Huu-chan xuu naa~-gha.
------------------------------------------------------------------------------
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
[email protected]
https://lists.sourceforge.net/lists/listinfo/linuxwacom-devel
