1dvipdfm(1) General Commands Manual dvipdfm(1)
2
6 dvipdfm - Produce PDF files directly from DVI files
7
10 dvipdfm [options] file[.dvi]
11
14 The program dvipdfm generates a PDF file from a DVI file. DVI files
15 are the output format produced by TeX. Output from groff can be con‐
16 verted to DVI format using grodvi.
17 The program dvipdfm recognizes several commonly used \special commands,
19 which are extensions to the DVI format. Specifically, it understands
20 color specials, papersize specials, tpic specials (which allow it to be
21 used with pic), hypertex specials, and some PostScript specials. These
22 extensions allow documents to contain color, figures, and hyperlinks.
23 The program tries to mimic the behavior of dvips so that many macro
24 packages produced for use with dvips will work with dvipdfm. Dvipdfm
25 understands its own specific \special commands to allow access to PDF
26 features such as annotations and bookmarks. For more details, consult
27 the Dvipdfm User's Manual, which is distributed with dvipdfm.
28
31 -c Ignore color \specials. The -c toggles a flag that disables color
32 \special processing. Unless changed in the configuration file,
33 that flag is off, and color \specials are interpreted normally.
34 The -c option may be used to produce a black and white document
35 from a document containing color TeX \special commands.
36 -d Remove thumbnail images after including them. (See the -t option
39 for more information.)
40 -e Toggle partial font embedding flag. If partial font embedding is
43 off, embedded fonts are fully embedded. The default, if not
44 changed in the configuration file, is to embed only those glyphs
45 actually used in the document.
46 -f map_file
49 Set the name of the font map file to map_file. The format of the
50 font map file is documented in the Dvipdfm User's Manual.
51 -l Select landscape mode. In other words, exchange the x and y
54 dimensions of the paper.
55 -m mag
58 Magnify the input document by mag.
59 -o name
62 Generate PDF output file having the name name. By default, the
63 name of the output file is file.pdf.
64 -p paper
67 Select the papersize by name (e.g., letter, legal, ledger,
68 tabloid, a3, a4, or a5 )
69 -r size
72 Set resolution of bitmapped fonts to size dots per inch.
73 Bitmapped fonts are generated by the Kpathsea library, which uses
74 MetaFont. Bitmapped fonts are included as type 3 fonts in the PDF
75 output file.
76 -s page_specifications
79 Select the pages of the DVI file to be converted. The page_speci‐
80 fications consists of a comma separated list of page_ranges:
81 page_specifications := page_specification[,page_specifications]
83 where
85 page_specification := single_page|page_range
87 page_range := [first_page]-[last_page]
89 An empty first_page is implied to be the first page of the DVI
91 file. An empty last_page is treated as the last page of the DVI
92 file.
93 Examples:
95 -s 1,3,5
97 includes pages 1, 3, and 5;
98 -s - includes all pages;
100 -s -,-
102 includes two copies of all pages in the DVI file; and
103 -s 1-10
105 includes the first ten pages of the DVI file.
106 -t Search for thumbnail images of each page in the directory named by
108 the TMP environment variable. The thumbnail images must be named
109 in a specific format. They must have the same base name as the
110 DVI file and they must have the page number as the extension to
111 the file name. Dvipdfm does not generate the thumbnails itself,
112 but it is distributed with a wrapper program named dvipdft that
113 does so.
114 -v Increase verbosity. Results of the -v option are cumulative
117 (e.g., -vv ) increases the verbosity by two increments.
118 -x x_offset
121 Set the left margin to x_offset. The default left margin is
122 1.0in. The dimension may be specified in any units understood by
123 TeX (e.g., bpt, pt, in, cm )
124 -y y_offset
127 Set the top margin to y_offset. The default top margin is 1.0in.
128 The dimension may be specified in any units understood by TeX
129 (e.g., bpt, pt, in, cm )
130 -z compression_level
133 Set the compression level to compression_level. Compressions lev‐
134 els range from 0 (no compression) to 9 (maximum compression) and
135 correspond to the values understood by zlib.
136
139 Dvipdfm uses the kpathsea library for locating the files that it opens.
140 Hence, the environment variables documented in the Kpathsea library
141 documentation influence dvipdfm.
142 Dvipdfm also reads the following environment variables:
144 TMP The directory to search for thumbnail images of each page.
147
150 The precise location of the following files is determined by the Kpath‐
151 sea library configuration. The location may be determined by using
152 kpsewhich, e.g.,
153 kpsewhich -progname=dvipdfm -format='other text files' config
154 config
157 Startup options
158 t1fonts.map
161 The default font map file (this name may be changed in the config
162 file).
163 *.tfm
166 TeX font metrics
167 *.vf TeX virtual font files
170 *.pfb
173 PostScript Type 1 font files
174 texmf.cnf
177 The Kpathsea library configuration file. The location of this
178 file may be found by typing
179 kpsewhich texmf.cnf
180
184 tex(1), dvips(1), groff(1), grodvi(1), pic(1), and the Kpathsea library
185 info documentation.
186
189 Mark A. Wicks <mwicks@kettering.edu>
190 5/28/2001 dvipdfm(1)