dvgt(1)

NAME
dvgt - interactive TeX page previewer

SYNOPSIS
dvgt [-H x_offset] [-V y_offset] [-d dummy_pk] [-e dummy_tfm] [-f pk_directory] [-h helpfile] [-i] [-l] [-m magnification] [-p postscript_font_prefix] [-r xres yres] [-t tfm_directory] [-v vdu] [-x paperwd] [-y paperht] filename[.dvi]

DESCRIPTION
dvgt is a version of the DVItoVDU interactive TeX page previewer. The program allows you to look at TeX-generated DVI files on a variety of commonly available VDUs. The "DVItoVDU User Guide", "userguide.tex", explains how to use the program. NOTE ON OPTIONS' DEFAULTS: All options have default values. System dependent initial defaults are set at compile-time. (Compilation note: these constants are set in the source file "defaults.h".) Some defaults can be set by environment variables. The command line options override the environment variables, which in turn override the compiled initial defaults.

OPTIONS

-H horizontal_offset, -V vertical_offset
    TeX, by default, considers the top left corner of the printed page as one inch below and one inch to the right of the physical page. So does dvgt. The two offsets move this corner. Positive dimensions move it downwards and rightwards; negative offsets are allowed. (default = 0.0in)

-d file
    dvgt will warn you if your document uses a font at a non-existent size. Rather than abort, it will load the PK font specified after -d and continue so you can look for more errors. Paragraphs using this dummy information are likely to have ragged right margins. (default is system dependent; environment: DV_DUMMY_PK)

-e file
    Default TFM file, similar to -d option. (default is system dependent; environment: DV_DUMMY_TFM)

-f file
    dvgt gets all its font information from PK files. These files are kept within the directory specified by this option. (default is system dependent; environment: PKFONTS or TEXFONTS)

-h file
    The ? command reads the help text file specified by this option. (default is system dependent; environment: DV_HELP)

-i  Display the path name of the immediate help file. Typing "dvgt" by itself displays the immediate help file. (default is system dependent; environment: DV_IMMED_HELP)

-l  Set landscape mode: exchange x and y dimensions. (This does NOT rotate the page, sorry.) The default is portrait mode.

-m i
    This option 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 PK files. Unless you know exactly what you are doing you should avoid using -m, especially if your TeX source file uses gnification AND true dimensions. (default = DVI magnification)

-p postscript_font_prefix
    dvgt will search the TFM search paths for TFM metric files with this prefix. dvgt cannot interpret PostScript, but TFM files for PS fonts will allow dvgt to leave sufficient space for PS font characters, which will then be displayed as filled (Full mode) or outline (Box mode) blocks of that size. (default is system dependent; environment: DV_PSPREFIX)

-r x,y, -r x
    dvgt 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. x and y are positive floating point numbers that define the numbers of pixels per inch in the horizontal and vertical directions, respectively. Their values should match the respective resolutions of the device that will be used to print your document. If only one value is given, then it is used as the resolution both horizontally and vertically. (default is system dependent)

-t tfm_directory
    This sets the directory where dvgt will look for TFM (TeX Font Metric) files, such as "cmr10.tfm". (default is system dependent; environment: TEXFONTS)

-v string
    This option is used to tell dvgt what type of VDU you are using. If TERM does not describe your VDU, you need to override the default value. Typing "dvgt -v vis550 foo" will tell dvgt you're using a Visual 550. The current version will accept the following strings (in upper or lower case):
    aed512 | AED 512 with 512 by 512 screen
    gigi | same as regis
    kermit | same as ncsatel
    linux | Linux SVGA driver
    ncsatel | NCSA Telnet's Tektronix 4010 emulation
    regis | any ReGIS compatible VDU
    tek4010 | same as ncsatel
    vis240 | Visual 240
    vis241 | same as vis240
    vis500 | Visual 500
    vis550 | Visual 550
    vis603 | Visual 603
    vis630 | Visual 630
    vk100 | same as regis
    vt100 | any VT100 compaible in 80 column mode;
    vt102 | same as vt100
    vt100132 | any VT100 compatible in 132 column mode
    vt125 | same as regis
    vt200 | same as vt220
    vt220 | VT220 using down-loaded chunky graphics
    vt240 | same as regis
    vt640a | VT100 with Retro-Graphics
    (default = value of DV_TERM or TERM)

-x dimen, -y dimen
    These two options define the width and height of the paper upon which your document will be printed. Both values are specified as dimensions like those used in TeX, but the units are restricted to bp, cm, in, mm, pc, pt, px, or sp. px is specific to dvgt, and represents one paper pixel. Every time you select a page, dvgt will use these paper dimensions to check that all printed material falls within the paper edges. (default is system dependent)

ENVIRONMENT
The default value for most of the options mentioned above can be set by an environment variables. In addition, the Linux SVGAlib driver uses these environment variables.

GSVGAMODE
    The default graphics mode used by dgvt. This must be a valid mode as defined in SVGAlib's "vga.h". It can be either a mode name (e.g., G640x480x256) or a mode number (e.g., 12).

DV_LINUX_FG, DV_LINUX_BG
    These define the foreground and background colors, respectively. The value should be the red, green, and blue color components separated by commas. For example, for bright red text, use "255,0,0".

AUTHOR
Originally written in Modula-2 for VAX/VMS systems, as dvitovdu, by Andrew Teverrow.

Translated to C for Unix systems, as dv, by Ian Dall.

Reworked and improved, as dvgt, by Geoffrey Tobin.

Linux port and SVGAlib driver by Rob Malouf (malouf@csli.stanford.edu).

SEE ALSO
tex(1), latex(1), dvips(1).