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

cnmat::WacomRouter [Help Patch]

Routes incoming messages to different variables according tool and attribute

Syntax

WacomRouter options

Options

Inlets

State Variables

Comments

Connecting this transform to the outputs of a Wacom transform routes messages to different variables according to tool and attribute. For example, if you have a pen as your primary tool, it will route different attributes to variables named /wacom/0/pen/x, /wacom/0/pen/y, etc. when you are using the pen. If you switch to the eraser, the messages will be routed to /wacom/0/eraser/x, /wacom/0/eraser/y, etc. If your secondary tool (i.e., the second tablet tool you use) is a puck or mouse, the messages will be routed to /wacom/1/puck/x, /wacom/1/puck/y, etc.

For each tool n, the following variables are available:

Pen:
/wacom/n/pen/x
/wacom/n/pen/y
/wacom/n/pen/buttons
/wacom/n/pen/pressure
/wacom/n/pen/tangent_pressure
/wacom/n/pen/azimuth
/wacom/n/pen/altitude
Pen Eraser:
/wacom/n/eraser/x
/wacom/n/eraser/y
/wacom/n/eraser/buttons
/wacom/n/eraser/pressure
/wacom/n/eraser/azimuth
/wacom/n/eraser/altitude
Mouse/Puck
/wacom/n/puck/x
/wacom/n/puck/y
/wacom/n/puck/y
/wacom/n/puck/buttons
/wacom/n/puck/twist

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).

See Also

Wacom

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.
Open Sound World User Guide
© 2000-2004 Amar Chaudhary. All rights reserved.