Table of Contents

Overview

Minimum Requirements

To run the program

Using the program

Window Preferences

FAQ

Overview

TrackMotion Program is a java program that uses an open source library JPen to track a pen over a tablet. We use the same pen but attached on top of a finger to track the finger as its moves over the tablet. The program tracks a finger x,y coordinates, finger i.d. and the time from the start of recording.

We use the program to analyze how a visually impaired user uses a tactile map as explained in this paper.

To see how to build this program please read our tech documentation.

top

Minimum Requirements

CPU: Intel Pentium III
RAM: 128MB
OS: Windows XP, Mac OS 10.5, Linux
Java RE 1.6
Latest tablet software

top

To run the program

Navigate to the folder with the program and double-click trackmotion.jar to run it.

You can also run the program on the command line by typing java -jar trackmotion.jar

top

Using the program

Most of the high end tablets comes with software that allows you to map the tablet active area to our program's active area. Our program provides the coordinates needed to do the mapping. Either press CTRL+W or click on View -> Window Config

Windows:

Mac:

Select a background image in .SVG format that will represent the map that the user will move their finger on. We use .SVG format because the image will keep its aspect ratio even after the window is stretched. To select a map click on File -> Open Background File. An example of Gresham, OR is in the maps folder.

Windows:

Mac:

Before recording press CTRL-S or click on File -> Open Output File and then fill in the filename to save the XML data file to location of your choice. Once you do that the black border will turn red.

Windows:

Mac:

Once file is select you can select which finger you are tracking. Using CTRL-1, CTRL-2, ... to pick the finger or use the finger selection window.

Windows:

Mac:

Once finger is selected you can start recording by pressing SHIFT+ENTER or click on Record -> Record in Progress. To pause press SHIFT+ENTER again. When recording border will be green and when paused it will be red.

Windows:

Mac:

Once done recording close the file by pressing CTRL-C or click on File -> Close Output File and then you can close the program by pressing CTRL-Q or click File -> Quit.

top

Window Preferences

The program window can be moved around the window, it can be stretched to any size. We also provide you options:

Full Screen: CTRL+F or View -> Full Screen
Default Size: CTRL+D or View -> Default Size

The changes you make to the window are correctly represented in the Windows Config information box and when the user exits the program it will save that state so that when the user opens the program again it will restore to the last state.

You can also clear the data on the screen by clicking on View -> Clear Panel

top

FAQ

Q. I doubled-click the program but nothing happened?

A. Check whether your Java version is 1.6. You can do this my going to command line or terminal and type java -version

Q. When I pause the recording the path drawn on the screen disappears?

A. Our program is more geared to storing the finger movement in an xml file. Right now we are not storing the path data that is displayed on the screen so you will see the data disappear. In the next version if we do store the path data more test will needed to be done related to efficiency of the program with large data sets.

Q. The Windows Config information box shows negative numbers but the tablet control panel doesn't allow negative numbers?

A. If you are using a dual-monitor setup with your desktop extended onto the secondary monitor you can have negative values because your operating system allows you to extend your desktop up, down, left, right. The primary monitor is treated as the origin so if the secondary monitor is up or left of the primary monitor you will negative x,y values because the primary monitor's top,left corner starts at (x,y) being 0,0

top