On Mon, Mar 07, 2011 at 01:38:58PM -0600, Favux ... wrote:
> Hi Peter,
> 
> Made the suggested changes.
> 
> Favux

> From aafa3b221888cc8c97b244010842cbaa96ac5951 Mon Sep 17 00:00:00 2001
> From: David <favux...@gmail.com>
> Date: Mon, 7 Mar 2011 12:56:35 -0600
> Subject: [Patch v2 1/1] xsetwacom.man:  Add 5 parameters
> 
> Add Mode, PressureCurve, Rotate, TabletPCButton, and Threshold.  And other 
> changes.
> 
> Signed-off-by: David Foley <favux...@gmail.com>
> ---
>  man/xsetwacom.man |   66 
> ++++++++++++++++++++++++++++++++++++++++++++---------
>  1 files changed, 55 insertions(+), 11 deletions(-)
> 
> diff --git a/man/xsetwacom.man b/man/xsetwacom.man
> index 67f8439..05e3450 100644
> --- a/man/xsetwacom.man
> +++ b/man/xsetwacom.man
> @@ -66,7 +66,8 @@ Get the current settings for the parameter on the given 
> device. Note that
>  not all parameters are available on all device types. The special parameter
>  name "all" may be provided to display all current settings on the device.
>  .TP
> -By default, options are printed on the commandline in the respective format. 
> The output format may be altered with one of the following options:
> +By default, options are printed on the commandline in the respective format.
> +The output format may be altered with one of the following options:
>  .TP
>  \fB-s, --shell\fR
>  Display the output in shell format, i.e. as shell commands to xsetwacom to
> @@ -84,16 +85,20 @@ not all parameters are writable, some are read-only and 
> result in an error
>  when trying to be modified.
>  
>  .SH "PARAMETERS"
> +.LP
> +Not all parameters are available on all tools.  Use the get command with the
> +parameter or "all" parameter for specific input tool applicable parameters
> +and current settings.
>  .TP
>  \fBArea\fR x1 y1 x2 y2
> -Specify the tablet input area in device coordinates in the form top left
> +Set the tablet input area in device coordinates in the form top left
>  x/y and bottom right x/y. Top left and bottom right are defined in the
>  device's native orientation, regardless of the actual rotation currently
> -applied. Input outside of these coordinates will be clipped
> -to the edges of the area defined.
> +applied. Input outside of these coordinates will be clipped to the edges
> +of the area defined.  Default:  0 0 x2 y2; with x2 and y2 tablet specific.

btw, technically this is is a bug that just happens to not show up because
all tablets have 0/0 maxx/maxy. I've got patch in the pipe to undo the 0/0
requirement but not sure how to test this.

merged, thanks.

Cheers,
  Peter

>  .TP
>  \fBButton\fR button-number [mapping]
> -Get or set the specified button. The mapping may be a button number to map
> +Set the specified button. The mapping may be a button number to map
>  the physical button to. e.g. a mapping of button 1 to 3 means
>  a button 1 press will be interpreted as right click. Alternatively, a
>  mapping in the form of "key +a +shift b -shift -a" converts the button into 
> a series
> @@ -105,25 +110,64 @@ the keyboard layout changes.
>  Map the tablet's input area to the given output (e.g. "VGA1"). The output
>  must specify one of those available through the XRandR extension. A list of
>  outputs may be obtained with the xrandr tool. The output mapping
> -configuration is a once-off setting and does not track output
> +configuration is a onetime setting and does not track output
>  reconfigurations; the command needs to be re-run whenever the output
>  configuration changes. When used with tablet rotation, the tablet must be
>  rotated before it is mapped to the new screen.
>  This parameter is write-only and cannot be queried.
>  .TP
> +\fBMode\fR Absolute|Relative
> +Set the device mode as either Relative or Absolute. Relative means pointer
> +tracking for the device will function like a mouse, whereas Absolute means
> +the pointer corresponds to the device's actual position on the tablet or
> +tablet PC screen.  Default:  Absolute for stylus, eraser and tablet PC touch;
> +Relative for cursor and tablet touch.
> +.TP
> +\fBPressureCurve\fR x1 y1 x2 y2
> +A Bezier curve of third order, composed of two anchor points (0,0 and 
> 100,100)
> +and two user modifiable control points that define the curve's shape.  Raise
> +the curve (x1<y1 x2<y2) to "soften" the feel and lower the curve (x1>y1 
> x2>y2)
> +for a "firmer" feel.  Sigmoid shaped curves are permitted (x1>y1 x2<y2 or
> +x1<y1 x2>y2).  Default:  0 0 100 100, a linear curve; range of 0 to 100 for
> +all four values.
> +.TP
> +\fBRotate\fR none|half|cw|ccw
> +Set the tablet to the given rotation:
> +  none: the tablet is not rotated and uses its natural rotation
> +  half: the tablet is rotated by 180 degrees (upside-down)
> +  cw: the tablet is rotated 90 degrees clockwise
> +  ccw: the tablet is rotated 90 degrees counter-clockwise
> +
> +Rotation is tool-specific, rotation of one does not affect other input tools.
> +When the tablet is physically rotated, rotate all tools to the corresponding
> +orientation.  Default:  none
> +.TP
>  \fBTabletDebugLevel\fR level
>  Set the debug level for this tablet to the given level. This only affects
>  code paths that are shared between several tools on the same physical
>  tablet. A higher level means more fine-grained debug messages, a level of 0
>  turns debugging off for this tool. Requires the driver to be built with
> -debugging enabled. See also ToolDebugLevel.
> +debugging enabled. See also ToolDebugLevel.  Default:  0, range of 0 to 12.
> +.TP
> +\fBTabletPCButton\fR on|off
> +If on, the stylus must be in contact with the screen for a stylus side button
> +to work.  If off, stylus buttons will work once the stylus is in proximity
> +of the tablet (regardless of whether it is touching the screen).  Default:
> +on for Tablet PCs; off for all other models. 
> +.TP
> +\fBThreshold\fR level
> +Set the minimum pressure necessary to generate a Button event for the stylus
> +tip, eraser, or touch.  The pressure levels of all tablets are normalized to
> +2048 levels irregardless of the actual hardware supported levels.  This
> +parameter is independent of the PressureCurve parameter.  Default:  27,
> +range of 0 to 2047.
>  .TP
>  \fBToolDebugLevel\fR level
> -Set the debug level for this tool to the given level. This only affects code
> -paths that are specific to a given tool. A higher level means
> -more fine-grained debug messages, a level of 0 turns debugging off for this
> +Set the debug level for this tool to the given level. This only affects
> +code paths that are specific to a given tool. A higher level means more
> +fine-grained debug messages, a level of 0 turns debugging off for this
>  tool. Requires the driver to be built with debugging enabled. See also
> -TabletDebugLevel.
> +TabletDebugLevel.  Default:  0, range of 0 to 12.
>  
>  
>  .SH "AUTHORS"
> -- 
> 1.7.1

------------------------------------------------------------------------------
What You Don't Know About Data Connectivity CAN Hurt You
This paper provides an overview of data connectivity, details
its effect on application quality, and explores various alternative
solutions. http://p.sf.net/sfu/progress-d2d
_______________________________________________
Linuxwacom-devel mailing list
Linuxwacom-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/linuxwacom-devel

Reply via email to