{
    "mode": "man",
    "parameter": "dvispc",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/dvispc/1/json",
    "generated": "2026-06-03T01:22:28Z",
    "synopsis": "dvispc [-c] [-bvz] inputdvifile [outputdvifile]\ndvispc -d inputdvifile\ndvispc -s [-p..] inputdvifile [outputtextfile]\ndvispc -a [-ltv] [-J..] [-p..] [-r..]  inputdvifile [outputtextfile]\ndvispc -x[..]  [-ltv] [-r..]  [inputtextfile] outputdvifile",
    "sections": {
        "NAME": {
            "content": "dvispc - Modify a DVI file to be page-independent in specials\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "dvispc [-c] [-bvz] inputdvifile [outputdvifile]\n\ndvispc -d inputdvifile\n\ndvispc -s [-p..] inputdvifile [outputtextfile]\n\ndvispc -a [-ltv] [-J..] [-p..] [-r..]  inputdvifile [outputtextfile]\n\ndvispc -x[..]  [-ltv] [-r..]  [inputtextfile] outputdvifile\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "Dvispc is a utility to modify/edit TeX DVI file with the following features:\n\nMode option -c (default):\ncorrect an input DVI to be page-independent in specials (default)\n\nMode option -d:\ndry run to check if an input DVI is page-independent in specials\n\nMode option -s:\nshow all specials in the input DVI\n\nMode option -a:\ntranslate DVI into a Text (like dv2dt in dtl)\n\nMode option -x:\ntranslate Text into a DVI (like dt2dv in dtl)\n\n(1) The main feature of dvispc is the first one, to make a page-independent DVI file.\n\nA \"pure\" DVI file must be actually page-independent.  However in recent years, DVI files with\nlots of \\special's (color, annotation etc.) are commonly used, and they are not always  page-\nindependent.  In  such  case,  for  example, dviselect or dvidvi fails to preserve \\special's\n(e.g. page color might be lost).\n\nThe program dvispc corrects such page-\"dependent\" DVI files to be page-independent, which can\nbe  safely processed by dviselect or dvidvi and then properly converted to other formats such\nas PostScript and PDF.\n\n(2) To know whether such a correction is needed or not, dvispc -d will suffice.\n\n(3) The mode -s lists all specials found in the input DVI  as-is,  with  a  preceding  number\nwhich denotes the page where it appears.  For example,\n\n[1]\n{color push  Black}\n{color pop}\n{color push rgb 1 0 0}\n{color pop}\n[2]\n{color push  Black}\n{color pop}\n\nThis  feature  is  equivalent  to  a  program  dvispecials  in  TeX-Guy  package <http://www-\nmasu.ist.osaka-u.ac.jp/%7Ekakugawa/TeX-Guy/> and dvii -s <https://ctan.org/pkg/dvii>.\n\n(4) The mode -a and -x correspond to dv2dt and dt2dv in the dtl (= DVI Text Language) package\nrespectively. By default dvispc -a formats the output text in its own style, but DTL-compati‐\nble format is available with -t option. Also, dvispc -x can accept DTL-compatible text input.\n",
            "subsections": []
        },
        "SUPPORTED SPECIALS": {
            "content": "Currently dvispc supports the followings:\n\ndvips-compatible specials\ncolor push, color pop, background\ndvipdfm(x) specials\npdf:bcolor, pdf:ecolor, pdf:bgcolor, pdf:bann, pdf:eann\ntpic specials:\npn\n\nOther specials might be supported in the future if needed.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "dviselect(1), dvidvi(1), dvips(1), dvipdfmx(1)\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "The program dvispc is derived from the DVIOUT package (DVI previewer for Windows)  by  Toshio\nOSHIMA  (\"SHIMA\"), Yoshiki OTOBE, and Kazunori ASAYAMA.  Current version is maintained by Ja‐\npanese TeX Development Community <https://texjp.org>.\nFor more information, please refer to dvispc-en.txt (in English) and dvispc-ja.txt (in  Japa‐\nnese)   on   our   GitHub   repository,   <https://github.com/texjporg/tex-jp-build>   (under\nsource/texk/dviout-util directory).\n\n\n\nDVISPC(1)",
            "subsections": []
        }
    },
    "summary": "dvispc - Modify a DVI file to be page-independent in specials",
    "flags": [],
    "examples": [],
    "see_also": [
        {
            "name": "dviselect",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/dviselect/1/json"
        },
        {
            "name": "dvidvi",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/dvidvi/1/json"
        },
        {
            "name": "dvips",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/dvips/1/json"
        },
        {
            "name": "dvipdfmx",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/dvipdfmx/1/json"
        }
    ]
}