	Transform Reference Guide
User Guide \| Transform Guide \| OSW on the Web

input::Wacom [Help Patch]

Wacom tablet input driver

Syntax

Wacomoptions

Options

-name: Optional user-defined name for the transform
-tablet: Specify which tablet to use; Type: Integer; Default: 0
-name: name of selected tablet device; Type: String; Default: "default tablet"

Inlets

tick: Get state of tablet now.; Type: Unit

Outlets

altitude: Tilt of the pen; Type: Integer
x: X (horizontal) position.; Type: Integer
tangent_pressure: Tangent, or barrel pressure; Type: Integer
pressure: pen pressure; Type: Integer
y: Y (vertical) position; Type: Integer
cursor: Cursor (i.e., pen, puck, etc.) being used; Type: Integer
azimuth: Azimuth, or rotion of pen about a verticle axis; Type: Integer
z: Z (?) position; Type: Integer
cursor_type: Type of cursor/device being used; Type: Integer
twist: not quite sure what this is; Type: Integer
buttons: State of buttons on pen/puck; Type: Integer

State Variables

tablet: Specify which tablet to use; Type: Integer; Default: 0
name: name of selected tablet device; Type: String; Default: "default tablet"

Comments

If you have more than tablet device, use the tablet option to select a particular device.

Some of the features may not be available (or always return zero) depending on the tools and the capabilities of your tablet. For example, tangent_pressure is only useful with airbrush tools, and altitude and azimuth are available on pens with ArtZ, Intuos and Intuos 2 devices (but not Graphire tablets).

The Wacom transform polls the tablet each time it receives a unit value via its inlet. Thus, attaching a Ticker transform to the inlet allows periodic polling of the device. To change the responsiveness, adjust the interval of the ticker. The recommended interval for good responsiveness is 10ms (i.e., set the interval of the Ticker to 0.01).

The name "Wacom" is a trademark of Wacom Technology Co.

Note: The Wacom transform is currently only available on Windows platforms.

Announcement / Credits

Wacom: OSW Interface to Wacom Tablet Driver for Windows NT/98/95. (c) 2001-2002 Amar Chaudhary. (c) 1999-2001 Regents of the University of California. \"Wacom\" is a registered trademark of Wacom Technology Co.

Copyright / Licence

Copyright (c) 2001 Amar Chaudhary. All rights reserved.
Copyright (c) 1998-2001 Regents of the University of California.
All rights reserved.

     ``The contents of this file are subject to the Open Sound World Public
     License Version 1.0 (the "License"); you may not use this file except in
     compliance with the License. A copy of the License should be included
     in a file named "License" or "License.txt" in the distribution from 
     which you obtained this file. 

     Software distributed under the License is distributed on an "AS IS"
     basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
     License for the specific language governing rights and limitations
     under the License.

     The Original Code is Open Sound World (OSW) software.

     The Initial Developer of the Original Code is Amar Chaudhary.
     Portions created by Amar Chaudhary are Copyright (C) 1998-2001 
     Regents of the University of California and Amar Chaudhary. 
     All Rights Reserved.

     Contributor(s):



From the UC Regents:

Permission to use, copy, modify, and distribute this software and its
documentation, without fee and without a signed licensing agreement, is hereby
granted, provided that the above copyright notice, this paragraph and the
following two paragraphs appear in all copies, modifications, and
distributions.  Contact The Office of Technology Licensing, UC Berkeley, 2150
Shattuck Avenue, Suite 510, Berkeley, CA 94720-1620, (510) 643-7201, for
commercial licensing opportunities.

Written by Amar Chaudhary, The Center for New Music and Audio Technologies, 
University of California, Berkeley.

     IN NO EVENT SHALL REGENTS BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT,
     SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST
     PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS
     DOCUMENTATION, EVEN IF REGENTS HAS BEEN ADVISED OF THE POSSIBILITY OF
     SUCH DAMAGE.

     REGENTS SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT
     LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
     FOR A PARTICULAR PURPOSE. THE SOFTWARE AND ACCOMPANYING
     DOCUMENTATION, IF ANY, PROVIDED HEREUNDER IS PROVIDED "AS IS".
     REGENTS HAS NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES,
     ENHANCEMENTS, OR MODIFICATIONS.

Transform Reference Guide