.TH TMVIEW  1 "1 June 1999"
.SH NAME
tmview, dvisvga, dvilx \- view DVI files on SVGA or X Window displays
.SH SYNOPSIS
\fBdvi\fP[\fBsvga\fP|\fBlx\fP] 
[\fB\-?\fP] 
[\fB\-h\fP<\fImarg\fP>] 
[\fB\-v\fP<\fImarg\fP>]
[\fB\-p\fP<\fIwidth\fP>\fBx\fP<\fIheight\fP>]
[\fB-r\fP<\fBxres\fP>\fBx\fP<\fIyres\fP>] 
[\fB\-f\fP<\fIpath\fP>]
[\fB\-n\fP<\fIname\fP>] 
[\fB\-t\fP<\fIpath\fP>]
[\fB\-g\fP<\fIpath\fP>]
[\fB\-d\fP<\fIwidth\fP>\fBx\fP<\fIheight\fP>] 
[\fB\-m\fP<\fImag\fP>]
[\fB\-k\fP<\fIleftmarg\fP>\fI,\fP<\fIrightmarg\fP>\fI,\fP<\fIuppermarg\fP>\fI,\fP<\fIlowermarg\fP>]
[\fB\-s\fP<\fIstartup-file\fP>] 
[\fBfile\fP[\fB.\fP[\fBdvi\fP]]
.SH DESCRIPTION
\fBtmview\fP is a screen-previewer for \fB.dvi\fP-files generated by
\fBTeX\fP.
It lets you see what your printed output will look like.
You can choose between a black-and-white representation and greyscaling. You can
choose an arbitrary zoomfactor.
You can set marks to measure distances.
You can search for textstrings.
\fBtmview\fP does
not support \fBpxl\fP-files since I think they are prehistoric. \fBtmview\fP
ignores almost all special-commands, sorry lads.
There is basic support for .vf-files.
If there occur any problems with this, use \fBdvicopy\fP to get a .vf-free .dvi-file.
\fBtmview\fP tries its best with included .eps-figures.
\fBdvisvga\fP is a version of \fBtmview\fP based on \fBsvgalib\fP for use with (s)vga equipment.
\fBdvilx\fP goes with the \fBX\fP Window System.

Try
\fBdvisvga\fP/\fBdvilx\fP \fB-?\fP to get a complete list
of command-line options and their default-values.


.SS ONLINEHELP
Pressing <\fB?\fP> twice shows the onlinehelp and gives a list of available
commands. However, you may check the cursor-keys and <\fB+\fP>/<\fB-\fP> first ...
or use <\fBq\fP> to quit.
.SS IMPORTANT
All options have to be followed \fBIMMEDIATELY\fP by their arguments,
\fBNO spaces\fP must be inserted !!!
.SS OPTIONS
.TP
\fB-h\fP (\fBhorizontal-offset\fP)
A lot of printer drivers do a horizontal offset of 1 inch. If yours does as
well, you should use \fB-h25.4\fP. The length following \fB-h\fP must be
given in mm. Default: "25.4"
.TP
\fB-v\fP (\fBvertical-offset\fP)
A lot of printer drivers do a vertival offset of 1 inch. If yours does as
well, you should use \fB-v25.4\fP. The length following \fB-v\fP must be
given in mm. Default: "25.4"
.TP
\fB-p\fP (\fBPaper-size\fP)
Tells \fBtmview\fP width and height of the paper you are using. The width
is given first and both width and height are given in mm. Width and height
are seperated by an "x". Default: "210.0x297.0" (german DIN A4)
.TP
\fB-r\fP (\fBResolution\fP)
Tells \fBtmview\fP what kind of pk-files to use. The horizontal resolution
is given first and both horizontal and vertical resolution are given in dpi
(dots per inch). The two values are seperated by an "x". Saying
\fB-r600x600\fP means \fBtmview\fP will use fonts which were generated for a
600-dpi-printer. As \fBtmview\fP assumes that pixels on the screen are
square, different values for horizontal and vertical resolution will result
in a distorted image. Always make sure the desired pk-files are available.
The chosen resolution determines the (maximum) size of the representation.
Default: "300x300"
.TP
\fB-f\fP (\fBFont-path\fP)
A list of paths telling \fBtmview\fP where to look for the pk-files. The
items in this list have to be seperated by \fB:\fP's. The given list is
executed from left to right. If an item ends with \fB//\fP all
subdirectories will be scanned too. This is programed in a very odd way, so
it takes lots of time. You should place such items at the end of the list.
Defaults: "./:/usr/lib/texmf/fonts//".
.TP
\fB-n\fP (\fBName-of-the-font-file\fP)
If your dvi-file tells \fBtmview\fP to use a font called "thisnthatfont"
and \fBtmview\fP was told to use a resolution of "123" dpi, \fBtmview\fP
has to know how the desired file is named. In the string following "-n" the
following replacements are made: 
.PP
.PD 0
		xx	replaced by
.PP
		@N	thisnthatfont
.PP
		@K	thisntha
.PP
			(this is @N reduced to 8 char. (MS-DOG !))
.PP
		@M	123
.PP
			(the resolution)
.PP
		@R	615
.PP
			(this is @M*5, intended for magnified 200 
.PP
			 dpi fonts used instead of 300 dpi fonts)
.PD 1
.TP
	  Defaults: "@N.@Mpk"
.TP
\fB-t\fP (\fBtfm-path\fP)
A list of paths telling \fBtmview\fP where to look for the tfm-files. The
items in this list have to be separated by \fB:\fP's. The given list is
executed from left to right. tfm-files are used, to figure out the
encoding. Therefore they are essential for searching text to work.
Defaults: "./:usr/lib/texmf/fonts//".
.TP
\fB-g\fP (\fBvf-path\fP)
A list of paths where to look for vf-files. Defaults: "./:usr/lib/texmf/fonts//".
.TP
\fB-d\fP (\fBDisplay\fP)
Size of the window when starting up (\fBdvilx\fP) or
desired resolution of your display (\fBdvisvga\fP). The width is
given first and both width and height are given in pixels. Width and height
are seperated by an "x". Using svgalib you may  choose a resulution
supported by your version with respect to your hardware. 
\fBdvisvga\fP prefers 256-color-modes. Hence, to get more than 320x200 an
super vga chipset supported by svgalib is required, standard vga wont do.
If the desired resolution is not available, \fBdvisvga\fP falls back to
640x480 at 256 colors, then to 640x480 at 16 colors.
Defaults: (dvisvga) "640x480"
.TP
\fB-m\fP (\fBmagnification\fP)
If you want to magnify by a factor n you have to specify n*1000 as an
argument to \fB-m\fP, e.g. \fB-m2000\fP means all lengths will be doubled.
\fBNOTE: tmview\fP magnifies according to the origin of the dvi-coordinates,
which is -in most cases- NOT the upper left corner of the paper. Always make
sure the desired pk-files are available. \fB-m\fP doesn't magnify the paper,
so if you wish a larger image use the \fB+\fP and \fB-\fP keys or the
\fB-r\fP option. Default: get magnification from dvi-file.
.TP
\fB-k\fP (\fBkannot-print-any-further\fP)
Most printers stop printing if they are too close at the papers edge (some
might even do strange things). The \fB-k\fP option describes the printable
area, e.g. saying \fB-k1.0,2.0,3.0,4.0\fP means that your printer can print
as close as 1 mm to the left 2 mm to the right 3 mm to the upper 4 mm to the
lower edge of the paper. These values are used to draw a frame indicating
the printable area. All four values have to be given
and they have to be seperated by ",". All lengths are given in mm. Default:
"4.0,4.0,4.0,12.0"
.TP
\fB-s\fP (\fBstartup-file\fP)
\fBtmview\fP reads default values for the commandline-options,
a list of visited dvi-files and lots of other interna from
a system startup-file, typically "/etc/dvisvga" or "/etc/dvilx".
After this a user startup-file is read. The name of the latter
can be  specified directly after the \fB-s\fP.  
When quitting \fBtmview\fP, the current options etc. will be saved in the
user startup-file.
\fBIf this is not desired, the user startup-file has to be set read-only !!\fP
However, \fBtmview\fP will never write to the system startup-file.
The default for the user start-upfile is "~/.dvisvga" or "~/.dvilx".


.SH COPYING 

The code of \fBtmview\fP uses some rather basic ideas stolen from
\fBxdvi\fP. This includes some few lines of code just copied. The author of
\fBxdvi\fP is \fBEric Cooper\fP. In a similar kind, \fBtmview\fP's code
depends on some lines of \fBdvidjc\fP, written by \fBWolfgang R.Mueller\fP.
The hyper-TeX related parts are taken from
\fBxhdvi\fP, written by \fBArthur Smith\fP. 
The sources of the above
can be found on the \fBCTAN\fP. So by having mentioned
the authors here, and giving a reference how to get the original sources,
this should not be a violation of their copyrights. 

As far as I am concerned, \fBtmview\fP may be modified or distributed
without any restrictions. \fBtmview\fP is distributed in the hope that it
will be useful, but without any warranty.
.SH AUTHOR
(C)opyright 1995 Thomas Moor (QElis@aol.com)