dvifb(1)
NAME
tmview, dvisvga, dvifb, dvilx - view DVI files on SVGA, framebuffer devices or X Window displays
SYNOPSIS
dvi[svga|fb|lx] [-?] [-h<marg>] [-v<marg>] [-p<width>x<height>] [-r<xres>x<yres>] [-f<path>] [-n<name>] [-t<path>] [-q<path>] [-d<width>x<height>] [-m<mag>] [-k<leftmarg>,<rightmarg>,<uppermarg>,<lowermarg>] [-s<startup-file>] [file[.[dvi]]
DESCRIPTION
tmview is a screen-previewer for .dvi-files generated by TeX. 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. tmview does not support
pxl-files since I think they are prehistoric. tmview ignores almost all
special-commands, sorry lads. There is basic support for .vf-files.
If there occur any problems with this, use dvicopy to get a .vf-free
.dvi-file. tmview tries its best with included .eps-figures. dvisvga
is a version of tmview based on svgalib for use with (s)vga equipment.
dvifb is a version of tmview writing on the "/dev/fb0" framebuffer
devive. dvilx goes with the X Window System.
Try dvisvga/dvifb/dvilx -? to get a complete list of command-line
options and their default-values.
ONLINEHELP
Pressing <?> twice shows the onlinehelp and gives a list of available
commands. However, you may check the cursor-keys and <+>/<-> first ...
or use <q> to quit.
IMPORTANT
All options have to be followed IMMEDIATELY by their arguments, NO
spaces must be inserted !!!
OPTIONS
-h (horizontal-offset)
A lot of printer drivers do a horizontal offset of 1 inch. If
yours does as well, you should use -h25.4. The length following
-h must be given in mm. Default: "25.4"
-v (vertical-offset)
A lot of printer drivers do a vertival offset of 1 inch. If
yours does as well, you should use -v25.4. The length following
-v must be given in mm. Default: "25.4"
-p (Paper-size)
Tells tmview 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)
-r (Resolution)
Tells tmview 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 -r600x600 means tmview will use
fonts which were generated for a 600-dpi-printer. As tmview
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"
-f (Font-path)
A list of paths telling tmview where to look for the pk-files.
The items in this list have to be seperated by :'s. The given
list is executed from left to right. If an item ends with // 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//".
-n (Name-of-the-font-file)
If your dvi-file tells tmview to use a font called
"thisnthatfont" and tmview was told to use a resolution of "123"
dpi, tmview has to know how the desired file is named. In the
string following "-n" the following replacements are made:
xx replaced by
@N thisnthatfont
@K thisntha
(this is @N reduced to 8 char. (MS-DOG !))
@M 123
(the resolution)
@R 615
(this is @M*5, intended for magnified 200
dpi fonts used instead of 300 dpi fonts)
Defaults: "@N.@Mpk"
-t (tfm-path)
A list of paths telling tmview where to look for the tfm-files.
The items in this list have to be separated by :'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//".
-q (vf-path)
A list of paths where to look for vf-files. Defaults:
"./:usr/lib/texmf/fonts//".
-d (Display)
Size desired resolution of your display (dvisvga). 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. dvisvga 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, dvisvga falls back to 640x480 at 256 colors, then
to 640x480 at 16 colors. The framebuffer version dvifb ignores
this option. Use the program fbset to set up the framebuffer
device before starting tmview. Using the X Window System
(dvisvga) \verb+-d+ will suggest the size of the tmview window.
However, you may alternatively use the resource
\verb+DviLX.geometry+ or the standard geometry option
\verb*-geometry widthxheigth+x+y*. Defaults: (dvisvga)
"640x480"
-m (magnification)
If you want to magnify by a factor n you have to specify n*1000
as an argument to -m, e.g. -m2000 means all lengths will be
doubled. NOTE: tmview 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. -m doesn't magnify the paper, so if you wish a larger
image use the + and - keys or the -r option. Default: get
magnification from dvi-file.
-k (kannot-print-any-further)
Most printers stop printing if they are too close at the papers
edge (some might even do strange things). The -k option
describes the printable area, e.g. saying -k1.0,2.0,3.0,4.0
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"
-s (startup-file)
tmview 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", "/etc/dvifb" or
"/etc/dvilx". After this a user startup-file is read. The name
of the latter can be specified directly after the -s. When
quitting tmview, the current options etc. will be saved in the
user startup-file. If this is not desired, the user startup-
file has to be set read-only !! However, tmview will never
write to the system startup-file. The default the user start-
upfile is "~/.dvisvga", "~/.dvifb" or "~/.dvilx".
COPYING
The code of tmview uses some rather basic ideas stolen from xdvi. This includes some few lines of code just copied. The author of xdvi is Eric Cooper. In a similar kind, tmview's code depends on some lines of dvidjc, written by Wolfgang R.Mueller. The hyper-TeX related parts are taken from xhdvi, written by Arthur Smith. The sources of the above can be found on the CTAN. 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, tmview may be modified or distributed without any restrictions. tmview is distributed in the hope that it will be useful, but without any warranty.
AUTHOR
(C)opyright 1995 Thomas Moor (QElis@aol.com)
1 March 2001 TMVIEW(1)
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
