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