# dvipos(1) - man - phpMan

[DVIPOS(1)](https://www.chedong.com/phpMan.php/man/DVIPOS/1/markdown)                                      ConTeXt                                     [DVIPOS(1)](https://www.chedong.com/phpMan.php/man/DVIPOS/1/markdown)



## NAME
       dvipos - compute positions in a DVI file


## SYNOPSIS
       **dvipos** [ _OPTION_... ] _infile[.dvi]_


## 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 postpro‐
       cessor could determine, such as the current _x_ and _y_ location.  The output looks like:
          \pospxywhd{text:54}{54}{10663sp}{8535sp}{21326sp}{34081sp}{0sp}
       and is suitable for including in a [**tex**(1)](https://www.chedong.com/phpMan.php/man/tex/1/markdown) or [**pdftex**(1)](https://www.chedong.com/phpMan.php/man/pdftex/1/markdown) auxilliary file, such as _document.tuo_,
       to be read in by the next run of the [**tex**(1)](https://www.chedong.com/phpMan.php/man/tex/1/markdown) or similar typesetting engine.


## OPTIONS
### -h, --help
              print usage.

### -W, --warning
              print warnings.

### -v, --verbose
              print verbose output.

### -d, --debug
              print [**dvitype**(1)](https://www.chedong.com/phpMan.php/man/dvitype/1/markdown) debugging data.

### -s, --smashchars
              regard height and depth as zero.

### -o, --output=
              send all output to FILE.  Without this option, output goes to stdout.

### -b, --bbox[=
              send bounding box to FILE (default FILE is _infile.pos_).

### -f, --framed[=
              request  copy  of  DVI file, _BASE.dvi_, with bounding boxes **framed** (default FILE is _in__‐
              _file_frames.dvi_).  See the **--framesize** option.

### -m, --mag=
              override [**tex**(1)](https://www.chedong.com/phpMan.php/man/tex/1/markdown) magnification by INT.

### -w, --framesize=
              set frame rule size by INT (default 6554 = .1pt).

### -p, --pages=
              set page ranges from X to Y.


## USAGE
       **dvipos** is run mostly behind the scenes by ConTeXt's [**texexec**(1)](https://www.chedong.com/phpMan.php/man/texexec/1/markdown) between runs of [**tex**(1)](https://www.chedong.com/phpMan.php/man/tex/1/markdown) or **pdf**‐‐
       [**tex**(1)](https://www.chedong.com/phpMan.php/man/tex/1/markdown),  in  order  to  provide information to and get information about positional graphics.
       These graphics are provided by the MetaFun interface to [**mpost**(1)](https://www.chedong.com/phpMan.php/man/mpost/1/markdown).  **dvipos**  is  not  used  (or
       needed)  in  PDF-output mode but is needed for DVI-output mode.  [**pdftex**(1)](https://www.chedong.com/phpMan.php/man/pdftex/1/markdown) starting with ver‐
       sion 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**:
          dvipos notes.dvi
       The  position  information  that  is  output  is  collected  by  [**texexec**(1)](https://www.chedong.com/phpMan.php/man/texexec/1/markdown) to include in the
       _notes.tuo_ auxilliary file to use in the next run.



## EXAMPLES
       Extract positions from _doc.dvi_, with output to _doc.loc_:
              dvipos -o doc.loc doc.dvi

       Same as above, but also send bbox information to _doc.pos_:
              dvipos -b -o doc.loc doc.dvi

       Instead send bbox information to _/tmp/debug.pos_:
              dvipos -b=/tmp/debug.pos -o doc.loc doc.dvi


## SEE ALSO
       [**dvips**(1)](https://www.chedong.com/phpMan.php/man/dvips/1/markdown), [**dvitype**(1)](https://www.chedong.com/phpMan.php/man/dvitype/1/markdown), [**mpost**(1)](https://www.chedong.com/phpMan.php/man/mpost/1/markdown), [**pdftex**(1)](https://www.chedong.com/phpMan.php/man/pdftex/1/markdown), [**tex**(1)](https://www.chedong.com/phpMan.php/man/tex/1/markdown), [**texexec**(1)](https://www.chedong.com/phpMan.php/man/texexec/1/markdown).

       For more about positional graphics, see the MetaFun documentation on the ConTeXt wiki
       ⟨<http://wiki.contextgarden.net/MetaFun>⟩.


## BUGS
       If you specify a file for the **-b** option, you must join the option and name with **=** rather than
       (the more common) space:
          dvipos -b=/tmp/debug.pos notes.dvi
       works, but
          dvipos -b /tmp/debug.pos notes.dvi
       does not.


## AUTHOR
       **dvipos** is written by Jin-Hwan Cho <<chofchof@ktug.or.kr>>.   It  is  free  software  (GPLv2  or
       later).  This manpage was written by Sanjoy Mahajan <<sanjoy@mit.edu>> and is in the public do‐
       main.



dvipos 20070107 (KPATHSEA)                  January 2007                                   [DVIPOS(1)](https://www.chedong.com/phpMan.php/man/DVIPOS/1/markdown)