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

NAME

6       dvipost, pptex, pplatex - post processing of dvi files
7
8

SYNOPSIS

10       dvipost [-debug] [-version] [-help] in out
11
12       pplatex [-debug] [-version] [-help] [LaTeX-Arguments]
13
14       pptex [-debug] [-version] [-help] [TeX-Arguments]
15
16

DESCRIPTION

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
24       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
29       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
33       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
39
40   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
44       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
50       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
56       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
69   Change bars
70       All text printed with change mode level higher than 0 is marked with  a
71       change bar.
72
73       The following LaTeX macros modifies the change mode level:
74
75       \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
82       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
102       The use of cbstart and cbend allows to set additional attributes to the
103       marked text, depending on the dvi driver.
104
105       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
112
113   Overstrike mode
114       All  text  printed  with  overstrike level higher than 0 is overstriked
115       with a horizontal line.
116
117       The overstrike line is positioned at the mean height of every block  of
118       text not broken by vertical movements and font changes.
119
120       The following LaTeX macros modifies the overstrike level:
121
122       \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
129       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
142       The use of osstart and osend is similar to cbstart and cbend.
143
144
145   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
151       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
157       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
162       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
166       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
171

NOTES

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
177       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
182       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
186
188       Copyright (C) 2002 Erich Fruehstueck
189
190
191
192                                                                    dvipost(1)
Impressum