NAME

       dvipdfm - produce PDF files directly from DVI files

SYNOPSIS

       dvipdfm [options] file[.dvi]

DESCRIPTION

       In  TeX  Live,  dvipdfm is another incarnation of dvipdfmx rather than a separate program.
       Compatibility is attempted as best as possible.  (The change was made  due  to  duplicated
       security  and  configuration issues arising repeatedly.)  Please report problems with this
       dvipdfm to the dvipdfmx maintainers at dvipdfmx (at) ktug.or.kr.

       The program dvipdfm generates a PDF file from a DVI file.  DVI files are the output format
       produced by TeX.  Output from groff can be converted to DVI format using grodvi.

       The  program  dvipdfm  recognizes  several  commonly  used  \special  commands,  which are
       extensions to the DVI format.  Specifically,  it  understands  color  specials,  papersize
       specials,  tpic specials (which allow it to be used with pic), hypertex specials, and some
       PostScript specials.  These extensions allow documents  to  contain  color,  figures,  and
       hyperlinks.   The program tries to mimic the behavior of dvips so that many macro packages
       produced for use with dvips will work with dvipdfm.  Dvipdfm understands its own  specific
       \special commands to allow access to PDF features such as annotations and bookmarks.

       For issues related to bounding boxes (and hence image sizes), please see extractbb(1).

OPTIONS

       -c   Ignore  color  \specials.   The  -c  toggles  a  flag  that  disables  color \special
            processing.  Unless changed in the configuration file, that flag is  off,  and  color
            \specials are interpreted normally.  The -c option may be used to produce a black and
            white document from a document containing color TeX \special commands.

       -d   Remove  thumbnail  images  after  including  them.   (See  the  -t  option  for  more
            information.)

       -e   Toggle partial font embedding flag.  If partial font embedding is off, embedded fonts
            are fully embedded.  The default, if not changed in the  configuration  file,  is  to
            embed only those glyphs actually used in the document.

       -f map_file
            Set  the  name  of the font map file to map_file.  The format of the font map file is
            documented in the Dvipdfm User's Manual.

       -l   Select landscape mode.  In other words, exchange the x and y dimensions of the paper.

       -m  mag
            Magnify the input document by mag.

       -o  name
            Generate PDF output file having the name name.  By default, the name  of  the  output
            file is file.pdf.

       -p  paper
            Select the papersize by name (e.g., letter, legal, ledger, tabloid, a3, a4, or a5 )

       -r  size
            Set  resolution  of  bitmapped  fonts  to  size  dots  per inch.  Bitmapped fonts are
            generated by the Kpathsea library, which uses Metafont.  Bitmapped fonts are included
            as type 3 fonts in the PDF output file.

       -s  page_specifications
            Select  the  pages of the DVI file to be converted.  The page_specifications consists
            of a comma separated list of page_ranges:

            page_specifications := page_specification[,page_specifications]

            where

            page_specification := single_page|page_range

            page_range := [first_page]-[last_page]

            An empty first_page is implied to be the first  page  of  the  DVI  file.   An  empty
            last_page is treated as the last page of the DVI file.

            Examples:

            -s 1,3,5
                 includes pages 1, 3, and 5;

            -s - includes all pages;

            -s -,-
                 includes two copies of all pages in the DVI file; and

            -s 1-10
                 includes the first ten pages of the DVI file.

       -t   Search  for  thumbnail  images  of  each  page  in  the directory named by the TMPDIR
            environment variable.  The thumbnail images must be named in a specific format.  They
            must  have  the  same base name as the DVI file and they must have the page number as
            the extension to the file name.  Dvipdfm does not generate the thumbnails itself, but
            it is distributed with a wrapper program named dvipdft that does so.

       -v   Increase  verbosity.   Results of the -v option are cumulative (e.g., -vv ) increases
            the verbosity by two increments.

       -x x_offset
            Set the left margin to x_offset.  The default left margin is  1.0in.   The  dimension
            may be specified in any units understood by TeX (e.g., bpt, pt, in, cm )

       -y y_offset
            Set  the top margin to y_offset.  The default top margin is 1.0in.  The dimension may
            be specified in any units understood by TeX (e.g., bpt, pt, in, cm )

       -z compression_level
            Set the compression level to compression_level.  Compressions levels range from 0 (no
            compression)  to  9  (maximum compression) and correspond to the values understood by
            zlib.

IMAGE BOUNDING BOXES

       When including images with dvipdfm, their bounding boxes should be  generated  by  running
       ebb, or extractbb -m.  The result will be in an .bb file.

       When  including  images with dvipdfmx, their bounding boxes should be generated by running
       extractbb.  The result will be in an .xbb file; the xbb information is the same as for the
       PDF format.

ENVIRONMENT

       Dvipdfm  uses  the  kpathsea  library  for  locating  the files that it opens.  Hence, the
       environment variables documented in the Kpathsea library documentation influence dvipdfm.

       Dvipdfm also reads the following environment variables:

       TMP  The directory to search for thumbnail images of each page.

FILES

       The precise location of  the  following  files  is  determined  by  the  Kpathsea  library
       configuration.  The location may be determined by using kpsewhich, e.g.,
       kpsewhich -progname=dvipdfm -format='other text files' config

       config
            Startup options

       t1fonts.map
            The default font map file (this name may be changed in the config file).

       *.tfm
            TeX font metrics

       *.vf TeX virtual font files

       *.pfb
            PostScript Type 1 font files

       texmf.cnf
            The  Kpathsea  library configuration file.  The location of this file may be found by
            typing
            kpsewhich texmf.cnf

SEE ALSO

       dvipdft(1), tex(1), dvips(1), groff(1), grodvi(1), pic(1), extractbb(1), and the  Kpathsea
       library info documentation.

AUTHOR

       Mark  A.  Wicks.  But for the version in TeX Live, all bugs and other reports should go to
       the dvipdfmx maintainers at dvipdfmx (at) ktug.or.kr.