


dvipdfm(1)                                             dvipdfm(1)


NNAAMMEE
       dvipdfm - Produce PDF files directly from DVI files


SSYYNNOOPPSSIISS
       ddvviippddffmm [_o_p_t_i_o_n_s] _f_i_l_e[.dvi]


DDEESSCCRRIIPPTTIIOONN
       The  program ddvviippddffmm generates a PDF file from a DVI file.
       DVI files are the output format produced by  TeX.   Output
       from ggrrooffff can be converted to DVI format using ggrrooddvvii.

       The program ddvviippddffmm recognizes several commonly used \\ssppee--
       cciiaall commands, which are extensions  to  the  DVI  format.
       Specifically,  it  understands  color  specials, papersize
       specials, tpic specials (which allow it to  be  used  with
       ppiicc),  hypertex  specials,  and  some PostScript specials.
       These extensions allow documents to  contain  color,  fig-
       ures,  and  hyperlinks.   The  program  tries to mimic the
       behavior of ddvviippss so that many macro packages produced for
       use  with  ddvviippss  will  work with ddvviippddffmm..  Dvipdfm under-
       stands its own specific \\ssppeecciiaall commands to allow  access
       to  PDF  features  such as annotations and bookmarks.  For
       more details, consult the _D_v_i_p_d_f_m _U_s_e_r_'_s _M_a_n_u_a_l_, which  is
       distributed with ddvviippddffmm..


OOPPTTIIOONNSS
       --cc   Ignore  color  \\ssppeecciiaallss.  The --cc toggles a flag that
            disables color \\ssppeecciiaall processing.   Unless  changed
            in  the  configuration  file,  that  flag is off, and
            color \\ssppeecciiaalls are  interpreted  normally.   The  --cc
            option may be used to produce a black and white docu-
            ment from a document containing  color  TeX  \\ssppeecciiaall
            commands.


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


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


       --ff mmaapp__ffiillee
            Set the name of the font map file to  _m_a_p___f_i_l_e.   The
            format  of  the  font  map  file is documented in the
            _D_v_i_p_d_f_m _U_s_e_r_'_s _M_a_n_u_a_l.




                            5/28/2001                           1





dvipdfm(1)                                             dvipdfm(1)


       --ll   Select landscape mode.  In other words, exchange  the
            _x and _y dimensions of the paper.


       --mm  mmaagg
            Magnify the input document by _m_a_g.


       --oo  nnaammee
            Generate  PDF  output  file having the name _n_a_m_e.  By
            default, the name of the output file is _f_i_l_e.pdf.


       --pp  ppaappeerr
            Select the papersize by name  (e.g.,  lleetttteerr,  lleeggaall,
            lleeddggeerr,  ttaabbllooiidd,  aa33, aa44, aa55, aa66, bb33, bb44, bb55, bb66, or
            bb55vvaarr )


       --rr  ssiizzee
            Set resolution of bitmapped fonts to  ssiizzee  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.


       --ss  ppaaggee__ssppeecciiffiiccaattiioonnss
            Select  the  pages  of  the DVI file to be converted.
            The _p_a_g_e___s_p_e_c_i_f_i_c_a_t_i_o_n_s consists of a comma separated
            list of _p_a_g_e___r_a_n_g_e_s_:

            _p_a_g_e___s_p_e_c_i_f_i_c_a_t_i_o_n_s                                _:_=
            _p_a_g_e___s_p_e_c_i_f_i_c_a_t_i_o_n[,_p_a_g_e___s_p_e_c_i_f_i_c_a_t_i_o_n_s]

            where

            _p_a_g_e___s_p_e_c_i_f_i_c_a_t_i_o_n _:_= _s_i_n_g_l_e___p_a_g_e|_p_a_g_e___r_a_n_g_e

            _p_a_g_e___r_a_n_g_e _:_= [_f_i_r_s_t___p_a_g_e]-[_l_a_s_t___p_a_g_e]

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

            Examples:

            --ss 11,,33,,55
                 includes pages 1, 3, and 5;

            --ss -- includes all pages;

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



                            5/28/2001                           2





dvipdfm(1)                                             dvipdfm(1)


            --ss 11--1100
                 includes the first ten pages of the DVI file.

       --tt   Search  for  thumbnail  images  of  each  page in the
            directory named by the TTMMPP 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  thumb-
            nails  itself,  but  it is distributed with a wrapper
            program named ddvviippddfftt that does so.


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


       --xx xx__ooffffsseett
            Set the left margin to _x___o_f_f_s_e_t 11..00iinn.  The dimension
            may  be  specified  in  any  units  understood by TeX
            (e.g., bbpptt, pptt, iinn, ccmm )


       --yy yy__ooffffsseett
            Set the top margin to _y___o_f_f_s_e_t 11..00iinn.  The  dimension
            may  be  specified  in  any  units  understood by TeX
            (e.g., bbpptt, pptt, iinn, ccmm )


       --zz ccoommpprreessssiioonn__lleevveell
            Set the compression level to _c_o_m_p_r_e_s_s_i_o_n___l_e_v_e_l.  Com-
            pressions  levels  range from 0 (no compression) to 9
            (maximum compression) and correspond  to  the  values
            understood by zlib.


EENNVVIIRROONNMMEENNTT
       DDvviippddffmm  uses  the kkppaatthhsseeaa library for locating the files
       that it opens.  Hence,  the  environment  variables  docu-
       mented  in  the  _K_p_a_t_h_s_e_a  _l_i_b_r_a_r_y documentation influence
       ddvviippddffmm..

       Dvipdfm also reads the following environment variables:


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


FFIILLEESS
       The  precise location of the following files is determined
       by the _K_p_a_t_h_s_e_a _l_i_b_r_a_r_y configuration.  The  location  may
       be determined by using kpsewhich, e.g.,



                            5/28/2001                           3





dvipdfm(1)                                             dvipdfm(1)


       kkppsseewwhhiicchh --pprrooggnnaammee==ddvviippddffmm --ffoorrmmaatt==''ootthheerr tteexxtt ffiilleess'' ccoonnffiigg


       _c_o_n_f_i_g
            Startup options


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


       _*_._t_f_m
            TeX font metrics


       _*_._v_f TeX virtual font files


       _*_._p_f_b
            PostScript Type 1 font files


       _t_e_x_m_f_._c_n_f
            The Kpathsea library configuration file.   The  loca-
            tion of this file may be found by typing
            kkppsseewwhhiicchh tteexxmmff..ccnnff



SSEEEE AALLSSOO
       tteexx(1),  ddvviippss(1),  ggrrooffff(1),  ggrrooddvvii(1),  ppiicc(1), and the
       _K_p_a_t_h_s_e_a _l_i_b_r_a_r_y info documentation.


AAUUTTHHOORR
       Mark A. Wicks <mwicks@kettering.edu>




















                            5/28/2001                           4


