TEX3B1
Section: Misc. Reference Manual Pages (l)
Index
Return to Main Contents
NAME
tex3b1 - tex previewer for the 3b1
SYNOPSIS
tex3b1 [-fn] [-mn] [-bn] [-dn] [-sddd] [-Dn] [-S] name
tex3b1 -V
DESCRIPTION
tex3b1
will read a tex dvi file and display it on the ATT 3b1 console window.
Tex3b1 was derived from the sun previewer, texsun. Both previewers do
subsampling of glyphs (shrinking) so that you can use fonts of higher
resolution than the screen itself. This means only one set of fonts (the
printer fonts) are needed.
Tex3b1 reads /usr/local/lib/tex/fontdesc
to find the directory where font files are stored.
You can use any combination of pk, gf and pxl font files.
In addition, the choice to make boxes or leave blanks when missing
fonts are encountered is controlled by this file, based on
information from the tfm file.
Since the 3b1 display is just 720 x 300 pixels in size, tex3b1 can
generally display only a partial page at a time. Therefore, commands
exist to move the page around on the screen as well as to select a
new page to view.
Tex3b1 potentially displays each partial page in three possible
magnifications (really "shrinkages"). These three shrink values
allow users to zoom in (a small shrink value) or zoom out (a large
shrink values) as a dvi file is being previewed.
OPTIONS
- V
-
Just print the version number of the current tex3b1 and a usage
statement. No previewing is done.
- b
-
[-b n] selects the blacker value. The current default is 3, if your
fonts are already thick then you might get by with a smaller number.
You may want
a larger number on the 3b1 to make up for otherwise dropped pixels due
to subsampling during shrinking of glyphs.
- f
-
[-f n] selects the starting page for tex3b1 to display.
This page number is strictly the count from the start of the dvi file
and not the page number that TeX places at the bottom of the file.
- m
-
[-m n] chooses which of the shrink values (there are three) to
make the default. For instance, suppose shrink values are 2,3,5
(or 235 as a shrink triple) then saying -m 3 would select 1/5 (shrink
value 5) as the default magnification. Normally the largest readable
shrink value is placed first in the list since the default for 'm'
is 1.
- d
-
[-d n] changes the dots per inch (dpi) font value. Normally one
would recompile the code with the right value for their own system,
but if that is not possible then ``-d 240'' will allow you to run with
fonts built at 240 dpi.
- s
-
[-s ddd] changes the default shrink values. These values are
displayed on the bottom SLK line as the previewer runs and controls
the amount of shrinkage (subsampling) of the displayed fonts. Changing
from one magnification to another is equivalent to selecting one of
these three values. For some types of work or for some font sizes it
makes sense to be able to control these shrink values. ``-s 482'', for
example, might give you a reasonable view of the page for a default
(shrink of 4) while allowing you to zoom out (shrink of 8) and zoom
in (shrink of 2) using the interactive commands 'm' and 'M'.
-
Note that, for most printers, the screen pixels are much larger
and hence a shrink value of 1 (full resolution) will look very much
larger on the screen. This 3-tuple method of naming three individual
numbers is a bit strange and limits you to values from 1 to 9. For
very high resolution devices (linotype machines?) this may be too
limiting. Most 3b1 owners, however, won't need to shrink more than 9.
- D
-
[-D n] turns on some debugging information as tex3b1 runs.
- S
-
[-S] causes tex3b1 to use a small window, complete with borders,
rather than using as much of the screen as it can get. The help,
cancel, resize, and scroll buttons all work as expected.
COMMANDS
Interactive commands:
- ?
-
Displays a summary of these interactive commands.
Screen movement commands:
- h
-
Move viewport a bit to the left.
- j
-
Move viewport a bit to the right.
- k
-
Move viewport a bit up.
- l
-
Move viewport a bit down.
- H
-
Move viewport completely to the left. (X coordinate goes to 0.)
- J
-
Move viewport completely to the right. (Left Margin is completely visible.)
- K
-
Move viewport to the top of the page. (Y coordinate goes to 0.)
- L
-
Move viewport to the bottom of the page.
- <ff>,r
-
Either '^L' or 'r' reset the current page (X and Y coordinates back
to 0, same as 'H' then 'K').
Commands to move to different pages:
- <space>,f,n,<nl>,<cr>
-
' ', 'f', 'n', '^J', and '^M' all move to next page. A number preceeding
any of the above will move forward that many pages (default is one).
- b,p,<bs>,<del>
-
'b', 'p', '^H', and '^?' all move to the previous page. A number preceeding
any of the above will move backward that many pages (default is one).
- <n>g,<n>G
-
A number followed by g or G will go to the requested page: ``21G''.
Note the syntax may seem backwards, but it is easy to parse. Just
think ``less'' and ``vi'' here. The default page number is one.
Other interactive commands:
- m
-
Toggle between the first and second shrink value. If shrink values
are 482, for instance, then the first 'm' will create a small 1/8
font display. The next 'm' toggles back to 1/4 font display.
- M
-
Toggle between the current (or first) and third shrink value. In
the example above, 'M' would give the largest magnification of the
page. Once these magnifications have been computed for a page,
moving between one and another is relatively fast.
- R
-
Re-open the dvi file. This generally isn't necessary.
- q,x,^C,^D
-
All these options leave tex3b1.
MOUSE
Each button on the mouse represents one of the three possible
shrink values. Clicking on a different button selects a different
magnification.
Further, the location pointed to by the arrow is placed as close to the
center of the screen as possible. Placing the arrow slightly above
and left of center, and hitting the middle button a number of times
will move you diagonally through the page at the second shrink value
magnification.
A rule of thumb that seems to work for me is to make gross motions with
the keyboard (hjkl and HJKL) and fine selections with the mouse. Indeed,
the only way to select exactly that section of the page you want on the
screen is to use the mouse.
BUGS
Very low resolution fonts (like the ones Emmett Gray sent along with one of the
first TeX ports to the 3b1) don't seem to work very well. This shouldn't
be a problem as most pinwriter and laser printer fonts are large enough
to work.
AUTHOR
The code is based on texsun, which was written by Dirk Grunwald.
It uses Chris Torek's dvi library. The 3b1
port is by Andy Fyfe andy@csvax.caltech.edu. Note the source for
tex3b1 is available on csvax.caltech.edu as tex3b1-src.tar.Z.
FILES
/usr/local/lib/tex/fontdesc
and all the pk, gf, pxl and tfm files pointed to therein.
SEE ALSO
tex(1), latex(1), dvi2printer(1) (your dvi print driver), mf(1)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- COMMANDS
-
- MOUSE
-
- BUGS
-
- AUTHOR
-
- FILES
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 23:18:31 GMT, February 06, 2023