DVITPS(1L) UNIX System V(19 May 89) DVITPS(1L)
NAME
dvitps - convert a DVI file of TeX into a POSTSCRIPT file
SYNOPSIS
dvitps [ -qvwCDFLMSZ ] [ -c number of copies ] [ -d forward/reverse ] [
-f from page-number ] [ -m magnification ] [ -o paper format ] [ -t to
page-number ] [ -z reset page count ] [ -A font file search path ] [ -B
capability file directory ] [ -H horizontal offset ] [ -O output file
name ] [ -Q number ] [ -R resolution ] [ -V vertical offset ] [ -X
horizontal fudge factor ] [ -Y vertical fudge factor ] filename[.dvi] [-]
...
DESCRIPTION
dvitps(L) is a DVI to POSTSCRIPT processor converting a TeX DVI file into
a POSTSCRIPT file. If more than one DVI file is listed one POSTSCRIPT
file for all the DVI files together is generated. Input from standard
input is accepted by specifying `-' as file name. The output appears on
standard output unless an output file is specified using the -O option.
The driver offers great facilities among them to include POSTSCRIPT
figures with the help of the psfig macro package, to generate figures
with tpic(1) and other facilities which will be not discussed here. The
driver, for instance, allows the user to use GF, PK and PXL files. Also
POSTSCRIPT fonts can be used in a document. See the associated
documentation which comes with this driver. This documentation is
mentioned at the end of this manual page.
The driver by default does not generate a "conforming document" so that,
for instance, TranScript's psrev(1) could be used. The -C option though
does cause the driver to generate a conforming document.
If you simply enter dvitps the driver will report all the available
options and the font files it recognizes at your installation plus the
font paths it uses to locate all fonts.
OPTIONS
-c number of copies
Specifies the number of copies to print. Each page is printed
number of copies times, and the pages have to be collated by hand.
-d direction
The direction is either forward or backward and the generated
POSTSCRIPT output file prints in the specified direction. The
default is
-f page number
Start output with the specified page number.
-m magnification
Magnify the document by the given magnification factor which can be
0 through 5 (\magsteps 0 through 5, and h (for \magstephalf). Any
10/89 Page 1
DVITPS(1L) UNIX System V(19 May 89) DVITPS(1L)
other number is interpreted as a TeX magnification (1000 times the
desired magnification).
-o paper format
The paper format instruction tells the POSTSCRIPT printer which
type of paper the output occurs on. Legal values are letter, legal
and note where letter is the default.
-q Quiet: do not print any messages while processing a DVI file. See
also the -v option.
-t page number
Generate output only until the specified page number is reached.
-v Verbose: print extensive messages while processing the DVI files.
See also the -q option. The default is somewhere between -q and
this option.
-w Do not generate a width vector for any of the POSTSCRIPT fonts.
This reduces the usage of virtual memory inside the POSTSCRIPT
printer by a factor of 50% but it also makes the driver not follow
the rules of dvitype, the master driver program, precisely. The
usage of this option is discouraged but it causes also a shorter
POSTSCRIPT file to be generated.
-z reset page count
Generate POSTSCRIPT code which encloses every block of reset page
count pages into a separate save restore pair. This option is
incompatible with the -C option.
-A font file search path
Use font file search path as the search path to locate all the font
files like the GF, PK, PXL or PDR files. Any environment variables
related to locating fonts are ignored in this case. See below for
those environment variables.
-B capability file directory
Use the specified directory to locate the capability file. This
file is normally expected to be in directory DVITPS_CAP_DIR. The
file name of this file is dvitps-cap.
-D Print ``Draft'' on top of each page including name of DVI file and
generation date of DVI file.
-F Show the search operations of the driver to locate GF, PK, PXL or
PDR files.
-H horizontal offset
Shift the final output by horizontal offset to the right (if
positive) or to the left (if negative). The value of horizontal
offset must be immediately (without intervening space) followed by
one of TeX's dimension unit such as pt (points) or in (inch). All
Page 2 10/89
DVITPS(1L) UNIX System V(19 May 89) DVITPS(1L)
other dimension units of TeX are acceptable too.
-L Print the whole job in landscape mode.
-M Expect manual feed when printing; this generates a manualfeed
instruction in POSTSCRIPT.
-O output file
The POSTSCRIPT file is written to the specified file instead of
standard output which is the default.
-Q number
This option is used to invoke certain test functions. They will not
be documented here any further. See the description of the driver
in the manual for details.
-R resolution
Specifies the resolution of the POSTSCRIPT printer on which the
output will occur. The default is 300 dots/inch.
-S The driver may safely assume that only characters with character
code less than 128 are used in POSTSCRIPT fonts. In case this turns
out to be not true the driver will generate a fatal error. The main
effect of this option is to shorten the length of the generated
POSTSCRIPT code.
-V vertical offset
Shift the final output by vertical offset down (if positive) or up
(if negative). The value of vertical offset must be immediately
followed (without intervening space) by a dimension unit which must
be one of pt (point), in (inch), mm (millimeter) or cm
(centimeter).
-X horizontal fudge factor
Stretch or shrink any output in the X direction (that is
horizontally) by horizontal fudge factor.
-Y vertical fudge factor
Stretch or shrink any output in the Y direction (that is
vertically) by vertical fudge factor.
-Z Causes all special's to be ignored. Therefore all tpic and psfig
based figures are ignored.
ENVIRONMENT VARIABLES
We will now briefly discuss the environment variables understood by the
driver.
TEXFONTSDVITPSGF
This environment variable can be used to specify a special search
path for GF files. If this variable is not set see below for
details. If the -A option of the driver is used this environment
10/89 Page 3
DVITPS(1L) UNIX System V(19 May 89) DVITPS(1L)
variable as any other font path related environment variable is
ignored.
TEXFONTSDVITPSPK
Similar to TEXFONTS_DVITPS_GF this environment variable can be used
to specify a search path for PK files only. If the -A option of
this driver is used this environment variable as any other font
path related environment variable is ignored.
TEXFONTSDVITPSPXL
Similar to TEXFONTS_DVITPS_GF this environment variable can be used
to specify a search path for PXL files only. If the -A option of
this driver is used this environment variable as any other font
path related environment variable is ignored.
TEXFONTSDVITPSPDR
Similar to TEXFONTS_DVITPS_GF this environment variable can be used
to specify a search path for PDR files. PDR files are accessed by
the driver in the case of POSTSCRIPT fonts. If the -A option of
this driver is used this environment variable as any other font
path related environment variable is ignored.
TEXFONTSDVITPS
This envrionment variable determines the search path if none of the
above environment variables is set or the -A option of the driver
is not used.
TEXFONTS
This envrionment variable is used if none of the above environment
variables are set or the -A option of the driver is used. This
environment variable is typically the environment variable used to
determine the search path for font files. If even this environment
variale is not set then a default will be used which in the case of
this installation is TEXFONTS_DEF.
DVITPSPROLOGUEFILESPATH
This environment variable can be used to overwrite the default for
the search path to locate POSTSCRIPT prologue files. Prologue files
have the file extension .pro. The default path in effect when this
environment variable is not set is DVITPS_PROLOGUE_FILES_PATH_DEF.
FILES
The prologue POSTSCRIPT files of this driver are installed in
DRIVER_PS_PROLOGUE_FILES_DIR. See the description of the environment
variable DVITPS_PROLOGUE_FILES_PATH for additional information.
Each time the driver is started up it looks for the file .dvitps-opt in
the current directory. If it can find this file it assumes that it
contains command line options. The options specified in this file will
be used before any of the command line options given by the user will be
evaluated. For instance, if this file contains -D then this option will
be applied to all DVI files printed in this directory, and therefore all
Page 4 10/89
DVITPS(1L) UNIX System V(19 May 89) DVITPS(1L)
options will contain a "draft stamp."
DIAGNOSTICS
Check the -F, -v and -q options above.
SEE ALSO
dvitype(l), pfd2tfm(l), printpdr(l)
Stephan v. Bechtolsheim, "TeXPS - A TeX POSTSCRIPT Software Package",
Report 89-TeXPS-1, Integrated Computer Software, Inc, 1989. This report
contains the full description of this software and is highly recommended
for further study of the driver. In particular in contains an explanation
of how to use POSTSCRIPT fonts in a document, how to include POSTSCRIPT
figures with the help of psfig etc. Also this report is a test document:
once you were able to reproduce this document locally on your machine you
can be pretty confident that the software works like promised.
BUGS
You find them, I fix them.
AUTHOR
Stephan v. Bechtolsheim, Integrated Computer Software, Inc
10/89 Page 5