1dvipost(1) General Commands Manual dvipost(1)
2
6 dvipost, pptex, pplatex - post processing of dvi files
7
10 dvipost [-debug] [-version] [-help] in out
11 pplatex [-debug] [-version] [-help] [LaTeX-Arguments]
13 pptex [-debug] [-version] [-help] [TeX-Arguments]
15
18 The command dvipost is a post procesor for dvi files, created by latex
19 or tex. It is used for special modes, which normally needs the support
20 of dvi drivers (such as dvips). With dvipost, this features could be
21 implemented independent of the prefered driver. Currently, the post
22 processor supports layout raster, change bars and overstrike mode.
23 This version of dvipost does not seek the dvi file, so it could be used
25 as a filter. If - is given as file name, the command uses standard
26 input or standard output respective. The command does not substitute a
27 missing .dvi extension to the filename.
28 Because the command works with a temporary file and creates the ouput
30 file only after successfull processing the input file, it is possible
31 to use the same name for input and output.
32 If the command is renamed or linked to pplatex/pptex, it runs latex/tex
34 and post processes the createt output. If the name of the dvi file
35 could not be determined by the arguments to latex/tex (e.g. on an
36 interactive run), the command processes all dvi files in the current
37 directory with a modification time later than the run of latex/tex.
38 Basics
41 If the filter is used in context of LaTeX, the style file dvipost.sty
42 should be included in the LaTeX source.
43 The filter interpretes dvi extensions in the form of
45 dvipost: name [arg]
46 where arg depends on the command name and may be separated from name by
47 = or space. All other extensions are not interpreted by dvipost and
48 remain in the dvi file.
49 Such a dvipost command could be placed with the TeX primitive
51 \special{dvipost: cmd}
52 or the LaTeX macro (provided by dvipost.sty)
53 \dvipost{cmd}
54 in the dvi file.
55 Depending on the type of dvipost commands, the following kinds of argu‐
57 ments may be used:
58 length is a floating point number followed by a unit specification.
59 The following units are supportet by divipost: pt, in, cm and
60 mm. If no argument is given or the unit specification is miss‐
61 ing, the corresponding length is set to 0.
62 string is an arbitrary string argument.
63 flag is an integer argument, where a value different from 0 (usually
64 1) means true and a missing value or 0 means false.
65 depth is an integer argument, where a value different from 0 (usually
66 1) increments a depth counter and a missing value or 0 decre‐
67 ments it.
68 Change bars
70 All text printed with change mode level higher than 0 is marked with a
71 change bar.
72 The following LaTeX macros modifies the change mode level:
74 \changestart
76 increments the change mode level.
77 \changeend
78 decrements the change mode level.
79 \textchanged{text}
80 increments the change mode level for text only.
81 The following dvipost commands are used in context of change bars:
83 cbmode depth
84 increments/decrements the change mode level. This command is
85 used by the LaTeX macros.
86 cbrule length
87 determines the thickness of the change bar. The default value is
88 2pt.
89 cbsep length
90 sets the distance beetween page margin and change bar. The
91 default value is 2pt.
92 cbexp length
93 sets the additional height and depth of a character in calculat‐
94 ing the change bar positions. The default value is 6pt.
95 cbstart string
96 places the dvi extension string before printing characters in
97 change mode.
98 cbend string
99 places the dvi extension string after printing characters in
100 change mode.
101 The use of cbstart and cbend allows to set additional attributes to the
103 marked text, depending on the dvi driver.
104 If dvips is used as dvi driver and the preamble of the LaTeX source
106 contains
107 \usepackage{dvipost}
108 \dvipost{cbstart color push Blue}
109 \dvipost{cbend color pop}
110 the marked text is colored blue.
111 Overstrike mode
114 All text printed with overstrike level higher than 0 is overstriked
115 with a horizontal line.
116 The overstrike line is positioned at the mean height of every block of
118 text not broken by vertical movements and font changes.
119 The following LaTeX macros modifies the overstrike level:
121 \overstrikeon
123 increments the overstrike level.
124 \overstrikeoff
125 decrements the overstrike level.
126 \overstrike{text}
127 increments the overstrike level for text only.
128 The following dvipost commands are used in context of overstrike mode:
130 osmode depth
131 increments/decrements the overstrike level. This command is
132 used by the LaTeX macros.
133 osrule length
134 sets the thickness of the overstrike line to length. The
135 default value is \fboxrule.
136 osstart string
137 places the dvi extension string before change of overstrike
138 mode.
139 osend string
140 places the dvi extension string after change of overstrike mode.
141 The use of osstart and osend is similar to cbstart and cbend.
143 Layout parameters
146 Layout parameters are transfered to the dvi file on loading the style
147 file. If any changes are made to layout parameters, like \evensidemar‐
148 gin, the macro \dvipostlayout must be called to get the correct place‐
149 ment of change bars. Additional calls to \dvipostlayout are harmeless.
150 The following layout parameters are transfered to the dvi file: \hoff‐
152 set, \voffset, \textwidth, \textheight, \oddsidemargin, \evensidemar‐
153 gin, \topmargin, \headheight, \headsep, \footskip, \marginparsep and
154 \marginparwidth. Additional the flag twoside is set to 0 or 1, depend‐
155 ing on the document style option twoside.
156 Instead of calling \dvipostlayout, partciucular values could be set.
158 The command
159 \dvipost{evensidemargin=\the\evensidemargin}
160 transfers the actual setting of \evensidemargin to the dvi file.
161 The dvipost command allows the printing of the layout raster by setting
163 layout to a length different to 0. The value of layout is used as the
164 thickness of the raster lines.
165 For example: The command
167 \dvipost{layout=\the\fboxrule}
168 activates the layout raster and uses the same line thicknes as frame
169 boxes.
170
173 The filter is primarly written for LaTeX. It could be used for plain
174 TeX, but currently there is no assistance style file included in the
175 distribution. Maybe somone would write one, I am not a plain TeX user.
176 The current state of change bar mode and overstrike mode must be com‐
178 mitted do environments, which are placed on different locations than
179 the current text. This is done in dvipost.sty by redefining \color@beg‐
180 ingroup and \color@endgroup. This may conflict with other packages.
181 If the macro \footnoterule is redefined, it should start with the com‐
183 mand \dvipost{footnote} for a correct handling of overstrike mode and
184 change bars.
185
188 Copyright (C) 2002 Erich Fruehstueck
189 dvipost(1)