1 Dvivdu ! Dvivdu is a TeX page previewer. The program allows you to look at TeX-generated DVI pages on a variety of VDUs (Visual Display Unit is computerese for a terminal with a display screen). The "DVIVDU User Guide" has more details on how to use the program. Copies may be obtained by mailing to ACTION. ! SYSDEP ! Please report any problems or suggestions to Andrew Trevorrow ! (ext. 5984, room 165 in the Computing Centre). Usage: DVIVDU [qualifiers] filename[.DVI] [qualifiers] ! ! Now keep lines < 75 chars long. ! 2 Commands_in_brief MISCELLANEOUS ------------- ? Display brief help on the commands. S Show the qualifier values and page statistics. Q Quit from Dvivdu. SELECTING A PAGE ---------------- i Select the ith DVI page; i must be a positive integer from 1 to n where n is the total number of pages in the DVI file. [i0..i9] Select the DVI page whose TeX page counters match the given integers, i0 to i9, separated by periods. Each integer is optional and trailing periods may be omitted. An absent integer matches any value in the corresponding counter. If more than one DVI page matches, the lowest will be chosen. N Select the Next DVI page according to the current direction. > Future N commands will move forwards through the DVI file. < Future N commands will move backwards through the DVI file. CHANGING THE WAY A PAGE IS DISPLAYED ------------------------------------ T Terse display of characters; fast but inaccurate. B Box display showing rectangular outlines of characters. F Full display of all pixels in characters; accurate but slow. CHANGING THE UNITS OF DIMENSIONS -------------------------------- IN Get/show dimensions in terms of inches (/RESOLUTION defines the number of paper pixels per inch). CM Get/show dimensions in terms of centimetres (2.54cm = 1in). MM Get/show dimensions in terms of millimetres (10mm = 1cm). PC Get/show dimensions in terms of picas (1pc = 12pt). PT Get/show dimensions in terms of points (72.27pt = 1in). PX Get/show dimensions in terms of paper pixels. CHANGING THE SIZE OF THE WINDOW ------------------------------- H wd Set the Horizontal size of the window to the given width. If wd absent then set width to initial, unscaled value. V ht Set the Vertical size of the window to the given height. If ht absent then set height to initial, unscaled value. MOVING THE WINDOW ----------------- W h,v Move the Window's top left corner to given paper position. h is the horizontal coordinate, v is the vertical coordinate. If h,v is absent then window is moved to (Minh,Minv), the top left corner of the page rectangle. U v Move window Up v units. If v is absent then move up by the window's current height. D v Move window Down v units. If v is absent then move down by the window's current height. L h Move window Left h units. If h is absent then move left by the window's current width. R h Move window Right h units. If h is absent then move right by the window's current width. 2 Qualifiers /VDU Usage: /VDU=string (default=ANSI) This qualifier is used to tell Dvivdu what type of VDU you are using. ! SYSDEP ! TRMHND is the logical name used by Ludwig and Scroll. If TRMHND does ! not describe your VDU, you need to override the default value. For example, typing `dvivdu/vdu=vis550 foo' will tell Dvivdu you're using a VISUAL 550. The current version of Dvivdu will accept the following /VDU values: AED483 (AED 512 with 512 by 483 screen) AED512 (AED 512 with 512 by 512 screen) ANSI (any ANSI compatible VDU; synonyms = VT100, VT220) REGIS (any ReGIS compatible VDU; synonyms = GIGI, VK100, VT125, VT240) VIS500 (VISUAL 500) VIS550 (VISUAL 550) VT100132 (any VT100 compatible VDU in 132 column mode) VT640 (VT100 with Retro-Graphics) /RESOLUTION Usage: /RESOLUTION=i (default=240) Dvivdu treats the imaginary sheet of paper on which a DVI page will appear as a two dimensional array of tiny dots known as paper pixels. i is a positive integer that defines the number of pixels per inch, horizontally and vertically. Its value should match the resolution of the device that will be used to print your document. ! SYSDEP ! We have a Canon/Imagen laser printer with a resolution of 240 dots/inch. /XSIZE /YSIZE Usage: /XSIZE=dimen (default=8.3in) /YSIZE=dimen (default=11.7in) These two qualifiers define the dimensions of the paper upon which your document will be printed. Both values are specified as dimensions similar to those used in TeX but units are restricted to IN, CM, MM, PC, PT or PX (these two-letter sequences are the same as the commands used to change the units of dimensions). ! SYSDEP ! Note that their default values specify A4 paper. Every time you select a page, Dvivdu will use these paper dimensions to check that the page edges fall within the paper edges. /MAGNIFICATION Usage: /MAGNIFICATION=I (DEFAULT=DVI magnification) This qualifier allows you to replace the magnification used in the DVI file with some other value; i is a positive integer 1000 times the desired magnification. The given value should be chosen carefully so that the new font sizes still correspond to existing PXL files. ! sysdep ! if you plan to use imprint's /magnification qualifier, you should supply ! the same override to dvivdu; that way you'll see exactly what the ! document will look like when printed. ! unless you know exactly what you are doing you should avoid using ! /magnification, especially if your tex source file uses \magnification ! and true dimensions. the complete story on magnification can be found in ! chapters 4 and 10 of "the texbook", along with the "tex user guide" and ! "imprint user guide". /FONT_DIRECTORY Usage: /FONT_DIRECTORY=list (DEFAULT=(TeX_fonts:)) Dvivdu gets all its font information from PXL files. These files are kept within subdirectories of the master directories specified by this qualifier. Each subdirectory contains pxl files at a particular magnification; the name of a subdirectory is simply the magnification times 1000 and expressed as a 4 digit integer. ! sysdep ! the "tex user guide" has samples of most fonts, but only at their ! design sizes. ! if you're interested in using fonts at different sizes, you should tex ! and imprint the public document tex_inputs:fontlist.tex. /DUMMY_FONT Usage: /DUMMY_FONT=string (DEFAULT=TeX_fontroot:[1500]cmr10.pxl) Dvivdu will warn you if your document uses a font at a non-existent size. Rather than abort, it will load the PXL file specified by /DUMMY_FONT and continue so you can look for more errors. paragraphs using this dummy information are likely to have ragged right margins. Even if you don't use /MAGNIFICATION, there might still be problems with the fonts requested in your TeX source file since fonts do not exist at all possible \MAGNIFICATION values. /HELP_FILE Usage: /HELP_FILE=string (DEFAULT=SYS$SYSROOT:[DVIVDU]DVIVDU.HLP) The ? command reads the text file specified by this qualifier.