# phpman > man > dvispc(1)


*Source: tldr-pages*

---

[DVISPC(1)](https://www.chedong.com/phpMan.php/man/DVISPC/1/markdown)                              General Commands Manual                             [DVISPC(1)](https://www.chedong.com/phpMan.php/man/DVISPC/1/markdown)



## NAME
       dvispc - Modify a DVI file to be page-independent in specials

## SYNOPSIS
       **dvispc** [**-c**] [**-bvz**] _input_dvi_file_ [_output_dvi_file_]

       **dvispc** **-d** _input_dvi_file_

       **dvispc** **-s** [**-p..**] _input_dvi_file_ [_output_text_file_]

       **dvispc** **-a** [**-ltv**] [**-J..**] [**-p..**] [**-r..**]  _input_dvi_file_ [_output_text_file_]

       **dvispc** **-x[..]**  [**-ltv**] [**-r..**]  [_input_text_file_] _output_dvi_file_

## DESCRIPTION
       **Dvispc** is a utility to modify/edit TeX DVI file with the following features:

           Mode option **-c** (default):
               correct an input DVI to be page-independent in specials (default)

           Mode option **-d**:
               dry run to check if an input DVI is page-independent in specials

           Mode option **-s**:
               show all specials in the input DVI

           Mode option **-a**:
               translate DVI into a Text (like **dv2dt** in dtl)

           Mode option **-x**:
               translate Text into a DVI (like **dt2dv** in dtl)

       (1) The _main_ feature of **dvispc** is the first one, to make a page-independent DVI file.

       A "pure" DVI file must be actually page-independent.  However in recent years, DVI files with
       lots of \special's (color, annotation etc.) are commonly used, and they are not always  page-
       independent.  In  such  case,  for  example, **dviselect** or **dvidvi** fails to preserve \special's
       (e.g. page color might be lost).

       The program **dvispc** corrects such page-"dependent" DVI files to be page-independent, which can
       be  safely processed by **dviselect** or **dvidvi** and then properly converted to other formats such
       as PostScript and PDF.

       (2) To know whether such a correction is needed or not, **dvispc** **-d** will suffice.

       (3) The mode **-s** lists all specials found in the input DVI  as-is,  with  a  preceding  number
       which denotes the page where it appears.  For example,

              [1]
              {color push  Black}
              {color pop}
              {color push rgb 1 0 0}
              {color pop}
              [2]
              {color push  Black}
              {color pop}

       This  feature  is  equivalent  to  a  program  **dvispecials**  in  TeX-Guy  package <<http://www>-
       masu.ist.osaka-u.ac.jp/%7Ekakugawa/TeX-Guy/> and **dvii** **-s** <<https://ctan.org/pkg/dvii>>.

       (4) The mode **-a** and **-x** correspond to **dv2dt** and **dt2dv** in the dtl (= DVI Text Language) package
       respectively. By default **dvispc** **-a** formats the output text in its own style, but DTL-compati‐
       ble format is available with **-t** option. Also, **dvispc** **-x** can accept DTL-compatible text input.

## SUPPORTED SPECIALS
       Currently **dvispc** supports the followings:

           dvips-compatible specials
               color push, color pop, background
           dvipdfm(x) specials
               pdf:bcolor, pdf:ecolor, pdf:bgcolor, pdf:bann, pdf:eann
           tpic specials:
               pn

       Other specials might be supported in the future if needed.

## SEE ALSO
       [dviselect(1)](https://www.chedong.com/phpMan.php/man/dviselect/1/markdown), [dvidvi(1)](https://www.chedong.com/phpMan.php/man/dvidvi/1/markdown), [dvips(1)](https://www.chedong.com/phpMan.php/man/dvips/1/markdown), [dvipdfmx(1)](https://www.chedong.com/phpMan.php/man/dvipdfmx/1/markdown)

## AUTHOR
       The program **dvispc** is derived from the DVIOUT package (DVI previewer for Windows)  by  Toshio
       OSHIMA  ("SHIMA"), Yoshiki OTOBE, and Kazunori ASAYAMA.  Current version is maintained by Ja‐
       panese TeX Development Community <<https://texjp.org>>.
       For more information, please refer to dvispc-en.txt (in English) and dvispc-ja.txt (in  Japa‐
       nese)   on   our   GitHub   repository,   <<https://github.com/texjporg/tex-jp-build>>   (under
       source/texk/dviout-util directory).



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