1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
|
[2] Modify a DVI file to be page-independent in specials
[1] Translation between DVI file <-> Text file
Ver.0.2 written by SHIMA, Jan. 2003
Usage: dvispc [-c] [-bv] input_dvi_file [output_dvi_file]
dvispc -d input_dvi_file
dvispc -s [-p..] input_dvi_file [output_text_file]
dvispc -a [-jltv][-p..][-r..] input_dvi_file [output_text_file]
dvispc -x[..] [-dltv][-r..] [input_text_file] output_dvi_file
-c: make page-indepent DVI in specials for color push/pop, background, pn
-d: check page-independence
-b: backup original even if output_dvi_file is not given
-s: show specials
-a: translate DVI to Text
-x: translate Text to DVI (-x0:str0 1:chkfnt 2:variety)
-v: verbose -j: Japanese characters -l: location
-r: replace (-rorg_1=new_1/org_2=new_2... eg. -rxxx=special/fnt=font)
-p: T:preamble L:postamble pages with - (eg: -pT-L -pT2/4-8L -p-4 etc.)
-t: comaptible to DLT (the followings are suboptions if necessary eg. -t02)
0:str 1:ch 2:ch2 3:cmd 4:c-sum 5:dir/name 6:err 7:page 8:oct 9:str0
color specials: color push/pop, background
tpic specials: pn
*****************************************************
[1] ** Translation between DVI file <-> Text file **
*****************************************************
-a: transform DVI file into a text file (the option -v can be valid)
-x: transform a text to DVI file.
stack depth, page numbers and address are automatically corrected.
-x0 is equivalent to -x -t9
The text should be the same format obtained by -a option.
The line which starts with an alphabetical character of the lower
case or the character [ or ] or \ has only been interpreted.
The valid line is of the following format with several blocks separated by
spaces.
<key> <number><comment> ... <number><comment> '<string>' <any comment>
<key>: key word
<number>: decimal, hexadecimal starting with 0x or 0X, octal starting with 0
<comment>: void or a string without a space and not starting with a figure
indicate after <number> without a space.
This is ignored.
<any comment>: void or any string. This is ignored.
The number of the blocks of <number><comment> and the existence of '<string>'
is determined by <key> as follows.
List of <key> (X: 1 - 4 XX: 0 - 127 YY: 0 - 63)
<key> <number><comment> '<string>'
pre : 5 1
bop : 11 0
nop, eop, push, pop : 0 0
setcharXX : 0 0
fntnumYY : 0 0
setX, putX, rightX, downX : 1 0
setrule, writerule : 2 0
w0, x0, y0, z0 : 0 0
wX, xX, yX, zX : 1 0
fntX : 1 0
fntdefX : 6 1
xxxX : 1 1
dir : 1 0
post_post : 6 - 9 0
The following is used in DTL for illegal code
opcode : 1 0
The following expression in DTL are also valid.
push -> [ pop -> ]
fntnum -> fn set -> s put -> p right -> r down -> d
setrule -> sr putrule -> pr fnt -> f fntdef -> fd
dvispc can read the format of the DVIware DTL (dt2dv/dv2dt) by Geoffrey Tobin.
Transformations: [DVI file -> a text -> edit it -> DVI file] is possible
The following command makes foo2.dvi by extracting the pages 4,5,6,8 from
foo.dvi.
dvispc -atpT4-6/8L foo1.dvi | dvispc -x foo2.dvi
The following command is the same as the above.
dvispc -atpT4-6/8L foo1.dvi | dvispc -x > foo2.dvi
-x : 0: toggle length follows from the given string
1: toggle omit unnecessary definitions of fonts
2: toggle igonore the first line "variety ..."
(If it is not ignored and it exists, then -t option is set).
-p : Output instruction for DVI -> Text
T: preambre
L: postambre
<n>: page <n>
<n1>-<n2>: from the page <n1> to the page <n2>
If <n1> is omitted, <n1> is assumed to be 1.
If <n2> is omitted, <n2> is assumed to be the last page number.
There are indicated by separating by appropriate characters if necessary.
-pT-L default (total as in the original order)
-pTL preambre and postambre
-p3-15/20L the pages 3,4,5,...,15 and 20 in this order and postambre
-r -rorg_1=new_1/org_2=new_2/... means org_i is replaced by new_i for i=1,2..
Here org_i is the keyword omitting figures. For example
-rxxx=special/setchar=set_char_
The first letter of orig_i should be an alphabet in the small case if the
option -x is indicated.
-t : Transformation is done according to the DTL(dt2dv/dv2dt) by Geoffrey Tobin.
The following suboptions (0-9: toggle switch) can be indicated such as -t02.
The option -t with no suboption means that the following all suboptions
and the options corresponding to the switches -x0 -x1 -x2 are all On and -j
is Off and also the following line is inserted at the top in case of
DVI -> Text.
variety sequences-6
If in case of Text -> dvi this line exists at the top, -t is automatically
set.
0: str
A string is indicated by '...' with the transformations ' -> \' and
\ -> \\. A character whose code is smaller that 32 or larger than 126 is
expressed by hexadecimal as in the following.
1: ch
Characters with the code between 0 and 127 are indicated by (...).
Here the transformations ( -> \(, ) -> \) and \ -> \\ are used and the
character with the code between 0 and 31 or 127 is independently shown by
hexadecimal character starting with \ such as \12.
2: ch2
The code of a character larger than 128 is expressed in digits.
3: cmd
The key word corresponding to a code is in the format as in DTL.
4: c-sum
check sum in the font definition is expressed by octal.
5: dir/name
The string of fontname is expressed by dividing into the directory and name.
6: err
The illegal code is expressed by opcode x (x: code).
7: page
The page number is not shown.
8: oct
The octal number for the check sum of the font definition is expressed
without the top 0.
9: str0
The length of a string is determined by the given string in case of
Text -> DVI.
-l: The address of the code is shown at the top of line.
In this case
0: pre 2 ...
exists at the head.
In case of Text -> DVI, the option -l is set if this line exists.
-j: toggle, If the code of the character is within JIS code, then the
corresponding character is shown.
************************************************************
[2] ** Modify a DVI file to be page-independent in specials **
************************************************************
DVI file should be page-independent in principle. But some specials break this
principle.
For example, color specials of graphics package of LaTeX2e for dvips break this.
Suppose there is a command to make letters red at page 2 of a document with the
total pages 100 and it continues up to page 99. Then there is no command to
make letters red at page 50.
\usepackages[dvips]{graphicx, color}
...
{\color{red}% page 2
...
...
...% page 99
}
...
dvips reads a DVI file from the first page and therefore it correctly interprets
color specials. But some other DVIwares such as dviout (previewer) cannot do so
because it may be requested only to display the page 50. The same problem
occurs for some DVI tools such as dvidvi.
dvispc modifies such a DVI file to be page-independent. Supporting specials are
color specials: color push/pop, background
tpic specials : sh, pn
--- specifications ---
-c: the above modification will be done
-s: show all specials in DVI file
-d: check the necessity of the modification
If none of the parameters -s -d -a -x is indicated, dvispc modifies DVI file as
described.
color specials: dvispc inserts necessary specials "color pop" at the end of each
page so that the stack becomes empty there. Then it also inserts necessary
specials "color push" at the top of the following page.
dvispc checks the underflow and overflow (the limit is about 500 in dvispc)
of this stack. Usually the overflow of stack occurs by the wrong source of
TeX. In the case of the unerflow, dvispc writes specials "color push Black"
at the top of the corresponding page to recover the error.
background : If the "background" color is defined in a page and the
definition is not written in another page where the definition should be
valid, then the definition is inserted at the top of the page.
tpic specials : If tpic special "pn" is defined, then the same special will be
inserted at the top of the following pages.
The order to be inserted at the top of each page is as follows
color push -> background -> pn (tpic special)
|
