XTEX

Section: User Commands (1)
Updated: November 12, 1991
Index Return to Main Contents

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.
-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.
-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.
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.

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.
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.

This document was created by man2html, using the manual pages.
Time: 23:18:33 GMT, February 06, 2023