XTEX(1) Local XTEX(1)
November 12, 1991
NAME
xtex - view DVI files on your X-11 display
SYNOPSIS
xtex
DESCRIPTION
Xtex allows you to preview a DVI file produced by TeX82, LaTeX, etc.,
under the X-11 windowing system. Xtex relies heavily on the
application defaults file, which is loaded into the X resource
database on invocation. Normally, this file lives in
/usr/lib/X11/app-defaults/Xtex.ad Xtex will not work properly if this
file is not installed. Must function bindings in xtex can be altered
by editing the application defaults file or by overriding those
options in your private resource file.
OPTIONS
-mag Set the default mag for windows. Default is 1000. Can be set by
``mag'' in resource database.
-smallMag
Set the default mag for the ``small'' magnification. Default is
1000. Can be set by ``smallMag'' in resource database.
-largeMag
Set the default mag for the ``large'' button. Default is 1440.
Can be set by ``largeMag'' in resource database.
-topOffset
alias for -voffset
-voffset
Set the vertical margin to display, in inches. This should
correspond to the value of voffset in your document. The default
is one inch. Specifying smaller values, e.g. 0.5, avoids
displaying whitespace that takes up display real estate.
-leftOffset
alias for -hoffset.
-hoffset
Specifies the horizontial (left) margin, corresponding to hoffset
in your document. Again, this can be used to save display real
estate.
-paperWidth
Specifies the width of ``paper'' to render, in inches. Default
is 8.5 inches. Can be specified using ``paperWidth'' in your
resource database.
- 1 - Formatted: December 18, 2025
XTEX(1) Local XTEX(1)
November 12, 1991
-paperHeight
Specifies the height of ``paper'' to render, in inches. Default
is 11 inches. Can be specified using ``paperWidth'' in your
resource database.
-print
Set the default printing program for files. Default is ``lpr
-d'' Can be set by ``print'' in resource database.
-automakeFont
Do not ask for confirmation when creating missing fonts.
-useButtons
Display function buttons in the page display, giving your
document more room. You must use the keypress accelerators within
that page (see Accelerators). Default is `True.' Can be set by
``useButtons'' in resource database.
-updateNames
Update the window and icon names as you open files and change
pages. Default is `True.' Can be set by ``updateNames'' in
resource database.
-autoSize
Automatically resize the window. Default is ``True'' Can be set
by ``autoSize'' in resource database.
-pageMaxWd
The maximum allowed page width (in pixels) when auto-sizing your
window. The default is about 95% of your display width. Can be
set by ``maxPageWd'' in resource database.
-pageMaxHt
The maximum allowed page height (in pixels) when auto-sizing.
Default is about 95% of your display height. Can be set by
``maxPageHt'' in resource database.
-dpiHoriz
Set the default horizontial resolution of the fonts, in dots per
inch. This value is used to actually determine what fonts are
loaded. Default is 85 dpi. Can be set by ``dpiHoriz'' in
resource database.
-dpiVert
Set the vertical font resolution; some displays have a non-unity
aspect ratio. E.g. on a Sun-3 monitor, the horizontial
resolution is about 85 dpi, but the vertical resolution (on mine)
is about 83.5dpi. This is only important if you're really
running at screen resolution and are trying to layout documents
to a specific format. Can be set by ``dpiVert'' in resource
database.
- 2 - Formatted: December 18, 2025
XTEX(1) Local XTEX(1)
November 12, 1991
-tfmPath
Specifies the default path used to locate the TFM files that
describe the TeX fonts.
-pushOnStart
Some people like a document to be automatically opened when xtex
begins execution. By specifying ``-pushOnStart open'' (note: you
must use the string ``open'', not ``Open'' or other variants),
the file will be opened; specifying ``-pushOnStart copy'' will
copy the file and open the copy (like the copy button). All other
values will do nothing. The default is ``open''. You can also set
this via ``pushOnStart'' in the resource database. Xtex uses X11
fonts to actually render the bitmaps, but must also know the size
of fonts when laying out a page. The TEXFONTS environment
variable will override this option.
FONTS
Xtex can display your document at a variety of sizes, but you must
have X-11 fonts corresponding to the fonts in your .dvi file. For
example, if your file calls for font ``cmr10'' scaled 1000, and you're
rendering it on your display at 300dpi with the magnification level
set to 500, xtex will look for the font ``cmr10.150''. The suffix is
compute by (dpi * scaled * mag ) / ( 1000 * 1000 ). You can generate
these fonts using mftobdf. For example, executing ``mftobdf -scaled
1000 -mag 500 cmr10'' would produce ``cmr10.300'' (the default
resolution is 300). The font ``cmr10.300pk'' would be shrunk by 50%
to produce ``cmr10.150.bdf'', the output file. You could also specify
this at using ``mftobdf cmr10.300pk.'' mftobdf can only magnify things
by 500, 333, 250, 200, ..., 1000/integer. You could also generate
this font by using Metafont to build a font ``cmr10.150'' and then
saying ``mftobdf -scaled 500 cmr10.'' In practice, most installations
use screen (or near screen) resolution fonts. For example, to produce
the ``cmr10.85'' (cmr10 font, normal scaling, 85dpi resolution), you
execute: ``mftobdf -dpi 85 cmr10.85pk.''
Ideally, this will have already been set up at your site, and you'll
never have to worry about it.
DOCUMENT LEVEL FUNCTIONS
There are many buttons at the top level display.
Quit quits Xtex entirely.
Open opens the file in the file name box.
Copy copies the file and then opens this copy; this lets you process a
new version of the file while looking at the old one.
Cd changes the current directory.
- 3 - Formatted: December 18, 2025
XTEX(1) Local XTEX(1)
November 12, 1991
Close
closes the current file if there is one.
These functions (and the button names) are all controlled by the
application defaults file, and may differ at your site. Normally, an
accellerator is installed to invoke ``copy'' and ``Page'' (see below)
when you press RETURN in the file name box.
Once you open a file, you can select other functions.
Page puts up a new page display.
Print all
uses the print program specified by -print to print your
document. You will be asked to confirm the printing, and you
will be able change the printing program at that time.
Print Marked
prints only marked pages.
Print Unmarked
prints unmarked pages.
The marked pages are displayed under the dialog box in the mark menu.
You can mark pages in the mark menu using the mouse. Button1 marks a
page, Button2 clears all marks and Button3 inverts all marks. These
button bindings are set by the application defaults file, and may
differ at your installation. Currently, the only thing you can do
with marked pages is print them. xtex invokes dviselect to copy the
pages into another file, which is then printed.
When you display a page of output, by selecting the ``Page'' button,
the first page of your document is displayed. You can press ``Page''
again to display multiple copies if you desire.
Actions within a page are specified either by using buttons or key
presses. Because the buttons take valuable real estate on your
display, you may wish to use the -useButtons options, or specify
``Xtex.useButtons: False'' in your resource database.
PAGE BUTTONS
You can move around (forewards and backwards), mark the current page
for printing or duplicate the page (e.g., to view it at a larger
size). You can also create tied pages; in these, pressing foreward or
backward in the master window (the one in which you poked `tied')
causes the tied page to go foreward or backward. Movement in the tied
page doesn't affect the master. Tied pages can also have tied pages.
The ``large'' and ``small'' buttons allow you to select two common
sizes for magnification. You can also use the mag button for other
general sizes.
- 4 - Formatted: December 18, 2025
XTEX(1) Local XTEX(1)
November 12, 1991
Options to the right of the text widget require extra input; that's
what the text widget is for. You specify a page number in the text
widget and then either hit ``Goto'' to go to that page number. You
specify a general mag by entering a mag number (e.g., 333, 500 or
1000) and hit ``Mag'' to set the magnification.
If you change the mag, the page will resize itself if you specified
-autoSize or set the ``Xtex.autoSize'' resource to true.
PAGE ACCELERATORS
There are accelerators for these functions.
Q, X, Control-d
exit xtex entirely.
q,x exit this particular page.
0,1,2,3,4,5,6,7,8,9
set the current <prefix>. These numbers are cummulative, i.e.
entering ``23'' gives the number ``23,'' not simply ``3''.
ESCAPE
clear the current <prefix>.
f, n, Control-n, RETURN
go forward <prefix> pages, with a default of one.
b, p, Control-h, BackSpace, Delete
go backward <prefix> pages, with a default of one.
g goto the logical page specified by <prefix>. A logical page
number is the number printed on the page.
Button-2
specify the physical page using a valuator. A physical page
number is the number of the page as printed; i.e. a monotonicly
increasing sequence of numbers.
Control-t
prints the current page. You will be asked to confirm this.
l shifts to ``large magnification.''
s shifts to ``small magnification.''
M shifts to arbitrary magnification specified by the <prefix>.
E.g. typing ``1095M'' will set the magnification to 1095.
m marks the current page.
- 5 - Formatted: December 18, 2025
XTEX(1) Local XTEX(1)
November 12, 1991
u unmarks the current page.
t toggles the mark for the current page.
F12, r
reopens the document. If you opened the document using ``Open,''
the document is opened again, while if you used ``Copy,'' a new
copy is made. This is used when making iterative changes to your
document. If the current logical page number exists in the newly
opened document, you'll continue to see that page. If it doesn't
exist, you'll see the first page. Reopening a document clears
all page marks.
d duplicates the current page (putting up another page window).
t duplicates the current page using a tied window. All forward and
backward actions in the original page are mimiced in the tied
page, allowing you to walk through a document with two (or more)
pages displayed in lockstep.
Space, Arrow Keys
If your document is too large to fit on the display, and must use
the scroll bar, Space-Down will display the bottom of the
document and Space-Up will return to displaying the upper half.
You can also the arrow keys to move up, down, left and right.
HINTS
Set your backing store in your resources file, e.g. Xtex*backingStore:
whenMapped and scolling will be MUCH faster.
BUGS
Although xtex understands most tpic graphical commands, it is unable
to display shading, because Dirk was too lazy to finish it. All other
graphics commands are supported, however.
AUTHOR
Dirk Grunwald, at the University of Colorado wrote xtex based using a
DVI-library written by Chris Torek at UMD. Tim Morgan, at the
University of Calif, Irvine, wrote the enhanced tpic support, and Dirk
beat on it heavily.
- 6 - Formatted: December 18, 2025
