dv2dt (1) Linux Manual Page

NAME

dv2dt – convert a binary TeX DVI file to DTL text representation

SYNOPSIS

dv2dt input-DVI-file output-DTL-file

If the filenames are omitted, then stdin and stdout are assumed.

DESCRIPTION

dv2dt converts a binary TeX DVI file to an editable text file in DTL (DVI Text Language) format. The companion dt2dv(1) utility can convert the DTL file back to a binary DVI file.

DVI COMMAND DESCRIPTION

TeX DVI files contain a compact binary description of typeset pages, as a stream of operation code bytes, each immediately followed by zero or more parameter bytes. The format of DVI files is fully described in Donald E. Knuth, TeX: The Program, Addison-Wesley (1986), ISBN 0-201-13437-3, as well as in the dvitype(1) literate program source code.

For convenience, we provide a summary of DVI commands here. In the following list, operation code bytes are given as unsigned decimal values, followed by their symbolic names (not present in the DVI file), and a short description. A designation like b[+n] means that the operation code byte is followed by a parameter b which uses n bytes, and is signed. Without the plus sign, the parameter is unsigned. Signed integer parameter values are always represented in two’s complement arithmetic, which is the system followed by most computers manufactured today, including all personal computers and workstations.

0 set_char_0 Set character 0 from current font.

…

127 set_char_127

Set character 127 from current font.

128 set1 c[1]

Set 1-byte unsigned character (uchar) number c.

129 set2 c[2]

Set 2-byte uchar number c.

130 set3 c[3]

Set 3-byte uchar number c.

131 set4 c[+4]

Set 4-byte signed character (schar) number c.

132 set_rule a[+4] b[+4]

Set rule, height a, width b.

133 put1 c[1]

Put 1-byte uchar c.

134 put2 c[2]

Put 2-byte uchar c.

135 put3 c[3]

Put 3-byte uchar c.

136 put4 c[+4]

Put 4-byte schar c.

137 put_rule a[+4] b[+4]

Put rule, height a, width b.

138 nop

Do nothing.

139 bop c0[+4] … c9[+4] p[+4]

Beginning of page. The parameters c0 … c9 are the TeX page counters, the contents of TeX count registers