UPVIEW --- a X-Windows tool for viewing UNIPEN files

SYNOPSIS

upview [options] file [files]

DESCRIPTION

Using the tool upview, a number of UNIPEN files can be viewed. It is an efficient tool for quickly visually inspecting a large number of files. Upview displays pieces of handwriting on a certain hierarchy level, arranged in a number of rows and columns (see e.g. upview.gif). Upview recognizes command-line arguments, reads two resource files and can be controlled dynamically via a graphical user-interface. When using upview, two environment variables have to be set (see general environment settings).

When starting up, upview reads a resource file ~/.upview. This file contains resources which control the layout of the graphical window, comprising e.g. ink color and fonts for labels and buttons. If the file does not exist, it will be created as:

     Box=dark slate blue
     Button=black
     FlashBox=blue
     CrossBox=medium slate blue
     SetupBox=yellow
     Ink=firebrick
     Air=yellow
     Text=dark slate blue
     ButtonText=dark slate blue
     BackGround=light grey
     ButtonFontName=fixed
     SmallFontName=-ADOBE-NEW CENTURY SCHOOLBOOK-BOLD-R-NORMAL--*-100-*-*-P-*
     BigFontName=-ADOBE-COURIER-BOLD-R-NORMAL--*-120-*-*-M-*
     HugeFontName=-ADOBE-COURIER-BOLD-R-NORMAL--*-240-*-*-M-*

OPTIONS

  -f file   the UNIPEN definition file (default=unipen.def)
  -W width  (default=850)
  -H height (default=770)
  -p N      PenDown pressure criterion, e.g., -p 0 inks all p>0
  -c N      number of columns in display, e.g., -c 3
  -i N      line thickness of Ink in X11 pixels, e.g., -i 4
  -h N      requested hierarchy level (differs per file),
            e.g., -h 0 is top level
  -B        biggest chunk size determines all scaling
  -S        setup .X_DIM/.Y_DIM determines all scaling
  -O        optimal scaling per chunk (periods and comma's are inflated)
  -Y        multiply Y channel by -1
  -U        also show .PENUP signal
  -V        display (pseudo)velocity for digitizer assessment

USAGE

When starting upview, a graphical window will be displayed, (like upview.gif). At the top of the window, the current filename and hierarchy are indicated. At the left of the window, a number of boxes are arranged in rows and columns. Each box is a container for a UNIPEN .SEGMENT entry at the hierarchy selected. At the right of the window, a number of buttons are displayed:

PrevFile
If more than one files are given at the command line, and it is not the first file that is being displayed, uptools loads the previous file in the list. Else a beep is issued.
NextFile
If more than one files are given at the command line, and it is not the last file that is being displayed, uptools loads the next file in the list. Else a beep is issued.
MoreInk
Increases the line thickness with which ink is being displayed.
LessInk
Decreases the line thickness with which ink is being displayed.
Zooming involves that the number of columns is changed, which gives the counter-intuitive result that some boxes depicted may dissapear from view.
ZoomIn
Reduces the number of columns being displayed by 1, thus zooming in.
ZoomOut
Increases the number of columns being displayed by 1, thus zooming out.
Down
Scrolls the display one row down.
Up
Scrolls the display one row up.
Opt. Scale | Same Scale | Tablet Scale
Changes the scaling of the segments displayed. Opt. Scale tries to fit each segment maximally in the box. Same Scale scales all segments equally, and can be used to compare different segments. Tablet Scale can be used if the dimensions of the tablet are available in the UNIPEN file currently being displayed. These dimensions are given by, e.g.:
```
.X_DIM 9700
.Y_DIM 7250
.V_LINE 1100 7050
.H_LINE 2876 3426 4076
```
Add Velocity | No Velocity
Shows or removes the velocity signal for each segment.
No Tapering | Tapered
Tapering is a gradual diminution of thickness. This effect can be used to indicate the start of a segment.
Filled Lines | Open Lines
Changes the way in which lines are displayed. Filled lines are solid. Open lines allow showing of sample points, like in upview.gif.
No Sample Dots | Sample Dots
Shows are removes sample points for each segment.
Hidden PenUp | Show PenUp
Shows or removes the hidden pen-trajectories for each segment.
Print
Saves the current display to upview-xx.ps in postscript format.
Quit
Exits the application.

AUTHORS

Louis Vuurpijl

Lambert Schomaker

Back to the uptools3 homepage

Page last updated on Fri Mar 14 12:18:15 MET 1997
You are visitor

Generated by htmlize at Fri Nov 14 12:31:55 1997 Louis Vuurpijl