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 “-Tdvi” 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. Output is written to the
standard output stream.
The DVI file generated by grodvi can 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. Instead,
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.
A device control escape sequence \X'anything' is translated to the same DVI file instructions as would be
produced by \special{anything} in TeX; anything cannot contain a newline.
Typefacesgrodvi 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 are not mounted by default.
The troff option -mec loads the ec.tmac macro file, employing the EC and TC fonts instead of CM. These
are designed similarly to the Computer Modern fonts; further, they provide Euro \[Eu] and per mille \[%0]
glyphs. ec.tmac must be loaded before any language-specific macro files because it does not set up the
codes necessary for automatic hyphenation.
Fontdescriptionfiles
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.
internalnamename
The name of the TFM file (without the .tfm extension) is name.
checksumn
The checksum in the TFM file is n.
designsizen
The design size in the TFM file is n.
Drawingcommandsgrodvi supports an additional drawing command.
\D'Rdhdv'
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.
Install Now
PNG Icons
