1DVIPDFM(1) DVIPDFMx DVIPDFM(1)
2
6 dvipdfm - produce PDF files directly from DVI files
7
10 dvipdfm [options] file[.dvi]
11
14 In TeX Live, dvipdfm is another incarnation of dvipdfmx rather than a
15 separate program. Compatibility is attempted as best as possible.
16 (The change was made due to duplicated security and configuration
17 issues arising repeatedly.) Please report problems with this dvipdfm
18 to the dvipdfmx maintainers at dvipdfmx (at) ktug.or.kr.
19 The program dvipdfm generates a PDF file from a DVI file. DVI files
21 are the output format produced by TeX. Output from groff can be con‐
22 verted to DVI format using grodvi.
23 The program dvipdfm recognizes several commonly used \special commands,
25 which are extensions to the DVI format. Specifically, it understands
26 color specials, papersize specials, tpic specials (which allow it to be
27 used with pic), hypertex specials, and some PostScript specials. These
28 extensions allow documents to contain color, figures, and hyperlinks.
29 The program tries to mimic the behavior of dvips so that many macro
30 packages produced for use with dvips will work with dvipdfm. Dvipdfm
31 understands its own specific \special commands to allow access to PDF
32 features such as annotations and bookmarks.
33 For issues related to bounding boxes (and hence image sizes), please
35 see extractbb(1).
36
39 -c Ignore color \specials. The -c toggles a flag that disables color
40 \special processing. Unless changed in the configuration file,
41 that flag is off, and color \specials are interpreted normally.
42 The -c option may be used to produce a black and white document
43 from a document containing color TeX \special commands.
44 -d Remove thumbnail images after including them. (See the -t option
47 for more information.)
48 -e Toggle partial font embedding flag. If partial font embedding is
51 off, embedded fonts are fully embedded. The default, if not
52 changed in the configuration file, is to embed only those glyphs
53 actually used in the document.
54 -f map_file
57 Set the name of the font map file to map_file. The format of the
58 font map file is documented in the Dvipdfm User's Manual.
59 -l Select landscape mode. In other words, exchange the x and y
62 dimensions of the paper.
63 -m mag
66 Magnify the input document by mag.
67 -o name
70 Generate PDF output file having the name name. By default, the
71 name of the output file is file.pdf.
72 -p paper
75 Select the papersize by name (e.g., letter, legal, ledger,
76 tabloid, a3, a4, or a5 )
77 -r size
80 Set resolution of bitmapped fonts to size dots per inch.
81 Bitmapped fonts are generated by the Kpathsea library, which uses
82 Metafont. Bitmapped fonts are included as type 3 fonts in the PDF
83 output file.
84 -s page_specifications
87 Select the pages of the DVI file to be converted. The page_speci‐
88 fications consists of a comma separated list of page_ranges:
89 page_specifications := page_specification[,page_specifications]
91 where
93 page_specification := single_page|page_range
95 page_range := [first_page]-[last_page]
97 An empty first_page is implied to be the first page of the DVI
99 file. An empty last_page is treated as the last page of the DVI
100 file.
101 Examples:
103 -s 1,3,5
105 includes pages 1, 3, and 5;
106 -s - includes all pages;
108 -s -,-
110 includes two copies of all pages in the DVI file; and
111 -s 1-10
113 includes the first ten pages of the DVI file.
114 -t Search for thumbnail images of each page in the directory named by
116 the TMPDIR environment variable. The thumbnail images must be
117 named in a specific format. They must have the same base name as
118 the DVI file and they must have the page number as the extension
119 to the file name. Dvipdfm does not generate the thumbnails
120 itself, but it is distributed with a wrapper program named dvipdft
121 that does so.
122 -v Increase verbosity. Results of the -v option are cumulative
125 (e.g., -vv ) increases the verbosity by two increments.
126 -x x_offset
129 Set the left margin to x_offset. The default left margin is
130 1.0in. The dimension may be specified in any units understood by
131 TeX (e.g., bpt, pt, in, cm )
132 -y y_offset
135 Set the top margin to y_offset. The default top margin is 1.0in.
136 The dimension may be specified in any units understood by TeX
137 (e.g., bpt, pt, in, cm )
138 -z compression_level
141 Set the compression level to compression_level. Compressions lev‐
142 els range from 0 (no compression) to 9 (maximum compression) and
143 correspond to the values understood by zlib.
144
147 When including images with dvipdfm, their bounding boxes should be gen‐
148 erated by running ebb, or extractbb -m. The result will be in an .bb
149 file.
150 When including images with dvipdfmx, their bounding boxes should be
152 generated by running extractbb. The result will be in an .xbb file;
153 the xbb information is the same as for the PDF format.
154
157 Dvipdfm uses the kpathsea library for locating the files that it opens.
158 Hence, the environment variables documented in the Kpathsea library
159 documentation influence dvipdfm.
160 Dvipdfm also reads the following environment variables:
162 TMP The directory to search for thumbnail images of each page.
165
168 The precise location of the following files is determined by the Kpath‐
169 sea library configuration. The location may be determined by using
170 kpsewhich, e.g.,
171 kpsewhich -progname=dvipdfm -format='other text files' config
172 config
175 Startup options
176 t1fonts.map
179 The default font map file (this name may be changed in the config
180 file).
181 *.tfm
184 TeX font metrics
185 *.vf TeX virtual font files
188 *.pfb
191 PostScript Type 1 font files
192 texmf.cnf
195 The Kpathsea library configuration file. The location of this
196 file may be found by typing
197 kpsewhich texmf.cnf
198
202 dvipdft(1), tex(1), dvips(1), groff(1), grodvi(1), pic(1),
203 extractbb(1), and the Kpathsea library info documentation.
204
207 Mark A. Wicks. But for the version in TeX Live, all bugs and other
208 reports should go to the dvipdfmx maintainers at dvipdfmx (at)
209 ktug.or.kr.
21020120420 28 April 2011 DVIPDFM(1)