| 1 |
.TH DVISPC 1 |
| 2 |
\"===================================================================== |
| 3 |
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP |
| 4 |
.if n .ds TX TeX |
| 5 |
.\" LX definition must follow TX so LX can use TX |
| 6 |
.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX |
| 7 |
.if n .ds LX LaTeX |
| 8 |
\"===================================================================== |
| 9 |
.SH NAME |
| 10 |
dvispc \- Modify a DVI file to be page-independent in specials |
| 11 |
.SH SYNOPSIS |
| 12 |
.B dvispc |
| 13 |
[\fB\-c\fR] [\fB\-bvz\fR] |
| 14 |
\fIinput_dvi_file\fR [\fIoutput_dvi_file\fR] |
| 15 |
.PP |
| 16 |
.B dvispc \-d |
| 17 |
\fIinput_dvi_file\fR |
| 18 |
.PP |
| 19 |
.B dvispc \-s |
| 20 |
[\fB\-p..\fR] \fIinput_dvi_file\fR [\fIoutput_text_file\fR] |
| 21 |
.PP |
| 22 |
.B dvispc \-a |
| 23 |
[\fB\-ltv\fR] [\fB\-J..\fR] [\fB\-p..\fR] [\fB\-r..\fR] |
| 24 |
\fIinput_dvi_file\fR [\fIoutput_text_file\fR] |
| 25 |
.PP |
| 26 |
.B dvispc \-x[..] |
| 27 |
[\fB\-ltv\fR] [\fB\-r..\fR] |
| 28 |
[\fIinput_text_file\fR] \fIoutput_dvi_file\fR |
| 29 |
.SH DESCRIPTION |
| 30 |
.B Dvispc |
| 31 |
is a utility to modify/edit \*(TX DVI file with the following features: |
| 32 |
.PP |
| 33 |
Mode option \fB\-c\fR (default): |
| 34 |
correct an input DVI to be page-independent in specials (default) |
| 35 |
.PP |
| 36 |
Mode option \fB\-d\fR: |
| 37 |
dry run to check if an input DVI is page-independent in specials |
| 38 |
.PP |
| 39 |
Mode option \fB\-s\fR: |
| 40 |
show all specials in the input DVI |
| 41 |
.PP |
| 42 |
Mode option \fB\-a\fR: |
| 43 |
translate DVI into a Text (like \fBdv2dt\fR in dtl) |
| 44 |
.PP |
| 45 |
Mode option \fB\-x\fR: |
| 46 |
translate Text into a DVI (like \fBdt2dv\fR in dtl) |
| 47 |
.PP |
| 48 |
(1) The \fImain\fR feature of |
| 49 |
.B dvispc |
| 50 |
is the first one, to make a page-independent DVI file. |
| 51 |
.PP |
| 52 |
A "pure" DVI file must be actually page-independent. |
| 53 |
However in recent years, DVI files with lots of \\special's (color, |
| 54 |
annotation etc.) are commonly used, and they are not always |
| 55 |
page-independent. In such case, for example, |
| 56 |
.B dviselect |
| 57 |
or |
| 58 |
.B dvidvi |
| 59 |
fails to preserve \\special's (e.g. page color might be lost). |
| 60 |
.PP |
| 61 |
The program |
| 62 |
.B dvispc |
| 63 |
corrects such page-"dependent" DVI files to be page-independent, |
| 64 |
which can be safely processed by |
| 65 |
.B dviselect |
| 66 |
or |
| 67 |
.B dvidvi |
| 68 |
and then properly converted to other formats such as PostScript and PDF. |
| 69 |
.PP |
| 70 |
(2) To know whether such a correction is needed or not, |
| 71 |
.B dvispc \-d |
| 72 |
will suffice. |
| 73 |
.PP |
| 74 |
(3) The mode \fB\-s\fR lists all specials found in the input DVI as-is, |
| 75 |
with a preceding number which denotes the page where it appears. |
| 76 |
For example, |
| 77 |
.PP |
| 78 |
.RS |
| 79 |
[1] |
| 80 |
.br |
| 81 |
{color push Black} |
| 82 |
.br |
| 83 |
{color pop} |
| 84 |
.br |
| 85 |
{color push rgb 1 0 0} |
| 86 |
.br |
| 87 |
{color pop} |
| 88 |
.br |
| 89 |
[2] |
| 90 |
.br |
| 91 |
{color push Black} |
| 92 |
.br |
| 93 |
{color pop} |
| 94 |
.RE |
| 95 |
.LP |
| 96 |
This feature is equivalent to a program |
| 97 |
.B dvispecials |
| 98 |
in TeX-Guy package |
| 99 |
<http://www-masu.ist.osaka-u.ac.jp/%7Ekakugawa/TeX-Guy/> |
| 100 |
and |
| 101 |
.B dvii \-s |
| 102 |
<https://ctan.org/pkg/dvii>. |
| 103 |
.PP |
| 104 |
(4) The mode \fB-a\fR and \fB-x\fR correspond to |
| 105 |
.B dv2dt |
| 106 |
and |
| 107 |
.B dt2dv |
| 108 |
in the dtl (= DVI Text Language) package respectively. By default |
| 109 |
.B dvispc \-a |
| 110 |
formats the output text in its own style, but DTL-compatible |
| 111 |
format is available with |
| 112 |
.B \-t |
| 113 |
option. Also, |
| 114 |
.B dvispc \-x |
| 115 |
can accept DTL-compatible text input. |
| 116 |
.SH SUPPORTED SPECIALS |
| 117 |
Currently |
| 118 |
.B dvispc |
| 119 |
supports the followings: |
| 120 |
.PP |
| 121 |
dvips-compatible specials |
| 122 |
color push, color pop, background |
| 123 |
dvipdfm(x) specials |
| 124 |
pdf:bcolor, pdf:ecolor, pdf:bgcolor, pdf:bann, pdf:eann |
| 125 |
tpic specials: |
| 126 |
pn |
| 127 |
.PP |
| 128 |
Other specials might be supported in the future if needed. |
| 129 |
.SH SEE ALSO |
| 130 |
dviselect(1), dvidvi(1), dvips(1), dvipdfmx(1) |
| 131 |
.SH AUTHOR |
| 132 |
The program |
| 133 |
.B dvispc |
| 134 |
is derived from the DVIOUT package (DVI previewer for Windows) |
| 135 |
by Toshio OSHIMA ("SHIMA"), Yoshiki OTOBE, and Kazunori ASAYAMA. |
| 136 |
Current version is maintained by Japanese \*(TX Development Community |
| 137 |
<https://texjp.org>. |
| 138 |
.br |
| 139 |
For more information, please refer to |
| 140 |
dvispc-en.txt (in English) and dvispc-ja.txt (in Japanese) |
| 141 |
on our GitHub repository, <https://github.com/texjporg/tex-jp-build> |
| 142 |
(under source/texk/dviout-util directory). |