1DVISPC(1)                   General Commands Manual                  DVISPC(1)
2
3
4

NAME

6       dvispc - Modify a DVI file to be page-independent in specials
7

SYNOPSIS

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

DESCRIPTION

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

SUPPORTED SPECIALS

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

SEE ALSO

91       dviselect(1), dvidvi(1), dvips(1), dvipdfmx(1)
92

AUTHOR

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)
Impressum