table of contents
other versions
- wheezy 1.1-4
dvipost(1) | General Commands Manual | dvipost(1) |
NAME¶
dvipost, pptex, pplatex - post processing of dvi filesSYNOPSIS¶
dvipost [-debug] [-version] [-help] in outDESCRIPTION¶
The command dvipost is a post procesor for dvi files, created by latex or tex. It is used for special modes, which normally needs the support of dvi drivers (such as dvips). With dvipost, this features could be implemented independent of the prefered driver. Currently, the post processor supports layout raster, change bars and overstrike mode.Basics¶
If the filter is used in context of LaTeX, the style file dvipost.sty should be included in the LaTeX source.dvipost: name [arg]
where arg depends on the command name and may be separated from
name by = or space. All other extensions are not interpreted by
dvipost and remain in the dvi file.
\special{dvipost:
cmd}
or the LaTeX macro (provided by dvipost.sty)
\dvipost{cmd}
in the dvi file.
- length
- is a floating point number followed by a unit specification. The following units are supportet by divipost: pt, in, cm and mm. If no argument is given or the unit specification is missing, the corresponding length is set to 0.
- string
- is an arbitrary string argument.
- flag
- is an integer argument, where a value different from 0 (usually 1) means true and a missing value or 0 means false.
- depth
- is an integer argument, where a value different from 0 (usually 1) increments a depth counter and a missing value or 0 decrements it.
Change bars¶
All text printed with change mode level higher than 0 is marked with a change bar.- \changestart
- increments the change mode level.
- \changeend
- decrements the change mode level.
- \textchanged{text}
- increments the change mode level for text only.
- cbmode depth
- increments/decrements the change mode level. This command is used by the LaTeX macros.
- cbrule length
- determines the thickness of the change bar. The default value is 2pt.
- cbsep length
- sets the distance beetween page margin and change bar. The default value is 2pt.
- cbexp length
- sets the additional height and depth of a character in calculating the change bar positions. The default value is 6pt.
- cbstart string
- places the dvi extension string before printing characters in change mode.
- cbend string
- places the dvi extension string after printing characters in change mode.
\usepackage{dvipost}
\dvipost{cbstart color push Blue}
\dvipost{cbend color pop}
the marked text is colored blue.
Overstrike mode¶
All text printed with overstrike level higher than 0 is overstriked with a horizontal line.- \overstrikeon
- increments the overstrike level.
- \overstrikeoff
- decrements the overstrike level.
- \overstrike{text}
- increments the overstrike level for text only.
- osmode depth
- increments/decrements the overstrike level. This command is used by the LaTeX macros.
- osrule length
- sets the thickness of the overstrike line to length. The default value is \fboxrule.
- osstart string
- places the dvi extension string before change of overstrike mode.
- osend string
- places the dvi extension string after change of overstrike mode.
Layout parameters¶
Layout parameters are transfered to the dvi file on loading the style file. If any changes are made to layout parameters, like \evensidemargin, the macro \dvipostlayout must be called to get the correct placement of change bars. Additional calls to \dvipostlayout are harmeless.\dvipost{evensidemargin=\the\evensidemargin}
transfers the actual setting of \evensidemargin to the dvi file.
\dvipost{layout=\the\fboxrule}
activates the layout raster and uses the same line thicknes as frame boxes.