UGTablet.usbfd

Version 1.8

This is a driver for UGTABLET  based Graphics Tablets. 

It has been specifically tested with the XP-Pen Deco01 Tablet. Other tablets
with the same ID
*should* work.


Andy

andy()broad.ology.org.uk




Installtion
-----------

copy UGTablet.usbfd to devs:usb/fd/

copy UGTablet.fdclass to devs:usb/fdclasses/

Try C:USBCtrl RESTART to load the driver, then insert your tablet in a usb slot.

Features
--------

The driver supports absolute X and Y positions, pen pressure and tilt in the X &
Y axes.
The driver also supports the eight buttons by default mapping them to the
Function keys 
F1 through F8

 
Usage
-----

The driver now has a configuraion GUI which is hidden by default by works as a
commodity so
can be brought up by pressing 'ctrl alt t'  or via Exchange.

The GUI has two sides, the left shows the current position and pressure (in
tablet coords)
and below that the maximum values that have occured during this session. The
right hand side
shows the current settings, the range of tablet coords that are mapped onto the
scrren and
the value of the pressure for maximum.

In the centre there is an area for pressure testing. The current X and Y coords
will be
shown any where on the screen, but the current pressure will only be shown when
pressing on
the test area.

You can move the pen  arround and press on the nib to find the maximum values,
then copy them
to the settings, or choose a smaller area if you prefer. You might want to do
that if you screen
 has a different aspect to your tablet, otherwise generally you will want the
maximums.

Beneath the pressure test area is a group of 7 sliders, these enable you to
create a pressure
sensitivity profile. The deafult is alinear just diagonal straight line. If you
make the line curve 
above the diagonal  you increase the sensitivity at lower presssures and if it
curves below sensitivity
decreases at lower pressure. If you slant the diagonal the other way then you
invert the pressure so that
a light touch acts as if hard. Beware this is very useful in some situation but
some apps may not like it
at all! 


You can also choose whether to send NEWTABLET (recomended) or the old TABLET
(for compataility
with old apps). (having allowed this option so far most apps I've tried work
with NEWTABLET.)
Also you have the option to send additional RAWMOUSE events, which enable some
software such
as popupmenu.class (< 53.8) to see the pointer movements.


SAVE saves the settings and clses the window
USE uses them for the curent session only,
COPY MAXIMUMS coppies the max values recorded in that session for you.

The config is saved to the folowing environment variables:

UGTablet/Range_P
UGTablet/Range_Y
UGTablet/Range_X
UGTablet/Top_Y
UGTablet/Top_X
UCLOgicTablet/EventType
UGTablet/Send_RAWMOUSE
UGTablet/Switch_Buttons
UGTablet/Curve_0
UGTablet/Curve_1
UGTablet/Curve_2
UGTablet/Curve_3
UGTablet/Curve_4

Compatable Tablets (possibly)
-----------------------------

The following Tablets are reported to work with the same driver as my tablet
on linux, that means that there a reasonable chance they'll work with this
driver
or they may not. No guarentees....

The following have been reported to work on Amiga Forums:

XP-Pen Deco 01 (my tablet)
UGTABLET

these are reported to work on linux with the same driver as my tablets uses:




History
-------
 v1.8 -  5.Nov.2024 - When adjusting size of request to MaxPacketSize 
                      ensure it is still less than struct UGTalbletData
                      other wise bad stuff happens
   
 v1.7 - 19.Jun.2020 - Adapt UCLogic frame work for UGTablet
                      Replace all deprocated functions
                      Add support for X and Y Axes Tilt
                      Add support for the 8 buttons.

 v1.6 - 11.Feb.2012 - Add Pressure Sensistive Curve

 v1.5 - 16.Dec.2011 - Added full paths to gadget libraries, so that GUI is
always 
                      available at startup

 v1.4 - 18.Nov.2011 - Defered opening of reaction classes, till first GUI
                      Opening. Allows correct detection of tablet at boot.

 v1.3 - 10.Nov.2011 - Add option to send RawMouse events to enable popupmenus
                      to see the tablet pointer movements

 v1.2 - 8.Nov.2011 - Fixed problem with library expunge code.
                   - Added Option to swicth buttons 2 & 3 for
                     easier RMB support.


 v1.1 - 6.Nov.2011 - Added Configuration GUI. (ctrl alt t)

 v1.0 - 3.Nov.2011 - First version mouse placement and pressure work via
NEWTABLET interface.


Donations
---------

If this works for you, I'd like some feedback!

And if your really pleased I have a donation button at

www.broad.ology.org.uk/amiga/