1DVISPC(1) General Commands Manual DVISPC(1)
2
3
4
6 dvispc - Modify a DVI file to be page-independent in specials
7
9 dvispc [-c] [-bvz] input_dvi_file [output_dvi_file]
10
11 dvispc -d input_dvi_file
12
13 dvispc -s [-p..] input_dvi_file [output_text_file]
14
15 dvispc -a [-ltv] [-J..] [-p..] [-r..] input_dvi_file [out‐
16 put_text_file]
17
18 dvispc -x[..] [-ltv] [-r..] [input_text_file] output_dvi_file
19
21 Dvispc is a utility to modify/edit TeX DVI file with the following fea‐
22 tures:
23
24 Mode option -c (default):
25 correct an input DVI to be page-independent in specials
26 (default)
27
28 Mode option -d:
29 dry run to check if an input DVI is page-independent in spe‐
30 cials
31
32 Mode option -s:
33 show all specials in the input DVI
34
35 Mode option -a:
36 translate DVI into a Text (like dv2dt in dtl)
37
38 Mode option -x:
39 translate Text into a DVI (like dt2dv in dtl)
40
41 (1) The main feature of dvispc is the first one, to make a page-inde‐
42 pendent DVI file.
43
44 A "pure" DVI file must be actually page-independent. However in recent
45 years, DVI files with lots of \special's (color, annotation etc.) are
46 commonly used, and they are not always page-independent. In such case,
47 for example, dviselect or dvidvi fails to preserve \special's (e.g.
48 page color might be lost).
49
50 The program dvispc corrects such page-"dependent" DVI files to be page-
51 independent, which can be safely processed by dviselect or dvidvi and
52 then properly converted to other formats such as PostScript and PDF.
53
54 (2) To know whether such a correction is needed or not, dvispc -d will
55 suffice.
56
57 (3) The mode -s lists all specials found in the input DVI as-is, with a
58 preceding number which denotes the page where it appears. For example,
59
60 [1]
61 {color push Black}
62 {color pop}
63 {color push rgb 1 0 0}
64 {color pop}
65 [2]
66 {color push Black}
67 {color pop}
68
69 This feature is equivalent to a program dvispecials in TeX-Guy package
70 <http://www-masu.ist.osaka-u.ac.jp/%7Ekakugawa/TeX-Guy/> and dvii -s
71 <https://ctan.org/pkg/dvii>.
72
73 (4) The mode -a and -x correspond to dv2dt and dt2dv in the dtl (= DVI
74 Text Language) package respectively. By default dvispc -a formats the
75 output text in its own style, but DTL-compatible format is available
76 with -t option. Also, dvispc -x can accept DTL-compatible text input.
77
79 Currently dvispc supports the followings:
80
81 dvips-compatible specials
82 color push, color pop, background
83 dvipdfm(x) specials
84 pdf:bcolor, pdf:ecolor, pdf:bgcolor, pdf:bann, pdf:eann
85 tpic specials:
86 pn
87
88 Other specials might be supported in the future if needed.
89
91 dviselect(1), dvidvi(1), dvips(1), dvipdfmx(1)
92
94 The program dvispc is derived from the DVIOUT package (DVI previewer
95 for Windows) by Toshio OSHIMA ("SHIMA"), Yoshiki OTOBE, and Kazunori
96 ASAYAMA. Current version is maintained by Japanese TeX Development
97 Community <https://texjp.org>.
98 For more information, please refer to dvispc-en.txt (in English) and
99 dvispc-ja.txt (in Japanese) on our GitHub repository,
100 <https://github.com/texjporg/tex-jp-build> (under source/texk/dviout-
101 util directory).
102
103
104
105 DVISPC(1)