Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

calcomp(7) [osf1 man page]

calcomp(7)						 Miscellaneous Information Manual						calcomp(7)

NAME
calcomp, tablet - Configuring a CalComp graphics tablet DESCRIPTION
This reference page provides information about how you configure a CalComp DrawingBoard III tablet, an input device supported by the Xinput extension to the Xserver. When the software for the tablet is installed on your system, you can configure it to emulate a system mouse. Other similar devices can be configured the samw way, but only the CalComp DrawingBoard III has been verified. Configuring the X Environment If you intend to use the CalComp DrawingBoard III tablet software, you must edit the file /usr/var/X11/Xserver.conf to turn on support for the X Input extension. To do this, remove the comment characters surrounding the following lines: input _dec_xi_db3 lib_dec_xi_db3.so XiDb3Init /dev/tty00:1:12:12:16: 1:8:1000:1:1 > > The backslash in this example indicates line continuation and is not in the actual display. You should also review these lines to ensure that the options specified for the tablet are correct, especially for the tty (logical COMM port) that is specified as the serial port, where the tablet is connected to your system. The last line of the /usr/var/X11/Xserver.conf file has the following syntax: device:mode:tabletWidth:tabletHeight:numbtns:core- Pointer:mouseScale: resolution:Xincrement:Yincrement The backslash in this example indicates line continuation and is not in the actual display. The following list can help you determine how to set up the entries for the tablet in the /usr/var/X11/Xserver.conf file: The port (tty) to which the device is connected. The default is tty00. This should be set to 1 for absolute motion. Width of the active tablet area in inches, not the physical size. The default is 12. Height of the active tablet area in inches, not the physical size. The default is 12. Number of buttons on the puck or pen. The maximum number is 16 and the default is 16. 0 indicates a native tablet mode (no system mouse). 1 indicates emulate core pointer (the mouse and tablet are both core pointer devices. The default is 1. 1 to 50 scaling factor in relative mode. Determines the speed of the cursor; the higher the number, the slower the cursor moves. The default is 8. 1 to 2540 lines per inch (lpi). The default is 1000. How much the X axis must be incremented to cause the tablet to send new coordinates to the Xserver. The range is 0 to 65536. The default is 1. How much the Y axis must be incremented to cause the tablet to send new coordinates to the Xserver. The range is 0 to 65536. The default is 1. The device option is required and specifies which tty device should be associated with the tablet. By default, the installation software assigns the CalComp DrawingBoard III tablet to tty00, which you may want to change if that tty is already allocated. For information on how to determine which serial port your tablet is connected to, see the hardware documentation that was shipped with your processor. Note that when the stylus or puck is moved as far as the minimum Xincrement or Yincrement value, the value of the corresponding axis is updated. For example, if the Xincrement value is set to 10 and the tablet is moved 10 units along the X axis, the value of the Y axis will also be updated simultaneously with the X axis, even if the Yincrement value has not been reached. Keep this in mind when setting the Xin- crement and Yincrement options. Configuring the Tablet into the X Server After you have configured the /usr/var/X11/Xserver.conf file, you must follow these steps to turn on support for the tablet in the Xserver: Plug the tablet into your system and turn it on. Enter the following command to restart the Xserver so that the Xinput extension can rec- ognize the tablet: # /usr/sbin/shutdown -r +5 "Turning on support for the Calcomp Drawingboard III tablet" (The backslash in this example indicates line continuation and is not in the actual display.) When the system comes back up, the tablet will be configured into the Xserver and ready to use. When the Xserver first accesses the tablet, it performs some hardware-specific initialization that can be saved in the on-board memory of the tablet. To save these settings, follow these steps: Press the EXIT CONFIG button on the tablet's menu. Under the SAVE button, press the DEFAULT button. Press the EXIT CONFIG button to save the settings. RESTRICTIONS
The following notes and restrictions apply to the CalComp DrawingBoard III tablet: If the puck or stylus is not used within a 5 minute period, the tablet will automatically shut off. To reactivate it, press any button on the puck or stylus while they are in close proximity to the tablet. If you configure the tablet as the system's core pointer, moving the puck and the system mouse simultaneously will cause the cursor to move in an unpredictable fashion. Use only one puck or stylus at a time. If you try to use both input devices simultane- ously, you will encounter unpredictable behavior. Manual configuration of the tablet via the tablet buttons is not supported. If you try to use these buttons to configure the tablet, the Xserver will malfunction and may even crash. If you need to reconfigure the tablet, edit the /usr/var/X11/Xserver.conf file and then reboot the Xserver. You can modify some parts of the tablet setup by programming the Xinput extension. For more information on how to do this, see the XInput specification provided by the X Consortium. FILES
The X server configuration file, in which the tablet is defined. RELATED INFORMATION
Xserver(1X), dc(7), scc(7), ports(7), tty(7), delim off calcomp(7)
Man Page