# grodvi

## Name



           grodvi - _groff_ output driver for TeX DVI format
    


## Synopsis



           **grodvi**[**-dl**] [**-F** _dir_] [**-p** _paper-format_] [**-w** _n_] [_file_ ...]
    
           **grodvi --help**
    
           **grodvi -v**
    
           **grodvi --version**
    


## Description



           The GNU _roff_ DVI output driver translates the output of _troff_(1)
           into TeX DVI format.  Normally, _grodvi_ is invoked by _groff_(1) when
           the latter is given the “**-T dvi** ” option.  (In this installation,
           **ps** is the default output device.)  Use _groff_ 's **-P** option to pass
           any options shown above to _grodvi_.  If no _file_ arguments are
           given, or if _file_ is “-”, _grodvi_ reads the standard input stream.
           It writes to the standard output stream.
    
           The DVI file generated by _grodvi_ can be interpreted by any
           correctly written DVI driver.  _troff_ drawing primitives are
           implemented using _tpic_ version 2 specials.  If the driver does not
           support these, **\D** escape sequences will not produce any output.
    
           Encapsulated PostScript (EPS) files can be easily included; use
           the **PSPIC** macro.  _pspic.tmac_ is loaded automatically by _dvi.tmac_.
           See _groff_tmac_(5).
    
           The default color used by the **\m** and **\M** escape sequences is black.
           Currently, the stroke color for **\D** drawing escape sequences is
           black; fill color values are translated to gray.
    
           In _groff_ , as in AT&T _troff_ , the **\N** escape sequence can be used to
           access any glyph in the current font by its position in the
           corresponding TFM file.
    
           By design, the DVI format doesn't care about the physical
           dimensions of the output medium.  See subsection “Device extension
           commands” below.
    
       **Typefaces**
           _grodvi_ supports the standard four styles: **R**(roman), **I**(_italic_), **B**
           (**bold**), and **BI**(_**bold-italic**_).  Fonts are grouped into families **T**
           and **H** having members in each style.  “CM” abbreviates “Computer
           Modern”.
    
                  **TR** CM Roman (cmr10)
                  **TI** CM Text Italic (cmti10)
                  **TB** CM Bold Extended Roman (cmbx10)
                  **TBI** CM Bold Extended Text Italic (cmbxti10)
                  **HR** CM Sans Serif (cmss10)
                  **HI** CM Slanted Sans Serif (cmssi10)
                  **HB** CM Sans Serif Bold Extended (cmssbx10)
                  **HBI** CM Slanted Sans Serif Bold Extended (cmssbxo10)
    
           The following fonts are not members of a family.
    
                  **CW** CM Typewriter Text (cmtt10)
                  **CWI** CM Italic Typewriter Text (cmitt10)
    
           Special fonts include **MI**(cmmi10), **S**(cmsy10), **EX**(cmex10), **SC**
           (cmtex10, only for **CW**), and, perhaps surprisingly, **TR** , **TI** , and **CW** ,
           because TeX places some glyphs in text fonts that _troff_ generally
           does not.  For italic fonts, **CWI** is used instead of **CW**.
    
           Finally, the symbol fonts of the American Mathematical Society are
           available as special fonts **SA**(msam10) and **SB**(msbm10).  They are
           not mounted by default.
    
           You can load the _ec.tmac_ macro file to employ the EC and TC fonts
           instead of CM, which they resemble.  They also provide Euro **\[Eu]**
           and per mille **\[%0]** glyphs.  Do so before loading localization
           macro files, because _ec.tmac_ does not set up automatic hyphenation
           codes.
    
       **Device extension commands**
           _grodvi_ emits the equivalent to TeX's **\special{**
           **papersize=**_width_**,**_length_**}** on the first page; _dvips_ (or another DVI
           driver) then sets the page size accordingly.  If either the page
           width or length is not positive, no **papersize** special is output.
    
           _grodvi_ supports one device extension, accessed with the _groff_
           request **device** or _roff_ **\X** escape sequence.
    
           **\X'papersize=**_width_**,**_length_**'**
                  Set the page dimensions in centimeters to _width_ by _length._
                  If the **-l** option was specified, these dimensions are
                  swapped.  Changes to the paper dimensions should occur
                  prior to the first page, or during page ejection before
                  starting a subsequent one.
    
                  _Caution:_ the ordering of dimensions differs from that used
                  by _papersize.tmac_ and _troff_(1)'s “**-d paper** ” option.
    
           The parameter(s) to **device** and **\X** are translated to the same DVI
           file instructions as would be produced by **\special{**_anything_**}** in
           TeX; _anything_ cannot contain a newline.
    
       **Font description files**
           Use _tfmtodit_(1) to create _groff_ font description files from TFM
           (TeX font metrics) files.  The font description file should
           contain the following additional directives, which _tfmtodit_
           generates automatically.
    
           **internalname** _name_
                  The name of the TFM file (without the _.tfm_ extension) is
                  _name_.
    
           **checksum** _n_
                  The checksum in the TFM file is _n_.
    
           **designsize** _n_
                  The design size in the TFM file is _n_.
    
       **Drawing commands**
           _grodvi_ supports an additional drawing command.
    
           **\D'R** _dh dv_**'**
                  Draw a rule (solid black rectangle) with one corner at the
                  drawing position, and the diagonally opposite corner at the
                  drawing position +(_dh_ ,_dv_), which becomes the new drawing
                  position afterward.  This command produces a rule in the
                  DVI file and so can be printed even with a driver that does
                  not support _tpic_ specials, unlike the other **\D** commands.
    


## Options



           **--help** displays a usage message, while **-v** and **--version** show
           version information; all exit afterward.
    
           **-d** Do not use _tpic_ specials to implement drawing commands.
                   Horizontal and vertical lines are implemented by rules.
                   Other drawing commands are ignored.
    
           **-F** _dir_  Prepend directory dir _/dev_ name to the search path for font
                   and device description files; _name_ is the name of the
                   device, usually **dvi**.
    
           **-l** Use landscape orientation rather than portrait.
    
           **-p** _paper-format_
                   Set physical dimensions of output medium, overriding the
                   **papersize** , **paperlength** , and **paperwidth** directives in the
                   _DESC_ file.  _paper-format_ can be any argument accepted by
                   the **papersize** directive; see _groff_font_(5).
    
           **-w** _n_    Draw rules (lines) with a thickness of _n_ thousandths of an
                   em.  The default thickness is **40**(0.04 em).
    


## Exit status



           _grodvi_ exits with status **0** on successful operation, status **2** if
           the program cannot interpret its command-line arguments, and
           status **1** if it encounters an error during operation.
    


## Environment



           _GROFF_FONT_PATH_
                  lists directories in which to search for _devdvi_ , _grodvi_ 's
                  directory of device and font description files.  See
                  _troff_(1) and _groff_font_(5).
    


## Files



           _/usr/local/share/groff/1.23.0/font/devdvi/DESC_
                  describes the **dvi** output device.
    
           _/usr/local/share/groff/1.23.0/font/devdvi/_ F
                  describes the font known as _F_ on device **dvi**.
    
           _/usr/local/share/groff/1.23.0/tmac/dvi.tmac_
                  defines font mappings, special characters, and colors for
                  use with the **dvi** output device.  It is automatically loaded
                  by _troffrc_ when the **dvi** output device is selected.
    
           _/usr/local/share/groff/1.23.0/tmac/ec.tmac_
                  configures the **dvi** output device to use the EC and TC font
                  families instead of CM (Computer Modern).
    


## Bugs



           DVI files produced by _grodvi_ use a different resolution (57,816
           units per inch) from those produced by TeX.  Incorrectly written
           drivers which assume the resolution used by TeX, rather than using
           the resolution specified in the DVI file, will not work with
           _grodvi_.
    
           When using the **-d** option with boxed tables, vertical and
           horizontal lines can sometimes protrude by one pixel.  This is a
           consequence of the way TeX requires that the heights and widths of
           rules be rounded.
    


## See also



           “What are the EC fonts?”  ⟨https://texfaq.org/FAQ-ECfonts⟩; TeX
           FAQ: Frequently Asked Question List for TeX
    
           _tfmtodit_(1), _groff_(1), _troff_(1), _groff_out_(5), _groff_font_(5),
           _groff_char_(7), _groff_tmac_(5)
    


* * *