1. NAME

dvipos - compute positions in a DVI file

2. SYNOPSIS

dvipos [ OPTION... ] infile[.dvi]

3. DESCRIPTION

dvipos parses a DVI file looking for pos: specials. It currently recognizes pos:pxy, pos:pxywhd, pos:pxyplus, pos:begbox, pos:endbox, pos:beglines, and pos:endlines. It then outputs the information from those specials along with information that only a DVI postprocessor could determine, such as the current x and y location. The output looks like:

 
Sélectionnez
\\pospxywhd{text:54}{54}{10663sp}{8535sp}{21326sp}{34081sp}{0sp}

and is suitable for including in a

R tex (1) or

R pdftex (1) auxilliary file, such as document.tuo, to be read in by the next run of the

R tex (1) or similar typesetting engine.

4. OPTIONS

  • -h, --help
        print usage.
  • -W, --warning
        print warnings.
  • -v, --verbose
        print verbose output.
  • -d, --debug
        print

R dvitype (1) debugging data.

  • -s, --smashchars
        regard height and depth as zero.
  • \fB-o, --output=FILE
        send all output to FILE. Without this option, output goes to stdout.
  • -b, --bbox[=FILE]\fR
        send bounding box to FILE (default FILE is infile.pos).
  • -f, --framed[=BASE]\fR
        request copy of DVI file, BASE.dvi, with bounding boxes framed (default FILE is infile_frames.dvi). See the --framesize option.
  • \fB-m, --mag=INT
        override

R tex (1) magnification by INT.

  • \fB-w, --framesize=INT
        set frame rule size by INT (default 6554 = .1pt).
  • \fB-p, --pages=X:Y
        set page ranges from X to Y.

5. USAGE

dvipos is run mostly behind the scenes by ConTeXt's

R texexec (1) between runs of

R tex (1) or

R pdftex (1), in order to provide information to and get information about positional graphics. These graphics are provided by the MetaFun interface to

R mpost (1). dvipos is not used (or needed) in PDF-output mode but is needed for DVI-output mode.

R pdftex (1) starting with version 1.40 can produce position information even in DVI mode, so once the ConTeXt macros take advantage of this feature, the need for dvipos will fade. Until then, here is a typical use of dvipos:

 
Sélectionnez
dvipos notes.dvi

The position information that is output is collected by

R texexec (1) to include in the notes.tuo auxilliary file to use in the next run.

6. EXAMPLES

  • Extract positions from doc.dvi, with output to doc.loc:
  • Same as above, but also send bbox information to doc.pos:
  • Instead send bbox information to /tmp/debug.pos:
 
Sélectionnez
dvipos -o doc.loc doc.dvi
 
Sélectionnez
dvipos -b -o doc.loc doc.dvi
 
Sélectionnez
dvipos -b=/tmp/debug.pos -o doc.loc doc.dvi

7. SEE ALSO

R dvips (1),

R dvitype (1),

R mpost (1),

R pdftex (1),

R tex (1),

R texexec (1). For more about positional graphics, see the MetaFun documentation on the .URL "http://wiki.contextgarden.net/MetaFun" "ConTeXt wiki" .

8. BUGS

If you specify a file for the -b option, you must join the option and name with = rather than (the more common) space:

 
Sélectionnez
dvipos -b=/tmp/debug.pos notes.dvi

works, but

 
Sélectionnez
dvipos -b /tmp/debug.pos notes.dvi

does not.

9. AUTHOR

dvipos is written by Jin-Hwan Cho <>. It is free software (GPLv2 or later). This manpage was written by Sanjoy Mahajan <> and is in the public domain.