| 1 |
<!DOCTYPE html> |
| 2 |
<html> |
| 3 |
<!-- Created by GNU Texinfo 7.2, https://www.gnu.org/software/texinfo/ --> |
| 4 |
<head> |
| 5 |
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> |
| 6 |
<!-- This manual documents Dvips version 2026.1 |
| 7 |
(January 2026), a program to translate a DVI file into |
| 8 |
PostScript. You may freely use, modify and/or distribute this file. --> |
| 9 |
<title>Dvips: A DVI-to-PostScript translator</title> |
| 10 |
|
| 11 |
<meta name="description" content="Dvips: A DVI-to-PostScript translator"> |
| 12 |
<meta name="keywords" content="Dvips: A DVI-to-PostScript translator"> |
| 13 |
<meta name="resource-type" content="document"> |
| 14 |
<meta name="distribution" content="global"> |
| 15 |
<meta name="Generator" content="makeinfo"> |
| 16 |
<meta name="viewport" content="width=device-width,initial-scale=1"> |
| 17 |
|
| 18 |
<link href="#Top" rel="start" title="Top"> |
| 19 |
<link href="#Index" rel="index" title="Index"> |
| 20 |
<link href="#SEC_Contents" rel="contents" title="Table of Contents"> |
| 21 |
<link href="http://tug.org/texinfohtml" rel="up" title="(dir)"> |
| 22 |
<link href="#Why-Dvips" rel="next" title="Why Dvips"> |
| 23 |
<style type="text/css"> |
| 24 |
<!-- |
| 25 |
a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em} |
| 26 |
a.summary-letter-printindex {text-decoration: none} |
| 27 |
div.display {margin-left: 3.2em} |
| 28 |
div.example {margin-left: 3.2em} |
| 29 |
pre.display-preformatted {font-family: inherit} |
| 30 |
span.r {font-family: initial; font-weight: normal; font-style: normal} |
| 31 |
span:hover a.copiable-link {visibility: visible} |
| 32 |
td.printindex-index-entry {vertical-align: top} |
| 33 |
td.printindex-index-section {vertical-align: top; padding-left: 1em} |
| 34 |
th.entries-header-printindex {text-align:left} |
| 35 |
th.sections-header-printindex {text-align:left; padding-left: 1em} |
| 36 |
ul.mark-bullet {list-style-type: disc} |
| 37 |
ul.mark-minus {list-style-type: "\2212"} |
| 38 |
ul.toc-numbered-mark {list-style: none} |
| 39 |
--> |
| 40 |
</style> |
| 41 |
|
| 42 |
|
| 43 |
</head> |
| 44 |
|
| 45 |
<body lang="en"> |
| 46 |
|
| 47 |
|
| 48 |
|
| 49 |
|
| 50 |
|
| 51 |
|
| 52 |
|
| 53 |
|
| 54 |
<div class="top-level-extent" id="Top"> |
| 55 |
<div class="nav-panel"> |
| 56 |
<p> |
| 57 |
Next: <a href="#Why-Dvips" accesskey="n" rel="next">Why use Dvips?</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 58 |
</div> |
| 59 |
<h1 class="top" id="Dvips"><span>Dvips<a class="copiable-link" href="#Dvips"> ¶</a></span></h1> |
| 60 |
|
| 61 |
<p>This manual documents Dvips version 2026.1 |
| 62 |
(January 2026), a program to translate a DVI file into |
| 63 |
PostScript. You may freely use, modify and/or distribute this file. |
| 64 |
</p> |
| 65 |
|
| 66 |
|
| 67 |
<div class="region-shortcontents" id="SEC_Shortcontents"> |
| 68 |
<h2 class="shortcontents-heading">Short Table of Contents</h2> |
| 69 |
|
| 70 |
<div class="shortcontents"> |
| 71 |
<ul class="toc-numbered-mark"> |
| 72 |
<li><a id="stoc-Why-use-Dvips_003f" href="#toc-Why-use-Dvips_003f">1 Why use Dvips?</a></li> |
| 73 |
<li><a id="stoc-Installation" href="#toc-Installation">2 Installation</a></li> |
| 74 |
<li><a id="stoc-Invoking-Dvips" href="#toc-Invoking-Dvips">3 Invoking Dvips</a></li> |
| 75 |
<li><a id="stoc-Paper-size-and-landscape-orientation" href="#toc-Paper-size-and-landscape-orientation">4 Paper size and landscape orientation</a></li> |
| 76 |
<li><a id="stoc-Interaction-with-PostScript" href="#toc-Interaction-with-PostScript">5 Interaction with PostScript</a></li> |
| 77 |
<li><a id="stoc-PostScript-fonts" href="#toc-PostScript-fonts">6 PostScript fonts</a></li> |
| 78 |
<li><a id="stoc-Color" href="#toc-Color">7 Color</a></li> |
| 79 |
<li><a id="stoc-Index" href="#toc-Index" rel="index">Index</a></li> |
| 80 |
</ul> |
| 81 |
</div> |
| 82 |
</div> |
| 83 |
<div class="region-contents" id="SEC_Contents"> |
| 84 |
<h2 class="contents-heading">Table of Contents</h2> |
| 85 |
|
| 86 |
<div class="contents"> |
| 87 |
|
| 88 |
<ul class="toc-numbered-mark"> |
| 89 |
<li><a id="toc-Why-use-Dvips_003f" href="#Why-Dvips">1 Why use Dvips?</a></li> |
| 90 |
<li><a id="toc-Installation" href="#Installation">2 Installation</a> |
| 91 |
<ul class="toc-numbered-mark"> |
| 92 |
<li><a id="toc-config_002eps-installation" href="#config_002eps-installation">2.1 <samp class="file">config.ps</samp> installation</a></li> |
| 93 |
<li><a id="toc-PostScript-font-installation" href="#PostScript-font-installation">2.2 PostScript font installation</a></li> |
| 94 |
<li><a id="toc-Ghostscript-installation" href="#Ghostscript-installation">2.3 Ghostscript installation</a></li> |
| 95 |
<li><a id="toc-Diagnosing-problems" href="#Diagnosing-problems">2.4 Diagnosing problems</a> |
| 96 |
<ul class="toc-numbered-mark"> |
| 97 |
<li><a id="toc-Debug-options" href="#Debug-options">2.4.1 Debug options</a></li> |
| 98 |
<li><a id="toc-No-output-at-all" href="#No-output">2.4.2 No output at all</a></li> |
| 99 |
<li><a id="toc-Output-too-small-or-inverted" href="#Small-or-inverted">2.4.3 Output too small or inverted</a></li> |
| 100 |
<li><a id="toc-Error-messages-from-printer" href="#Printer-errors">2.4.4 Error messages from printer</a></li> |
| 101 |
<li><a id="toc-Long-documents-fail-to-print" href="#Long-documents-fail">2.4.5 Long documents fail to print</a></li> |
| 102 |
<li><a id="toc-Including-graphics-fails" href="#Including-graphics-fails">2.4.6 Including graphics fails</a></li> |
| 103 |
</ul></li> |
| 104 |
</ul></li> |
| 105 |
<li><a id="toc-Invoking-Dvips" href="#Invoking-Dvips">3 Invoking Dvips</a> |
| 106 |
<ul class="toc-numbered-mark"> |
| 107 |
<li><a id="toc-Basic-usage-of-Dvips" href="#Basic-usage">3.1 Basic usage of Dvips</a></li> |
| 108 |
<li><a id="toc-Command_002dline-options" href="#Command_002dline-options">3.2 Command-line options</a> |
| 109 |
<ul class="toc-numbered-mark"> |
| 110 |
<li><a id="toc-Option-summary" href="#Option-summary">3.2.1 Option summary</a></li> |
| 111 |
<li><a id="toc-Option-details" href="#Option-details">3.2.2 Option details</a></li> |
| 112 |
</ul></li> |
| 113 |
<li><a id="toc-Environment-variables" href="#Environment-variables">3.3 Environment variables</a></li> |
| 114 |
<li><a id="toc-Dvips-configuration-files" href="#Config-files">3.4 Dvips configuration files</a> |
| 115 |
<ul class="toc-numbered-mark"> |
| 116 |
<li><a id="toc-Configuration-file-searching" href="#Configuration-file-searching">3.4.1 Configuration file searching</a></li> |
| 117 |
<li><a id="toc-Configuration-file-commands" href="#Configuration-file-commands">3.4.2 Configuration file commands</a></li> |
| 118 |
</ul></li> |
| 119 |
</ul></li> |
| 120 |
<li><a id="toc-Paper-size-and-landscape-orientation" href="#Paper-size-and-landscape">4 Paper size and landscape orientation</a> |
| 121 |
<ul class="toc-numbered-mark"> |
| 122 |
<li><a id="toc-papersize-special" href="#papersize-special">4.1 ‘<samp class="samp">papersize</samp>’ special</a></li> |
| 123 |
<li><a id="toc-Configuration-file-paper-size-command" href="#Config-file-paper-sizes">4.2 Configuration file paper size command</a></li> |
| 124 |
<li><a id="toc-Paper-trays" href="#Paper-trays">4.3 Paper trays</a></li> |
| 125 |
</ul></li> |
| 126 |
<li><a id="toc-Interaction-with-PostScript" href="#Interaction-with-PostScript">5 Interaction with PostScript</a> |
| 127 |
<ul class="toc-numbered-mark"> |
| 128 |
<li><a id="toc-PostScript-figures" href="#PostScript-figures">5.1 PostScript figures</a> |
| 129 |
<ul class="toc-numbered-mark"> |
| 130 |
<li><a id="toc-The-bounding-box-comment" href="#Bounding-box">5.1.1 The bounding box comment</a></li> |
| 131 |
<li><a id="toc-The-_005cincludegraphics-macro-for-LaTeX" href="#g_t_005cincludegraphics">5.1.2 The \includegraphics macro for LaTeX</a></li> |
| 132 |
<li><a id="toc-Using-the-EPSF-macros" href="#EPSF-macros">5.1.3 Using the EPSF macros</a> |
| 133 |
<ul class="toc-numbered-mark"> |
| 134 |
<li><a id="toc-EPSF-scaling" href="#EPSF-scaling">5.1.3.1 EPSF scaling</a></li> |
| 135 |
<li><a id="toc-EPSF-clipping" href="#EPSF-clipping">5.1.3.2 EPSF clipping</a></li> |
| 136 |
</ul></li> |
| 137 |
<li><a id="toc-psfile-special" href="#psfile-special">5.1.4 ‘<samp class="samp">psfile</samp>’ special</a></li> |
| 138 |
<li><a id="toc-Dynamic-creation-of-PostScript-graphics-files" href="#Dynamic-creation-of-graphics">5.1.5 Dynamic creation of PostScript graphics files</a></li> |
| 139 |
<li><a id="toc-Fonts-in-figures" href="#Fonts-in-figures">5.1.6 Fonts in figures</a></li> |
| 140 |
</ul></li> |
| 141 |
<li><a id="toc-PostScript-header-files" href="#Header-files">5.2 PostScript header files</a> |
| 142 |
<ul class="toc-numbered-mark"> |
| 143 |
<li><a id="toc-Including-headers-from-TeX" href="#Including-headers-from-TeX">5.2.1 Including headers from TeX</a></li> |
| 144 |
<li><a id="toc-Including-headers-from-the-command-line" href="#Including-headers-from-the-command-line">5.2.2 Including headers from the command line</a></li> |
| 145 |
<li><a id="toc-Headers-and-memory-usage" href="#Headers-and-memory-usage">5.2.3 Headers and memory usage</a></li> |
| 146 |
</ul></li> |
| 147 |
<li><a id="toc-Literal-PostScript" href="#Literal-PS">5.3 Literal PostScript</a> |
| 148 |
<ul class="toc-numbered-mark"> |
| 149 |
<li><a id="toc-_0022-special_003a-Literal-PostScript" href="#g_t_0022-special">5.3.1 <code class="code">"</code> special: Literal PostScript</a></li> |
| 150 |
<li><a id="toc-ps-special" href="#ps-special">5.3.2 ‘<samp class="samp">ps</samp>’ special</a></li> |
| 151 |
<li><a id="toc-Literal-headers_003a-_0021-_005cspecial" href="#Literal-headers">5.3.3 Literal headers: ‘<samp class="samp">!</samp>’ <code class="code">\special</code></a></li> |
| 152 |
<li><a id="toc-PostScript-hooks" href="#PostScript-hooks">5.3.4 PostScript hooks</a></li> |
| 153 |
<li><a id="toc-Literal-examples" href="#Literal-examples">5.3.5 Literal examples</a></li> |
| 154 |
</ul></li> |
| 155 |
<li><a id="toc-HyperTeXt" href="#Hypertext">5.4 HyperTeXt</a> |
| 156 |
<ul class="toc-numbered-mark"> |
| 157 |
<li><a id="toc-Hypertext-caveats" href="#Hypertext-caveats">5.4.1 Hypertext caveats</a></li> |
| 158 |
<li><a id="toc-Hypertext-specials" href="#Hypertext-specials">5.4.2 Hypertext specials</a></li> |
| 159 |
</ul></li> |
| 160 |
</ul></li> |
| 161 |
<li><a id="toc-PostScript-fonts" href="#PostScript-fonts">6 PostScript fonts</a> |
| 162 |
<ul class="toc-numbered-mark"> |
| 163 |
<li><a id="toc-Font-concepts" href="#Font-concepts">6.1 Font concepts</a> |
| 164 |
<ul class="toc-numbered-mark"> |
| 165 |
<li><a id="toc-Metric-files" href="#Metric-files">6.1.1 Metric files</a></li> |
| 166 |
<li><a id="toc-Glyph-files" href="#Glyph-files">6.1.2 Glyph files</a></li> |
| 167 |
<li><a id="toc-Virtual-fonts" href="#Virtual-fonts">6.1.3 Virtual fonts</a></li> |
| 168 |
<li><a id="toc-Encodings" href="#Encodings">6.1.4 Encodings</a></li> |
| 169 |
<li><a id="toc-Bitmap-font-encodings" href="#Bitmap-font-encodings">6.1.5 Bitmap font encodings</a></li> |
| 170 |
<li><a id="toc-How-PostScript-typesets-a-character" href="#PostScript-typesetting">6.1.6 How PostScript typesets a character</a></li> |
| 171 |
</ul></li> |
| 172 |
<li><a id="toc-Making-a-PostScript-font-available" href="#Making-a-font-available">6.2 Making a PostScript font available</a></li> |
| 173 |
<li><a id="toc-Invoking-Afm2tfm" href="#Invoking-afm2tfm">6.3 Invoking Afm2tfm</a> |
| 174 |
<ul class="toc-numbered-mark"> |
| 175 |
<li><a id="toc-Changing-font-encodings" href="#Changing-font-encodings">6.3.1 Changing font encodings</a> |
| 176 |
<ul class="toc-numbered-mark"> |
| 177 |
<li><a id="toc-_002dt_003a-Changing-TeX-encodings" href="#Changing-TeX-encodings">6.3.1.1 ‘<samp class="samp">-t</samp>’: Changing TeX encodings</a></li> |
| 178 |
<li><a id="toc-_002dp_003a-Changing-PostScript-encodings" href="#Changing-PostScript-encodings">6.3.1.2 ‘<samp class="samp">-p</samp>’: Changing PostScript encodings</a></li> |
| 179 |
<li><a id="toc-_002dT_003a-Changing-both-TeX-and-PostScript-encodings" href="#Changing-both-encodings">6.3.1.3 ‘<samp class="samp">-T</samp>’: Changing both TeX and PostScript encodings</a></li> |
| 180 |
<li><a id="toc-Reencoding-with-Afm2tfm" href="#Reencoding-with-Afm2tfm">6.3.1.4 Reencoding with Afm2tfm</a></li> |
| 181 |
<li><a id="toc-Encoding-file-format" href="#Encoding-file-format">6.3.1.5 Encoding file format</a></li> |
| 182 |
</ul></li> |
| 183 |
<li><a id="toc-Special-font-effects" href="#Special-font-effects">6.3.2 Special font effects</a></li> |
| 184 |
<li><a id="toc-Afm2tfm-options" href="#Afm2tfm-options">6.3.3 Afm2tfm options</a></li> |
| 185 |
</ul></li> |
| 186 |
<li><a id="toc-psfonts_002emap_003a-PostScript-font-catalog" href="#psfonts_002emap">6.4 <samp class="file">psfonts.map</samp>: PostScript font catalog</a></li> |
| 187 |
</ul></li> |
| 188 |
<li><a id="toc-Color" href="#Color">7 Color</a> |
| 189 |
<ul class="toc-numbered-mark"> |
| 190 |
<li><a id="toc-Color-macro-files" href="#Color-macro-files">7.1 Color macro files</a></li> |
| 191 |
<li><a id="toc-User_002ddefinable-colors" href="#User_002ddefinable-colors">7.2 User-definable colors</a></li> |
| 192 |
<li><a id="toc-Color-subtleties" href="#Color-subtleties">7.3 Color subtleties</a></li> |
| 193 |
<li><a id="toc-Printing-in-black_002fwhite-after-colorizing" href="#Ted-Turner">7.4 Printing in black/white after colorizing</a></li> |
| 194 |
<li><a id="toc-Color-device-configuration" href="#Color-device-configuration">7.5 Color device configuration</a></li> |
| 195 |
<li><a id="toc-Color-support-details" href="#Color-support-details">7.6 Color support details</a> |
| 196 |
<ul class="toc-numbered-mark"> |
| 197 |
<li><a id="toc-Color-specifications" href="#Color-specifications">7.6.1 Color specifications</a></li> |
| 198 |
<li><a id="toc-Color-specials" href="#Color-specials">7.6.2 Color specials</a></li> |
| 199 |
</ul></li> |
| 200 |
</ul></li> |
| 201 |
<li><a id="toc-Index" href="#Index" rel="index">Index</a></li> |
| 202 |
</ul> |
| 203 |
</div> |
| 204 |
</div> |
| 205 |
<hr> |
| 206 |
<div class="chapter-level-extent" id="Why-Dvips"> |
| 207 |
<div class="nav-panel"> |
| 208 |
<p> |
| 209 |
Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Dvips</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 210 |
</div> |
| 211 |
<h2 class="chapter" id="Why-use-Dvips_003f"><span>1 Why use Dvips?<a class="copiable-link" href="#Why-use-Dvips_003f"> ¶</a></span></h2> |
| 212 |
|
| 213 |
<p>The Dvips program has a number of features that set it apart from |
| 214 |
other PostScript drivers for TeX. This rather long section describes |
| 215 |
the advantages of using Dvips, and may be skipped if you are just |
| 216 |
interested in learning how to use the program. See <a class="xref" href="#Installation">Installation</a>, for |
| 217 |
details of compilation and installation. |
| 218 |
</p> |
| 219 |
<p>The Dvips driver generates excellent, standard PostScript, that |
| 220 |
can be included in other documents as figures or printed through a |
| 221 |
variety of spoolers. The generated PostScript requires very little |
| 222 |
printer memory, so very complex documents with a lot of fonts can easily |
| 223 |
be printed even on PostScript printers without much memory, such as the |
| 224 |
original Apple LaserWriter. The PostScript output is also compact, |
| 225 |
requiring less disk space to store and making it feasible as a transfer |
| 226 |
format. |
| 227 |
</p> |
| 228 |
<p>Even those documents that are too complex to print in their entirety on |
| 229 |
a particular printer can be printed, since Dvips will |
| 230 |
automatically split such documents into pieces, reclaiming the printer |
| 231 |
memory between each piece. |
| 232 |
</p> |
| 233 |
<p>The Dvips program supports graphics in a natural way, allowing |
| 234 |
PostScript graphics to be included and automatically scaled and |
| 235 |
positioned in a variety of ways. |
| 236 |
</p> |
| 237 |
<p>Printers with any resolution are supported, even if they have different |
| 238 |
resolutions in the horizontal and vertical directions. High resolution |
| 239 |
output is supported for typesetters, including an option that compresses |
| 240 |
the bitmap fonts so that typesetter virtual memory is not exhausted. |
| 241 |
This option also significantly reduces the size of the PostScript file |
| 242 |
and decoding in the printer is very fast. |
| 243 |
</p> |
| 244 |
<p>Missing fonts can be automatically generated if Metafont exists on |
| 245 |
the system, or fonts can be converted from GF to PK format |
| 246 |
on demand. If a font cannot be generated, a scaled version of the same |
| 247 |
font at a different size can be used instead, although Dvips will |
| 248 |
complain loudly about the poor aesthetics of the resulting output. |
| 249 |
</p> |
| 250 |
<p>One of the most important features is the support of virtual fonts, |
| 251 |
which add an entirely new level of flexibility to TeX. Dvips even |
| 252 |
comes with its own Afm2tfm program that can create the virtual fonts |
| 253 |
and TeX font metric files automatically from Adobe font metric |
| 254 |
files. |
| 255 |
</p> |
| 256 |
<p>Source is provided and freely distributable, so adding a site-specific feature |
| 257 |
is possible. Adding such features is made easier by the highly modular |
| 258 |
structure of the program. |
| 259 |
</p> |
| 260 |
<a class="index-entry-id" id="index-Rokicki_002c-Tomas"></a> |
| 261 |
<p>Tom Rokicki wrote and maintains the original Dvips program. |
| 262 |
</p> |
| 263 |
|
| 264 |
<hr> |
| 265 |
</div> |
| 266 |
<div class="chapter-level-extent" id="Installation"> |
| 267 |
<div class="nav-panel"> |
| 268 |
<p> |
| 269 |
Next: <a href="#Invoking-Dvips" accesskey="n" rel="next">Invoking Dvips</a>, Previous: <a href="#Why-Dvips" accesskey="p" rel="prev">Why use Dvips?</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 270 |
</div> |
| 271 |
<h2 class="chapter" id="Installation-1"><span>2 Installation<a class="copiable-link" href="#Installation-1"> ¶</a></span></h2> |
| 272 |
|
| 273 |
<a class="index-entry-id" id="index-configuration_002c-of-Dvips"></a> |
| 274 |
<a class="index-entry-id" id="index-compilation"></a> |
| 275 |
<a class="index-entry-id" id="index-installation_002c-of-Dvips"></a> |
| 276 |
|
| 277 |
|
| 278 |
<p>Installing Dvips is mostly the same as installing any Kpathsea-using |
| 279 |
program. Therefore, for the basic steps involved, |
| 280 |
see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite class="cite">Kpathsea</cite>. |
| 281 |
</p> |
| 282 |
<p>For solutions to common installation problems and information on how to |
| 283 |
report a bug, see the file <samp class="file">kpathsea/BUGS</samp> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite class="cite">Kpathsea</cite>). For solutions to Dvips-specific problems, |
| 284 |
see <a class="pxref" href="#Debug-options">Debug options</a>. |
| 285 |
</p> |
| 286 |
<p>Dvips does require some additional installation, detailed in the |
| 287 |
sections below. Also, to configure color devices, see <a class="pxref" href="#Color-device-configuration">Color device configuration</a>. |
| 288 |
</p> |
| 289 |
|
| 290 |
|
| 291 |
<ul class="mini-toc"> |
| 292 |
<li><a href="#config_002eps-installation" accesskey="1"><samp class="file">config.ps</samp> installation</a></li> |
| 293 |
<li><a href="#PostScript-font-installation" accesskey="2">PostScript font installation</a></li> |
| 294 |
<li><a href="#Ghostscript-installation" accesskey="3">Ghostscript installation</a></li> |
| 295 |
<li><a href="#Diagnosing-problems" accesskey="4">Diagnosing problems</a></li> |
| 296 |
</ul> |
| 297 |
<hr> |
| 298 |
<div class="section-level-extent" id="config_002eps-installation"> |
| 299 |
<div class="nav-panel"> |
| 300 |
<p> |
| 301 |
Next: <a href="#PostScript-font-installation" accesskey="n" rel="next">PostScript font installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 302 |
</div> |
| 303 |
<h3 class="section" id="config_002eps-installation-1"><span>2.1 <samp class="file">config.ps</samp> installation<a class="copiable-link" href="#config_002eps-installation-1"> ¶</a></span></h3> |
| 304 |
|
| 305 |
<a class="index-entry-id" id="index-config_002eps-installation"></a> |
| 306 |
<a class="index-entry-id" id="index-installation-of-config_002eps"></a> |
| 307 |
<a class="index-entry-id" id="index-printer-configuration"></a> |
| 308 |
<a class="index-entry-id" id="index-paper-size_002c-default"></a> |
| 309 |
<a class="index-entry-id" id="index-configuration-files_002c-creating"></a> |
| 310 |
|
| 311 |
<p>Dvips has its own configuration files: a file <samp class="file">config.ps</samp> for |
| 312 |
sitewide defaults, and a file <samp class="file">config.<var class="var">printer</var></samp> for each |
| 313 |
printer (output device). Since these are site-specific, <code class="code">make |
| 314 |
install</code> does not create them; you must create them yourself. |
| 315 |
</p> |
| 316 |
<p>(These Dvips configuration files are independent of the Kpathsea |
| 317 |
configuration file <samp class="file">texmf.cnf</samp> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite class="cite">Kpathsea</cite>). |
| 318 |
</p> |
| 319 |
<a class="index-entry-id" id="index-config_002eproto"></a> |
| 320 |
<a class="index-entry-id" id="index-prototype-printer-configuration-file"></a> |
| 321 |
<a class="index-entry-id" id="index-printer-configuration-file_002c-prototype"></a> |
| 322 |
<a class="index-entry-id" id="index-configuration-files_002c-prototype"></a> |
| 323 |
<p>Dvips configuration files contents and searching are described fully in |
| 324 |
<a class="ref" href="#Config-files">Dvips configuration files</a>. The simplest way to create a new configuration file |
| 325 |
is to copy and modify the file <samp class="file">dvipsk/contrib/config.proto</samp>, |
| 326 |
seasoning with options to your taste from <a class="ref" href="#Config-files">Dvips configuration files</a>. Here is |
| 327 |
<samp class="file">config.proto</samp> |
| 328 |
for your reading pleasure: |
| 329 |
</p><div class="example"> |
| 330 |
<pre class="example-preformatted">% Prototype Dvips configuration file. (Public domain.) |
| 331 |
|
| 332 |
% How to print, maybe with lp instead lpr, etc. |
| 333 |
o |lpr |
| 334 |
|
| 335 |
% Default resolution of this device, in dots per inch. |
| 336 |
D 600 |
| 337 |
|
| 338 |
% Metafont mode. (This is completely different from the -M command-line |
| 339 |
% option, which controls whether MakeTeXPK is invoked.) Get |
| 340 |
% <a class="url" href="ftp://ftp.tug.org/tex/modes.mf">ftp://ftp.tug.org/tex/modes.mf</a> for a list of mode names. This mode |
| 341 |
% and the D number above must agree, or MakeTeXPK will get confused. |
| 342 |
M ljfour |
| 343 |
|
| 344 |
% Memory available. Download the three-line PostScript file: |
| 345 |
% %! Hey, we're PostScript |
| 346 |
% /Times-Roman findfont 30 scalefont setfont 144 432 moveto |
| 347 |
% vmstatus exch sub 40 string cvs show pop showpage |
| 348 |
% to determine this number. (It will be the only thing printed.) |
| 349 |
m 3500000 |
| 350 |
|
| 351 |
% Correct printer offset. You can use testpage.tex from the LaTeX |
| 352 |
% distribution to find these numbers. Print testpage.dvi more than once. |
| 353 |
O 0pt,0pt |
| 354 |
|
| 355 |
% Partially download Type 1 fonts by default. Only reason not to do |
| 356 |
% this is if you encounter bugs. (Please report them to |
| 357 |
% <a class="email" href="mailto:[email protected]">[email protected]</a> if you do.) |
| 358 |
j |
| 359 |
|
| 360 |
% Also look for fonts at these resolutions. |
| 361 |
R 300 600 |
| 362 |
|
| 363 |
% With a high resolution and a RISC cpu, better to compress the bitmaps. |
| 364 |
Z |
| 365 |
|
| 366 |
% Uncomment these if you have and want to use PostScript versions of the |
| 367 |
% fonts. |
| 368 |
%p +cmfonts.map |
| 369 |
%p +lafonts.map |
| 370 |
%p +cyrfonts.map |
| 371 |
%p +eufonts.map |
| 372 |
|
| 373 |
% To include another configuration file here. |
| 374 |
%c FILENAME |
| 375 |
|
| 376 |
% You will also want definitions for alternative paper sizes -- A4, |
| 377 |
% legal, and such. Examples in <samp class="file">contrib/papersize.level2</samp> and |
| 378 |
% <samp class="file">contrib/papersize.simple</samp>. |
| 379 |
</pre></div> |
| 380 |
|
| 381 |
|
| 382 |
<hr> |
| 383 |
</div> |
| 384 |
<div class="section-level-extent" id="PostScript-font-installation"> |
| 385 |
<div class="nav-panel"> |
| 386 |
<p> |
| 387 |
Next: <a href="#Ghostscript-installation" accesskey="n" rel="next">Ghostscript installation</a>, Previous: <a href="#config_002eps-installation" accesskey="p" rel="prev"><samp class="file">config.ps</samp> installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 388 |
</div> |
| 389 |
<h3 class="section" id="PostScript-font-installation-1"><span>2.2 PostScript font installation<a class="copiable-link" href="#PostScript-font-installation-1"> ¶</a></span></h3> |
| 390 |
|
| 391 |
<a class="index-entry-id" id="index-installation-of-PostScript-fonts"></a> |
| 392 |
<a class="index-entry-id" id="index-fonts_002c-installation-of-PostScript"></a> |
| 393 |
<a class="index-entry-id" id="index-PostScript-fonts_002c-installing"></a> |
| 394 |
|
| 395 |
<p>To use PostScript fonts with TeX and Dvips, you need both metric |
| 396 |
files (<samp class="file">.tfm</samp> and <samp class="file">.vf</samp>) and the outlines (<samp class="file">.pfa</samp> or |
| 397 |
<samp class="file">.pfb</samp>). See <a class="xref" href="#Font-concepts">Font concepts</a>. Current TeX systems |
| 398 |
come with support for 35 base PostScript fonts and many more. |
| 399 |
</p> |
| 400 |
<a class="index-entry-id" id="index-fonts_002c-system-PostScript"></a> |
| 401 |
<a class="index-entry-id" id="index-PostScript-fonts_002c-on-your-system"></a> |
| 402 |
<a class="index-entry-id" id="index-psfonts_002emap"></a> |
| 403 |
<p>If you have additional PostScript fonts, you can make them available |
| 404 |
to Dvips by (1) giving them appropriate filenames; and |
| 405 |
(2) running Afm2tfm (see <a class="pxref" href="#Making-a-font-available">Making a PostScript font available</a>) to make TFM |
| 406 |
and VF metrics for TeX and Dvips to use. Also add them to |
| 407 |
<samp class="file">psfonts.map</samp> (see <a class="pxref" href="#psfonts_002emap"><samp class="file">psfonts.map</samp>: PostScript font catalog</a>); this file must contain |
| 408 |
everything available in the system. The <code class="code">updmap</code> program is |
| 409 |
usually used to maintain <samp class="file">psfonts.map</samp>; run ‘<samp class="samp">updmap --help</samp>’ |
| 410 |
for lots of information about how it works. |
| 411 |
</p> |
| 412 |
|
| 413 |
<hr> |
| 414 |
</div> |
| 415 |
<div class="section-level-extent" id="Ghostscript-installation"> |
| 416 |
<div class="nav-panel"> |
| 417 |
<p> |
| 418 |
Next: <a href="#Diagnosing-problems" accesskey="n" rel="next">Diagnosing problems</a>, Previous: <a href="#PostScript-font-installation" accesskey="p" rel="prev">PostScript font installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 419 |
</div> |
| 420 |
<h3 class="section" id="Ghostscript-installation-1"><span>2.3 Ghostscript installation<a class="copiable-link" href="#Ghostscript-installation-1"> ¶</a></span></h3> |
| 421 |
|
| 422 |
<a class="index-entry-id" id="index-Ghostscript-installation"></a> |
| 423 |
<a class="index-entry-id" id="index-gs-installation"></a> |
| 424 |
|
| 425 |
<a class="index-entry-id" id="index-Deutsch_002c-Peter"></a> |
| 426 |
<a class="index-entry-id" id="index-Epson-printers"></a> |
| 427 |
<a class="index-entry-id" id="index-previewing-Dvips-output"></a> |
| 428 |
<a class="index-entry-id" id="index-PostScript-previewers"></a> |
| 429 |
<a class="index-entry-id" id="index-PDF-files_002c-making"></a> |
| 430 |
<a class="index-entry-id" id="index-Aladdin-Ghostscript"></a> |
| 431 |
<p>Ghostscript is a PostScript interpreter freely available to end-users, |
| 432 |
originally written by Peter Deutsch. It can read the PostScript |
| 433 |
produced by Dvips and render it on your monitor, or for another device |
| 434 |
(e.g., an Epson printer) that does not support PostScript, or in PDF |
| 435 |
format. The latest version is available via |
| 436 |
<a class="url" href="https://ghostscript.com">https://ghostscript.com</a>. |
| 437 |
</p> |
| 438 |
<a class="index-entry-id" id="index-Theisen_002c-Tim"></a> |
| 439 |
<a class="index-entry-id" id="index-ghostview"></a> |
| 440 |
<a class="index-entry-id" id="index-Ghostview_002c-and-no-N"></a> |
| 441 |
<a class="index-entry-id" id="index-EPS_002c-and-Ghostview"></a> |
| 442 |
<a class="index-entry-id" id="index-standard-PostScript_002c-required-by-Ghostview"></a> |
| 443 |
<a class="index-entry-id" id="index-_0025_0025Page_002c-required-by-Ghostview"></a> |
| 444 |
<p>The program Ghostview, originally written by Johannes Plass and Tim |
| 445 |
Theisen, provides typical previewing capabilities (next page/previous |
| 446 |
page, magnification, etc.). It requires Ghostscript to run, and files |
| 447 |
in structured PostScript, specifically with ‘<samp class="samp">%%Page</samp>’ comments (no |
| 448 |
‘<samp class="samp">N</samp>’ in <samp class="file">config.ps</samp>). The current version is known as GV, |
| 449 |
and is available from <a class="url" href="https://www.gnu.org/software/gv">https://www.gnu.org/software/gv</a>. |
| 450 |
</p> |
| 451 |
|
| 452 |
<hr> |
| 453 |
</div> |
| 454 |
<div class="section-level-extent" id="Diagnosing-problems"> |
| 455 |
<div class="nav-panel"> |
| 456 |
<p> |
| 457 |
Previous: <a href="#Ghostscript-installation" accesskey="p" rel="prev">Ghostscript installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 458 |
</div> |
| 459 |
<h3 class="section" id="Diagnosing-problems-1"><span>2.4 Diagnosing problems<a class="copiable-link" href="#Diagnosing-problems-1"> ¶</a></span></h3> |
| 460 |
|
| 461 |
<a class="index-entry-id" id="index-problems"></a> |
| 462 |
<a class="index-entry-id" id="index-trouble"></a> |
| 463 |
<a class="index-entry-id" id="index-debugging"></a> |
| 464 |
|
| 465 |
<p>You’ve gone through all the trouble of installing Dvips, carefully read |
| 466 |
all the instructions in this manual, and still can’t get something to |
| 467 |
work. The following sections provide some helpful hints if you find |
| 468 |
yourself in such a situation. |
| 469 |
</p> |
| 470 |
<p>For details on effective bug reporting, common installation problems, |
| 471 |
and <code class="code">mktexpk</code> problems, see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite class="cite">Kpathsea</cite>. |
| 472 |
</p> |
| 473 |
<p>A good first debugging operation is to set the environment variable |
| 474 |
<code class="env">DVIPSDEBUG</code>, which will display any configuration and map files |
| 475 |
read by Dvips. This way you can be sure it’s finding the files and |
| 476 |
settings you expect. |
| 477 |
</p> |
| 478 |
|
| 479 |
|
| 480 |
<ul class="mini-toc"> |
| 481 |
<li><a href="#Debug-options" accesskey="1">Debug options</a></li> |
| 482 |
<li><a href="#No-output" accesskey="2">No output at all</a></li> |
| 483 |
<li><a href="#Small-or-inverted" accesskey="3">Output too small or inverted</a></li> |
| 484 |
<li><a href="#Printer-errors" accesskey="4">Error messages from printer</a></li> |
| 485 |
<li><a href="#Long-documents-fail" accesskey="5">Long documents fail to print</a></li> |
| 486 |
<li><a href="#Including-graphics-fails" accesskey="6">Including graphics fails</a></li> |
| 487 |
</ul> |
| 488 |
<hr> |
| 489 |
<div class="subsection-level-extent" id="Debug-options"> |
| 490 |
<div class="nav-panel"> |
| 491 |
<p> |
| 492 |
Next: <a href="#No-output" accesskey="n" rel="next">No output at all</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 493 |
</div> |
| 494 |
<h4 class="subsection" id="Debug-options-1"><span>2.4.1 Debug options<a class="copiable-link" href="#Debug-options-1"> ¶</a></span></h4> |
| 495 |
|
| 496 |
<a class="index-entry-id" id="index-debugging-options"></a> |
| 497 |
<a class="index-entry-id" id="index-options_002c-debugging"></a> |
| 498 |
|
| 499 |
<p>The ‘<samp class="samp">-d</samp>’ flag to Dvips helps in tracking down certain errors. |
| 500 |
The parameter to this flag is an integer that tells what errors are |
| 501 |
currently being tracked. To track a certain class of debug messages, |
| 502 |
specify the appropriate number given below; if you wish to track |
| 503 |
multiple classes, sum the numbers of the classes you wish to track. |
| 504 |
To track all classes, you can use <code class="code">-1</code>. |
| 505 |
</p> |
| 506 |
<p>You can also set the environment variable <code class="env">KPATHSEA_DEBUG</code> instead |
| 507 |
of using ‘<samp class="samp">-d</samp>’. Some of these debugging options are actually |
| 508 |
provided by Kpathsea (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite class="cite">Kpathsea</cite>). |
| 509 |
</p> |
| 510 |
<p>The classes are: |
| 511 |
</p> |
| 512 |
<dl class="table"> |
| 513 |
<dt>1</dt> |
| 514 |
<dd><p>specials |
| 515 |
</p></dd> |
| 516 |
<dt>2</dt> |
| 517 |
<dd><p>paths |
| 518 |
</p></dd> |
| 519 |
<dt>4</dt> |
| 520 |
<dd><p>fonts |
| 521 |
</p></dd> |
| 522 |
<dt>8</dt> |
| 523 |
<dd><p>pages |
| 524 |
</p></dd> |
| 525 |
<dt>16</dt> |
| 526 |
<dd><p>headers |
| 527 |
</p></dd> |
| 528 |
<dt>32</dt> |
| 529 |
<dd><p>font compression |
| 530 |
</p></dd> |
| 531 |
<dt>64</dt> |
| 532 |
<dd><p>files |
| 533 |
</p></dd> |
| 534 |
<dt>128</dt> |
| 535 |
<dd><p>(omitted) |
| 536 |
</p></dd> |
| 537 |
<dt>256</dt> |
| 538 |
<dd><p>config files |
| 539 |
</p></dd> |
| 540 |
<dt>512</dt> |
| 541 |
<dd><p>Kpathsea <code class="code">stat</code> calls |
| 542 |
</p></dd> |
| 543 |
<dt>1024</dt> |
| 544 |
<dd><p>Kpathsea hash table lookups |
| 545 |
</p></dd> |
| 546 |
<dt>2048</dt> |
| 547 |
<dd><p>Kpathsea path element expansion |
| 548 |
</p></dd> |
| 549 |
<dt>4096</dt> |
| 550 |
<dd><p>Kpathsea path searches |
| 551 |
</p></dd> |
| 552 |
</dl> |
| 553 |
|
| 554 |
|
| 555 |
<hr> |
| 556 |
</div> |
| 557 |
<div class="subsection-level-extent" id="No-output"> |
| 558 |
<div class="nav-panel"> |
| 559 |
<p> |
| 560 |
Next: <a href="#Small-or-inverted" accesskey="n" rel="next">Output too small or inverted</a>, Previous: <a href="#Debug-options" accesskey="p" rel="prev">Debug options</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 561 |
</div> |
| 562 |
<h4 class="subsection" id="No-output-at-all"><span>2.4.2 No output at all<a class="copiable-link" href="#No-output-at-all"> ¶</a></span></h4> |
| 563 |
|
| 564 |
<a class="index-entry-id" id="index-output_002c-none"></a> |
| 565 |
<a class="index-entry-id" id="index-no-output-at-all"></a> |
| 566 |
<a class="index-entry-id" id="index-failure_002c-to-print-at-all"></a> |
| 567 |
|
| 568 |
<p>If you are not getting any output at all, even from the simplest |
| 569 |
one-character file (for instance, ‘<samp class="samp">\ \bye</samp>’), then something is very |
| 570 |
wrong. Practically any file sent to a PostScript laser printer should |
| 571 |
generate some output, at the very least a page detailing what error |
| 572 |
occurred, if any. Talk to your system administrator about downloading a |
| 573 |
PostScript error handler. (Adobe distributes a good one called |
| 574 |
‘<samp class="samp">ehandler.ps</samp>’.) |
| 575 |
<a class="index-entry-id" id="index-ehandler_002eps"></a> |
| 576 |
</p> |
| 577 |
<a class="index-entry-id" id="index-PowerPage-PostScript-implementation"></a> |
| 578 |
<a class="index-entry-id" id="index-Shinko-CHC_002dS446i-printer"></a> |
| 579 |
<a class="index-entry-id" id="index-Mitsubishi-Shinko-CHC_002dS446i-printer"></a> |
| 580 |
<p>It is possible, especially if you are using non-Adobe PostScript, that |
| 581 |
your PostScript interpreter is broken. Even then it should generate an |
| 582 |
error message. Dvips tries to work around as many bugs as possible in |
| 583 |
common non-Adobe PostScript interpreters, but doubtless it misses a few. |
| 584 |
PowerPage Revision 1, Interpreter Version 20001.001, on a Mitsubishi |
| 585 |
Shinko CHC-S446i color thermal dye sublimation printer is known to be |
| 586 |
unable to print with any but builtin fonts. |
| 587 |
</p> |
| 588 |
<p>If Dvips gives any strange error messages, or compilation on your |
| 589 |
machine generated a lot of warnings, perhaps the Dvips program itself is |
| 590 |
broken. Try using the debug options to determine where the error |
| 591 |
occurred (see <a class="pxref" href="#Debug-options">Debug options</a>). |
| 592 |
</p> |
| 593 |
<p>It is possible your spooler is broken and is misinterpreting the |
| 594 |
structured comments. Try the ‘<samp class="samp">-N</samp>’ flag to turn off structured |
| 595 |
comments and see what happens. |
| 596 |
</p> |
| 597 |
|
| 598 |
<hr> |
| 599 |
</div> |
| 600 |
<div class="subsection-level-extent" id="Small-or-inverted"> |
| 601 |
<div class="nav-panel"> |
| 602 |
<p> |
| 603 |
Next: <a href="#Printer-errors" accesskey="n" rel="next">Error messages from printer</a>, Previous: <a href="#No-output" accesskey="p" rel="prev">No output at all</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 604 |
</div> |
| 605 |
<h4 class="subsection" id="Output-too-small-or-inverted"><span>2.4.3 Output too small or inverted<a class="copiable-link" href="#Output-too-small-or-inverted"> ¶</a></span></h4> |
| 606 |
|
| 607 |
<a class="index-entry-id" id="index-output_002c-too-small"></a> |
| 608 |
<a class="index-entry-id" id="index-output_002c-inverted"></a> |
| 609 |
<a class="index-entry-id" id="index-inverted-output"></a> |
| 610 |
<a class="index-entry-id" id="index-too_002dsmall-output"></a> |
| 611 |
|
| 612 |
<a class="index-entry-id" id="index-save_002frestore_002c-and-inverted-output"></a> |
| 613 |
<p>If some documents come out inverted or too small, probably your spooler |
| 614 |
is not supplying an end of job indicator at the end of each file. (This |
| 615 |
commonly happens on small machines that don’t have spoolers.) You can |
| 616 |
force Dvips to do this with the ‘<samp class="samp">-F</samp>’ flag (or ‘<samp class="samp">F</samp>’ config file |
| 617 |
option), but this generates files with a terminating binary character |
| 618 |
(control-D). You can also try using the ‘<samp class="samp">-s</samp>’ flag (or ‘<samp class="samp">s</samp>’ |
| 619 |
config file option) to enclose the entire job in a save/restore pair. |
| 620 |
See <a class="xref" href="#Command_002dline-options">Command-line options</a>, and <a class="ref" href="#Config-files">Dvips configuration files</a>. |
| 621 |
</p> |
| 622 |
|
| 623 |
<hr> |
| 624 |
</div> |
| 625 |
<div class="subsection-level-extent" id="Printer-errors"> |
| 626 |
<div class="nav-panel"> |
| 627 |
<p> |
| 628 |
Next: <a href="#Long-documents-fail" accesskey="n" rel="next">Long documents fail to print</a>, Previous: <a href="#Small-or-inverted" accesskey="p" rel="prev">Output too small or inverted</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 629 |
</div> |
| 630 |
<h4 class="subsection" id="Error-messages-from-printer"><span>2.4.4 Error messages from printer<a class="copiable-link" href="#Error-messages-from-printer"> ¶</a></span></h4> |
| 631 |
|
| 632 |
<a class="index-entry-id" id="index-printer-errors"></a> |
| 633 |
<a class="index-entry-id" id="index-error-messages-from-printer"></a> |
| 634 |
<a class="index-entry-id" id="index-failure_002c-and-printer-errors"></a> |
| 635 |
|
| 636 |
<a class="index-entry-id" id="index-bop-undefined-error"></a> |
| 637 |
<p>If your printer returns error messages, the error message gives very |
| 638 |
good information on what might be going wrong. One of the most common |
| 639 |
error messages is ‘<samp class="samp">bop undefined</samp>’. This is caused by old versions |
| 640 |
of Transcript and other spoolers that do not properly parse the setup |
| 641 |
section of the PostScript. To fix this, turn off structured comments |
| 642 |
with the ‘<samp class="samp">-N</samp>’ option, but it’d be best to get your spooling |
| 643 |
software updated. |
| 644 |
</p> |
| 645 |
<a class="index-entry-id" id="index-VM-exhausted"></a> |
| 646 |
<a class="index-entry-id" id="index-printer-memory-exhausted"></a> |
| 647 |
<a class="index-entry-id" id="index-memory-of-printer-exhausted"></a> |
| 648 |
<p>Another error message is ‘<samp class="samp">VM exhausted</samp>’. Some printers indicate |
| 649 |
this error by locking up, others quietly reset. This is caused by Dvips |
| 650 |
thinking that the printer has more memory than it actually does, and |
| 651 |
then printing a complicated document. To fix this, try lowering the |
| 652 |
‘<samp class="samp">m</samp>’ parameter in the configuration file; use the debug option to |
| 653 |
make sure you adjust the correct file. |
| 654 |
</p> |
| 655 |
<p>Other errors may indicate you are trying to include graphics that don’t |
| 656 |
nest properly in other PostScript documents, among other things. Try |
| 657 |
the PostScript file on a QMS PS-810 or other Adobe PostScript printer if |
| 658 |
you have one, or Ghostscript (see <a class="pxref" href="#Ghostscript-installation">Ghostscript installation</a>); it |
| 659 |
might be a problem with the printer itself. |
| 660 |
</p> |
| 661 |
|
| 662 |
<hr> |
| 663 |
</div> |
| 664 |
<div class="subsection-level-extent" id="Long-documents-fail"> |
| 665 |
<div class="nav-panel"> |
| 666 |
<p> |
| 667 |
Next: <a href="#Including-graphics-fails" accesskey="n" rel="next">Including graphics fails</a>, Previous: <a href="#Printer-errors" accesskey="p" rel="prev">Error messages from printer</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 668 |
</div> |
| 669 |
<h4 class="subsection" id="Long-documents-fail-to-print"><span>2.4.5 Long documents fail to print<a class="copiable-link" href="#Long-documents-fail-to-print"> ¶</a></span></h4> |
| 670 |
|
| 671 |
<a class="index-entry-id" id="index-long-documents-not-printing"></a> |
| 672 |
<a class="index-entry-id" id="index-failure_002c-of-long-documents"></a> |
| 673 |
|
| 674 |
<p>This is usually caused by incorrectly specifying the amount of memory |
| 675 |
the printer has in the configuration file; see the previous section. |
| 676 |
</p> |
| 677 |
|
| 678 |
<hr> |
| 679 |
</div> |
| 680 |
<div class="subsection-level-extent" id="Including-graphics-fails"> |
| 681 |
<div class="nav-panel"> |
| 682 |
<p> |
| 683 |
Previous: <a href="#Long-documents-fail" accesskey="p" rel="prev">Long documents fail to print</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 684 |
</div> |
| 685 |
<h4 class="subsection" id="Including-graphics-fails-1"><span>2.4.6 Including graphics fails<a class="copiable-link" href="#Including-graphics-fails-1"> ¶</a></span></h4> |
| 686 |
|
| 687 |
<a class="index-entry-id" id="index-including-graphics-fails"></a> |
| 688 |
<a class="index-entry-id" id="index-graphics-inclusion-fails"></a> |
| 689 |
<a class="index-entry-id" id="index-failure_002c-to-include-graphics"></a> |
| 690 |
|
| 691 |
<p>The most common problem with including graphics is an incorrect bounding |
| 692 |
box (see <a class="pxref" href="#Bounding-box">The bounding box comment</a>). Complain to whoever wrote the software that |
| 693 |
generated the file if the bounding box is indeed incorrect. |
| 694 |
</p> |
| 695 |
<a class="index-entry-id" id="index-Illustrator_002c-workaround-for"></a> |
| 696 |
<p>Another possible problem is that the figure you are trying to include |
| 697 |
does not nest properly; there are certain rules PostScript applications |
| 698 |
must follow when generating files to be included. The Dvips program |
| 699 |
includes work-arounds for such errors in Adobe Illustrator and other |
| 700 |
programs, but there are certainly applications that haven’t been tested. |
| 701 |
</p> |
| 702 |
<p>One possible thing to try is the ‘<samp class="samp">-K</samp>’ flag which strips the comments |
| 703 |
from an included figure. This might be necessary if the PostScript |
| 704 |
spooling software does not read the structured comments correctly. Use |
| 705 |
of this flag will break graphics from some applications, though, since |
| 706 |
some applications read the PostScript file from the input stream, |
| 707 |
looking for a particular comment. |
| 708 |
</p> |
| 709 |
<a class="index-entry-id" id="index-binary-files_002c-not-supported"></a> |
| 710 |
<p>Any application which generates graphics output containing raw binary |
| 711 |
(not ASCII hex) will probably fail with Dvips. |
| 712 |
</p> |
| 713 |
|
| 714 |
<hr> |
| 715 |
</div> |
| 716 |
</div> |
| 717 |
</div> |
| 718 |
<div class="chapter-level-extent" id="Invoking-Dvips"> |
| 719 |
<div class="nav-panel"> |
| 720 |
<p> |
| 721 |
Next: <a href="#Paper-size-and-landscape" accesskey="n" rel="next">Paper size and landscape orientation</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 722 |
</div> |
| 723 |
<h2 class="chapter" id="Invoking-Dvips-1"><span>3 Invoking Dvips<a class="copiable-link" href="#Invoking-Dvips-1"> ¶</a></span></h2> |
| 724 |
|
| 725 |
<a class="index-entry-id" id="index-command_002dline-options"></a> |
| 726 |
<a class="index-entry-id" id="index-options_002c-Dvips"></a> |
| 727 |
<a class="index-entry-id" id="index-invoking-Dvips"></a> |
| 728 |
|
| 729 |
<p>Dvips reads a DVI file as output by (for example) TeX, and converts |
| 730 |
it to PostScript, taking care of builtin or downloaded PostScript fonts, |
| 731 |
font reencoding, color, etc. These features are described in other |
| 732 |
chapters in this document. |
| 733 |
</p> |
| 734 |
<p>There many ways to control Dvips’ behavior: configuration files, |
| 735 |
environment variables, and command-line options. |
| 736 |
</p> |
| 737 |
|
| 738 |
|
| 739 |
<ul class="mini-toc"> |
| 740 |
<li><a href="#Basic-usage" accesskey="1">Basic usage of Dvips</a></li> |
| 741 |
<li><a href="#Command_002dline-options" accesskey="2">Command-line options</a></li> |
| 742 |
<li><a href="#Environment-variables" accesskey="3">Environment variables</a></li> |
| 743 |
<li><a href="#Config-files" accesskey="4">Dvips configuration files</a></li> |
| 744 |
</ul> |
| 745 |
<hr> |
| 746 |
<div class="section-level-extent" id="Basic-usage"> |
| 747 |
<div class="nav-panel"> |
| 748 |
<p> |
| 749 |
Next: <a href="#Command_002dline-options" accesskey="n" rel="next">Command-line options</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 750 |
</div> |
| 751 |
<h3 class="section" id="Basic-usage-of-Dvips"><span>3.1 Basic usage of Dvips<a class="copiable-link" href="#Basic-usage-of-Dvips"> ¶</a></span></h3> |
| 752 |
|
| 753 |
<a class="index-entry-id" id="index-usage_002c-basic"></a> |
| 754 |
|
| 755 |
<p>To use Dvips at its simplest, simply type |
| 756 |
</p> |
| 757 |
<div class="example"> |
| 758 |
<pre class="example-preformatted">dvips foo |
| 759 |
</pre></div> |
| 760 |
|
| 761 |
<p>where <samp class="file">foo.dvi</samp> is the output of TeX that you want to print. |
| 762 |
The default output is to a corresponding file <samp class="file">foo.ps</samp>; Dvips may |
| 763 |
also have been locally configured to output directly to a printer by |
| 764 |
default. |
| 765 |
</p> |
| 766 |
<p>If you use fonts that have not been used on your system before, they may |
| 767 |
be automatically generated; this process can take a few minutes, so |
| 768 |
progress reports appear by default. The next time that document is |
| 769 |
printed, these fonts will have been saved in the proper directories, so |
| 770 |
printing will go much faster. (If Dvips tries to endlessly generate the |
| 771 |
same fonts over and over again, it hasn’t been installed properly. |
| 772 |
See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite class="cite">Kpathsea</cite>.) |
| 773 |
</p> |
| 774 |
<p>Many options are available (see the next section). For a brief summary |
| 775 |
of available options, run |
| 776 |
</p> |
| 777 |
<div class="example"> |
| 778 |
<pre class="example-preformatted">dvips --help |
| 779 |
</pre></div> |
| 780 |
|
| 781 |
|
| 782 |
<hr> |
| 783 |
</div> |
| 784 |
<div class="section-level-extent" id="Command_002dline-options"> |
| 785 |
<div class="nav-panel"> |
| 786 |
<p> |
| 787 |
Next: <a href="#Environment-variables" accesskey="n" rel="next">Environment variables</a>, Previous: <a href="#Basic-usage" accesskey="p" rel="prev">Basic usage of Dvips</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 788 |
</div> |
| 789 |
<h3 class="section" id="Command_002dline-options-1"><span>3.2 Command-line options<a class="copiable-link" href="#Command_002dline-options-1"> ¶</a></span></h3> |
| 790 |
|
| 791 |
<p>Dvips has a plethora of command line options. Reading through this |
| 792 |
section will give a good idea of the capabilities of the driver. |
| 793 |
</p> |
| 794 |
|
| 795 |
|
| 796 |
<ul class="mini-toc"> |
| 797 |
<li><a href="#Option-summary" accesskey="1">Option summary</a></li> |
| 798 |
<li><a href="#Option-details" accesskey="2">Option details</a></li> |
| 799 |
</ul> |
| 800 |
<hr> |
| 801 |
<div class="subsection-level-extent" id="Option-summary"> |
| 802 |
<div class="nav-panel"> |
| 803 |
<p> |
| 804 |
Next: <a href="#Option-details" accesskey="n" rel="next">Option details</a>, Up: <a href="#Command_002dline-options" accesskey="u" rel="up">Command-line options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 805 |
</div> |
| 806 |
<h4 class="subsection" id="Option-summary-1"><span>3.2.1 Option summary<a class="copiable-link" href="#Option-summary-1"> ¶</a></span></h4> |
| 807 |
|
| 808 |
<a class="index-entry-id" id="index-options_002c-summary"></a> |
| 809 |
<p>Here is a handy summary of the options; it is printed out when you run |
| 810 |
Dvips with no arguments or with the standard ‘<samp class="samp">--help</samp>’ option. |
| 811 |
<a class="index-entry-id" id="index-_002d_002dhelp"></a> |
| 812 |
</p> |
| 813 |
<pre class="verbatim">Usage: dvips [OPTION]... FILENAME[.dvi] |
| 814 |
Convert DVI input files to PostScript. |
| 815 |
See http://tug.org/dvips/ for the full manual and other information. |
| 816 |
|
| 817 |
Options: |
| 818 |
-a* Conserve memory, not time -A Print only odd (TeX) pages |
| 819 |
-b # Page copies, for posters e.g. -B Print only even (TeX) pages |
| 820 |
-c # Uncollated copies -C # Collated copies |
| 821 |
-d # Debugging -D # Resolution |
| 822 |
-e # Maxdrift value -E* Try to create EPSF |
| 823 |
-f* Run as filter -F* Send control-D at end |
| 824 |
-G* Shift low chars to higher pos. |
| 825 |
-h f Add header file |
| 826 |
-i* Separate file per section |
| 827 |
-j* Download fonts partially |
| 828 |
-k* Print crop marks -K* Pull comments from inclusions |
| 829 |
-l # Last page -L* Last special papersize wins |
| 830 |
-m* Manual feed -M* Don't make fonts |
| 831 |
-mode s Metafont device name |
| 832 |
-n # Maximum number of pages -N* No structured comments |
| 833 |
-noomega Disable Omega extensions |
| 834 |
-noptex Disable pTeX extensions |
| 835 |
-o f Output file -O c Set/change paper offset |
| 836 |
-p # First page -P s Load config.$s |
| 837 |
-pp l Print only pages listed |
| 838 |
-q* Run quietly |
| 839 |
-r* Reverse order of pages -R* Run securely |
| 840 |
-s* Enclose output in save/restore -S # Max section size in pages |
| 841 |
-t s Paper format -T c Specify desired page size |
| 842 |
-title s Title in comment |
| 843 |
-u s PS mapfile -U* Disable string param trick |
| 844 |
-v Print version number and quit -V* Send downloadable PS fonts as PK |
| 845 |
-x # Override dvi magnification -X # Horizontal resolution |
| 846 |
-y # Multiply by dvi magnification -Y # Vertical resolution |
| 847 |
-z* Hyper PS -Z* Compress bitmap fonts |
| 848 |
# = number f = file s = string * = suffix, `0' to turn off |
| 849 |
c = comma-separated dimension pair (e.g., 3.2in,-32.1cm) |
| 850 |
l = comma-separated list of page ranges (e.g., 1-4,7-9) |
| 851 |
|
| 852 |
Email bug reports to [email protected]. |
| 853 |
</pre> |
| 854 |
|
| 855 |
<hr> |
| 856 |
</div> |
| 857 |
<div class="subsection-level-extent" id="Option-details"> |
| 858 |
<div class="nav-panel"> |
| 859 |
<p> |
| 860 |
Previous: <a href="#Option-summary" accesskey="p" rel="prev">Option summary</a>, Up: <a href="#Command_002dline-options" accesskey="u" rel="up">Command-line options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 861 |
</div> |
| 862 |
<h4 class="subsection" id="Option-details-1"><span>3.2.2 Option details<a class="copiable-link" href="#Option-details-1"> ¶</a></span></h4> |
| 863 |
|
| 864 |
<a class="index-entry-id" id="index-option_002c-details-of"></a> |
| 865 |
|
| 866 |
<p>Many of the parameterless options listed here can be turned off by |
| 867 |
suffixing the option with a zero (‘<samp class="samp">0</samp>’); for instance, to turn off |
| 868 |
page reversal, use ‘<samp class="samp">-r0</samp>’. Such options are marked with a trailing |
| 869 |
‘<samp class="samp">*</samp>’. |
| 870 |
</p> |
| 871 |
<dl class="table"> |
| 872 |
<dt><a class="index-entry-id" id="index-options_002c-reading-from-standard-input"></a> |
| 873 |
<a class="index-entry-id" id="index-standard-input_002c-reading-options-from"></a> |
| 874 |
<a id="index-_002d"></a><span>‘<samp class="samp">-</samp>’<a class="copiable-link" href="#index-_002d"> ¶</a></span></dt> |
| 875 |
<dd><p>Read additional options from standard input after processing the command |
| 876 |
line. |
| 877 |
</p> |
| 878 |
</dd> |
| 879 |
<dt><a id="index-_002d_002dhelp-1"></a><span>‘<samp class="samp">--help</samp>’<a class="copiable-link" href="#index-_002d_002dhelp-1"> ¶</a></span></dt> |
| 880 |
<dd><p>Print a usage message and exit. |
| 881 |
</p> |
| 882 |
</dd> |
| 883 |
<dt><a id="index-_002d_002dversion"></a><span>‘<samp class="samp">--version</samp>’<a class="copiable-link" href="#index-_002d_002dversion"> ¶</a></span></dt> |
| 884 |
<dd><p>Print the version number and exit. |
| 885 |
</p> |
| 886 |
</dd> |
| 887 |
<dt><a class="index-entry-id" id="index-memory_002c-conserving"></a> |
| 888 |
<a id="index-_002da"></a><span>‘<samp class="samp">-a*</samp>’<a class="copiable-link" href="#index-_002da"> ¶</a></span></dt> |
| 889 |
<dd><p>Conserve memory by making three passes over the DVI file instead |
| 890 |
of two and only loading those characters actually used. Generally only |
| 891 |
useful on machines with a very limited amount of memory, like some PCs. |
| 892 |
</p> |
| 893 |
</dd> |
| 894 |
<dt><a class="index-entry-id" id="index-odd-pages-only"></a> |
| 895 |
<a id="index-_002dA"></a><span>‘<samp class="samp">-A</samp>’<a class="copiable-link" href="#index-_002dA"> ¶</a></span></dt> |
| 896 |
<dd><p>Print only the odd pages. This option uses TeX |
| 897 |
page numbers, not physical page numbers. |
| 898 |
</p> |
| 899 |
</dd> |
| 900 |
<dt><a class="index-entry-id" id="index-_002f_0023copies"></a> |
| 901 |
<a class="index-entry-id" id="index-copies_002c-duplicated-page-bodies"></a> |
| 902 |
<a class="index-entry-id" id="index-color-separations"></a> |
| 903 |
<a id="index-_002db-num"></a><span>‘<samp class="samp">-b <var class="var">num</var></samp>’<a class="copiable-link" href="#index-_002db-num"> ¶</a></span></dt> |
| 904 |
<dd><p>Generate <var class="var">num</var> copies of each page, but duplicating the page body |
| 905 |
rather than using the ‘<samp class="samp">/#copies</samp>’ PostScript variable. This can |
| 906 |
be useful in conjunction with a header file setting ‘<samp class="samp">bop-hook</samp>’ to |
| 907 |
do color separations or other neat tricks. |
| 908 |
</p> |
| 909 |
</dd> |
| 910 |
<dt><a class="index-entry-id" id="index-even-pages-only"></a> |
| 911 |
<a class="index-entry-id" id="index-double_002dsided-printing"></a> |
| 912 |
<a id="index-_002dB"></a><span>‘<samp class="samp">-B</samp>’<a class="copiable-link" href="#index-_002dB"> ¶</a></span></dt> |
| 913 |
<dd><p>Print only the even pages. This option uses TeX page numbers, not |
| 914 |
physical page numbers. |
| 915 |
</p> |
| 916 |
</dd> |
| 917 |
<dt><a class="index-entry-id" id="index-bitmap-font-encoding"></a> |
| 918 |
<a id="index-_002dbitmapfontenc-option"></a><span>‘<samp class="samp">-bitmapfontenc <var class="var">option</var></samp>’<a class="copiable-link" href="#index-_002dbitmapfontenc-option"> ¶</a></span></dt> |
| 919 |
<dd><p>Turns bitmap font encoding to ‘<samp class="samp">off</samp>’, ‘<samp class="samp">on</samp>’ (no warnings |
| 920 |
for missing bitmap font encodings), or ‘<samp class="samp">strict</samp>’ (with warnings |
| 921 |
for missing bitmap font encodings). |
| 922 |
</p> |
| 923 |
</dd> |
| 924 |
<dt><a class="index-entry-id" id="index-_002f_0023copies-1"></a> |
| 925 |
<a class="index-entry-id" id="index-copies_002c-uncollated"></a> |
| 926 |
<a class="index-entry-id" id="index-uncollated-copies"></a> |
| 927 |
<a id="index-_002dc-num"></a><span>‘<samp class="samp">-c <var class="var">num</var></samp>’<a class="copiable-link" href="#index-_002dc-num"> ¶</a></span></dt> |
| 928 |
<dd><p>Generate <var class="var">num</var> consecutive copies of every page, i.e., the output is |
| 929 |
uncollated. This merely sets the builtin PostScript variable |
| 930 |
‘<samp class="samp">/#copies</samp>’. |
| 931 |
</p> |
| 932 |
</dd> |
| 933 |
<dt><a class="index-entry-id" id="index-copies_002c-collated"></a> |
| 934 |
<a class="index-entry-id" id="index-collated-copies"></a> |
| 935 |
<a id="index-_002dC-num"></a><span>‘<samp class="samp">-C <var class="var">num</var></samp>’<a class="copiable-link" href="#index-_002dC-num"> ¶</a></span></dt> |
| 936 |
<dd><p>Generate <var class="var">num</var> copies, but collated (by replicating the data in the |
| 937 |
PostScript file). Slower than the ‘<samp class="samp">-c</samp>’ option, but easier on the |
| 938 |
hands, and faster than resubmitting the same PostScript file multiple |
| 939 |
times. |
| 940 |
</p> |
| 941 |
</dd> |
| 942 |
<dt><a class="index-entry-id" id="index-debugging-1"></a> |
| 943 |
<a id="index-_002dd-num"></a><span>‘<samp class="samp">-d <var class="var">num</var></samp>’<a class="copiable-link" href="#index-_002dd-num"> ¶</a></span></dt> |
| 944 |
<dd><p>Set the debug flags, showing what Dvips (thinks it) is doing. This will |
| 945 |
work unless Dvips has been compiled without the ‘<samp class="samp">DEBUG</samp>’ option (not |
| 946 |
recommended). See <a class="xref" href="#Debug-options">Debug options</a>, for the possible values of |
| 947 |
<var class="var">num</var>. Use ‘<samp class="samp">-d -1</samp>’ as the first option for maximum output. |
| 948 |
</p> |
| 949 |
</dd> |
| 950 |
<dt><a class="index-entry-id" id="index-resolution_002c-setting"></a> |
| 951 |
<a id="index-_002dD-num"></a><span>‘<samp class="samp">-D <var class="var">num</var></samp>’<a class="copiable-link" href="#index-_002dD-num"> ¶</a></span></dt> |
| 952 |
<dd><p>Set both the horizontal and vertical resolution to <var class="var">num</var>, given in |
| 953 |
dpi (dots per inch). This affects the choice of bitmap fonts that are |
| 954 |
loaded and also the positioning of letters in resident PostScript |
| 955 |
fonts. Must be between 10 and 10000. This affects both the horizontal |
| 956 |
and vertical resolution. If a high resolution (something greater than |
| 957 |
400 dpi, say) is selected, the ‘<samp class="samp">-Z</samp>’ flag should probably also be |
| 958 |
used. If you are using fonts made with Metafont, such as Computer |
| 959 |
Modern, <samp class="file">mktexpk</samp> needs to know about the value for <var class="var">num</var> |
| 960 |
that you use or Metafont will fail. See the <code class="code">modes.mf</code> file |
| 961 |
(<a class="url" href="https://ctan.org/pkg/modes">https://ctan.org/pkg/modes</a>) for a list of resolutions and mode |
| 962 |
names for most devices. |
| 963 |
</p> |
| 964 |
</dd> |
| 965 |
<dt><a class="index-entry-id" id="index-maxdrift"></a> |
| 966 |
<a class="index-entry-id" id="index-accuracy-in-positioning"></a> |
| 967 |
<a class="index-entry-id" id="index-positioning-accuracy"></a> |
| 968 |
<a id="index-_002de-num"></a><span>‘<samp class="samp">-e <var class="var">num</var></samp>’<a class="copiable-link" href="#index-_002de-num"> ¶</a></span></dt> |
| 969 |
<dd><p>Maximum drift in pixels of each character from its ‘true’ |
| 970 |
resolution-independent position on the page. The default value of this |
| 971 |
parameter is resolution dependent (it is the number of entries in the |
| 972 |
list [100, 200, 300, 400, 500, 600, 800, 1000, 1200, 1600, 2000, 2400, |
| 973 |
2800, 3200, …] that are less than or equal to the resolution in |
| 974 |
dots per inch). Allowing individual characters to ‘drift’ from their |
| 975 |
correctly rounded positions by a few pixels, while regaining the true |
| 976 |
position at the beginning of each new word, improves the spacing of |
| 977 |
letters in words. |
| 978 |
</p> |
| 979 |
</dd> |
| 980 |
<dt><a class="index-entry-id" id="index-EPSF_002c-generating"></a> |
| 981 |
<a class="index-entry-id" id="index-tight-bounding-box_002c-finding"></a> |
| 982 |
<a class="index-entry-id" id="index-bounding-box_002c-finding-tight"></a> |
| 983 |
<a id="index-_002dE"></a><span>‘<samp class="samp">-E*</samp>’<a class="copiable-link" href="#index-_002dE"> ¶</a></span></dt> |
| 984 |
<dd><p>Generate an EPSF file with a tight bounding box. This only looks at |
| 985 |
marks made by characters and rules, not by any included graphics. In |
| 986 |
addition, it gets the glyph metrics from the TFM file, so characters |
| 987 |
that print outside their enclosing TFM box may confuse it. In addition, |
| 988 |
the bounding box might be a bit too loose if the character glyph has |
| 989 |
significant left or right side bearings. Nonetheless, this option works |
| 990 |
well enough for creating small EPSF files for equations or tables or the |
| 991 |
like. (Of course, Dvips output, especially when using bitmap fonts, is |
| 992 |
resolution-dependent and thus does not make very good EPSF files, |
| 993 |
especially if the images are to be scaled; use these EPSF files with |
| 994 |
care.) For multiple page input files, also specify ‘<samp class="samp">-i</samp>’ to get |
| 995 |
each page as a separate EPSF file; otherwise, all the pages are overlaid |
| 996 |
in the single output file. |
| 997 |
</p> |
| 998 |
</dd> |
| 999 |
<dt><a class="index-entry-id" id="index-filter_002c-running-as-a"></a> |
| 1000 |
<a class="index-entry-id" id="index-standard-I_002fO"></a> |
| 1001 |
<a class="index-entry-id" id="index-pipes_002c-not-readable"></a> |
| 1002 |
<a class="index-entry-id" id="index-PRINTER_002c-avoided-with-_002df"></a> |
| 1003 |
<a id="index-_002df"></a><span>‘<samp class="samp">-f*</samp>’<a class="copiable-link" href="#index-_002df"> ¶</a></span></dt> |
| 1004 |
<dd><p>Run as a filter. Read the DVI file from standard input and write the |
| 1005 |
PostScript to standard output. The standard input must be seekable, so |
| 1006 |
it cannot be a pipe. If your input must be a pipe, write a shell script |
| 1007 |
that copies the pipe output to a temporary file and then points Dvips at |
| 1008 |
this file. This option also disables the automatic reading of the |
| 1009 |
<code class="code">PRINTER</code> environment variable; use ‘<samp class="samp">-P$PRINTER</samp>’ after the |
| 1010 |
‘<samp class="samp">-f</samp>’ to read it anyway. It also turns off the automatic sending of |
| 1011 |
control-D if it was turned on with the ‘<samp class="samp">-F</samp>’ option or in the |
| 1012 |
configuration file; use ‘<samp class="samp">-F</samp>’ after the ‘<samp class="samp">-f</samp>’ to send it anyway. |
| 1013 |
</p> |
| 1014 |
</dd> |
| 1015 |
<dt><a class="index-entry-id" id="index-EOF"></a> |
| 1016 |
<a class="index-entry-id" id="index-control_002dD"></a> |
| 1017 |
<a class="index-entry-id" id="index-printer_002c-driving-directly"></a> |
| 1018 |
<a class="index-entry-id" id="index-spooler_002c-lacking"></a> |
| 1019 |
<a id="index-_002dF"></a><span>‘<samp class="samp">-F*</samp>’<a class="copiable-link" href="#index-_002dF"> ¶</a></span></dt> |
| 1020 |
<dd><p>Write control-D (ASCII code 4) as the very last character of the |
| 1021 |
PostScript file. This is useful when Dvips is driving the printer |
| 1022 |
directly instead of working through a spooler, as is common on personal |
| 1023 |
systems. On systems shared by more than one person, this is not |
| 1024 |
recommended. |
| 1025 |
</p> |
| 1026 |
</dd> |
| 1027 |
<dt><a class="index-entry-id" id="index-low-characters_002c-shifting"></a> |
| 1028 |
<a class="index-entry-id" id="index-non_002dprinting-characters_002c-shifting"></a> |
| 1029 |
<a id="index-_002dG"></a><span>‘<samp class="samp">-G*</samp>’<a class="copiable-link" href="#index-_002dG"> ¶</a></span></dt> |
| 1030 |
<dd><p>Shift non-printing characters (ASCII 0-32, 127) to higher-numbered positions. |
| 1031 |
This was useful to work around bugs in old versions of Adobe’s PDF |
| 1032 |
reader. It’s more likely to cause problems nowadays. |
| 1033 |
</p> |
| 1034 |
</dd> |
| 1035 |
<dt><a class="index-entry-id" id="index-header-file_002c-downloading"></a> |
| 1036 |
<a class="index-entry-id" id="index-userdict_002c-used-for-header-files"></a> |
| 1037 |
<a id="index-_002dh-name"></a><span>‘<samp class="samp">-h <var class="var">name</var></samp>’<a class="copiable-link" href="#index-_002dh-name"> ¶</a></span></dt> |
| 1038 |
<dd><p>Prepend <var class="var">name</var> as an additional header file, or, if <var class="var">name</var> is |
| 1039 |
‘<samp class="samp">-</samp>’, suppress inclusion of default header files. If <code class="code">-h</code> is |
| 1040 |
given multiple times, the headers are included in the order given. |
| 1041 |
Any definitions in the header file get added to the PostScript |
| 1042 |
‘<samp class="samp">userdict</samp>’. |
| 1043 |
</p> |
| 1044 |
</dd> |
| 1045 |
<dt><a class="index-entry-id" id="index-sections-output_002c-in-separate-files"></a> |
| 1046 |
<a class="index-entry-id" id="index-multiple-output-files"></a> |
| 1047 |
<a class="index-entry-id" id="index-output-files_002c-multiple"></a> |
| 1048 |
<a id="index-_002di"></a><span>‘<samp class="samp">-i*</samp>’<a class="copiable-link" href="#index-_002di"> ¶</a></span></dt> |
| 1049 |
<dd><p>Make each section be a separate file; a <em class="dfn">section</em> is a part of the |
| 1050 |
document processed independently, most often created to avoid memory |
| 1051 |
overflow. The filenames are created replacing the suffix of the |
| 1052 |
supplied output file name by a three-digit sequence number. This option |
| 1053 |
is most often used in conjunction with the ‘<samp class="samp">-S</samp>’ option which sets |
| 1054 |
the maximum section length in pages; if ‘<samp class="samp">-i</samp>’ is specified and |
| 1055 |
‘<samp class="samp">-S</samp>’ is not, each page is output as a separate file. For instance, |
| 1056 |
some phototypesetters cannot print more than ten or so consecutive pages |
| 1057 |
before running out of steam; these options can be used to automatically |
| 1058 |
split a book into ten-page sections, each to its own file. |
| 1059 |
</p> |
| 1060 |
<p>On the other hand, if your document uses very large fonts or very |
| 1061 |
large included figures, Dvips might take it upon itself to split the |
| 1062 |
output into unwanted sections, to try to avoid overflowing printer |
| 1063 |
memory. See <a class="xref" href="#Headers-and-memory-usage">Headers and memory usage</a>, for ways to handle this. |
| 1064 |
</p> |
| 1065 |
</dd> |
| 1066 |
<dt><a id="index-_002dj-for-partial-font-downloading"></a><span>‘<samp class="samp">-j*</samp>’<a class="copiable-link" href="#index-_002dj-for-partial-font-downloading"> ¶</a></span></dt> |
| 1067 |
<dd><p>Download only needed characters from Type 1 fonts. This is the |
| 1068 |
default in the current release. Some debugging flags trace this operation |
| 1069 |
(see <a class="pxref" href="#Debug-options">Debug options</a>). You can also control partial downloading on a |
| 1070 |
per-font basis (see <a class="pxref" href="#psfonts_002emap"><samp class="file">psfonts.map</samp>: PostScript font catalog</a>). |
| 1071 |
</p> |
| 1072 |
</dd> |
| 1073 |
<dt><a class="index-entry-id" id="index-cropmarks"></a> |
| 1074 |
<a class="index-entry-id" id="index-crop_002epro"></a> |
| 1075 |
<a id="index-_002dk-for-cropmarks"></a><span>‘<samp class="samp">-k*</samp>’<a class="copiable-link" href="#index-_002dk-for-cropmarks"> ¶</a></span></dt> |
| 1076 |
<dd><p>Print crop marks. This option increases the paper size (which should be |
| 1077 |
specified, either with a paper size special or with the ‘<samp class="samp">-T</samp>’ |
| 1078 |
option) by a half inch in each dimension. It translates each page by a |
| 1079 |
quarter inch and draws cross-style crop marks. It is mostly useful with |
| 1080 |
typesetters that can set the page size automatically. This works by |
| 1081 |
downloading <samp class="file">crop.pro</samp>. |
| 1082 |
</p> |
| 1083 |
</dd> |
| 1084 |
<dt><a class="index-entry-id" id="index-comments_002c-removing-included"></a> |
| 1085 |
<a class="index-entry-id" id="index-_0025_0025Page_002c-removing"></a> |
| 1086 |
<a id="index-_002dK"></a><span>‘<samp class="samp">-K*</samp>’<a class="copiable-link" href="#index-_002dK"> ¶</a></span></dt> |
| 1087 |
<dd><p>Remove comments in included PostScript graphics, font files, and |
| 1088 |
headers; only necessary to get around bugs in spoolers or PostScript |
| 1089 |
post-processing programs. Specifically, the ‘<samp class="samp">%%Page</samp>’ |
| 1090 |
comments, when left in, often cause difficulties. Use of this flag can |
| 1091 |
cause other graphics to fail, however, since the PostScript header |
| 1092 |
macros from some software packages read portion the input stream line by |
| 1093 |
line, searching for a particular comment. |
| 1094 |
</p> |
| 1095 |
</dd> |
| 1096 |
<dt><a class="index-entry-id" id="index-last-page-printed"></a> |
| 1097 |
<a class="index-entry-id" id="index-page_002c-last-printed"></a> |
| 1098 |
<a class="index-entry-id" id="index-page-numbers_002c-multiple-repetitions-of"></a> |
| 1099 |
<a class="index-entry-id" id="index-physical-page-number_002c-and-_002dl"></a> |
| 1100 |
<a class="index-entry-id" id="index-absolute-page-number_002c-and-_002dl"></a> |
| 1101 |
<a id="index-_002dl-_005b_003d_005dnum_005b_002epageseq_005d"></a><span>‘<samp class="samp">-l [=]<var class="var">num</var>[.<var class="var">pageseq</var>]</samp>’<a class="copiable-link" href="#index-_002dl-_005b_003d_005dnum_005b_002epageseq_005d"> ¶</a></span></dt> |
| 1102 |
<dd><p>The last page printed will be the first one numbered <var class="var">num</var>; the |
| 1103 |
default is the last page in the document. |
| 1104 |
</p> |
| 1105 |
<p>By default, <var class="var">num</var> is compared to TeX’s idea of the page number |
| 1106 |
(more precisely, the <code class="code">\count0</code> value written in the DVI file). |
| 1107 |
But if <var class="var">num</var> is prefixed by an equals sign, then it (and the |
| 1108 |
argument to the ‘<samp class="samp">-p</samp>’ option, if specified) is treated as a |
| 1109 |
physical (absolute) page number, Thus, using ‘<samp class="samp">-l =9</samp>’ will end the |
| 1110 |
output with the ninth page of the document, no matter what the pages |
| 1111 |
are actually numbered. |
| 1112 |
</p> |
| 1113 |
<p>On the other hand, if <var class="var">pageseq</var> is specified, the <var class="var">pageseq</var>th |
| 1114 |
occurrence of the given TeX page number is used. For example, |
| 1115 |
‘<samp class="samp">-l 99.2</samp>’ says to end with the second page numbered 99 in the |
| 1116 |
document. The ‘<samp class="samp">=</samp>’ and <var class="var">lastseq</var> features aren’t useful |
| 1117 |
together. |
| 1118 |
</p> |
| 1119 |
</dd> |
| 1120 |
<dt><a class="index-entry-id" id="index-papersize-special_002c-first-vs_002e-last"></a> |
| 1121 |
<a id="index-_002dL"></a><span>‘<samp class="samp">-L*</samp>’<a class="copiable-link" href="#index-_002dL"> ¶</a></span></dt> |
| 1122 |
<dd><p>By default or with <code class="code">-L1</code>, the last ‘<samp class="samp">papersize</samp>’ special wins; |
| 1123 |
with <code class="code">-L0</code>, the first special wins. See <a class="xref" href="#papersize-special">‘<samp class="samp">papersize</samp>’ special</a>. |
| 1124 |
</p> |
| 1125 |
</dd> |
| 1126 |
<dt><a class="index-entry-id" id="index-landscaperotate"></a> |
| 1127 |
<a id="index-_002dlandscaperotate"></a><span>‘<samp class="samp">-landscaperotate*</samp>’<a class="copiable-link" href="#index-_002dlandscaperotate"> ¶</a></span></dt> |
| 1128 |
<dd><p>When looking for matching paper sizes, permit rotation of page content |
| 1129 |
on the page to match the given size; the default, as of Dvips 2022.1, |
| 1130 |
is not to do this. It should not be needed in modern systems with |
| 1131 |
normal print spoolers, and can be harmful when converting to PDF |
| 1132 |
(see <a class="pxref" href="#Config-file-paper-sizes">Configuration file paper size command</a>). This option accepts an optional |
| 1133 |
suffix of 0 (to explicitly disable) or 1 (to explicitly enable); if |
| 1134 |
the option is specified without a suffix, it enables the behavior. |
| 1135 |
</p> |
| 1136 |
</dd> |
| 1137 |
<dt><a class="index-entry-id" id="index-manual-feed"></a> |
| 1138 |
<a id="index-_002dm"></a><span>‘<samp class="samp">-m*</samp>’<a class="copiable-link" href="#index-_002dm"> ¶</a></span></dt> |
| 1139 |
<dd><p>Specify manual feed, if supported by the output device. |
| 1140 |
</p> |
| 1141 |
</dd> |
| 1142 |
<dt><a class="index-entry-id" id="index-mode-name_002c-specifying"></a> |
| 1143 |
<a class="index-entry-id" id="index-Metafont-mode_002c-specifying"></a> |
| 1144 |
<a id="index-_002dmode-mode"></a><span>‘<samp class="samp">-mode <var class="var">mode</var></samp>’<a class="copiable-link" href="#index-_002dmode-mode"> ¶</a></span></dt> |
| 1145 |
<dd><p>Use <var class="var">mode</var> as the Metafont device name for path searching and font |
| 1146 |
generation. This overrides any value from configuration files. With |
| 1147 |
the default paths, explicitly specifying the mode also makes the program |
| 1148 |
assume the fonts are in a subdirectory named <var class="var">mode</var>. |
| 1149 |
See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#TeX-directory-structure">TeX directory structure</a> in <cite class="cite">Kpathsea</cite>. If Metafont does not understand the <var class="var">mode</var> name, see |
| 1150 |
<a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite class="cite">Kpathsea</cite>. |
| 1151 |
</p> |
| 1152 |
</dd> |
| 1153 |
<dt><a class="index-entry-id" id="index-font-generation_002c-avoiding"></a> |
| 1154 |
<a class="index-entry-id" id="index-mktexpk_002c-avoiding"></a> |
| 1155 |
<a class="index-entry-id" id="index-missfont_002elog"></a> |
| 1156 |
<a id="index-_002dM"></a><span>‘<samp class="samp">-M*</samp>’<a class="copiable-link" href="#index-_002dM"> ¶</a></span></dt> |
| 1157 |
<dd><p>Turns off automatic font generation (<samp class="file">mktexpk</samp>). If |
| 1158 |
<code class="code">mktexpk</code>, the invocation is appended to a file |
| 1159 |
<samp class="file">missfont.log</samp> (by default) in the current directory. You can then |
| 1160 |
execute the log file to create the missing files after fixing the |
| 1161 |
problem. |
| 1162 |
<a class="index-entry-id" id="index-TEXMFOUTPUT"></a> |
| 1163 |
<a class="index-entry-id" id="index-MISSFONT_005fLOG"></a> |
| 1164 |
If the current directory is not writable and the environment variable or |
| 1165 |
configuration file value ‘<samp class="samp">TEXMFOUTPUT</samp>’ is set, its value is used. |
| 1166 |
Otherwise, nothing is written. The name ‘<samp class="samp">missfont.log</samp>’ is |
| 1167 |
overridden by the ‘<samp class="samp">MISSFONT_LOG</samp>’ environment variable or |
| 1168 |
configuration file value. |
| 1169 |
</p> |
| 1170 |
</dd> |
| 1171 |
<dt><a class="index-entry-id" id="index-maximum-pages-printed"></a> |
| 1172 |
<a class="index-entry-id" id="index-pages_002c-maximum-printed"></a> |
| 1173 |
<a id="index-_002dn-num"></a><span>‘<samp class="samp">-n <var class="var">num</var></samp>’<a class="copiable-link" href="#index-_002dn-num"> ¶</a></span></dt> |
| 1174 |
<dd><p>Print at most <var class="var">num</var> pages. Default is 100000. |
| 1175 |
</p> |
| 1176 |
</dd> |
| 1177 |
<dt><a class="index-entry-id" id="index-structured-comments"></a> |
| 1178 |
<a class="index-entry-id" id="index-TranScript"></a> |
| 1179 |
<a class="index-entry-id" id="index-_0025_0025Page_002c-not-generating"></a> |
| 1180 |
<a id="index-_002dN"></a><span>‘<samp class="samp">-N*</samp>’<a class="copiable-link" href="#index-_002dN"> ¶</a></span></dt> |
| 1181 |
<dd><p>Turns off generation of structured comments such as ‘<samp class="samp">%%Page</samp>’; this |
| 1182 |
may be necessary on some systems that try to interpret PostScript |
| 1183 |
comments in weird ways, or on some PostScript printers. Old versions of |
| 1184 |
TranScript in particular cannot handle modern Encapsulated PostScript. |
| 1185 |
Beware: This also disables page movement, etc., in PostScript viewers |
| 1186 |
such as Ghostview. |
| 1187 |
</p> |
| 1188 |
</dd> |
| 1189 |
<dt><a class="index-entry-id" id="index-Omega-extensions"></a> |
| 1190 |
<a class="index-entry-id" id="index-pTeX-extensions"></a> |
| 1191 |
<a id="index-_002dnoomega"></a><span>‘<samp class="samp">-noomega</samp>’<a class="copiable-link" href="#index-_002dnoomega"> ¶</a></span></dt> |
| 1192 |
<dd><p>Disable the use of Omega extensions when interpreting DVI |
| 1193 |
files. By default, the additional opcodes ‘<samp class="samp">129</samp>’ and ‘<samp class="samp">134</samp>’ |
| 1194 |
are recognized by Dvips as Omega or pTeX extensions and interpreted as |
| 1195 |
requests to set 2-byte characters. |
| 1196 |
</p> |
| 1197 |
</dd> |
| 1198 |
<dt><a class="index-entry-id" id="index-pTeX-extensions-1"></a> |
| 1199 |
<a id="index-_002dnoptex"></a><span>‘<samp class="samp">-noptex</samp>’<a class="copiable-link" href="#index-_002dnoptex"> ¶</a></span></dt> |
| 1200 |
<dd><p>Disable the use of pTeX extensions when interpreting DVI files. By |
| 1201 |
default, the additional opcodes ‘<samp class="samp">130</samp>’ and ‘<samp class="samp">135</samp>’ are |
| 1202 |
recognized by Dvips as Omega extensions and interpreted as requests to |
| 1203 |
set 3-byte characters, and ‘<samp class="samp">255</samp>’ as request to change the |
| 1204 |
typesetting direction. |
| 1205 |
</p> |
| 1206 |
<p>The only drawback is that the virtual font array will (at least |
| 1207 |
temporarily) require 65536 or more positions instead of the default |
| 1208 |
256 positions, i.e., the memory requirements of Dvips will be somewhat |
| 1209 |
larger. If you find this unacceptable or encounter another problem |
| 1210 |
with the Omega or pTeX extensions, you can switch off the pTeX |
| 1211 |
extension by using ‘<samp class="samp">-noptex</samp>’, or both by using ‘<samp class="samp">-noomega</samp>’ |
| 1212 |
(but please do send a bug report if you find such problems, |
| 1213 |
see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite class="cite">Kpathsea</cite>). |
| 1214 |
</p> |
| 1215 |
</dd> |
| 1216 |
<dt><a class="index-entry-id" id="index-output_002c-redirecting"></a> |
| 1217 |
<a class="index-entry-id" id="index-standard-output_002c-output-to"></a> |
| 1218 |
<a id="index-_002do-name"></a><span>‘<samp class="samp">-o <var class="var">name</var></samp>’<a class="copiable-link" href="#index-_002do-name"> ¶</a></span></dt> |
| 1219 |
<dd><p>Send output to the file <var class="var">name</var>. If ‘<samp class="samp">-o</samp>’ is specified without |
| 1220 |
<var class="var">name</var> (i.e., it is the last thing on the command line), the |
| 1221 |
default is ‘<samp class="samp"><var class="var">file</var>.ps</samp>’ where the input DVI file was |
| 1222 |
‘<samp class="samp"><var class="var">file</var>.dvi</samp>’. If ‘<samp class="samp">-o</samp>’ isn’t given at all, the |
| 1223 |
configuration file default is used. |
| 1224 |
</p> |
| 1225 |
<a class="index-entry-id" id="index-popen-for-output"></a> |
| 1226 |
<a class="index-entry-id" id="index-_002d-as-output-filename"></a> |
| 1227 |
<a class="index-entry-id" id="index-_0021-starting-output-filename"></a> |
| 1228 |
<a class="index-entry-id" id="index-_007c-starting-output-filename"></a> |
| 1229 |
<a class="index-entry-id" id="index-lpr-spooler_002c-MS_002dDOS-emulation"></a> |
| 1230 |
<a class="index-entry-id" id="index-spooling-to-lpr-on-MS_002dDOS"></a> |
| 1231 |
<p>If <var class="var">name</var> is ‘<samp class="samp">-</samp>’, output goes to standard output. If the first |
| 1232 |
character of <var class="var">name</var> is ‘<samp class="samp">!</samp>’ or ‘<samp class="samp">|</samp>’, then the remainder will |
| 1233 |
be used as an argument to <code class="code">popen</code>; thus, specifying ‘<samp class="samp">|lpr</samp>’ as |
| 1234 |
the output file will automatically queue the file for printing as |
| 1235 |
usual. (The MS-DOS version will print to the local printer device |
| 1236 |
<samp class="file">PRN</samp> when <var class="var">name</var> is ‘<samp class="samp">|lpr</samp>’ and a program by that name |
| 1237 |
cannot be found.) |
| 1238 |
</p> |
| 1239 |
<p>‘<samp class="samp">-o</samp>’ disables the automatic reading of the <code class="code">PRINTER</code> |
| 1240 |
environment variable, and turns off the automatic sending of control-D. |
| 1241 |
See the ‘<samp class="samp">-f</samp>’ option for how to override this. |
| 1242 |
</p> |
| 1243 |
</dd> |
| 1244 |
<dt><a class="index-entry-id" id="index-offset-pages"></a> |
| 1245 |
<a class="index-entry-id" id="index-printer-offset"></a> |
| 1246 |
<a id="index-_002dO-x_002doffset_002cy_002doffset"></a><span>‘<samp class="samp">-O <var class="var">x-offset</var>,<var class="var">y-offset</var></samp>’<a class="copiable-link" href="#index-_002dO-x_002doffset_002cy_002doffset"> ¶</a></span></dt> |
| 1247 |
<dd><p>Move the origin by <var class="var">x-offset</var>,<var class="var">y-offset</var>, a comma-separated |
| 1248 |
pair of dimensions such as ‘<samp class="samp">.1in,-.3cm</samp>’ (see <a class="pxref" href="#papersize-special">‘<samp class="samp">papersize</samp>’ special</a>). The origin of the page is shifted from the default position |
| 1249 |
(of one inch down, one inch to the right from the upper left corner of |
| 1250 |
the paper) by this amount. This is usually best specified in the |
| 1251 |
printer-specific configuration file. |
| 1252 |
</p> |
| 1253 |
<a class="index-entry-id" id="index-testpage_002etex"></a> |
| 1254 |
<p>This is useful for a printer that consistently offsets output pages by a |
| 1255 |
certain amount. You can use the file <samp class="file">testpage.tex</samp> to determine |
| 1256 |
the correct value for your printer. Be sure to do several runs with the |
| 1257 |
same <code class="code">O</code> value—some printers vary widely from run to run. |
| 1258 |
</p> |
| 1259 |
<a class="index-entry-id" id="index-bop_002dhook_002c-and-offset-pages"></a> |
| 1260 |
<p>If your printer offsets every other page consistently, instead of every |
| 1261 |
page, your best recourse is to use ‘<samp class="samp">bop-hook</samp>’ (see <a class="pxref" href="#PostScript-hooks">PostScript hooks</a>). |
| 1262 |
</p> |
| 1263 |
</dd> |
| 1264 |
<dt><a class="index-entry-id" id="index-first-page-printed"></a> |
| 1265 |
<a class="index-entry-id" id="index-page_002c-first-printed"></a> |
| 1266 |
<a class="index-entry-id" id="index-physical-page-number_002c-and-_002dp"></a> |
| 1267 |
<a class="index-entry-id" id="index-absolute-page-number_002c-and-_002dp"></a> |
| 1268 |
<a id="index-_002dp-_005b_003d_005dnum_005b_002epageseq_005d"></a><span>‘<samp class="samp">-p [=]<var class="var">num</var>[.<var class="var">pageseq</var>]</samp>’<a class="copiable-link" href="#index-_002dp-_005b_003d_005dnum_005b_002epageseq_005d"> ¶</a></span></dt> |
| 1269 |
<dd><p>Exactly analogous to <code class="code">-l</code> (q.v.), but specifying the first page |
| 1270 |
number to be printed (processed). |
| 1271 |
</p> |
| 1272 |
</dd> |
| 1273 |
<dt><a class="index-entry-id" id="index-page-range"></a> |
| 1274 |
<a class="index-entry-id" id="index-_002dpp-range"></a> |
| 1275 |
<a id="index-_002dpp-first_002dlast"></a><span>‘<samp class="samp">-pp <var class="var">first</var>-<var class="var">last</var></samp>’<a class="copiable-link" href="#index-_002dpp-first_002dlast"> ¶</a></span></dt> |
| 1276 |
<dd><p>Print pages <var class="var">first</var> through <var class="var">last</var>; equivalent to ‘<samp class="samp">-p |
| 1277 |
<var class="var">first</var> -l <var class="var">last</var></samp>’, except that multiple ‘<samp class="samp">-pp</samp>’ options |
| 1278 |
accumulate, unlike ‘<samp class="samp">-p</samp>’ and ‘<samp class="samp">-l</samp>’. The ‘<samp class="samp">-</samp>’ separator can |
| 1279 |
also be ‘<samp class="samp">:</samp>’. |
| 1280 |
</p> |
| 1281 |
</dd> |
| 1282 |
<dt><a class="index-entry-id" id="index-config_002eps"></a> |
| 1283 |
<a id="index-_002dP-printer"></a><span>‘<samp class="samp">-P <var class="var">printer</var></samp>’<a class="copiable-link" href="#index-_002dP-printer"> ¶</a></span></dt> |
| 1284 |
<dd><p>Read the configuration file <samp class="file">config.<var class="var">printer</var></samp> |
| 1285 |
(<samp class="file"><var class="var">printer</var>.cfg</samp> on MS-DOS), which typically sets the output |
| 1286 |
name (most likely ‘<samp class="samp">o |lpr -P<var class="var">printer</var></samp>’), resolution, Metafont |
| 1287 |
mode, and perhaps other printer-specific defaults. It works best to |
| 1288 |
put sitewide defaults in the one master ‘<samp class="samp">config.ps</samp>’ file and only |
| 1289 |
things that vary from printer to printer in the |
| 1290 |
‘<samp class="samp">config.<var class="var">printer</var></samp>’ files; ‘<samp class="samp">config.ps</samp>’ is read before |
| 1291 |
‘<samp class="samp">config.<var class="var">printer</var></samp>’. |
| 1292 |
</p> |
| 1293 |
<p>A configuration file for eventual creation of Adobe PDF files is |
| 1294 |
provided in ‘<samp class="samp">config.pdf</samp>’ and thus can be loaded with |
| 1295 |
‘<samp class="samp">-Ppdf</samp>’. It will try to include Type 1 outline fonts into the |
| 1296 |
PostScript file (see <a class="pxref" href="#Hypertext-caveats">Hypertext caveats</a>). |
| 1297 |
</p> |
| 1298 |
<p>If no ‘<samp class="samp">-P</samp>’ or ‘<samp class="samp">-o</samp>’ is given, the environment variable |
| 1299 |
<code class="code">PRINTER</code> is checked. If that variable exists, and a corresponding |
| 1300 |
<samp class="file">config.<var class="var">printer</var></samp> (<samp class="file"><var class="var">printer</var>.cfg</samp> on MS-DOS) file |
| 1301 |
exists, it is read. |
| 1302 |
See <a class="xref" href="#Configuration-file-searching">Configuration file searching</a>. |
| 1303 |
</p> |
| 1304 |
</dd> |
| 1305 |
<dt><a class="index-entry-id" id="index-quiet-operation"></a> |
| 1306 |
<a class="index-entry-id" id="index-silent-operation"></a> |
| 1307 |
<a class="index-entry-id" id="index-warnings_002c-suppressing"></a> |
| 1308 |
<a id="index-_002dq"></a><span>‘<samp class="samp">-q*</samp>’<a class="copiable-link" href="#index-_002dq"> ¶</a></span></dt> |
| 1309 |
<dd><p>Run quietly. Don’t chatter about pages converted, etc., |
| 1310 |
and report no warnings (only errors) to standard error. |
| 1311 |
</p> |
| 1312 |
</dd> |
| 1313 |
<dt><a class="index-entry-id" id="index-reverse-pagination"></a> |
| 1314 |
<a id="index-_002dr"></a><span>‘<samp class="samp">-r*</samp>’<a class="copiable-link" href="#index-_002dr"> ¶</a></span></dt> |
| 1315 |
<dd><p>Output pages in reverse order. By default, page 1 is output first. |
| 1316 |
</p> |
| 1317 |
</dd> |
| 1318 |
<dt><a class="index-entry-id" id="index-security"></a> |
| 1319 |
<a class="index-entry-id" id="index-shell-command-execution_002c-disabling"></a> |
| 1320 |
<a class="index-entry-id" id="index-absolute-filenames_002c-disabling"></a> |
| 1321 |
<a class="index-entry-id" id="index-_002e_002e_002drelative-filenames"></a> |
| 1322 |
<a id="index-_002dR"></a><span>‘<samp class="samp">-R</samp>’<a class="copiable-link" href="#index-_002dR"> ¶</a></span></dt> |
| 1323 |
<dd><p>Run securely. ‘<samp class="samp">-R2</samp>’ disables both shell command execution in |
| 1324 |
<code class="code">\special</code> (via ‘<samp class="samp">`</samp>’, see <a class="pxref" href="#Dynamic-creation-of-graphics">Dynamic creation of PostScript graphics files</a>) |
| 1325 |
and config files (via the ‘<samp class="samp">E</samp>’ option, see <a class="pxref" href="#Configuration-file-commands">Configuration file commands</a>) and opening of any absolute or <samp class="file">..</samp>-relative |
| 1326 |
filenames. ‘<samp class="samp">-R1</samp>’, the default, forbids shell escapes but allows |
| 1327 |
absolute filenames. ‘<samp class="samp">-R0</samp>’ allows both. |
| 1328 |
</p> |
| 1329 |
</dd> |
| 1330 |
<dt><a class="index-entry-id" id="index-save_002frestore_002c-generating-global"></a> |
| 1331 |
<a id="index-_002ds"></a><span>‘<samp class="samp">-s*</samp>’<a class="copiable-link" href="#index-_002ds"> ¶</a></span></dt> |
| 1332 |
<dd><p>Enclose the output in a global save/restore pair. This causes the file |
| 1333 |
to not be truly conformant, and is thus not recommended, but is useful |
| 1334 |
if you are driving a deficient printer directly and thus don’t care too |
| 1335 |
much about the portability of the output to other environments. |
| 1336 |
</p> |
| 1337 |
</dd> |
| 1338 |
<dt><a id="index-_002dS-num"></a><span>‘<samp class="samp">-S <var class="var">num</var></samp>’<a class="copiable-link" href="#index-_002dS-num"> ¶</a></span></dt> |
| 1339 |
<dd><p>Set the maximum number of pages in each ‘section’. This option is most |
| 1340 |
commonly used with the ‘<samp class="samp">-i</samp>’ option; see its description above for |
| 1341 |
more information. |
| 1342 |
</p> |
| 1343 |
</dd> |
| 1344 |
<dt><a class="index-entry-id" id="index-paper-type"></a> |
| 1345 |
<a class="index-entry-id" id="index-media"></a> |
| 1346 |
<a class="index-entry-id" id="index-letter-papertype"></a> |
| 1347 |
<a class="index-entry-id" id="index-legal-papertype"></a> |
| 1348 |
<a class="index-entry-id" id="index-ledger-papertype"></a> |
| 1349 |
<a class="index-entry-id" id="index-a4-papertype"></a> |
| 1350 |
<a class="index-entry-id" id="index-a3-papertype"></a> |
| 1351 |
<a class="index-entry-id" id="index-landscape-papertype"></a> |
| 1352 |
<a class="index-entry-id" id="index-papersize-special_002c-and-no-_002dt"></a> |
| 1353 |
<a id="index-_002dt-papertype"></a><span>‘<samp class="samp">-t <var class="var">papertype</var></samp>’<a class="copiable-link" href="#index-_002dt-papertype"> ¶</a></span></dt> |
| 1354 |
<dd><p>Set the paper type to <var class="var">papertype</var>, usually defined in one of the |
| 1355 |
configuration files, along with the appropriate PostScript code to |
| 1356 |
select it (see <a class="pxref" href="#Config-file-paper-sizes">Configuration file paper size command</a>). |
| 1357 |
</p><ul class="itemize mark-minus"> |
| 1358 |
<li>You can also specify a <var class="var">papertype</var> of ‘<samp class="samp">landscape</samp>’, |
| 1359 |
which rotates a document by 90 degrees. |
| 1360 |
</li><li>To rotate a document whose paper type is not the default, you |
| 1361 |
can use the ‘<samp class="samp">-t</samp>’ option twice, once for the paper type, and once |
| 1362 |
for ‘<samp class="samp">landscape</samp>’. |
| 1363 |
</li><li>In general, you should not use any ‘<samp class="samp">-t</samp>’ option when |
| 1364 |
using a ‘<samp class="samp">papersize</samp>’ special, which some LaTeX packages (e.g., |
| 1365 |
‘<samp class="samp">hyperref</samp>’) insert. |
| 1366 |
</li><li>One exception is when using a nonstandard paper size that is not |
| 1367 |
already defined in <samp class="file">config.ps</samp>; in this case, you need to specify |
| 1368 |
‘<samp class="samp">-t unknown</samp>’. |
| 1369 |
</li><li>Another exception is when producing multi-page files for further |
| 1370 |
processing; use ‘<samp class="samp">-t nopaper</samp>’ to omit any paper size |
| 1371 |
information in the output. (If you just have a single page document, |
| 1372 |
you can use ‘<samp class="samp">-E</samp>’ to get pure EPSF output.) |
| 1373 |
</li></ul> |
| 1374 |
|
| 1375 |
</dd> |
| 1376 |
<dt><a class="index-entry-id" id="index-title_002c-specifying"></a> |
| 1377 |
<a class="index-entry-id" id="index-output-title_002c-specifying"></a> |
| 1378 |
<a class="index-entry-id" id="index-document-title_002c-specifying"></a> |
| 1379 |
<a class="index-entry-id" id="index-_0025_0025Title"></a> |
| 1380 |
<a id="index-_002dtitle-str"></a><span>‘<samp class="samp">-title <var class="var">string</var></samp>’<a class="copiable-link" href="#index-_002dtitle-str"> ¶</a></span></dt> |
| 1381 |
<dd><p>Use <var class="var">string</var> as the title in the generated PostScript |
| 1382 |
(<code class="code">%%Title</code>). If not specified, the default is the basename of the |
| 1383 |
input file; for example, running <code class="code">dvips /foo/bar.dvi</code> will have a |
| 1384 |
<code class="code">%%Title</code> of ‘<samp class="samp">bar.dvi</samp>’. |
| 1385 |
</p> |
| 1386 |
</dd> |
| 1387 |
<dt><a id="index-_002dT-hsize_002cvsize"></a><span>‘<samp class="samp">-T <var class="var">hsize</var>,<var class="var">vsize</var></samp>’<a class="copiable-link" href="#index-_002dT-hsize_002cvsize"> ¶</a></span></dt> |
| 1388 |
<dd><p>Set the paper size to (<var class="var">hsize</var>,<var class="var">vsize</var>), a comma-separated |
| 1389 |
pair of dimensions such as ‘<samp class="samp">.1in,-.3cm</samp>’ (see <a class="pxref" href="#papersize-special">‘<samp class="samp">papersize</samp>’ special</a>). It overrides any paper size special in the DVI file. Be |
| 1390 |
careful, as the paper size will stick to a predefined size if there is |
| 1391 |
one close enough. To disable this behavior, use ‘<samp class="samp">-tunknown</samp>’. |
| 1392 |
</p> |
| 1393 |
</dd> |
| 1394 |
<dt><a class="index-entry-id" id="index-PostScript-font-alias-file"></a> |
| 1395 |
<a class="index-entry-id" id="index-resident-fonts_002c-different-in-different-printers"></a> |
| 1396 |
<a id="index-_002du-psmapfile"></a><span>‘<samp class="samp">-u <var class="var">psmapfile</var></samp>’<a class="copiable-link" href="#index-_002du-psmapfile"> ¶</a></span></dt> |
| 1397 |
<dd><p>Set <var class="var">psmapfile</var> to be the file that dvips uses for looking up |
| 1398 |
PostScript font aliases. If <var class="var">psmapfile</var> begins with a ‘<samp class="samp">+</samp>’ |
| 1399 |
character, then the rest of the name is used as the name of the map file, |
| 1400 |
and the map file is appended to the list of map files (instead of replacing |
| 1401 |
the list). In either case, if the name has no extension, then ‘<samp class="samp">.map</samp>’ |
| 1402 |
is added at the end. |
| 1403 |
</p> |
| 1404 |
</dd> |
| 1405 |
<dt><a class="index-entry-id" id="index-Xerox-4045"></a> |
| 1406 |
<a id="index-_002dU"></a><span>‘<samp class="samp">-U*</samp>’<a class="copiable-link" href="#index-_002dU"> ¶</a></span></dt> |
| 1407 |
<dd><p>Disable a PostScript virtual memory-saving optimization that stores the |
| 1408 |
character metric information in the same string that is used to store |
| 1409 |
the bitmap information. This is only necessary when driving the Xerox |
| 1410 |
4045 PostScript interpreter, which has a bug that puts garbage on the |
| 1411 |
bottom of each character. Not recommended unless you must drive this |
| 1412 |
printer. |
| 1413 |
</p> |
| 1414 |
</dd> |
| 1415 |
<dt><a id="index-_002dv"></a><span>‘<samp class="samp">-v</samp>’<a class="copiable-link" href="#index-_002dv"> ¶</a></span></dt> |
| 1416 |
<dd><p>Print the dvips version number and exit. |
| 1417 |
</p> |
| 1418 |
</dd> |
| 1419 |
<dt><a id="index-_002dV"></a><span>‘<samp class="samp">-V*</samp>’<a class="copiable-link" href="#index-_002dV"> ¶</a></span></dt> |
| 1420 |
<dd><p>Download non-resident PostScript fonts as bitmaps. This requires use |
| 1421 |
<a class="index-entry-id" id="index-mtpk"></a> |
| 1422 |
<a class="index-entry-id" id="index-gsftopk"></a> |
| 1423 |
<a class="index-entry-id" id="index-pstopk"></a> |
| 1424 |
of <code class="code">mtpk</code> or <code class="code">gsftopk</code> or <code class="code">pstopk</code> or some combination |
| 1425 |
thereof to generate the required bitmap fonts; these programs are |
| 1426 |
supplied with Dvips. The bitmap must be put into <samp class="file">psfonts.map</samp> as |
| 1427 |
the downloadable file for that font. This is useful only for those |
| 1428 |
fonts for which you do not have real outlines, being downloaded to |
| 1429 |
printers that have no resident fonts, i.e., very rarely. |
| 1430 |
</p> |
| 1431 |
|
| 1432 |
</dd> |
| 1433 |
<dt><a class="index-entry-id" id="index-magnification_002c-overriding-DVI"></a> |
| 1434 |
<a id="index-_002dx-num"></a><span>‘<samp class="samp">-x <var class="var">num</var></samp>’<a class="copiable-link" href="#index-_002dx-num"> ¶</a></span></dt> |
| 1435 |
<dd><p>Set the magnification ratio to <em class="math"><var class="var">num</var>/1000</em>. Overrides |
| 1436 |
the magnification specified in the DVI file. Must be between 10 and |
| 1437 |
100000. It is recommended that you use standard magstep values (1095, |
| 1438 |
1200, 1440, 1728, 2074, 2488, 2986, and so on) to help reduce the total |
| 1439 |
number of PK files generated. <var class="var">num</var> may be a real number, not an |
| 1440 |
integer, for increased precision. |
| 1441 |
</p> |
| 1442 |
</dd> |
| 1443 |
<dt><a class="index-entry-id" id="index-resolution"></a> |
| 1444 |
<a id="index-_002dX-num"></a><span>‘<samp class="samp">-X <var class="var">num</var></samp>’<a class="copiable-link" href="#index-_002dX-num"> ¶</a></span></dt> |
| 1445 |
<dd><p>Set the horizontal resolution in dots per inch to <var class="var">num</var>. |
| 1446 |
</p> |
| 1447 |
</dd> |
| 1448 |
<dt><a id="index-magnification_002c-vertical"></a><span>‘<samp class="samp">-y <var class="var">num</var></samp>’<a class="copiable-link" href="#index-magnification_002c-vertical"> ¶</a></span></dt> |
| 1449 |
<dd><p>Set the magnification ratio to <em class="math"><var class="var">num</var>/1000</em> times the |
| 1450 |
magnification specified in the DVI file. See |
| 1451 |
‘<samp class="samp">-x</samp>’ above. |
| 1452 |
</p> |
| 1453 |
</dd> |
| 1454 |
<dt><a id="index-_002dY-num"></a><span>‘<samp class="samp">-Y <var class="var">num</var></samp>’<a class="copiable-link" href="#index-_002dY-num"> ¶</a></span></dt> |
| 1455 |
<dd><p>Set the vertical resolution in dots per inch to <var class="var">num.</var> |
| 1456 |
<a class="index-entry-id" id="index-resolution-1"></a> |
| 1457 |
</p> |
| 1458 |
</dd> |
| 1459 |
<dt><a class="index-entry-id" id="index-hyperdvi-extensions_002c-enabling"></a> |
| 1460 |
<a class="index-entry-id" id="index-distillation_002c-and-_002dz"></a> |
| 1461 |
<a class="index-entry-id" id="index-PDF-files_002c-option-for"></a> |
| 1462 |
<a class="index-entry-id" id="index-html-specials_002c-and-_002dz"></a> |
| 1463 |
<a id="index-_002dz-for-recognizing-hyperdvi"></a><span>‘<samp class="samp">-z*</samp>’<a class="copiable-link" href="#index-_002dz-for-recognizing-hyperdvi"> ¶</a></span></dt> |
| 1464 |
<dd><p>Pass ‘<samp class="samp">html</samp>’ hyperdvi specials through to the output for eventual |
| 1465 |
distillation into PDF. This is not enabled by default to avoid |
| 1466 |
including the header files unnecessarily, and use of temporary files in |
| 1467 |
creating the output. See <a class="xref" href="#Hypertext">HyperTeXt</a>. |
| 1468 |
</p> |
| 1469 |
</dd> |
| 1470 |
<dt><a class="index-entry-id" id="index-compressing-bitmap-fonts"></a> |
| 1471 |
<a id="index-_002dZ-for-compressing-bitmap-fonts"></a><span>‘<samp class="samp">-Z*</samp>’<a class="copiable-link" href="#index-_002dZ-for-compressing-bitmap-fonts"> ¶</a></span></dt> |
| 1472 |
<dd><p>Compress bitmap fonts in the output file, thereby reducing the size of |
| 1473 |
what gets downloaded. Especially useful at high resolutions or when |
| 1474 |
very large fonts are used. May slow down printing, especially on early |
| 1475 |
68000-based PostScript printers. Generally recommend today, and can be |
| 1476 |
enabled in the configuration file (see <a class="pxref" href="#Configuration-file-commands">Configuration file commands</a>). |
| 1477 |
</p> |
| 1478 |
</dd> |
| 1479 |
</dl> |
| 1480 |
|
| 1481 |
|
| 1482 |
<hr> |
| 1483 |
</div> |
| 1484 |
</div> |
| 1485 |
<div class="section-level-extent" id="Environment-variables"> |
| 1486 |
<div class="nav-panel"> |
| 1487 |
<p> |
| 1488 |
Next: <a href="#Config-files" accesskey="n" rel="next">Dvips configuration files</a>, Previous: <a href="#Command_002dline-options" accesskey="p" rel="prev">Command-line options</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 1489 |
</div> |
| 1490 |
<h3 class="section" id="Environment-variables-1"><span>3.3 Environment variables<a class="copiable-link" href="#Environment-variables-1"> ¶</a></span></h3> |
| 1491 |
|
| 1492 |
<a class="index-entry-id" id="index-environment-variables"></a> |
| 1493 |
|
| 1494 |
<p>Dvips looks for many environment variables, to define search paths and |
| 1495 |
other things. The path variables are read as needed, after all |
| 1496 |
configuration files are read, so they override values in the |
| 1497 |
configuration files. (Except for <code class="code">TEXCONFIG</code>, which defines where |
| 1498 |
the configuration files themselves are found.) |
| 1499 |
</p> |
| 1500 |
<p>See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Path-specifications">Path specifications</a> in <cite class="cite">Kpathsea</cite>, for details of |
| 1501 |
interpretation of path and other environment variables common to all |
| 1502 |
Kpathsea-using programs. Only the environment variables specific to |
| 1503 |
Dvips are mentioned here. |
| 1504 |
</p> |
| 1505 |
<dl class="vtable"> |
| 1506 |
<dt><a id="index-DVIPSDEBUG"></a><span><code class="code">DVIPSDEBUG</code><a class="copiable-link" href="#index-DVIPSDEBUG"> ¶</a></span></dt> |
| 1507 |
<dd><a class="index-entry-id" id="index-KPATHSEA_005fDEBUG"></a> |
| 1508 |
<p>Write the absolute path names of any configuration or map files to |
| 1509 |
standard output, for debugging. This isn’t done by default because |
| 1510 |
these files are read even before the banner is printed. For |
| 1511 |
voluminous additional debugging, set the environment variable |
| 1512 |
<code class="env">KPATHSEA_DEBUG</code> to ‘<samp class="samp">-1</samp>’ |
| 1513 |
(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite class="cite">Kpathsea</cite>). (If <code class="env">KPATHSEA_DEBUG</code> is |
| 1514 |
set to any value, it automatically turns on <code class="env">DVIPSDEBUG</code>.) |
| 1515 |
</p> |
| 1516 |
</dd> |
| 1517 |
<dt><a id="index-DVIPSFONTS"></a><span><code class="code">DVIPSFONTS</code><a class="copiable-link" href="#index-DVIPSFONTS"> ¶</a></span></dt> |
| 1518 |
<dd><p>Default path to search for all fonts. Overrides all the font path |
| 1519 |
config file options and other environment variables (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported |
| 1520 |
file formats</a> in <cite class="cite">Kpathsea</cite>). |
| 1521 |
</p> |
| 1522 |
</dd> |
| 1523 |
<dt><a id="index-DVIPSHEADERS"></a><span><code class="code">DVIPSHEADERS</code><a class="copiable-link" href="#index-DVIPSHEADERS"> ¶</a></span></dt> |
| 1524 |
<dd><p>Default path to search for PostScript header files. Overrides the ‘<samp class="samp">H</samp>’ |
| 1525 |
config file option (see <a class="pxref" href="#Configuration-file-commands">Configuration file commands</a>). |
| 1526 |
</p> |
| 1527 |
</dd> |
| 1528 |
<dt><a id="index-DVIPSMAKEPK"></a><span><code class="code">DVIPSMAKEPK</code><a class="copiable-link" href="#index-DVIPSMAKEPK"> ¶</a></span></dt> |
| 1529 |
<dd><a class="index-entry-id" id="index-mktexpk_002c-changing-name"></a> |
| 1530 |
<p>Overrides ‘<samp class="samp">mktexpk</samp>’ as the name of the program to invoke to |
| 1531 |
create missing PK fonts. You can change the arguments passed to the |
| 1532 |
<code class="code">mktexpk</code> program with the <code class="code">MAKETEXPK</code> environment |
| 1533 |
variable; see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#MakeTeX-script-arguments">MakeTeX script arguments</a> in <cite class="cite">Kpathsea</cite>. |
| 1534 |
</p> |
| 1535 |
</dd> |
| 1536 |
<dt><a id="index-DVIPSRC"></a><span><code class="code">DVIPSRC</code><a class="copiable-link" href="#index-DVIPSRC"> ¶</a></span></dt> |
| 1537 |
<dd><p>Specifies the name of the startup file (see <a class="pxref" href="#Configuration-file-searching">Configuration file searching</a>) which is read after <samp class="file">config.ps</samp> but before any |
| 1538 |
printer-specific configuration files. |
| 1539 |
</p> |
| 1540 |
</dd> |
| 1541 |
<dt><a id="index-DVIPSSIZES"></a><span><code class="code">DVIPSSIZES</code><a class="copiable-link" href="#index-DVIPSSIZES"> ¶</a></span></dt> |
| 1542 |
<dd><a class="index-entry-id" id="index-last_002dresort-font-scaling_002c-with-DVIPSSIZES"></a> |
| 1543 |
<p>Last-resort sizes for scaling of unfound fonts. Overrides the ‘<samp class="samp">R</samp>’ |
| 1544 |
definition in config files (see <a class="pxref" href="#Configuration-file-commands">Configuration file commands</a>). |
| 1545 |
</p> |
| 1546 |
</dd> |
| 1547 |
<dt><a id="index-PRINTER"></a><span><code class="code">PRINTER</code><a class="copiable-link" href="#index-PRINTER"> ¶</a></span></dt> |
| 1548 |
<dd><p>Determine the default printer configuration file. (Dvips itself does |
| 1549 |
not use <code class="code">PRINTER</code> to determine the output destination in any way.) |
| 1550 |
</p> |
| 1551 |
</dd> |
| 1552 |
<dt><a id="index-TEXCONFIG"></a><span><code class="code">TEXCONFIG</code><a class="copiable-link" href="#index-TEXCONFIG"> ¶</a></span></dt> |
| 1553 |
<dd><a class="index-entry-id" id="index-configuration-file-path"></a> |
| 1554 |
<p>Path to search for Dvips’ <samp class="file">config.<var class="var">printer</var></samp> configuration |
| 1555 |
files, including the base <samp class="file">config.ps</samp>. Using this single |
| 1556 |
environment variable, you can override everything else. (The |
| 1557 |
printer-specific configuration files are called <samp class="file"><var class="var">printer</var>.cfg</samp> |
| 1558 |
on MS-DOS, but <samp class="file">config.ps</samp> is called by that name on all |
| 1559 |
platforms.) |
| 1560 |
</p> |
| 1561 |
</dd> |
| 1562 |
<dt><a id="index-TEXPICTS"></a><span><code class="code">TEXPICTS</code><a class="copiable-link" href="#index-TEXPICTS"> ¶</a></span></dt> |
| 1563 |
<dd><p>Path to search for included graphics files. Overrides the ‘<samp class="samp">S</samp>’ |
| 1564 |
config file option (see <a class="pxref" href="#Configuration-file-commands">Configuration file commands</a>). If not set, |
| 1565 |
<code class="code">TEXINPUTS</code> is looked for. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite class="cite">Kpathsea</cite>. |
| 1566 |
</p> |
| 1567 |
</dd> |
| 1568 |
</dl> |
| 1569 |
|
| 1570 |
|
| 1571 |
<hr> |
| 1572 |
</div> |
| 1573 |
<div class="section-level-extent" id="Config-files"> |
| 1574 |
<div class="nav-panel"> |
| 1575 |
<p> |
| 1576 |
Previous: <a href="#Environment-variables" accesskey="p" rel="prev">Environment variables</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 1577 |
</div> |
| 1578 |
<h3 class="section" id="Dvips-configuration-files"><span>3.4 Dvips configuration files<a class="copiable-link" href="#Dvips-configuration-files"> ¶</a></span></h3> |
| 1579 |
|
| 1580 |
<a class="index-entry-id" id="index-configuration-files"></a> |
| 1581 |
|
| 1582 |
<p>This section describes in detail the Dvips-specific <samp class="file">config.*</samp> |
| 1583 |
device configuration files (called <samp class="file">*.cfg</samp> on MS-DOS), which |
| 1584 |
override the <samp class="file">texmf.cnf</samp> |
| 1585 |
configuration files generic to Kpathsea which Dvips also reads |
| 1586 |
(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite class="cite">Kpathsea</cite>). |
| 1587 |
</p> |
| 1588 |
<p>For information about installing these files, including a prototype file |
| 1589 |
you can copy, see <a class="pxref" href="#config_002eps-installation"><samp class="file">config.ps</samp> installation</a>. |
| 1590 |
</p> |
| 1591 |
|
| 1592 |
|
| 1593 |
<ul class="mini-toc"> |
| 1594 |
<li><a href="#Configuration-file-searching" accesskey="1">Configuration file searching</a></li> |
| 1595 |
<li><a href="#Configuration-file-commands" accesskey="2">Configuration file commands</a></li> |
| 1596 |
</ul> |
| 1597 |
<hr> |
| 1598 |
<div class="subsection-level-extent" id="Configuration-file-searching"> |
| 1599 |
<div class="nav-panel"> |
| 1600 |
<p> |
| 1601 |
Next: <a href="#Configuration-file-commands" accesskey="n" rel="next">Configuration file commands</a>, Up: <a href="#Config-files" accesskey="u" rel="up">Dvips configuration files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 1602 |
</div> |
| 1603 |
<h4 class="subsection" id="Configuration-file-searching-1"><span>3.4.1 Configuration file searching<a class="copiable-link" href="#Configuration-file-searching-1"> ¶</a></span></h4> |
| 1604 |
|
| 1605 |
<a class="index-entry-id" id="index-configuration-file-searching"></a> |
| 1606 |
<a class="index-entry-id" id="index-searching-config-files_002c-order-of"></a> |
| 1607 |
|
| 1608 |
<p>The Dvips program loads many different configuration files, so that |
| 1609 |
parameters can be set globally across the system, on a per-device basis, |
| 1610 |
or individually by each user. |
| 1611 |
</p> |
| 1612 |
<ol class="enumerate"> |
| 1613 |
<li> <a class="index-entry-id" id="index-config_002eps_002c-searched-for"></a> |
| 1614 |
Dvips first reads (if it exists) <samp class="file">config.ps</samp>; it is searched for |
| 1615 |
along the path for Dvips configuration files, as described in |
| 1616 |
<a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite class="cite">Kpathsea</cite>. |
| 1617 |
|
| 1618 |
</li><li> <a class="index-entry-id" id="index-_002edvipsrc_002c-searched-for"></a> |
| 1619 |
A user-specific startup file is loaded, so individual users can override |
| 1620 |
any options set in the global file. The environment variable |
| 1621 |
<code class="code">DVIPSRC</code>, if defined, is used as the specification of the startup |
| 1622 |
file. If this variable is undefined, Dvips uses a platform-specific |
| 1623 |
default name. On Unix Dvips looks for the default startup file under |
| 1624 |
the name <samp class="file">$HOME/.dvipsrc</samp>, which is in the user’s home directory. |
| 1625 |
On MS-DOS and MS-Windows, where users generally don’t have their private |
| 1626 |
directories, the startup file is called <samp class="file">dvips.ini</samp> and it is |
| 1627 |
searched for along the path for Dvips configuration files (as described |
| 1628 |
in <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite class="cite">Kpathsea</cite>.); users are |
| 1629 |
expected to set this path as they see fit for their taste. |
| 1630 |
|
| 1631 |
</li><li> <a class="index-entry-id" id="index-_002dPprinter_002c-and-config-file-searching"></a> |
| 1632 |
The command line is read and parsed: if the ‘<samp class="samp">-P<var class="var">device</var></samp>’ option |
| 1633 |
is encountered, at that point <samp class="file">config.<var class="var">device</var></samp> is loaded. |
| 1634 |
Thus, the printer configuration file can override anything in the |
| 1635 |
site-wide or user configuration file, and it can also override options |
| 1636 |
in the command line up to the point that the ‘<samp class="samp">-P</samp>’ option was |
| 1637 |
encountered. (On MS-DOS, the printer configuration files are called |
| 1638 |
<samp class="file"><var class="var">device</var>.cfg</samp>, since DOS doesn’t allow more than 3 characters |
| 1639 |
after the dot in filenames.) |
| 1640 |
|
| 1641 |
</li><li> <a class="index-entry-id" id="index-PRINTER_002c-and-config-file-searching"></a> |
| 1642 |
If no ‘<samp class="samp">-P</samp>’ option was specified, and also the ‘<samp class="samp">-o</samp>’ and |
| 1643 |
‘<samp class="samp">-f</samp>’ command line options were not used, Dvips checks the |
| 1644 |
environment variable <code class="code">PRINTER</code>. If it exists, then |
| 1645 |
<samp class="file">config.<var class="var">$PRINTER</var></samp> (<samp class="file"><var class="var">$PRINTER</var>.cfg</samp> on MS-DOS) is |
| 1646 |
loaded (if it exists). |
| 1647 |
|
| 1648 |
</li></ol> |
| 1649 |
|
| 1650 |
<p>Because the <samp class="file">.dvipsrc</samp> file is read before the printer-specific |
| 1651 |
configuration files, individual users cannot override settings in the |
| 1652 |
latter. On the other hand, the <code class="code">TEXCONFIG</code> path can be set to |
| 1653 |
anything, so the users can always define their own printer-specific |
| 1654 |
configuration files to be found before the system’s. |
| 1655 |
</p> |
| 1656 |
<p>A few command-line options are treated specially, in that they are not |
| 1657 |
overridden by configuration files: |
| 1658 |
</p> |
| 1659 |
<dl class="table"> |
| 1660 |
<dt>‘<samp class="samp">-D</samp>’</dt> |
| 1661 |
<dd><p>As well as setting the resolution, this unsets the mode, if the mode was |
| 1662 |
previously set from a configuration file. If <samp class="file">config.$PRINTER</samp> is |
| 1663 |
read, however, any ‘<samp class="samp">D</samp>’ or ‘<samp class="samp">M</samp>’ lines from there will take |
| 1664 |
effect. |
| 1665 |
</p> |
| 1666 |
</dd> |
| 1667 |
<dt>‘<samp class="samp">-mode</samp>’</dt> |
| 1668 |
<dd><p>This overrides any mode setting (‘<samp class="samp">M</samp>’ line) in configuration files. |
| 1669 |
‘<samp class="samp">-mode</samp>’ does not affect the resolution. |
| 1670 |
</p> |
| 1671 |
</dd> |
| 1672 |
<dt>‘<samp class="samp">-o</samp>’</dt> |
| 1673 |
<dd><p>This overrides any output setting (‘<samp class="samp">o</samp>’ line) in configuration files. |
| 1674 |
</p> |
| 1675 |
</dd> |
| 1676 |
</dl> |
| 1677 |
|
| 1678 |
<p>The purpose of these special cases is to (1) minimize the chance of |
| 1679 |
having a mismatched mode and resolution (which ‘<samp class="samp">mktexpk</samp>’ cannot |
| 1680 |
resolve), and (2) let command-line options override config files where |
| 1681 |
possible. |
| 1682 |
</p> |
| 1683 |
|
| 1684 |
<hr> |
| 1685 |
</div> |
| 1686 |
<div class="subsection-level-extent" id="Configuration-file-commands"> |
| 1687 |
<div class="nav-panel"> |
| 1688 |
<p> |
| 1689 |
Previous: <a href="#Configuration-file-searching" accesskey="p" rel="prev">Configuration file searching</a>, Up: <a href="#Config-files" accesskey="u" rel="up">Dvips configuration files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 1690 |
</div> |
| 1691 |
<h4 class="subsection" id="Configuration-file-commands-1"><span>3.4.2 Configuration file commands<a class="copiable-link" href="#Configuration-file-commands-1"> ¶</a></span></h4> |
| 1692 |
|
| 1693 |
<a class="index-entry-id" id="index-configuration-file-options"></a> |
| 1694 |
<a class="index-entry-id" id="index-Dvips-configuration-file-options"></a> |
| 1695 |
|
| 1696 |
<p>Most of the configuration file commands are similar to corresponding |
| 1697 |
command line options, but there are a few exceptions. When they are the |
| 1698 |
same, we omit the description here. |
| 1699 |
</p> |
| 1700 |
<p>As with command line options, many may be turned off by suffixing the |
| 1701 |
letter with a zero (‘<samp class="samp">0</samp>’). |
| 1702 |
</p> |
| 1703 |
<a class="index-entry-id" id="index-comments_002c-in-configuration-files"></a> |
| 1704 |
<a class="index-entry-id" id="index-continuation-lines_002c-not-supported"></a> |
| 1705 |
<p>Within a configuration file, empty lines, and lines starting with a |
| 1706 |
space, asterisk, equal sign, percent sign, or pound sign are ignored. |
| 1707 |
There is no provision for continuation lines. |
| 1708 |
</p> |
| 1709 |
<dl class="table"> |
| 1710 |
<dt><a id="index-_0040-config-command-_0028define-paper-sizes_0029"></a><span>‘<samp class="samp">@ <var class="var">name hsize vsize</var></samp>’<a class="copiable-link" href="#index-_0040-config-command-_0028define-paper-sizes_0029"> ¶</a></span></dt> |
| 1711 |
<dd><p>Define paper sizes. See <a class="xref" href="#Config-file-paper-sizes">Configuration file paper size command</a>. |
| 1712 |
</p> |
| 1713 |
</dd> |
| 1714 |
<dt><a id="index-a-config-command-_0028conserve-memory_0029"></a><span>‘<samp class="samp">a*</samp>’<a class="copiable-link" href="#index-a-config-command-_0028conserve-memory_0029"> ¶</a></span></dt> |
| 1715 |
<dd><p>Memory conservation. Same as ‘<samp class="samp">-a</samp>’, see <a class="pxref" href="#Option-details">Option details</a>. |
| 1716 |
</p> |
| 1717 |
</dd> |
| 1718 |
<dt><a id="index-b-config-command-_0028_0023copies_0029"></a><span>‘<samp class="samp">b <var class="var">#copies</var></samp>’<a class="copiable-link" href="#index-b-config-command-_0028_0023copies_0029"> ¶</a></span></dt> |
| 1719 |
<dd><p>Multiple copies. Same as ‘<samp class="samp">-b</samp>’, see <a class="pxref" href="#Option-details">Option details</a>. |
| 1720 |
</p> |
| 1721 |
</dd> |
| 1722 |
<dt><a id="index-bitmapfontenc-config-command-_0028bitmap-font-encoding_0029"></a><span>‘<samp class="samp">bitmapfontenc <var class="var">option</var></samp>’<a class="copiable-link" href="#index-bitmapfontenc-config-command-_0028bitmap-font-encoding_0029"> ¶</a></span></dt> |
| 1723 |
<dd><p>Turns bitmap font encoding to ‘<samp class="samp">off</samp>’, ‘<samp class="samp">on</samp>’ (no warnings |
| 1724 |
for missing bitmap font encodings), or ‘<samp class="samp">strict</samp>’ (with warnings |
| 1725 |
for missing bitmap font encodings). |
| 1726 |
</p> |
| 1727 |
</dd> |
| 1728 |
<dt><a id="index-c-config-command-_0028include-another-config-file_0029"></a><span>‘<samp class="samp">c <var class="var">filename</var></samp>’<a class="copiable-link" href="#index-c-config-command-_0028include-another-config-file_0029"> ¶</a></span></dt> |
| 1729 |
<dd><p>Include <var class="var">filename</var> as an additional configuration file, read |
| 1730 |
immediately. |
| 1731 |
</p> |
| 1732 |
</dd> |
| 1733 |
<dt><a id="index-D-config-command-_0028dpi_0029"></a><span>‘<samp class="samp">D <var class="var">dpi</var></samp>’<a class="copiable-link" href="#index-D-config-command-_0028dpi_0029"> ¶</a></span></dt> |
| 1734 |
<dd><p>Output resolution. Same as ‘<samp class="samp">-D</samp>’, see <a class="pxref" href="#Option-details">Option details</a>. |
| 1735 |
</p> |
| 1736 |
</dd> |
| 1737 |
<dt><a id="index-e-config-command-_0028maxdrift_0029"></a><span>‘<samp class="samp">e <var class="var">num</var></samp>’<a class="copiable-link" href="#index-e-config-command-_0028maxdrift_0029"> ¶</a></span></dt> |
| 1738 |
<dd><p>Max drift. Same as ‘<samp class="samp">-e</samp>’, see <a class="pxref" href="#Option-details">Option details</a>. |
| 1739 |
</p> |
| 1740 |
</dd> |
| 1741 |
<dt><a class="index-entry-id" id="index-system-in-config-file"></a> |
| 1742 |
<a class="index-entry-id" id="index-datestamp_002c-in-output"></a> |
| 1743 |
<a class="index-entry-id" id="index-shell-escape_002c-in-config-file"></a> |
| 1744 |
<a id="index-E-config-command-_0028shell-escape_0029"></a><span>‘<samp class="samp">E <var class="var">command</var></samp>’<a class="copiable-link" href="#index-E-config-command-_0028shell-escape_0029"> ¶</a></span></dt> |
| 1745 |
<dd><p>Executes the command listed with <code class="code">system</code>(3); can be used to get |
| 1746 |
the current date into a header file for inclusion, for instance. |
| 1747 |
Possibly dangerous; this may be disabled, in which case a warning will |
| 1748 |
be printed if the option is used (and warnings are not suppressed). |
| 1749 |
</p> |
| 1750 |
</dd> |
| 1751 |
<dt><a class="index-entry-id" id="index-F-config-command-_0028filter_0029"></a> |
| 1752 |
<a id="index-f-config-command-_0028filter_0029"></a><span>‘<samp class="samp">f*</samp>’<a class="copiable-link" href="#index-f-config-command-_0028filter_0029"> ¶</a></span></dt> |
| 1753 |
<dt>‘<samp class="samp">F</samp>’</dt> |
| 1754 |
<dd><p>Run as a filter. Same as ‘<samp class="samp">-f</samp>’, see <a class="pxref" href="#Option-details">Option details</a>. |
| 1755 |
</p> |
| 1756 |
</dd> |
| 1757 |
<dt><a id="index-G-config-command-_0028character-shifting_0029"></a><span>‘<samp class="samp">G*</samp>’<a class="copiable-link" href="#index-G-config-command-_0028character-shifting_0029"> ¶</a></span></dt> |
| 1758 |
<dd><p>Shift low-numbered characters; obsolete. Same as ‘<samp class="samp">-G</samp>’, |
| 1759 |
see <a class="pxref" href="#Option-details">Option details</a>. |
| 1760 |
</p> |
| 1761 |
</dd> |
| 1762 |
<dt><a id="index-h-config-command-_0028download-additional-header_0029"></a><span>‘<samp class="samp">h <var class="var">header</var></samp>’<a class="copiable-link" href="#index-h-config-command-_0028download-additional-header_0029"> ¶</a></span></dt> |
| 1763 |
<dd><p>Prepend <var class="var">header</var> to output. Same as ‘<samp class="samp">h-</samp>’; that is, the |
| 1764 |
config file <code class="code">h</code> directive suppresses any inclusion of standard |
| 1765 |
headers (see <a class="pxref" href="#Option-details">Option details</a>). |
| 1766 |
</p> |
| 1767 |
</dd> |
| 1768 |
<dt><a class="index-entry-id" id="index-header-path_002c-defining"></a> |
| 1769 |
<a class="index-entry-id" id="index-DVIPSHEADERS_002c-overrides-H"></a> |
| 1770 |
<a id="index-H-config-command-_0028PostScript-header-path_0029"></a><span>‘<samp class="samp">H <var class="var">path</var></samp>’<a class="copiable-link" href="#index-H-config-command-_0028PostScript-header-path_0029"> ¶</a></span></dt> |
| 1771 |
<dd><p>Use <var class="var">path</var> to search for PostScript header files. The environment |
| 1772 |
variable <code class="code">DVIPSHEADERS</code> overrides this. |
| 1773 |
</p> |
| 1774 |
</dd> |
| 1775 |
<dt><a id="index-i-config-command-_0028pages_002fsection_0029"></a><span>‘<samp class="samp">i <var class="var">n</var></samp>’<a class="copiable-link" href="#index-i-config-command-_0028pages_002fsection_0029"> ¶</a></span></dt> |
| 1776 |
<dd><p>Make multiple output files. Same as ‘<samp class="samp">-i -S <var class="var">n</var></samp>’, see <a class="pxref" href="#Option-details">Option details</a>. |
| 1777 |
</p> |
| 1778 |
</dd> |
| 1779 |
<dt><a id="index-j-config-command-_0028partial-font-downloading_0029"></a><span>‘<samp class="samp">j*</samp>’<a class="copiable-link" href="#index-j-config-command-_0028partial-font-downloading_0029"> ¶</a></span></dt> |
| 1780 |
<dd><p>Partially download Type 1 fonts. Same as ‘<samp class="samp">-j</samp>’, see <a class="pxref" href="#Option-details">Option details</a>. |
| 1781 |
</p> |
| 1782 |
</dd> |
| 1783 |
<dt><a id="index-K-config-command-_0028comment-removal_0029"></a><span>‘<samp class="samp">K*</samp>’<a class="copiable-link" href="#index-K-config-command-_0028comment-removal_0029"> ¶</a></span></dt> |
| 1784 |
<dd><p>Remove comments from included PostScript files. Same as ‘<samp class="samp">-K</samp>’, |
| 1785 |
see <a class="pxref" href="#Option-details">Option details</a>. |
| 1786 |
</p> |
| 1787 |
</dd> |
| 1788 |
<dt><a id="index-L-config-command-_0028last-paper-size-wins_0029"></a><span>‘<samp class="samp">L*</samp>’<a class="copiable-link" href="#index-L-config-command-_0028last-paper-size-wins_0029"> ¶</a></span></dt> |
| 1789 |
<dd><p>If zero, the first paper size specified is effective, else the last. |
| 1790 |
Same as ‘<samp class="samp">-L</samp>’, see <a class="pxref" href="#Option-details">Option details</a>. |
| 1791 |
</p> |
| 1792 |
</dd> |
| 1793 |
<dt><a id="index-landscaperotate-config-command"></a><span>‘<samp class="samp">landscaperotate</samp>’<a class="copiable-link" href="#index-landscaperotate-config-command"> ¶</a></span></dt> |
| 1794 |
<dd><p>Permit rotation of page content to match page size. |
| 1795 |
Same as ‘<samp class="samp">-landscaperotate</samp>’, see <a class="pxref" href="#Option-details">Option details</a>. |
| 1796 |
</p> |
| 1797 |
</dd> |
| 1798 |
<dt><a class="index-entry-id" id="index-memory-available"></a> |
| 1799 |
<a class="index-entry-id" id="index-printer-memory"></a> |
| 1800 |
<a id="index-m-config-command-_0028available-memory_0029"></a><span>‘<samp class="samp">m <var class="var">num</var></samp>’<a class="copiable-link" href="#index-m-config-command-_0028available-memory_0029"> ¶</a></span></dt> |
| 1801 |
<dd><p>Declare <var class="var">num</var> as the memory available for fonts and strings in the |
| 1802 |
printer. The compile-time default is 180000, but this is typically |
| 1803 |
overridden by <samp class="file">config.ps</samp> or other configuration files. This |
| 1804 |
value must be accurate if memory conservation and document splitting |
| 1805 |
is to work correctly. To determine this value, send the following |
| 1806 |
file to the printer: |
| 1807 |
</p> |
| 1808 |
<div class="example"> |
| 1809 |
<pre class="example-preformatted">%! Hey, we're PostScript |
| 1810 |
/Times-Roman findfont 30 scalefont setfont 144 432 moveto |
| 1811 |
vmstatus exch sub 40 string cvs show pop showpage |
| 1812 |
</pre></div> |
| 1813 |
|
| 1814 |
<p>The number printed by this file is the total memory free; it is usually |
| 1815 |
best to tell Dvips that the printer has slightly less memory, because |
| 1816 |
many programs download permanent macros that can reduce the memory in |
| 1817 |
the printer. Some systems or printers can dynamically increase the |
| 1818 |
memory available to a PostScript interpreter, in which case this file |
| 1819 |
might return a ridiculously low number; for example, the NeXT computer |
| 1820 |
and Ghostscript. In these cases, a value of, say, 10 million is |
| 1821 |
likely fine. |
| 1822 |
</p> |
| 1823 |
<p>To go all out: If <var class="var">num</var> is zero or negative, Dvips sets the |
| 1824 |
available memory to a very large number (the maximum integer value in |
| 1825 |
C), the idea being that output is not to a printer and thus no |
| 1826 |
splitting of the output is desirable. The Dvips config file |
| 1827 |
<samp class="file">config.maxmem</samp> is provided to do this conveniently, namely with |
| 1828 |
‘<samp class="samp">dvips -Pmaxmem</samp>’. |
| 1829 |
</p> |
| 1830 |
</dd> |
| 1831 |
<dt><a id="index-M-config-command-_0028mf-mode_0029"></a><span>‘<samp class="samp">M <var class="var">mode</var></samp>’<a class="copiable-link" href="#index-M-config-command-_0028mf-mode_0029"> ¶</a></span></dt> |
| 1832 |
<dd><p>Metafont mode. Same as ‘<samp class="samp">-mode</samp>’, see <a class="pxref" href="#Option-details">Option details</a>. |
| 1833 |
</p> |
| 1834 |
</dd> |
| 1835 |
<dt><a id="index-N-config-command-_0028disable-EPS_0029"></a><span>‘<samp class="samp">N*</samp>’<a class="copiable-link" href="#index-N-config-command-_0028disable-EPS_0029"> ¶</a></span></dt> |
| 1836 |
<dd><p>Disable structured comments. Beware: This also turns off displaying |
| 1837 |
page numbers or changing to specific page numbers in PostScript viewers. |
| 1838 |
Same as ‘<samp class="samp">-N</samp>’, see <a class="pxref" href="#Option-details">Option details</a>. |
| 1839 |
</p> |
| 1840 |
</dd> |
| 1841 |
<dt><a class="index-entry-id" id="index-output-file_002c-setting"></a> |
| 1842 |
<a id="index-o-config-command-_0028output-destination_0029"></a><span>‘<samp class="samp">o <var class="var">name</var></samp>’<a class="copiable-link" href="#index-o-config-command-_0028output-destination_0029"> ¶</a></span></dt> |
| 1843 |
<dd><p>Send output to <var class="var">name</var>. Same as ‘<samp class="samp">-o</samp>’, see <a class="pxref" href="#Option-details">Option details</a>. |
| 1844 |
In the file <samp class="file">config.foo</samp>, a setting like this is probably |
| 1845 |
appropriate: |
| 1846 |
</p><div class="example"> |
| 1847 |
<pre class="example-preformatted">o |lpr -Pfoo |
| 1848 |
</pre></div> |
| 1849 |
<p>The MS-DOS version will emulate spooling to <code class="code">lpr</code> by printing to |
| 1850 |
the local printer device <samp class="file">PRN</samp> if it doesn’t find an executable |
| 1851 |
program by that name in the current directory or along the <code class="code">PATH</code>. |
| 1852 |
</p> |
| 1853 |
</dd> |
| 1854 |
<dt><a id="index-O-config-command-_0028page-offsets_0029"></a><span>‘<samp class="samp">O <var class="var">xoff</var>,<var class="var">yoff</var></samp>’<a class="copiable-link" href="#index-O-config-command-_0028page-offsets_0029"> ¶</a></span></dt> |
| 1855 |
<dd><p>Origin offset. Same as ‘<samp class="samp">-O</samp>’, see <a class="pxref" href="#Option-details">Option details</a>. |
| 1856 |
</p> |
| 1857 |
</dd> |
| 1858 |
<dt><a class="index-entry-id" id="index-PostScript-font-alias-file-1"></a> |
| 1859 |
<a class="index-entry-id" id="index-resident-fonts_002c-different-in-different-printers-1"></a> |
| 1860 |
<a class="index-entry-id" id="index-_002bpsmapfile"></a> |
| 1861 |
<a id="index-p-config-command-_0028font-aliases_0029"></a><span>‘<samp class="samp">p <span class="r">[+]</span><var class="var">name</var></samp>’<a class="copiable-link" href="#index-p-config-command-_0028font-aliases_0029"> ¶</a></span></dt> |
| 1862 |
<dd><p>Examine <var class="var">name</var> for PostScript font aliases. Default is |
| 1863 |
<samp class="file">psfonts.map</samp>. This option allows you to specify different resident |
| 1864 |
fonts that different printers may have. If <var class="var">name</var> starts with a |
| 1865 |
‘<samp class="samp">+</samp>’ character, then the rest of the name (after any leading spaces) |
| 1866 |
is used as an additional map file; thus, it is possible to have local |
| 1867 |
map files pointed to by local configuration files that append to the |
| 1868 |
global map file. This can be used for font families. |
| 1869 |
</p> |
| 1870 |
</dd> |
| 1871 |
<dt><a class="index-entry-id" id="index-PKFONTS_002c-overrides-P"></a> |
| 1872 |
<a class="index-entry-id" id="index-TEXPKS_002c-overrides-P"></a> |
| 1873 |
<a class="index-entry-id" id="index-GLYPHFONTS_002c-overrides-P"></a> |
| 1874 |
<a class="index-entry-id" id="index-TEXFONTS_002c-overrides-P"></a> |
| 1875 |
<a id="index-P-config-command-_0028PK-path_0029"></a><span>‘<samp class="samp">P <var class="var">path</var></samp>’<a class="copiable-link" href="#index-P-config-command-_0028PK-path_0029"> ¶</a></span></dt> |
| 1876 |
<dd><p>Use <var class="var">path</var> to search for bitmap PK font files is <var class="var">path</var>. The |
| 1877 |
<code class="code">PKFONTS</code>, <code class="code">TEXPKS</code>, <code class="code">GLYPHFONTS</code>, and <code class="code">TEXFONTS</code> |
| 1878 |
environment variables override this. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite class="cite">Kpathsea</cite>. |
| 1879 |
</p> |
| 1880 |
</dd> |
| 1881 |
<dt><a class="index-entry-id" id="index-Q-config-command-_0028quiet_0029"></a> |
| 1882 |
<a id="index-q-config-command-_0028quiet_0029"></a><span>‘<samp class="samp">q*</samp>’<a class="copiable-link" href="#index-q-config-command-_0028quiet_0029"> ¶</a></span></dt> |
| 1883 |
<dt>‘<samp class="samp">Q</samp>’</dt> |
| 1884 |
<dd><p>Run quietly. Same as ‘<samp class="samp">-q</samp>’, see <a class="pxref" href="#Option-details">Option details</a>. |
| 1885 |
</p> |
| 1886 |
</dd> |
| 1887 |
<dt><a id="index-r-config-command-_0028page-reversal_0029"></a><span>‘<samp class="samp">r*</samp>’<a class="copiable-link" href="#index-r-config-command-_0028page-reversal_0029"> ¶</a></span></dt> |
| 1888 |
<dd><p>Page reversal. Same as ‘<samp class="samp">-r</samp>’, see <a class="pxref" href="#Option-details">Option details</a>. |
| 1889 |
</p> |
| 1890 |
</dd> |
| 1891 |
<dt><a class="index-entry-id" id="index-fallback-resolutions"></a> |
| 1892 |
<a class="index-entry-id" id="index-default-resolutions"></a> |
| 1893 |
<a class="index-entry-id" id="index-last_002dresort-scaling_002c-with-R"></a> |
| 1894 |
<a id="index-R-config-command-_0028fallback-resolution_0029"></a><span>‘<samp class="samp">R <var class="var">num1 num2 …</var></samp>’<a class="copiable-link" href="#index-R-config-command-_0028fallback-resolution_0029"> ¶</a></span></dt> |
| 1895 |
<dd><p>Define the list of default resolutions for PK fonts. If a font size |
| 1896 |
actually used in a document is not available and cannot be created, |
| 1897 |
Dvips will scale the font found at the closest of these resolutions to |
| 1898 |
the requested size, using PostScript scaling. The resulting output may |
| 1899 |
be ugly, and thus a warning is issued. To turn this last-resort scaling |
| 1900 |
off, use a line with just the ‘<samp class="samp">R</samp>’ and no numbers. |
| 1901 |
</p> |
| 1902 |
<p>The given numbers must be sorted in increasing order; any number smaller |
| 1903 |
than the preceding one is ignored. This is because it is better to |
| 1904 |
scale a font up than down; scaling down can obliterate small features in |
| 1905 |
the character shape. |
| 1906 |
</p> |
| 1907 |
<a class="index-entry-id" id="index-DVIPSSIZES_002c-overrides-R"></a> |
| 1908 |
<a class="index-entry-id" id="index-TEXSIZES_002c-overrides-R"></a> |
| 1909 |
<p>The environment and config file values ‘<samp class="samp">DVIPSSIZES</samp>’ or |
| 1910 |
‘<samp class="samp">TEXSIZES</samp>’ override this configuration file setting. |
| 1911 |
</p> |
| 1912 |
<a class="index-entry-id" id="index-default_005ftexsizes-Make-variable"></a> |
| 1913 |
<p>If no ‘<samp class="samp">R</samp>’ settings or environment variables are specified, a list |
| 1914 |
compiled in during installation is used. This default list is defined by |
| 1915 |
the Makefile variable ‘<samp class="samp">default_texsizes</samp>’, defined in the file |
| 1916 |
<samp class="file">make/paths.make</samp>. |
| 1917 |
</p> |
| 1918 |
</dd> |
| 1919 |
<dt><a id="index-s-config-command-_0028global-save_002frestore_0029"></a><span>‘<samp class="samp">s*</samp>’<a class="copiable-link" href="#index-s-config-command-_0028global-save_002frestore_0029"> ¶</a></span></dt> |
| 1920 |
<dd><p>Output global save/restore. Same as ‘<samp class="samp">-s</samp>’, see <a class="pxref" href="#Option-details">Option details</a>. |
| 1921 |
</p> |
| 1922 |
</dd> |
| 1923 |
<dt><a class="index-entry-id" id="index-TEXPICTS_002c-overrides-S"></a> |
| 1924 |
<a class="index-entry-id" id="index-TEXINPUTS_002c-overrides-S"></a> |
| 1925 |
<a id="index-S-config-command-_0028pict-path_0029"></a><span>‘<samp class="samp">S <var class="var">path</var></samp>’<a class="copiable-link" href="#index-S-config-command-_0028pict-path_0029"> ¶</a></span></dt> |
| 1926 |
<dd><p>Use <var class="var">path</var> to search for special illustrations (Encapsulated |
| 1927 |
PostScript files or psfiles). The <code class="code">TEXPICTS</code> and then |
| 1928 |
<code class="code">TEXINPUTS</code> environment variables override this. |
| 1929 |
</p> |
| 1930 |
</dd> |
| 1931 |
<dt><a class="index-entry-id" id="index-TFMFONTS_002c-overrides-T"></a> |
| 1932 |
<a class="index-entry-id" id="index-TEXFONTS_002c-overrides-T"></a> |
| 1933 |
<a id="index-T-config-command-_0028TFM-path_0029"></a><span>‘<samp class="samp">T <var class="var">path</var></samp>’<a class="copiable-link" href="#index-T-config-command-_0028TFM-path_0029"> ¶</a></span></dt> |
| 1934 |
<dd><p>Use <var class="var">path</var> to search for TFM files. The <code class="code">TFMFONTS</code> and then |
| 1935 |
<code class="code">TEXFONTS</code> environment variables overrides this. This path is used |
| 1936 |
for resident fonts and fonts that can’t otherwise be found. |
| 1937 |
</p> |
| 1938 |
</dd> |
| 1939 |
<dt><a id="index-U-config-command-_0028Xerox-4045_0029"></a><span>‘<samp class="samp">U*</samp>’<a class="copiable-link" href="#index-U-config-command-_0028Xerox-4045_0029"> ¶</a></span></dt> |
| 1940 |
<dd><p>Work around bug in Xerox 4045 printer. Same as ‘<samp class="samp">-U</samp>’, see <a class="pxref" href="#Option-details">Option details</a>. |
| 1941 |
</p> |
| 1942 |
</dd> |
| 1943 |
<dt><a class="index-entry-id" id="index-virtual-font-path"></a> |
| 1944 |
<a class="index-entry-id" id="index-device-dependency_002c-and-virtual-fonts"></a> |
| 1945 |
<a id="index-V-config-command-_0028vf-path_0029"></a><span>‘<samp class="samp">V <var class="var">path</var></samp>’<a class="copiable-link" href="#index-V-config-command-_0028vf-path_0029"> ¶</a></span></dt> |
| 1946 |
<dd><p>Use <var class="var">path</var> to search for virtual font files. This may be |
| 1947 |
device-dependent if you use virtual fonts to simulate actual fonts on |
| 1948 |
different devices. |
| 1949 |
</p> |
| 1950 |
</dd> |
| 1951 |
<dt><a class="index-entry-id" id="index-warning-messages_002c-defining"></a> |
| 1952 |
<a id="index-W-config-command-_0028emit-warning_0029"></a><span>‘<samp class="samp">W <span class="r">[<var class="var">string</var>]</span></samp>’<a class="copiable-link" href="#index-W-config-command-_0028emit-warning_0029"> ¶</a></span></dt> |
| 1953 |
<dd><p>If <var class="var">string</var> is supplied, write it to standard error after reading |
| 1954 |
all the configuration files; with no <var class="var">string</var>, cancel any previous |
| 1955 |
‘<samp class="samp">W</samp>’ message. This is useful in the default configuration file to |
| 1956 |
remind users to specify a printer, for instance, or to notify users |
| 1957 |
about special characteristics of a particular printer. |
| 1958 |
</p> |
| 1959 |
</dd> |
| 1960 |
<dt><a id="index-X-config-command-_0028horizontal-resolution_0029"></a><span>‘<samp class="samp">X <var class="var">num</var></samp>’<a class="copiable-link" href="#index-X-config-command-_0028horizontal-resolution_0029"> ¶</a></span></dt> |
| 1961 |
<dd><p>Horizontal resolution. Same as ‘<samp class="samp">-X</samp>’ (see <a class="pxref" href="#Option-details">Option details</a>). |
| 1962 |
</p> |
| 1963 |
</dd> |
| 1964 |
<dt><a id="index-Y-config-command-_0028vertical-resolution_0029"></a><span>‘<samp class="samp">Y <var class="var">num</var></samp>’<a class="copiable-link" href="#index-Y-config-command-_0028vertical-resolution_0029"> ¶</a></span></dt> |
| 1965 |
<dd><p>Vertical resolution. Same as ‘<samp class="samp">-Y</samp>’ (see <a class="pxref" href="#Option-details">Option details</a>). |
| 1966 |
</p> |
| 1967 |
</dd> |
| 1968 |
<dt><a id="index-Z-config-command-_0028compress-fonts_0029"></a><span>‘<samp class="samp">Z*</samp>’<a class="copiable-link" href="#index-Z-config-command-_0028compress-fonts_0029"> ¶</a></span></dt> |
| 1969 |
<dd><p>Compress bitmap fonts. Same as ‘<samp class="samp">-Z</samp>’ (see <a class="pxref" href="#Option-details">Option details</a>). |
| 1970 |
</p> |
| 1971 |
</dd> |
| 1972 |
<dt><a id="index-z-config-command-_0028secure-mode_0029"></a><span>‘<samp class="samp">z*</samp>’<a class="copiable-link" href="#index-z-config-command-_0028secure-mode_0029"> ¶</a></span></dt> |
| 1973 |
<dd><p>Disables execution of system commands, like ‘<samp class="samp">-R</samp>’ |
| 1974 |
(see <a class="pxref" href="#Option-details">Option details</a>). If ‘<samp class="samp">-R</samp>’ is specified |
| 1975 |
on the command line, that takes precedence. |
| 1976 |
</p> |
| 1977 |
</dd> |
| 1978 |
</dl> |
| 1979 |
|
| 1980 |
|
| 1981 |
<hr> |
| 1982 |
</div> |
| 1983 |
</div> |
| 1984 |
</div> |
| 1985 |
<div class="chapter-level-extent" id="Paper-size-and-landscape"> |
| 1986 |
<div class="nav-panel"> |
| 1987 |
<p> |
| 1988 |
Next: <a href="#Interaction-with-PostScript" accesskey="n" rel="next">Interaction with PostScript</a>, Previous: <a href="#Invoking-Dvips" accesskey="p" rel="prev">Invoking Dvips</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 1989 |
</div> |
| 1990 |
<h2 class="chapter" id="Paper-size-and-landscape-orientation"><span>4 Paper size and landscape orientation<a class="copiable-link" href="#Paper-size-and-landscape-orientation"> ¶</a></span></h2> |
| 1991 |
|
| 1992 |
<a class="index-entry-id" id="index-paper-size_002c-general"></a> |
| 1993 |
|
| 1994 |
<p>Most TeX documents at a particular site are designed to use the |
| 1995 |
local standard paper size (letter size in the United States, A4 |
| 1996 |
elsewhere). The Dvips program can be customized either sitewide or |
| 1997 |
for a particular printer. |
| 1998 |
</p> |
| 1999 |
<a class="index-entry-id" id="index-landscape-orientation_002c-defined"></a> |
| 2000 |
<a class="index-entry-id" id="index-portrait-orientation_002c-defined"></a> |
| 2001 |
<p>On the other hand, plenty of documents are designed for other paper |
| 2002 |
sizes. For instance, you may want to design a document that has the |
| 2003 |
long edge of the paper horizontal. This can be useful when |
| 2004 |
typesetting booklets, brochures, complex tables, or many other |
| 2005 |
documents. This type of paper orientation is called <em class="dfn">landscape</em> |
| 2006 |
orientation (the default orientation is called <em class="dfn">portrait</em>). |
| 2007 |
Alternatively, a document might be designed for ledger or A3 paper. |
| 2008 |
</p> |
| 2009 |
<p>Since the intended paper size in these cases is a document design |
| 2010 |
decision, not a printing decision, such information should be given in |
| 2011 |
the TeX file and not on the Dvips command line. For this reason, |
| 2012 |
Dvips supports a ‘<samp class="samp">papersize</samp>’ special. It is hoped that this |
| 2013 |
special will become standard over time for TeX previewers and other |
| 2014 |
printer drivers. |
| 2015 |
</p> |
| 2016 |
<p>Some LaTeX packages, e.g., ‘<samp class="samp">hyperref.sty</samp>’, write a |
| 2017 |
‘<samp class="samp">papersize</samp>’ special into the DVI file. In this case, you need |
| 2018 |
not and should not attempt to override it manually. |
| 2019 |
</p> |
| 2020 |
|
| 2021 |
|
| 2022 |
<ul class="mini-toc"> |
| 2023 |
<li><a href="#papersize-special" accesskey="1">‘<samp class="samp">papersize</samp>’ special</a></li> |
| 2024 |
<li><a href="#Config-file-paper-sizes" accesskey="2">Configuration file paper size command</a></li> |
| 2025 |
<li><a href="#Paper-trays" accesskey="3">Paper trays</a></li> |
| 2026 |
</ul> |
| 2027 |
<hr> |
| 2028 |
<div class="section-level-extent" id="papersize-special"> |
| 2029 |
<div class="nav-panel"> |
| 2030 |
<p> |
| 2031 |
Next: <a href="#Config-file-paper-sizes" accesskey="n" rel="next">Configuration file paper size command</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape orientation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 2032 |
</div> |
| 2033 |
<h3 class="section" id="papersize-special-1"><span>4.1 ‘<samp class="samp">papersize</samp>’ special<a class="copiable-link" href="#papersize-special-1"> ¶</a></span></h3> |
| 2034 |
|
| 2035 |
<a class="index-entry-id" id="index-papersize-special"></a> |
| 2036 |
|
| 2037 |
<p>The format of the ‘<samp class="samp">papersize</samp>’ special is |
| 2038 |
</p> |
| 2039 |
<div class="example"> |
| 2040 |
<pre class="example-preformatted">\special{papersize=<var class="var">width</var>,<var class="var">height</var>} |
| 2041 |
</pre></div> |
| 2042 |
|
| 2043 |
<p><var class="var">width</var> is the horizontal size of the page, and <var class="var">height</var> is the |
| 2044 |
vertical size. The dimensions supported are the same as for TeX; |
| 2045 |
namely, in (inches), cm (centimeters), mm (millimeters), pt (points), sp |
| 2046 |
(scaled points), bp (big points, the same as the default PostScript |
| 2047 |
unit), pc (picas), dd (didot points), and cc (ciceros). |
| 2048 |
</p> |
| 2049 |
<a class="index-entry-id" id="index-landscape_002c-as-_005cspecial"></a> |
| 2050 |
<p>For a US letter size landscape document, the ‘<samp class="samp">papersize</samp>’ would be: |
| 2051 |
</p><div class="example"> |
| 2052 |
<pre class="example-preformatted">\special{papersize=11in,8.5in} |
| 2053 |
</pre></div> |
| 2054 |
|
| 2055 |
<p>An alternate specification of <code class="code">landscape</code>: |
| 2056 |
</p><div class="example"> |
| 2057 |
<pre class="example-preformatted">\special{landscape} |
| 2058 |
</pre></div> |
| 2059 |
|
| 2060 |
<p>This is supported for backward compatibility, but it is hoped that |
| 2061 |
eventually the ‘<samp class="samp">papersize</samp>’ comment will dominate. |
| 2062 |
</p> |
| 2063 |
<p>Of course, such a <code class="code">\special</code> only informs Dvips of the desired |
| 2064 |
paper size; you must also adjust <code class="code">\hsize</code> and <code class="code">\vsize</code> in your |
| 2065 |
TeX document typeset to those dimensions. |
| 2066 |
</p> |
| 2067 |
<a class="index-entry-id" id="index-unknown_002c-paper-format-for-_002dt"></a> |
| 2068 |
<p>When using the ‘<samp class="samp">papersize</samp>’ special, you generally should not also |
| 2069 |
specify <code class="code">-t</code> on the command line (see <a class="pxref" href="#Option-details">Option details</a>). The |
| 2070 |
exception is when using a nonstandard paper size that isn’t |
| 2071 |
predefined; in this case, use <code class="code">-t unknown</code>. |
| 2072 |
</p> |
| 2073 |
<p>The ‘<samp class="samp">papersize</samp>’ special must occur somewhere on the first page of |
| 2074 |
the document. Some packages, notably ‘<samp class="samp">hyperref</samp>’, insert this special. |
| 2075 |
</p> |
| 2076 |
<p>By default, if a DVI file contains multiple ‘<samp class="samp">papersize</samp>’ specials, |
| 2077 |
the last one wins; this is also the behavior of the <code class="code">dvipdfmx</code> |
| 2078 |
driver. If the <code class="code">-L0</code> command line option or <code class="code">L0</code> config |
| 2079 |
file command is specified, the first special wins—this was the |
| 2080 |
behavior of Dvips prior to the 2017 release. |
| 2081 |
</p> |
| 2082 |
|
| 2083 |
<hr> |
| 2084 |
</div> |
| 2085 |
<div class="section-level-extent" id="Config-file-paper-sizes"> |
| 2086 |
<div class="nav-panel"> |
| 2087 |
<p> |
| 2088 |
Next: <a href="#Paper-trays" accesskey="n" rel="next">Paper trays</a>, Previous: <a href="#papersize-special" accesskey="p" rel="prev">‘<samp class="samp">papersize</samp>’ special</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape orientation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 2089 |
</div> |
| 2090 |
<h3 class="section" id="Configuration-file-paper-size-command"><span>4.2 Configuration file paper size command<a class="copiable-link" href="#Configuration-file-paper-size-command"> ¶</a></span></h3> |
| 2091 |
|
| 2092 |
<a class="index-entry-id" id="index-paper-size-configuration-file-command"></a> |
| 2093 |
<a class="index-entry-id" id="index-configuration-file-paper-size-command"></a> |
| 2094 |
|
| 2095 |
<p>The ‘<samp class="samp">@</samp>’ command in a configuration file sets the paper size |
| 2096 |
defaults and options. The first ‘<samp class="samp">@</samp>’ command defines the default |
| 2097 |
paper size. It has three possible parameters: |
| 2098 |
</p> |
| 2099 |
<div class="example"> |
| 2100 |
<pre class="example-preformatted">@ <span class="r">[</span><var class="var">name</var> <span class="r">[</span><var class="var">hsize</var> <var class="var">vsize</var><span class="r">]]</span> |
| 2101 |
</pre></div> |
| 2102 |
|
| 2103 |
<p>If ‘<samp class="samp">@</samp>’ is specified on a line by itself, with no parameters, it |
| 2104 |
instructs Dvips to discard all previous paper size information (possibly |
| 2105 |
from another configuration file). |
| 2106 |
</p> |
| 2107 |
<p>If three parameters are given, with the first parameter being a name and |
| 2108 |
the second and third being a dimension (as in ‘<samp class="samp">8.5in</samp>’ or |
| 2109 |
‘<samp class="samp">3.2cc</samp>’, just like in the ‘<samp class="samp">papersize</samp>’ special), then the |
| 2110 |
option is interpreted as starting a new paper size description, where |
| 2111 |
<var class="var">name</var> is the name and <var class="var">hsize</var> and <var class="var">vsize</var> define the |
| 2112 |
horizontal and vertical size of the sheet of paper, respectively. For |
| 2113 |
example: |
| 2114 |
</p> |
| 2115 |
<div class="example"> |
| 2116 |
<pre class="example-preformatted">@ letterSize 8.5in 11in |
| 2117 |
</pre></div> |
| 2118 |
|
| 2119 |
<p>If both <var class="var">hsize</var> and <var class="var">vsize</var> are zero (you must still specify |
| 2120 |
units!) then any page size will match. If the ‘<samp class="samp">@</samp>’ character is |
| 2121 |
immediately followed by a ‘<samp class="samp">+</samp>’ sign, then the remainder of the line |
| 2122 |
(after skipping any leading blanks) is treated as PostScript code to |
| 2123 |
send to the printer, presumably to select that particular paper size: |
| 2124 |
</p> |
| 2125 |
<div class="example"> |
| 2126 |
<pre class="example-preformatted">@ letter 8.5in 11in |
| 2127 |
@+ %%BeginPaperSize: Letter |
| 2128 |
@+ letter |
| 2129 |
@+ %%EndPaperSize |
| 2130 |
</pre></div> |
| 2131 |
|
| 2132 |
<p>After all that, if the first character of the line is an exclamation |
| 2133 |
point, then the line is put in the initial comments section of the final |
| 2134 |
output file; else, it is put in the setup section of the output file. |
| 2135 |
For example: |
| 2136 |
</p> |
| 2137 |
<div class="example"> |
| 2138 |
<pre class="example-preformatted">@ legal 8.5in 14in |
| 2139 |
@+ ! %%DocumentPaperSizes: Legal |
| 2140 |
@+ %%BeginPaperSize: Legal |
| 2141 |
@+ legal |
| 2142 |
@+ %%EndPaperSize |
| 2143 |
</pre></div> |
| 2144 |
|
| 2145 |
<p>When Dvips has a paper format name given on the command line, it looks |
| 2146 |
for a match by the <var class="var">name</var>; when it has a ‘<samp class="samp">papersize</samp>’ special, |
| 2147 |
it looks for a match by dimensions. The best match found (from the |
| 2148 |
paper size information in the configuration file) is used. The |
| 2149 |
dimensions must match within 5bp. |
| 2150 |
</p> |
| 2151 |
<p>If nothing matches, a warning is printed and the first paper size with |
| 2152 |
zero dimensions is used; this should be the <code class="code">unknown</code> paper size |
| 2153 |
definition mentioned below, resulting in the actual dimensions being |
| 2154 |
used. |
| 2155 |
</p> |
| 2156 |
<a class="index-entry-id" id="index-landscaperotate-configuration-file-command"></a> |
| 2157 |
<a class="index-entry-id" id="index-landscaperotate-command-line-option"></a> |
| 2158 |
<p>In versions of Dvips prior to 2022.1, if the paper size specified did |
| 2159 |
not match one of the defined paper sizes, Dvips considered rotated |
| 2160 |
page content and rotated paper sizes for a match. This provided some |
| 2161 |
automatic support for landscape mode on raw printers, but today it can |
| 2162 |
be harmful when generating PDF. (Specifically, the ‘<samp class="samp">/MediaBox</samp>’ |
| 2163 |
then ends up with rotated values, which is not expected by PDF |
| 2164 |
viewers, e.g., when a document intentionally has a single page |
| 2165 |
rotated.) |
| 2166 |
</p> |
| 2167 |
<p>Further, on all recent computer systems, this facility is typically |
| 2168 |
provided instead by a print spooler that considers the bounding box of |
| 2169 |
the document and inserts appropriate media selection commands as part |
| 2170 |
of the print job. So, this automatic rotation is no longer done by |
| 2171 |
default by Dvips. If you want to enable it, the |
| 2172 |
‘<samp class="samp">-landscaperotate</samp>’ command line option or ‘<samp class="samp">landscaperotate</samp>’ |
| 2173 |
configuration file option can be used. See <a class="xref" href="#Option-details">Option details</a>. |
| 2174 |
</p> |
| 2175 |
<a class="index-entry-id" id="index-zero-dimensions-and-setting-paper-size"></a> |
| 2176 |
<p>If your printer has a command to set a special paper size, then give |
| 2177 |
dimensions of ‘<samp class="samp">0in 0in</samp>’; the PostScript code that sets the paper |
| 2178 |
size can refer to the dimensions the user requested as ‘<samp class="samp">hsize</samp>’ |
| 2179 |
and ‘<samp class="samp">vsize</samp>’; these will be macros defined in the PostScript that |
| 2180 |
return the requested size in default PostScript units. Also, some |
| 2181 |
printers want ‘<samp class="samp">BeginPaperSize</samp>’ comments and paper size setting |
| 2182 |
commands; others (such as the NeXT) want ‘<samp class="samp">PaperSize</samp>’ comments and |
| 2183 |
they will handle setting the paper size. So paper size entries should |
| 2184 |
typically specify both. |
| 2185 |
</p> |
| 2186 |
<a class="index-entry-id" id="index-unknown_002c-paper-format-for-_002dt-1"></a> |
| 2187 |
<p>When using a paper size that is not already defined in |
| 2188 |
<samp class="file">config.ps</samp>, you probably want to say ‘<samp class="samp">-t unknown</samp>’ on |
| 2189 |
the command line; the <code class="code">unknown</code> paper size definition in |
| 2190 |
<samp class="file">config.ps</samp> has the requisite PostScript incantation to set the |
| 2191 |
PostScript page size, as just described. |
| 2192 |
</p> |
| 2193 |
<a class="index-entry-id" id="index-nopaper_002c-paper-format-for-_002dt"></a> |
| 2194 |
<p>If you want no paper size information in the output at all, use |
| 2195 |
‘<samp class="samp">-t nopaper</samp>’. This is useful with multi-page output that |
| 2196 |
will be processed further. If you just have a single page document, |
| 2197 |
you can use ‘<samp class="samp">-E</samp>’ to get pure EPSF output. |
| 2198 |
</p> |
| 2199 |
<a class="index-entry-id" id="index-mkdvipspapers"></a> |
| 2200 |
<p>The Perl 5 script <samp class="file">contrib/configs/mkdvipspapers</samp> in the |
| 2201 |
distribution directory may help in determining appropriate paper size |
| 2202 |
definitions. |
| 2203 |
</p> |
| 2204 |
<a class="index-entry-id" id="index-config_002eps-paper-sizes"></a> |
| 2205 |
<a class="index-entry-id" id="index-letter-paper-size"></a> |
| 2206 |
<a class="index-entry-id" id="index-a4-paper-size"></a> |
| 2207 |
<p>Notwithstanding the above, the default <code class="code">letter</code> and <code class="code">a4</code> |
| 2208 |
paper size definitions in <samp class="file">config.ps</samp> execute the |
| 2209 |
<code class="code">setpagedevice</code> operator if it exists (it was defined in |
| 2210 |
PostScript Level 2), or the ‘<samp class="samp">letter</samp>’ or ‘<samp class="samp">a4</samp>’ operator |
| 2211 |
if they exist (they are nonstandard and thus perhaps cause failures on |
| 2212 |
certain (unknown) printers). Not executing any page size definition |
| 2213 |
at all confuses PostScript conversion programs such as |
| 2214 |
<code class="command">ps2pdf</code>, so we want to execute one if we can. |
| 2215 |
</p> |
| 2216 |
<a class="index-entry-id" id="index-letterSize-paper-size"></a> |
| 2217 |
<a class="index-entry-id" id="index-A4size-paper-size"></a> |
| 2218 |
<p>The <code class="code">letterSize</code> and <code class="code">A4Size</code> paper size definitions are now |
| 2219 |
synonyms for <code class="code">letter</code> and <code class="code">a4</code>. |
| 2220 |
</p> |
| 2221 |
|
| 2222 |
<hr> |
| 2223 |
</div> |
| 2224 |
<div class="section-level-extent" id="Paper-trays"> |
| 2225 |
<div class="nav-panel"> |
| 2226 |
<p> |
| 2227 |
Previous: <a href="#Config-file-paper-sizes" accesskey="p" rel="prev">Configuration file paper size command</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape orientation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 2228 |
</div> |
| 2229 |
<h3 class="section" id="Paper-trays-1"><span>4.3 Paper trays<a class="copiable-link" href="#Paper-trays-1"> ¶</a></span></h3> |
| 2230 |
|
| 2231 |
<a class="index-entry-id" id="index-paper-trays"></a> |
| 2232 |
<a class="index-entry-id" id="index-dual-paper-trays"></a> |
| 2233 |
<a class="index-entry-id" id="index-multiple-paper-trays"></a> |
| 2234 |
<a class="index-entry-id" id="index-HP4Si-printer-and-paper-trays"></a> |
| 2235 |
|
| 2236 |
<a class="index-entry-id" id="index-bop_002dhook"></a> |
| 2237 |
<p>Some printers, such as the Hewlett-Packard HP4si, have multiple paper |
| 2238 |
trays. You can set up Dvips to take advantage of this using the |
| 2239 |
<code class="code">bop-hook</code> PostScript variable (see <a class="pxref" href="#PostScript-hooks">PostScript hooks</a>). |
| 2240 |
</p> |
| 2241 |
<a class="index-entry-id" id="index-letterhead-tray"></a> |
| 2242 |
<p>For example, suppose you have an alternate tray stocked with letterhead |
| 2243 |
paper; the usual tray has the usual paper. You have a document where |
| 2244 |
you want the first page printed on letterhead, and the remaining pages |
| 2245 |
on the usual paper. You can create a header file, say |
| 2246 |
<samp class="file">firstletterhead.PS</samp>, with the following (PostScript) code |
| 2247 |
(<code class="code">bop-hook</code> is passed the current physical page number, which |
| 2248 |
starts at zero): |
| 2249 |
</p> |
| 2250 |
<div class="example"> |
| 2251 |
<pre class="example-preformatted">/bop-hook { dup 0 eq { <var class="var">alternatetray</var> } { <var class="var">normaltray</var> } ifelse } def |
| 2252 |
</pre></div> |
| 2253 |
|
| 2254 |
<p>where <var class="var">alternatetray</var> and <var class="var">normaltray</var> are the appropriate |
| 2255 |
commands to select the paper trays. On the 4SI, <var class="var">alternatetray</var> is |
| 2256 |
‘<samp class="samp">statusdict begin 1 setpapertray end</samp>’ and <var class="var">normaltray</var> is |
| 2257 |
‘<samp class="samp">statusdict begin 0 setpapertray end</samp>’. |
| 2258 |
</p> |
| 2259 |
<p>Then, include the file with either |
| 2260 |
</p><ul class="itemize mark-bullet"> |
| 2261 |
<li>the ‘<samp class="samp">-h</samp>’ command-line option (see <a class="pxref" href="#Option-details">Option details</a>); or |
| 2262 |
|
| 2263 |
</li><li>the ‘<samp class="samp">h</samp>’ config file option (see <a class="pxref" href="#Configuration-file-commands">Configuration file commands</a>); or |
| 2264 |
|
| 2265 |
</li><li>‘<samp class="samp">\special{header=<var class="var">file</var>}</samp>’ in your TeX document |
| 2266 |
(see <a class="pxref" href="#Including-headers-from-TeX">Including headers from TeX</a>). |
| 2267 |
|
| 2268 |
</li></ul> |
| 2269 |
|
| 2270 |
|
| 2271 |
<hr> |
| 2272 |
</div> |
| 2273 |
</div> |
| 2274 |
<div class="chapter-level-extent" id="Interaction-with-PostScript"> |
| 2275 |
<div class="nav-panel"> |
| 2276 |
<p> |
| 2277 |
Next: <a href="#PostScript-fonts" accesskey="n" rel="next">PostScript fonts</a>, Previous: <a href="#Paper-size-and-landscape" accesskey="p" rel="prev">Paper size and landscape orientation</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 2278 |
</div> |
| 2279 |
<h2 class="chapter" id="Interaction-with-PostScript-1"><span>5 Interaction with PostScript<a class="copiable-link" href="#Interaction-with-PostScript-1"> ¶</a></span></h2> |
| 2280 |
|
| 2281 |
<a class="index-entry-id" id="index-interaction-with-PostScript"></a> |
| 2282 |
<a class="index-entry-id" id="index-PostScript-interaction"></a> |
| 2283 |
|
| 2284 |
<p>Dvips supports inclusion of PostScript figure files (e.g., Encapsulated |
| 2285 |
PostScript), downloading other header files (e.g., fonts), including |
| 2286 |
literal PostScript code, and hypertext. |
| 2287 |
</p> |
| 2288 |
|
| 2289 |
|
| 2290 |
<ul class="mini-toc"> |
| 2291 |
<li><a href="#PostScript-figures" accesskey="1">PostScript figures</a></li> |
| 2292 |
<li><a href="#Header-files" accesskey="2">PostScript header files</a></li> |
| 2293 |
<li><a href="#Literal-PS" accesskey="3">Literal PostScript</a></li> |
| 2294 |
<li><a href="#Hypertext" accesskey="4">HyperTeXt</a></li> |
| 2295 |
</ul> |
| 2296 |
<hr> |
| 2297 |
<div class="section-level-extent" id="PostScript-figures"> |
| 2298 |
<div class="nav-panel"> |
| 2299 |
<p> |
| 2300 |
Next: <a href="#Header-files" accesskey="n" rel="next">PostScript header files</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 2301 |
</div> |
| 2302 |
<h3 class="section" id="PostScript-figures-1"><span>5.1 PostScript figures<a class="copiable-link" href="#PostScript-figures-1"> ¶</a></span></h3> |
| 2303 |
|
| 2304 |
<p>Scaling and including PostScript graphics is a breeze—if the PostScript |
| 2305 |
file is correctly formed. Even if it is not, however, the file can usually |
| 2306 |
be accommodated with just a little more work. |
| 2307 |
</p> |
| 2308 |
|
| 2309 |
|
| 2310 |
<ul class="mini-toc"> |
| 2311 |
<li><a href="#Bounding-box" accesskey="1">The bounding box comment</a></li> |
| 2312 |
<li><a href="#g_t_005cincludegraphics" accesskey="2">The \includegraphics macro for LaTeX</a></li> |
| 2313 |
<li><a href="#EPSF-macros" accesskey="3">Using the EPSF macros</a></li> |
| 2314 |
<li><a href="#psfile-special" accesskey="4">‘<samp class="samp">psfile</samp>’ special</a></li> |
| 2315 |
<li><a href="#Dynamic-creation-of-graphics" accesskey="5">Dynamic creation of PostScript graphics files</a></li> |
| 2316 |
<li><a href="#Fonts-in-figures" accesskey="6">Fonts in figures</a></li> |
| 2317 |
</ul> |
| 2318 |
<hr> |
| 2319 |
<div class="subsection-level-extent" id="Bounding-box"> |
| 2320 |
<div class="nav-panel"> |
| 2321 |
<p> |
| 2322 |
Next: <a href="#g_t_005cincludegraphics" accesskey="n" rel="next">The \includegraphics macro for LaTeX</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 2323 |
</div> |
| 2324 |
<h4 class="subsection" id="The-bounding-box-comment"><span>5.1.1 The bounding box comment<a class="copiable-link" href="#The-bounding-box-comment"> ¶</a></span></h4> |
| 2325 |
|
| 2326 |
<a class="index-entry-id" id="index-bounding-box_002c-comment-for"></a> |
| 2327 |
|
| 2328 |
<p>The most important feature of a good PostScript file from the standpoint |
| 2329 |
of including it in another document is an accurate bounding box comment. |
| 2330 |
Every well-formed PostScript file has a comment describing where on the |
| 2331 |
page the graphic is located, and how big that graphic is. |
| 2332 |
</p> |
| 2333 |
<a class="index-entry-id" id="index-big-points"></a> |
| 2334 |
<a class="index-entry-id" id="index-PostScript-units"></a> |
| 2335 |
<a class="index-entry-id" id="index-bounding-box_002c-defined"></a> |
| 2336 |
<p>This information is given as the lower left and upper right corners of |
| 2337 |
the box just enclosing the graphic, and is thus referred to as the |
| 2338 |
<em class="dfn">bounding box</em>. These coordinates are given in the default |
| 2339 |
PostScript units (there are precisely 72 PostScript units to the inch, |
| 2340 |
like TeX big points) with respect to the lower left corner of the |
| 2341 |
sheet of paper. |
| 2342 |
</p> |
| 2343 |
<a class="index-entry-id" id="index-_0025_0025BoundingBox"></a> |
| 2344 |
<p>To see if a PostScript file has a bounding box comment, just look at the |
| 2345 |
first few lines of the file. PostScript files are standard ASCII, so |
| 2346 |
you can use any text editor to do this. If within the first few dozen |
| 2347 |
lines there is a line like |
| 2348 |
</p> |
| 2349 |
<div class="example"> |
| 2350 |
<pre class="example-preformatted">%%BoundingBox: 25 50 400 300 |
| 2351 |
</pre></div> |
| 2352 |
|
| 2353 |
<p>(with any reasonable numbers), chances are very good that the file is |
| 2354 |
Encapsulated PostScript and will work easily with Dvips. If the file |
| 2355 |
contains instead a line like |
| 2356 |
</p> |
| 2357 |
<a class="index-entry-id" id="index-atend_002c-bounding-box-specification"></a> |
| 2358 |
<a class="index-entry-id" id="index-_0028atend_0029_002c-bounding-box-specification"></a> |
| 2359 |
<div class="example"> |
| 2360 |
<pre class="example-preformatted">%%BoundingBox: (atend) |
| 2361 |
</pre></div> |
| 2362 |
|
| 2363 |
<p>the file is still probably Encapsulated PostScript, but the bounding box |
| 2364 |
is given at the end of the file. Dvips needs it at the beginning. You |
| 2365 |
can move it with that same text editor, or a simple script. (The |
| 2366 |
bounding box is given in this way when the program that generated the |
| 2367 |
PostScript couldn’t know the size in advance, or was too lazy to compute |
| 2368 |
it.) |
| 2369 |
</p> |
| 2370 |
<a class="index-entry-id" id="index-bbfig"></a> |
| 2371 |
<a class="index-entry-id" id="index-bounding-box_002c-determining"></a> |
| 2372 |
<p>If the document lacks a ‘<samp class="samp">%%BoundingBox:</samp>’ altogether, you can |
| 2373 |
determine one in a couple of ways. One is to use the ‘<samp class="samp">bbfig</samp>’ |
| 2374 |
program distributed with Dvips in the <samp class="file">contrib</samp> directory. This can |
| 2375 |
usually find the correct bounding box automatically; it works best with |
| 2376 |
Ghostscript. |
| 2377 |
</p> |
| 2378 |
<a class="index-entry-id" id="index-612-792-bounding-box-size"></a> |
| 2379 |
<p>If the comment looks like this: |
| 2380 |
</p><div class="example"> |
| 2381 |
<pre class="example-preformatted">%%BoundingBox: 0 0 612 792 |
| 2382 |
</pre></div> |
| 2383 |
|
| 2384 |
<p>the graphic claims to take up an entire sheet of paper. This is |
| 2385 |
usually a symptom of a bug in the program that generated it. |
| 2386 |
</p> |
| 2387 |
<p>The other is to do it yourself: print the file. Now, take a ruler, and |
| 2388 |
make the following measurements (in PostScript units, so measure in |
| 2389 |
inches and multiply by 72): From the left edge of the paper to the |
| 2390 |
leftmost mark on the paper is <var class="var">llx</var>, the first number. From the |
| 2391 |
bottom edge of the paper to the bottommost mark on the paper is |
| 2392 |
<var class="var">lly</var>, the second number. From the left edge of the paper to the |
| 2393 |
rightmost mark on the paper is <var class="var">urx</var>, the third number. The fourth |
| 2394 |
and final number, <var class="var">ury</var>, is the distance from the bottom of the page |
| 2395 |
to the uppermost mark on the paper. |
| 2396 |
</p> |
| 2397 |
<p>Once you have the numbers, add a comment of the following form as the |
| 2398 |
second line of the document. (The first line should already be a line |
| 2399 |
starting with the two characters ‘<samp class="samp">%!</samp>’; if it is not, the file |
| 2400 |
probably isn’t PostScript.) |
| 2401 |
</p> |
| 2402 |
<div class="example"> |
| 2403 |
<pre class="example-preformatted">%%BoundingBox: <var class="var">llx</var> <var class="var">lly</var> <var class="var">urx</var> <var class="var">ury</var> |
| 2404 |
</pre></div> |
| 2405 |
|
| 2406 |
<p>Or, if you don’t want to modify the file, you can simply write these |
| 2407 |
numbers down in a convenient place and give them in your TeX document |
| 2408 |
when you import the graphic, as described in the next section. |
| 2409 |
</p> |
| 2410 |
<p>If the document does not have such a bounding box, or if the bounding |
| 2411 |
box is given at the end of the document, or the bounding box is wrong, |
| 2412 |
please complain to the authors of the software package that generated |
| 2413 |
the file. |
| 2414 |
</p> |
| 2415 |
|
| 2416 |
<hr> |
| 2417 |
</div> |
| 2418 |
<div class="subsection-level-extent" id="g_t_005cincludegraphics"> |
| 2419 |
<div class="nav-panel"> |
| 2420 |
<p> |
| 2421 |
Next: <a href="#EPSF-macros" accesskey="n" rel="next">Using the EPSF macros</a>, Previous: <a href="#Bounding-box" accesskey="p" rel="prev">The bounding box comment</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 2422 |
</div> |
| 2423 |
<h4 class="subsection" id="The-_005cincludegraphics-macro-for-LaTeX"><span>5.1.2 The \includegraphics macro for LaTeX<a class="copiable-link" href="#The-_005cincludegraphics-macro-for-LaTeX"> ¶</a></span></h4> |
| 2424 |
|
| 2425 |
<a class="index-entry-id" id="index-_005cincludegraphics-LaTeX-macro"></a> |
| 2426 |
<a class="index-entry-id" id="index-macros-for-epsf-inclusion"></a> |
| 2427 |
|
| 2428 |
<p>Once the figure file has a bounding box comment (see the previous |
| 2429 |
section) you are ready to import the graphic into a LaTeX |
| 2430 |
document. For LaTeX2e, you can use the epsf, graphics or graphicx |
| 2431 |
packages, but the last is recommended—it has the most flexible |
| 2432 |
syntax, and is briefly described here. Further information can be |
| 2433 |
found in <samp class="file">grfguide</samp> or <samp class="file">epslatex</samp>, which should be included |
| 2434 |
in your LaTeX distribution in DVI, PDF, or other formats. (If you |
| 2435 |
are still using LaTeX 2.09, use epsf.sty). |
| 2436 |
</p> |
| 2437 |
<p>Just put the following command into your preamble: |
| 2438 |
</p> |
| 2439 |
<div class="example"> |
| 2440 |
<pre class="example-preformatted">\usepackage[dvips]{graphicx} |
| 2441 |
</pre></div> |
| 2442 |
|
| 2443 |
<p>Depending on your system, a suitable driver setup may already be |
| 2444 |
present, so that LaTeX automatically produces DVI files suitable for |
| 2445 |
Dvips. In this case you can leave out the ‘<samp class="samp">[dvips]</samp>’ parameter. |
| 2446 |
</p> |
| 2447 |
<p>Now, at the point you want to include a file <samp class="file">foo.eps</samp>, enter a |
| 2448 |
line such as: |
| 2449 |
</p> |
| 2450 |
<div class="example"> |
| 2451 |
<pre class="example-preformatted">\includegraphics{foo.eps} |
| 2452 |
</pre></div> |
| 2453 |
|
| 2454 |
<p>However, it is usually best to omit the file extension and only use |
| 2455 |
</p> |
| 2456 |
<div class="example"> |
| 2457 |
<pre class="example-preformatted">\includegraphics{foo} |
| 2458 |
</pre></div> |
| 2459 |
|
| 2460 |
<p>because then you can process the same LaTeX file with |
| 2461 |
different TeX engines or DVI converters if you also provide |
| 2462 |
suitable graphics files for them, e.g., <samp class="file">foo.pdf</samp> or |
| 2463 |
<samp class="file">foo.png</samp>. |
| 2464 |
</p> |
| 2465 |
<a class="index-entry-id" id="index-bounding-box_002c-supplying-to-TeX"></a> |
| 2466 |
<p>The \includegraphics command has many options, specified in |
| 2467 |
‘<samp class="samp">key=value</samp>’ syntax, to allow you to resize, rotate or trim the |
| 2468 |
included graphic—see <samp class="file">grfguide</samp> or <samp class="file">epslatex</samp>. If your |
| 2469 |
file does not have a bounding box comment, you can supply the numbers |
| 2470 |
as determined in the previous section, in the same order they would |
| 2471 |
have been in a normal bounding box comment: |
| 2472 |
</p> |
| 2473 |
<div class="example"> |
| 2474 |
<pre class="example-preformatted">\includegraphics[bb=100 100 500 500]{foo.ps} |
| 2475 |
</pre></div> |
| 2476 |
|
| 2477 |
<p>Now, save your changes and run LaTeX and Dvips; the output should |
| 2478 |
have your graphic positioned at precisely the point you indicated, |
| 2479 |
occupying the proper amount of space. |
| 2480 |
</p> |
| 2481 |
<p>PostScript graphics have their origin in the lower left |
| 2482 |
corner. Therefore, in TeX, a graphic will occupy a box that extends |
| 2483 |
far above the line where it is put in, but has depth zero below it. |
| 2484 |
Combining ‘<samp class="samp">\includegraphics</samp>’ with ‘<samp class="samp">\parbox</samp>’ commands or |
| 2485 |
minipages can sometimes be confusing when this is not taken into |
| 2486 |
account. |
| 2487 |
</p> |
| 2488 |
|
| 2489 |
<hr> |
| 2490 |
</div> |
| 2491 |
<div class="subsection-level-extent" id="EPSF-macros"> |
| 2492 |
<div class="nav-panel"> |
| 2493 |
<p> |
| 2494 |
Next: <a href="#psfile-special" accesskey="n" rel="next">‘<samp class="samp">psfile</samp>’ special</a>, Previous: <a href="#g_t_005cincludegraphics" accesskey="p" rel="prev">The \includegraphics macro for LaTeX</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 2495 |
</div> |
| 2496 |
<h4 class="subsection" id="Using-the-EPSF-macros"><span>5.1.3 Using the EPSF macros<a class="copiable-link" href="#Using-the-EPSF-macros"> ¶</a></span></h4> |
| 2497 |
|
| 2498 |
<a class="index-entry-id" id="index-EPSF-macros"></a> |
| 2499 |
<a class="index-entry-id" id="index-macros-for-epsf-inclusion-1"></a> |
| 2500 |
|
| 2501 |
<p>If you are using LaTeX2e, use the ‘<samp class="samp">graphics</samp>’ or ‘<samp class="samp">graphicx</samp>’ |
| 2502 |
package. See <a class="xref" href="#g_t_005cincludegraphics">The \includegraphics macro for LaTeX</a>. |
| 2503 |
</p> |
| 2504 |
<p>If you are using plain TeX or LaTeX 2.09, you need <samp class="file">epsf.tex</samp> |
| 2505 |
(for plain TeX) and <samp class="file">epsf.sty</samp> (for LaTeX). For plain |
| 2506 |
TeX, add a line like this near the top of your input file: |
| 2507 |
</p> |
| 2508 |
<a class="index-entry-id" id="index-epsf_002etex"></a> |
| 2509 |
<div class="example"> |
| 2510 |
<pre class="example-preformatted">\input epsf |
| 2511 |
</pre></div> |
| 2512 |
|
| 2513 |
<a class="index-entry-id" id="index-epsf_002esty"></a> |
| 2514 |
<p>If you are using LaTeX 2.09, add the ‘<samp class="samp">epsf</samp>’ style option, as in: |
| 2515 |
</p> |
| 2516 |
<div class="example"> |
| 2517 |
<pre class="example-preformatted">\documentstyle[12pt,epsf]{article} |
| 2518 |
</pre></div> |
| 2519 |
|
| 2520 |
<p>In any case, the above only needs to be done once, no matter how many |
| 2521 |
figures you plan to include. |
| 2522 |
</p> |
| 2523 |
<p>Now, at the point you want to include a file, enter a line such as: |
| 2524 |
</p> |
| 2525 |
<div class="example"> |
| 2526 |
<pre class="example-preformatted">\epsffile{foo.eps} |
| 2527 |
</pre></div> |
| 2528 |
|
| 2529 |
<a class="index-entry-id" id="index-_005cleavevmode"></a> |
| 2530 |
<a class="index-entry-id" id="index-bounding-box_002c-supplying-to-TeX-1"></a> |
| 2531 |
<p>If you are using LaTeX, you may need to add <code class="code">\leavevmode</code> |
| 2532 |
immediately before the <code class="code">\epsffile</code> command to get certain |
| 2533 |
environments to work correctly. If your file does not have a bounding |
| 2534 |
box comment, you can supply the numbers as determined in the previous |
| 2535 |
section, in the same order they would have been in a normal bounding box |
| 2536 |
comment: |
| 2537 |
</p> |
| 2538 |
<div class="example"> |
| 2539 |
<pre class="example-preformatted">\epsffile[100 100 500 500]{foo.ps} |
| 2540 |
</pre></div> |
| 2541 |
|
| 2542 |
<p>Now, save your changes and run TeX and Dvips; the output should have |
| 2543 |
your graphic positioned at precisely the point you indicated, occupying |
| 2544 |
the proper amount of space. |
| 2545 |
</p> |
| 2546 |
<a class="index-entry-id" id="index-_005cepsffile-macro"></a> |
| 2547 |
<a class="index-entry-id" id="index-figures_002c-natural-size"></a> |
| 2548 |
<p>The <code class="code">\epsffile</code> macro typesets the figure as a TeX <code class="code">\vbox</code> |
| 2549 |
at the point of the page that the command is executed. By default, the |
| 2550 |
graphic will have its ‘natural’ width (namely, the width of its bounding |
| 2551 |
box). The TeX box will have depth zero and its natural height. By |
| 2552 |
default, the graphic will be scaled by any DVI magnification in effect, |
| 2553 |
just as is everything else in your document. See the next section for |
| 2554 |
more information on scaling. |
| 2555 |
</p> |
| 2556 |
<a class="index-entry-id" id="index-_005cepsfverbosetrue"></a> |
| 2557 |
<a class="index-entry-id" id="index-verbose-EPSF-processing"></a> |
| 2558 |
<p>If you want TeX to report the size of the figure as a message on your |
| 2559 |
terminal when it processes each figure, give the command: |
| 2560 |
</p> |
| 2561 |
<div class="example"> |
| 2562 |
<pre class="example-preformatted">\epsfverbosetrue |
| 2563 |
</pre></div> |
| 2564 |
|
| 2565 |
|
| 2566 |
|
| 2567 |
<ul class="mini-toc"> |
| 2568 |
<li><a href="#EPSF-scaling" accesskey="1">EPSF scaling</a></li> |
| 2569 |
<li><a href="#EPSF-clipping" accesskey="2">EPSF clipping</a></li> |
| 2570 |
</ul> |
| 2571 |
<hr> |
| 2572 |
<div class="subsubsection-level-extent" id="EPSF-scaling"> |
| 2573 |
<div class="nav-panel"> |
| 2574 |
<p> |
| 2575 |
Next: <a href="#EPSF-clipping" accesskey="n" rel="next">EPSF clipping</a>, Up: <a href="#EPSF-macros" accesskey="u" rel="up">Using the EPSF macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 2576 |
</div> |
| 2577 |
<h4 class="subsubsection" id="EPSF-scaling-1"><span>5.1.3.1 EPSF scaling<a class="copiable-link" href="#EPSF-scaling-1"> ¶</a></span></h4> |
| 2578 |
|
| 2579 |
<a class="index-entry-id" id="index-scaling-of-figures"></a> |
| 2580 |
<a class="index-entry-id" id="index-figures_002c-scaling"></a> |
| 2581 |
|
| 2582 |
<p>Usually, you will want to scale an EPSF figure to some size appropriate |
| 2583 |
for your document, since its natural size is determined by the creator |
| 2584 |
of the EPS file. |
| 2585 |
</p> |
| 2586 |
<p>The best way to do this is to assign the desired size to the TeX |
| 2587 |
<code class="code">\epsfxsize</code> or <code class="code">\epsfysize</code> variables, whichever is more |
| 2588 |
convenient for you. That is, put |
| 2589 |
</p> |
| 2590 |
<a class="index-entry-id" id="index-_005cepsfxsize"></a> |
| 2591 |
<div class="example"> |
| 2592 |
<pre class="example-preformatted">\epsfxsize=<var class="var">dimen</var> |
| 2593 |
</pre></div> |
| 2594 |
|
| 2595 |
<p>right before the call to <code class="code">\epsffile</code>. Then the width of the TeX |
| 2596 |
box will be <var class="var">dimen</var> and its height will be scaled proportionately. |
| 2597 |
Similarly, you can set the vertical size with |
| 2598 |
</p> |
| 2599 |
<a class="index-entry-id" id="index-_005cepsfysize"></a> |
| 2600 |
<div class="example"> |
| 2601 |
<pre class="example-preformatted">\epsfysize=<var class="var">dimen</var> |
| 2602 |
</pre></div> |
| 2603 |
|
| 2604 |
<p>in which case the height will be set and the width scaled |
| 2605 |
proportionally. |
| 2606 |
</p> |
| 2607 |
<p>If you set both, both will be honored, but the aspect ratio of the |
| 2608 |
included graphic may necessarily be distorted, i.e., its contents |
| 2609 |
stretched in one direction or the other. |
| 2610 |
</p> |
| 2611 |
<a class="index-entry-id" id="index-_005cepsfsize"></a> |
| 2612 |
<p>You can resize graphics in a more general way by redefining the |
| 2613 |
<code class="code">\epsfsize</code> macro. <code class="code">\epsffile</code> calls this with two |
| 2614 |
parameters: the natural horizontal and vertical sizes of the PostScript |
| 2615 |
graphic. <code class="code">\epsfsize</code> must expand to the desired horizontal size, |
| 2616 |
that is, the width of the <code class="code">\vbox</code>. Schematically: |
| 2617 |
</p> |
| 2618 |
<div class="example"> |
| 2619 |
<pre class="example-preformatted">\def\epsfsize#1#2{<var class="var">body</var>} |
| 2620 |
</pre></div> |
| 2621 |
|
| 2622 |
<p>Some useful definitions of <var class="var">body</var>: |
| 2623 |
</p> |
| 2624 |
<dl class="table"> |
| 2625 |
<dt>‘<samp class="samp">\epsfxsize</samp>’</dt> |
| 2626 |
<dd><p>This definition (the default) enables the default features listed above, |
| 2627 |
by setting <code class="code">\epsfxsize</code> to the same value it had before the macro |
| 2628 |
was called. |
| 2629 |
</p> |
| 2630 |
</dd> |
| 2631 |
<dt>‘<samp class="samp">#1</samp>’</dt> |
| 2632 |
<dd><p>Force the natural size by returning the first parameter (the original |
| 2633 |
width). |
| 2634 |
</p> |
| 2635 |
</dd> |
| 2636 |
<dt>‘<samp class="samp">0pt</samp>’</dt> |
| 2637 |
<dd><p>A special case, equivalent to ‘<samp class="samp">#1</samp>’. |
| 2638 |
</p> |
| 2639 |
</dd> |
| 2640 |
<dt>‘<samp class="samp">0.5#1</samp>’</dt> |
| 2641 |
<dd><p>Scale to half the natural size. |
| 2642 |
</p> |
| 2643 |
</dd> |
| 2644 |
<dt>‘<samp class="samp">\hsize</samp>’</dt> |
| 2645 |
<dd><p>Scale to the current <code class="code">\hsize</code>. (In LaTeX, use <code class="code">\textwidth</code> |
| 2646 |
instead of <code class="code">\hsize</code>.) |
| 2647 |
</p> |
| 2648 |
</dd> |
| 2649 |
<dt>‘<samp class="samp">\ifnum#1>\hsize\hsize\else#1\fi</samp>’</dt> |
| 2650 |
<dd><p>If the natural width is greater than the current <code class="code">\hsize</code>, scale to |
| 2651 |
<code class="code">\hsize</code>, otherwise use the natural width. |
| 2652 |
</p> |
| 2653 |
</dd> |
| 2654 |
</dl> |
| 2655 |
|
| 2656 |
<a class="index-entry-id" id="index-DVI-magnification"></a> |
| 2657 |
<a class="index-entry-id" id="index-magnification_002c-DVI"></a> |
| 2658 |
<a class="index-entry-id" id="index-_005cmagnification"></a> |
| 2659 |
<p>For compatibility with other PostScript drivers, it is possible to turn |
| 2660 |
off the default scaling of included figures by the DVI magnification |
| 2661 |
with the following TeX command: |
| 2662 |
</p> |
| 2663 |
<a class="index-entry-id" id="index-_002fmagscale"></a> |
| 2664 |
<div class="example"> |
| 2665 |
<pre class="example-preformatted">\special{! /magscale false def} |
| 2666 |
</pre></div> |
| 2667 |
|
| 2668 |
<p>Use of this command is not recommended because it will make the |
| 2669 |
<code class="code">\epsffile</code> graphics the “wrong” size if global magnification is |
| 2670 |
being used, and it will cause any PostScript graphics to appear |
| 2671 |
improperly scaled and out of position if a DVI to DVI program is used to |
| 2672 |
scale or otherwise modify the document. |
| 2673 |
</p> |
| 2674 |
<a class="index-entry-id" id="index-bop_002dhook-1"></a> |
| 2675 |
<p>DVI magnification is not applied to any output from code you write in |
| 2676 |
‘<samp class="samp">bop-hook</samp>’ or its ilk (see <a class="pxref" href="#PostScript-hooks">PostScript hooks</a>), |
| 2677 |
</p> |
| 2678 |
|
| 2679 |
<hr> |
| 2680 |
</div> |
| 2681 |
<div class="subsubsection-level-extent" id="EPSF-clipping"> |
| 2682 |
<div class="nav-panel"> |
| 2683 |
<p> |
| 2684 |
Previous: <a href="#EPSF-scaling" accesskey="p" rel="prev">EPSF scaling</a>, Up: <a href="#EPSF-macros" accesskey="u" rel="up">Using the EPSF macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 2685 |
</div> |
| 2686 |
<h4 class="subsubsection" id="EPSF-clipping-1"><span>5.1.3.2 EPSF clipping<a class="copiable-link" href="#EPSF-clipping-1"> ¶</a></span></h4> |
| 2687 |
|
| 2688 |
<a class="index-entry-id" id="index-clipping-of-EPSF"></a> |
| 2689 |
<a class="index-entry-id" id="index-bounding-box_002c-inaccurate"></a> |
| 2690 |
<a class="index-entry-id" id="index-text-in-figures_002c-chopped-off"></a> |
| 2691 |
<a class="index-entry-id" id="index-lines-in-figures_002c-wrong-width"></a> |
| 2692 |
|
| 2693 |
<p>By default, clipping is disabled for included EPSF images. This is |
| 2694 |
because clipping to the bounding box dimensions often cuts off a |
| 2695 |
small portion of the figure, due to slightly inaccurate bounding |
| 2696 |
box arguments. The problem might be subtle; lines around the boundary |
| 2697 |
of the image might be half their intended width, or the tops or |
| 2698 |
bottoms of some text annotations might be sliced off. If you want to |
| 2699 |
turn clipping on, just use the command |
| 2700 |
</p> |
| 2701 |
<div class="example"> |
| 2702 |
<pre class="example-preformatted">\epsfclipon |
| 2703 |
</pre></div> |
| 2704 |
|
| 2705 |
<p>and to turn clipping back off, use |
| 2706 |
</p> |
| 2707 |
<div class="example"> |
| 2708 |
<pre class="example-preformatted">\epsfclipoff |
| 2709 |
</pre></div> |
| 2710 |
|
| 2711 |
|
| 2712 |
<hr> |
| 2713 |
</div> |
| 2714 |
</div> |
| 2715 |
<div class="subsection-level-extent" id="psfile-special"> |
| 2716 |
<div class="nav-panel"> |
| 2717 |
<p> |
| 2718 |
Next: <a href="#Dynamic-creation-of-graphics" accesskey="n" rel="next">Dynamic creation of PostScript graphics files</a>, Previous: <a href="#EPSF-macros" accesskey="p" rel="prev">Using the EPSF macros</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 2719 |
</div> |
| 2720 |
<h4 class="subsection" id="psfile-special-1"><span>5.1.4 ‘<samp class="samp">psfile</samp>’ special<a class="copiable-link" href="#psfile-special-1"> ¶</a></span></h4> |
| 2721 |
|
| 2722 |
<a class="index-entry-id" id="index-psfile-special"></a> |
| 2723 |
|
| 2724 |
<p>The basic special for file inclusion is as follows: |
| 2725 |
</p> |
| 2726 |
<div class="example"> |
| 2727 |
<pre class="example-preformatted">\special{psfile=<var class="var">filename</var>.ps <span class="r">[</span><var class="var">key</var>=<var class="var">value</var><span class="r">]</span> ... } |
| 2728 |
</pre></div> |
| 2729 |
|
| 2730 |
<p>This downloads the PostScript file <samp class="file"><var class="var">filename</var>.ps</samp> such that |
| 2731 |
the current point will be the origin of the PostScript coordinate |
| 2732 |
system. The optional <var class="var">key</var><code class="t">=</code><var class="var">value</var> assignments allow you to |
| 2733 |
specify transformations on the PostScript. |
| 2734 |
</p> |
| 2735 |
<p>The possible <var class="var">key</var>s are: |
| 2736 |
</p> |
| 2737 |
<dl class="table"> |
| 2738 |
<dt><a id="index-hoffset-_0028psfile-special-option_0029"></a><span>‘<samp class="samp">hoffset</samp>’<a class="copiable-link" href="#index-hoffset-_0028psfile-special-option_0029"> ¶</a></span></dt> |
| 2739 |
<dd><p>The horizontal offset (default 0). |
| 2740 |
</p> |
| 2741 |
</dd> |
| 2742 |
<dt><a id="index-voffset-_0028psfile-special-option_0029"></a><span>‘<samp class="samp">voffset</samp>’<a class="copiable-link" href="#index-voffset-_0028psfile-special-option_0029"> ¶</a></span></dt> |
| 2743 |
<dd><p>The vertical offset (default 0). |
| 2744 |
</p> |
| 2745 |
</dd> |
| 2746 |
<dt><a id="index-hsize-_0028psfile-special-option_0029"></a><span>‘<samp class="samp">hsize</samp>’<a class="copiable-link" href="#index-hsize-_0028psfile-special-option_0029"> ¶</a></span></dt> |
| 2747 |
<dd><p>The horizontal clipping size (default 612). |
| 2748 |
</p> |
| 2749 |
</dd> |
| 2750 |
<dt><a id="index-vsize-_0028psfile-special-option_0029"></a><span>‘<samp class="samp">vsize</samp>’<a class="copiable-link" href="#index-vsize-_0028psfile-special-option_0029"> ¶</a></span></dt> |
| 2751 |
<dd><p>The vertical clipping size (default 792). |
| 2752 |
</p> |
| 2753 |
</dd> |
| 2754 |
<dt><a id="index-hscale-_0028psfile-special-option_0029"></a><span>‘<samp class="samp">hscale</samp>’<a class="copiable-link" href="#index-hscale-_0028psfile-special-option_0029"> ¶</a></span></dt> |
| 2755 |
<dd><p>The horizontal scaling factor, as a percentage (default 100). |
| 2756 |
</p> |
| 2757 |
</dd> |
| 2758 |
<dt><a id="index-vscale-_0028psfile-special-option_0029"></a><span>‘<samp class="samp">vscale</samp>’<a class="copiable-link" href="#index-vscale-_0028psfile-special-option_0029"> ¶</a></span></dt> |
| 2759 |
<dd><p>The vertical scaling factor, as a percentage (default 100). |
| 2760 |
</p> |
| 2761 |
</dd> |
| 2762 |
<dt><a id="index-angle-_0028psfile-special-option_0029"></a><span>‘<samp class="samp">angle</samp>’<a class="copiable-link" href="#index-angle-_0028psfile-special-option_0029"> ¶</a></span></dt> |
| 2763 |
<dd><p>The rotation, in degrees (default 0). |
| 2764 |
</p> |
| 2765 |
</dd> |
| 2766 |
<dt><a id="index-clip-_0028psfile-special-option_0029"></a><span>‘<samp class="samp">clip</samp>’<a class="copiable-link" href="#index-clip-_0028psfile-special-option_0029"> ¶</a></span></dt> |
| 2767 |
<dd><p>Enable clipping to the bounding box (default disabled). |
| 2768 |
</p> |
| 2769 |
</dd> |
| 2770 |
<dt><a class="index-entry-id" id="index-lly-_0028psfile-special-option_0029"></a> |
| 2771 |
<a class="index-entry-id" id="index-urx-_0028psfile-special-option_0029"></a> |
| 2772 |
<a class="index-entry-id" id="index-ury-_0028psfile-special-option_0029"></a> |
| 2773 |
<a id="index-llx-_0028psfile-special-option_0029"></a><span>‘<samp class="samp">llx, lly, urx, ury</samp>’<a class="copiable-link" href="#index-llx-_0028psfile-special-option_0029"> ¶</a></span></dt> |
| 2774 |
<dd><p>Bounding box of the included image, just as in a <code class="code">%%BoundingBox</code> |
| 2775 |
comment. Values are in big points, and may be fractional. |
| 2776 |
</p> |
| 2777 |
</dd> |
| 2778 |
<dt><a class="index-entry-id" id="index-rwi-_0028psfile-special-option_0029"></a> |
| 2779 |
<a id="index-rhi-_0028psfile-special-option_0029"></a><span>‘<samp class="samp">rhi, rwi</samp>’<a class="copiable-link" href="#index-rhi-_0028psfile-special-option_0029"> ¶</a></span></dt> |
| 2780 |
<dd><p>Desired width and height of the resulting figure in the output, in |
| 2781 |
tenths of big points (720 to the inch); may be fractional. |
| 2782 |
</p> |
| 2783 |
<p>If both <code class="code">rwi</code> and <code class="code">rhi</code> are nonzero, the picture is scaled, |
| 2784 |
possibly losing aspect ratio. If only one of <code class="code">rwi</code> and |
| 2785 |
<code class="code">rhi</code> is nonzero, the picture is scaled, preserving aspect ratio. |
| 2786 |
</p> |
| 2787 |
</dd> |
| 2788 |
</dl> |
| 2789 |
|
| 2790 |
<p>The offsets and sizes are given in PostScript units (big points). |
| 2791 |
Thus, for example: |
| 2792 |
</p> |
| 2793 |
<div class="example"> |
| 2794 |
<pre class="example-preformatted">\special{psfile=foo.ps hoffset=72 hscale=90 vscale=90} |
| 2795 |
</pre></div> |
| 2796 |
|
| 2797 |
<p>will shift the graphics produced by file <samp class="file">foo.ps</samp> right by one inch |
| 2798 |
and will draw it at 0.9 times normal size. Offsets are given relative |
| 2799 |
to the point of the special command, and are unaffected by scaling or |
| 2800 |
rotation. Rotation is counterclockwise about the origin. The order of |
| 2801 |
operations is to rotate the figure, scale it, then offset it. |
| 2802 |
</p> |
| 2803 |
<p>For compatibility with older PostScript drivers, it is possible to change |
| 2804 |
the units that ‘<samp class="samp">hscale</samp>’ and ‘<samp class="samp">vscale</samp>’ are given in. This can be |
| 2805 |
done by redefining ‘<samp class="samp">@scaleunit</samp>’ |
| 2806 |
<a class="index-entry-id" id="index-scaleunit"></a> |
| 2807 |
in ‘<samp class="samp">SDict</samp>’ |
| 2808 |
<a class="index-entry-id" id="index-SDict"></a> |
| 2809 |
by a TeX command such as |
| 2810 |
</p> |
| 2811 |
<div class="example"> |
| 2812 |
<pre class="example-preformatted">\special{! /@scaleunit 1 def} |
| 2813 |
</pre></div> |
| 2814 |
|
| 2815 |
<p>The ‘<samp class="samp">@scaleunit</samp>’ variable, which is by default 100, is what |
| 2816 |
‘<samp class="samp">hscale</samp>’ and ‘<samp class="samp">vscale</samp>’ are divided by to yield an absolute |
| 2817 |
scale factor. |
| 2818 |
</p> |
| 2819 |
|
| 2820 |
<hr> |
| 2821 |
</div> |
| 2822 |
<div class="subsection-level-extent" id="Dynamic-creation-of-graphics"> |
| 2823 |
<div class="nav-panel"> |
| 2824 |
<p> |
| 2825 |
Next: <a href="#Fonts-in-figures" accesskey="n" rel="next">Fonts in figures</a>, Previous: <a href="#psfile-special" accesskey="p" rel="prev">‘<samp class="samp">psfile</samp>’ special</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 2826 |
</div> |
| 2827 |
<h4 class="subsection" id="Dynamic-creation-of-PostScript-graphics-files"><span>5.1.5 Dynamic creation of PostScript graphics files<a class="copiable-link" href="#Dynamic-creation-of-PostScript-graphics-files"> ¶</a></span></h4> |
| 2828 |
|
| 2829 |
<a class="index-entry-id" id="index-dynamic-creation-of-graphics"></a> |
| 2830 |
<a class="index-entry-id" id="index-compressed-PostScript"></a> |
| 2831 |
<a class="index-entry-id" id="index-uncompressing-PostScript"></a> |
| 2832 |
|
| 2833 |
<p>PostScript is an excellent page description language—but it does tend |
| 2834 |
to be rather verbose. Compressing PostScript graphics files can reduce |
| 2835 |
them by factor of five or more. For this reason, if the name of an |
| 2836 |
included PostScript file ends with <samp class="file">.Z</samp> or <samp class="file">.gz</samp>, Dvips |
| 2837 |
automatically runs ‘<samp class="samp">gzip -d</samp>’. For example: |
| 2838 |
</p> |
| 2839 |
<div class="example"> |
| 2840 |
<pre class="example-preformatted">\epsffile[72 72 540 720]{foo.ps.gz} |
| 2841 |
</pre></div> |
| 2842 |
|
| 2843 |
<p>Since the results of such a command are not accessible to TeX, if you |
| 2844 |
use this facility with the <samp class="file">epsf</samp> macros, you need to supply the |
| 2845 |
bounding box parameter yourself, as shown. |
| 2846 |
</p> |
| 2847 |
<p>More generally, if the filename parameter to one of the graphics |
| 2848 |
inclusion techniques starts with a left quote (‘<samp class="samp">`</samp>’), the parameter |
| 2849 |
is instead interpreted as a command to execute that will send the actual |
| 2850 |
file to standard output. For example: |
| 2851 |
</p> |
| 2852 |
<div class="example"> |
| 2853 |
<pre class="example-preformatted">\special{psfile="`gnuplot foo"} |
| 2854 |
</pre></div> |
| 2855 |
|
| 2856 |
<a class="index-entry-id" id="index-gnuplot"></a> |
| 2857 |
<p>to include the file <samp class="file">foo</samp>. Of course, the command to be executed |
| 2858 |
can be anything, including using a file conversion utility such as |
| 2859 |
<samp class="file">tek2ps</samp> or whatever is appropriate. This feature can be disabled |
| 2860 |
with the ‘<samp class="samp">-R</samp>’ command-line option or ‘<samp class="samp">R</samp>’ configuration option. |
| 2861 |
</p> |
| 2862 |
|
| 2863 |
<hr> |
| 2864 |
</div> |
| 2865 |
<div class="subsection-level-extent" id="Fonts-in-figures"> |
| 2866 |
<div class="nav-panel"> |
| 2867 |
<p> |
| 2868 |
Previous: <a href="#Dynamic-creation-of-graphics" accesskey="p" rel="prev">Dynamic creation of PostScript graphics files</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 2869 |
</div> |
| 2870 |
<h4 class="subsection" id="Fonts-in-figures-1"><span>5.1.6 Fonts in figures<a class="copiable-link" href="#Fonts-in-figures-1"> ¶</a></span></h4> |
| 2871 |
|
| 2872 |
<a class="index-entry-id" id="index-figures-and-fonts"></a> |
| 2873 |
<a class="index-entry-id" id="index-fonts_002c-in-PostScript-figures"></a> |
| 2874 |
<a class="index-entry-id" id="index-_0025_002aFont"></a> |
| 2875 |
|
| 2876 |
<p>You can use any font available to TeX and Dvips within a graphics |
| 2877 |
file by putting a <code class="code">%*Font:</code> line in the leading commentary of the |
| 2878 |
file. Schematically, this looks like: |
| 2879 |
</p> |
| 2880 |
<div class="example"> |
| 2881 |
<pre class="example-preformatted">%*Font: <var class="var">tfmname</var> <var class="var">scaledbp</var> <var class="var">designbp</var> <var class="var">hex-start</var>:<var class="var">hex-bitstring</var> |
| 2882 |
</pre></div> |
| 2883 |
|
| 2884 |
<p>Here is the meaning of each of these elements: |
| 2885 |
</p> |
| 2886 |
<dl class="table"> |
| 2887 |
<dt><var class="var">tfmname</var></dt> |
| 2888 |
<dd><p>The TeX TFM filename, e.g., <samp class="file">cmr10</samp>. You can give the same |
| 2889 |
<var class="var">tfmname</var> on more than one ‘<samp class="samp">%*Font</samp>’ line; this is useful when |
| 2890 |
the number of characters from the font used needs a longer |
| 2891 |
<var class="var">hex-bitstring</var> (see item below) than conveniently fits on one line. |
| 2892 |
</p> |
| 2893 |
</dd> |
| 2894 |
<dt><var class="var">scaledbp</var></dt> |
| 2895 |
<dd><p>The size at which you are using the font, in PostScript points (TeX |
| 2896 |
big points). 72<span class="dmn">bp</span> = 72.27<span class="dmn">pt</span> = 1<span class="dmn">in</span>. |
| 2897 |
</p> |
| 2898 |
</dd> |
| 2899 |
<dt><var class="var">designbp</var></dt> |
| 2900 |
<dd><p>The designsize of the font, again in PostScript points. This should |
| 2901 |
match the value in the TFM file <var class="var">tfmname</var>. Thus, for <samp class="file">cmr10</samp>, |
| 2902 |
it should be ‘<samp class="samp">9.96265</samp>’. |
| 2903 |
</p> |
| 2904 |
</dd> |
| 2905 |
<dt><var class="var">hex-start</var></dt> |
| 2906 |
<dd><p>The character code of the first character used from the font, specified |
| 2907 |
as two ASCII hexadecimal characters, e.g., ‘<samp class="samp">4b</samp>’ or ‘<samp class="samp">4B</samp>’ for |
| 2908 |
‘<samp class="samp">K</samp>’. |
| 2909 |
</p> |
| 2910 |
</dd> |
| 2911 |
<dt><var class="var">hex-bitstring</var></dt> |
| 2912 |
<dd><p>An arbitrary number of ASCII hexadecimal digits specifying which |
| 2913 |
characters following (and including) <var class="var">hex-start</var> are used. This is |
| 2914 |
treated as a bitmap. For example, if your figure used the single letter |
| 2915 |
‘<samp class="samp">K</samp>’, you would use ‘<samp class="samp">4b:8</samp>’ for <var class="var">hex-start</var> and |
| 2916 |
<var class="var">hex-bitstring</var>. If it used ‘<samp class="samp">KLMNP</samp>’, you would use |
| 2917 |
‘<samp class="samp">4b:f4</samp>’. |
| 2918 |
</p> |
| 2919 |
</dd> |
| 2920 |
</dl> |
| 2921 |
|
| 2922 |
<p>MetaPost’s output figures contain lines like this for bitmap fonts used |
| 2923 |
in a MetaPost label (see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#MetaPost">MetaPost</a> in <cite class="cite">Web2c</cite>). |
| 2924 |
</p> |
| 2925 |
|
| 2926 |
<hr> |
| 2927 |
</div> |
| 2928 |
</div> |
| 2929 |
<div class="section-level-extent" id="Header-files"> |
| 2930 |
<div class="nav-panel"> |
| 2931 |
<p> |
| 2932 |
Next: <a href="#Literal-PS" accesskey="n" rel="next">Literal PostScript</a>, Previous: <a href="#PostScript-figures" accesskey="p" rel="prev">PostScript figures</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 2933 |
</div> |
| 2934 |
<h3 class="section" id="PostScript-header-files"><span>5.2 PostScript header files<a class="copiable-link" href="#PostScript-header-files"> ¶</a></span></h3> |
| 2935 |
|
| 2936 |
<a class="index-entry-id" id="index-header-files_002c-defined"></a> |
| 2937 |
<a class="index-entry-id" id="index-PostScript-header-files"></a> |
| 2938 |
|
| 2939 |
<p><em class="dfn">Header files</em> are bits of PostScript included in the output file; |
| 2940 |
generally they provide support for special features, rather than |
| 2941 |
producing any printed output themselves. You can explicitly request |
| 2942 |
downloading header files if necessary for some figure, or to achieve |
| 2943 |
some special effect. |
| 2944 |
</p> |
| 2945 |
<a class="index-entry-id" id="index-psheaderdir"></a> |
| 2946 |
<a class="index-entry-id" id="index-_002epro-prologue-files"></a> |
| 2947 |
<a class="index-entry-id" id="index-_002elpro-long-prologue-files"></a> |
| 2948 |
<p>Dvips includes some headers on its own initiative, to implement features |
| 2949 |
such as PostScript font reencoding, bitmap font downloading, handling of |
| 2950 |
<code class="code">\special</code>’s, and so on. These standard headers are the |
| 2951 |
<samp class="file">.pro</samp> files (for “prologue”) in the installation directory |
| 2952 |
‘<samp class="samp">$(psheaderdir)</samp>’; they are created from the <samp class="file">.lpro</samp> (“long |
| 2953 |
prologue”) files in the distribution by stripping |
| 2954 |
comments, squeezing blank lines, etc., for maximum efficiency. If you |
| 2955 |
want to peruse one of the standard header files, read the <samp class="file">.lpro</samp> |
| 2956 |
version. |
| 2957 |
</p> |
| 2958 |
<a class="index-entry-id" id="index-userdict_002c-and-dictionary-files"></a> |
| 2959 |
<a class="index-entry-id" id="index-dictionary_002c-userdict"></a> |
| 2960 |
<p>The PostScript dictionary stack will be at the ‘<samp class="samp">userdict</samp>’ level |
| 2961 |
when header files are included. |
| 2962 |
</p> |
| 2963 |
|
| 2964 |
|
| 2965 |
<ul class="mini-toc"> |
| 2966 |
<li><a href="#Including-headers-from-TeX" accesskey="1">Including headers from TeX</a></li> |
| 2967 |
<li><a href="#Including-headers-from-the-command-line" accesskey="2">Including headers from the command line</a></li> |
| 2968 |
<li><a href="#Headers-and-memory-usage" accesskey="3">Headers and memory usage</a></li> |
| 2969 |
</ul> |
| 2970 |
<hr> |
| 2971 |
<div class="subsection-level-extent" id="Including-headers-from-TeX"> |
| 2972 |
<div class="nav-panel"> |
| 2973 |
<p> |
| 2974 |
Next: <a href="#Including-headers-from-the-command-line" accesskey="n" rel="next">Including headers from the command line</a>, Up: <a href="#Header-files" accesskey="u" rel="up">PostScript header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 2975 |
</div> |
| 2976 |
<h4 class="subsection" id="Including-headers-from-TeX-1"><span>5.2.1 Including headers from TeX<a class="copiable-link" href="#Including-headers-from-TeX-1"> ¶</a></span></h4> |
| 2977 |
|
| 2978 |
<a class="index-entry-id" id="index-including-headers-in-TeX"></a> |
| 2979 |
<a class="index-entry-id" id="index-header_003dfile-_005cspecial"></a> |
| 2980 |
<a class="index-entry-id" id="index-TeX_002c-including-headers-in"></a> |
| 2981 |
|
| 2982 |
<a class="index-entry-id" id="index-headers_002c-including-in-TeX"></a> |
| 2983 |
<p>In order to get a particular graphic file to work, a certain font or |
| 2984 |
header file might need to be sent first. The Dvips program provides |
| 2985 |
support for this with the ‘<samp class="samp">header</samp>’ <code class="code">\special</code>. For instance, |
| 2986 |
to ensure that <samp class="file">foo.ps</samp> gets downloaded: |
| 2987 |
</p> |
| 2988 |
<div class="example"> |
| 2989 |
<pre class="example-preformatted">\special{header=foo.ps} |
| 2990 |
</pre></div> |
| 2991 |
|
| 2992 |
<a class="index-entry-id" id="index-fonts_002c-as-header-files"></a> |
| 2993 |
<p>As another example, if you have some PostScript code that uses a |
| 2994 |
PostScript font not built into your printer, you must download it to the |
| 2995 |
printer. If the font isn’t used elsewhere in the document, Dvips can’t |
| 2996 |
know you’ve used it, so you must include it in the same way, as in: |
| 2997 |
</p> |
| 2998 |
<div class="example"> |
| 2999 |
<pre class="example-preformatted">\special{header=putr.pfa} |
| 3000 |
</pre></div> |
| 3001 |
|
| 3002 |
<p>to include the font definition file for Adobe Utopia Roman. |
| 3003 |
</p> |
| 3004 |
<p>The <code class="code">header</code> also special allows for specifying some additional |
| 3005 |
code that should be inserted into the PostScript document before and after |
| 3006 |
the file itself, as follows: |
| 3007 |
</p> |
| 3008 |
<div class="example"> |
| 3009 |
<pre class="example-preformatted">\special{header={foo.ps} pre={pre code} post={post code}} |
| 3010 |
</pre></div> |
| 3011 |
|
| 3012 |
<a class="index-entry-id" id="index-before-header_002c-inserting-code"></a> |
| 3013 |
<a class="index-entry-id" id="index-after-header_002c-inserting-code"></a> |
| 3014 |
<a class="index-entry-id" id="index-pre-code-before-headers"></a> |
| 3015 |
<a class="index-entry-id" id="index-post-code-after-headers"></a> |
| 3016 |
<p>This will insert <code class="code">pre code</code> just before <samp class="file">foo.ps</samp> and |
| 3017 |
<code class="code">post code</code> just after. It is required to use the (balanced) |
| 3018 |
braces in <em class="emph">all</em> of the arguments, including the <code class="code">header</code>, |
| 3019 |
when using this extended syntax. |
| 3020 |
</p> |
| 3021 |
<p>This allows, for instance, dynamic headers, where some of the content |
| 3022 |
depends on settings from the user in (La)TeX. Another application |
| 3023 |
is the inclusion of graphics inside the PostScript header, so that |
| 3024 |
they can be reused throughout the document, as with logs. That avoids |
| 3025 |
including the same graphic several times. This is implemented in the |
| 3026 |
<samp class="file">graphics/graphicx-psmin</samp> package. |
| 3027 |
</p> |
| 3028 |
<p>This extended syntax has one additional feature. When Dvips finds the |
| 3029 |
extended syntax, it will also look in the installed <samp class="file">tex/</samp> |
| 3030 |
tree(s) for the header file (<samp class="file">foo.ps</samp> in our example), and not |
| 3031 |
only in the current directory and dvips tree as the original syntax |
| 3032 |
does. This is because common graphics may well come with packages |
| 3033 |
which are installed in the <samp class="file">tex/</samp> tree. |
| 3034 |
</p> |
| 3035 |
|
| 3036 |
<hr> |
| 3037 |
</div> |
| 3038 |
<div class="subsection-level-extent" id="Including-headers-from-the-command-line"> |
| 3039 |
<div class="nav-panel"> |
| 3040 |
<p> |
| 3041 |
Next: <a href="#Headers-and-memory-usage" accesskey="n" rel="next">Headers and memory usage</a>, Previous: <a href="#Including-headers-from-TeX" accesskey="p" rel="prev">Including headers from TeX</a>, Up: <a href="#Header-files" accesskey="u" rel="up">PostScript header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3042 |
</div> |
| 3043 |
<h4 class="subsection" id="Including-headers-from-the-command-line-1"><span>5.2.2 Including headers from the command line<a class="copiable-link" href="#Including-headers-from-the-command-line-1"> ¶</a></span></h4> |
| 3044 |
|
| 3045 |
<a class="index-entry-id" id="index-including-headers-from-the-command-line"></a> |
| 3046 |
<a class="index-entry-id" id="index-command-line_002c-including-headers-from"></a> |
| 3047 |
<a class="index-entry-id" id="index-headers_002c-including-from-the-command-line"></a> |
| 3048 |
|
| 3049 |
<p>You can include headers when you run Dvips, as well as from your |
| 3050 |
document (see the previous section). To do this, run Dvips with the |
| 3051 |
option ‘<samp class="samp">-P <var class="var">header</var></samp>’; this will read the file |
| 3052 |
<samp class="file">config.<var class="var">header</var></samp>, which in turn can specify a header file to |
| 3053 |
be downloaded with the ‘<samp class="samp">h</samp>’ option. See <a class="xref" href="#Configuration-file-commands">Configuration file commands</a>. These files are called <samp class="file"><var class="var">header</var>.cfg</samp> on MS-DOS. |
| 3054 |
</p> |
| 3055 |
<a class="index-entry-id" id="index-duplex-printers"></a> |
| 3056 |
<a class="index-entry-id" id="index-simplex-mode-on-duplex-printers"></a> |
| 3057 |
<a class="index-entry-id" id="index-screen-frequencies_002c-setting"></a> |
| 3058 |
<p>You can arrange for the same file to serve as a ‘<samp class="samp">-P</samp>’ config file |
| 3059 |
and the downloadable header file, by starting the lines of PostScript |
| 3060 |
code with a space, leaving only the ‘<samp class="samp">h</samp>’ line and any comments |
| 3061 |
starting in the first column. As an example, see |
| 3062 |
<samp class="file">contrib/volker/config.*</samp> (<samp class="file">contrib/volker/*.cfg</samp> on MS-DOS). |
| 3063 |
(These files also perform useful functions: controlling duplex/simplex |
| 3064 |
mode on duplex printers, and setting various screen frequencies; |
| 3065 |
<samp class="file">contrib/volker/README</samp> explains further.) |
| 3066 |
</p> |
| 3067 |
|
| 3068 |
<hr> |
| 3069 |
</div> |
| 3070 |
<div class="subsection-level-extent" id="Headers-and-memory-usage"> |
| 3071 |
<div class="nav-panel"> |
| 3072 |
<p> |
| 3073 |
Previous: <a href="#Including-headers-from-the-command-line" accesskey="p" rel="prev">Including headers from the command line</a>, Up: <a href="#Header-files" accesskey="u" rel="up">PostScript header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3074 |
</div> |
| 3075 |
<h4 class="subsection" id="Headers-and-memory-usage-1"><span>5.2.3 Headers and memory usage<a class="copiable-link" href="#Headers-and-memory-usage-1"> ¶</a></span></h4> |
| 3076 |
|
| 3077 |
<a class="index-entry-id" id="index-headers-and-memory-usage"></a> |
| 3078 |
<a class="index-entry-id" id="index-memory-usage_002c-and-headers"></a> |
| 3079 |
|
| 3080 |
<a class="index-entry-id" id="index-sections-of-output-file_002c-and-memory"></a> |
| 3081 |
<a class="index-entry-id" id="index-output-file_002c-sectioning-of"></a> |
| 3082 |
<p>Dvips tries to avoid overflowing the printer’s memory by splitting the |
| 3083 |
output files into “sections” (see the ‘<samp class="samp">-i</samp>’ option in <a class="ref" href="#Option-details">Option details</a>). Therefore, for all header files, Dvips debits the printer VM |
| 3084 |
budget by some value. If the header file has, in its leading |
| 3085 |
commentary a line of the form |
| 3086 |
</p> |
| 3087 |
<a class="index-entry-id" id="index-VMusage"></a> |
| 3088 |
<a class="index-entry-id" id="index-_0025_0025VMusage"></a> |
| 3089 |
<div class="example"> |
| 3090 |
<pre class="example-preformatted">%%VMusage: <var class="var">min</var> <var class="var">max</var> |
| 3091 |
</pre></div> |
| 3092 |
|
| 3093 |
<p>then <var class="var">max</var> is used. If there is no <code class="code">%%VMusage</code> line, then |
| 3094 |
the size (in bytes) of the header file is used as an approximation. |
| 3095 |
If you want a file to be ignored in the sectioning calculations, use |
| 3096 |
‘<samp class="samp">%%VMusage: 0 0</samp>’. |
| 3097 |
</p> |
| 3098 |
<p>Illustrations (figure files) are also checked for <code class="code">%%VMusage</code> line. |
| 3099 |
</p> |
| 3100 |
<p>Therefore, if your document uses very large fonts or very large |
| 3101 |
included figures, Dvips might take it upon itself to split the output |
| 3102 |
into unwanted sections. If this causes problems, the simplest |
| 3103 |
solution is to use ‘<samp class="samp">dvips -Pmaxmem</samp>’, which reads the Dvips file |
| 3104 |
<samp class="file">config.maxmem</samp>, which sets Dvips’s idea of the memory available |
| 3105 |
to a very large number. (See the ‘<samp class="samp">m</samp>’ item in <a class="ref" href="#Configuration-file-commands">Configuration file commands</a>.) |
| 3106 |
</p> |
| 3107 |
|
| 3108 |
<hr> |
| 3109 |
</div> |
| 3110 |
</div> |
| 3111 |
<div class="section-level-extent" id="Literal-PS"> |
| 3112 |
<div class="nav-panel"> |
| 3113 |
<p> |
| 3114 |
Next: <a href="#Hypertext" accesskey="n" rel="next">HyperTeXt</a>, Previous: <a href="#Header-files" accesskey="p" rel="prev">PostScript header files</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3115 |
</div> |
| 3116 |
<h3 class="section" id="Literal-PostScript"><span>5.3 Literal PostScript<a class="copiable-link" href="#Literal-PostScript"> ¶</a></span></h3> |
| 3117 |
|
| 3118 |
<a class="index-entry-id" id="index-literal-PostScript_002c-using"></a> |
| 3119 |
<a class="index-entry-id" id="index-PostScript-code_002c-literal"></a> |
| 3120 |
|
| 3121 |
<p>You can include literal PostScript code in your document in several ways. |
| 3122 |
</p> |
| 3123 |
|
| 3124 |
|
| 3125 |
<ul class="mini-toc"> |
| 3126 |
<li><a href="#g_t_0022-special" accesskey="1"><code class="code">"</code> special: Literal PostScript</a></li> |
| 3127 |
<li><a href="#ps-special" accesskey="2">‘<samp class="samp">ps</samp>’ special</a></li> |
| 3128 |
<li><a href="#Literal-headers" accesskey="3">Literal headers: ‘<samp class="samp">!</samp>’ <code class="code">\special</code></a></li> |
| 3129 |
<li><a href="#PostScript-hooks" accesskey="4">PostScript hooks</a></li> |
| 3130 |
<li><a href="#Literal-examples" accesskey="5">Literal examples</a></li> |
| 3131 |
</ul> |
| 3132 |
<hr> |
| 3133 |
<div class="subsection-level-extent" id="g_t_0022-special"> |
| 3134 |
<div class="nav-panel"> |
| 3135 |
<p> |
| 3136 |
Next: <a href="#ps-special" accesskey="n" rel="next">‘<samp class="samp">ps</samp>’ special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3137 |
</div> |
| 3138 |
<h4 class="subsection" id="g_t_0022-special_003a-Literal-PostScript"><span>5.3.1 <code class="code">"</code> special: Literal PostScript<a class="copiable-link" href="#g_t_0022-special_003a-Literal-PostScript"> ¶</a></span></h4> |
| 3139 |
|
| 3140 |
<a class="index-entry-id" id="index-_0022-special-_0028literal-PostScript_0029"></a> |
| 3141 |
|
| 3142 |
<p>For simple graphics, or just for experimentation, literal PostScript |
| 3143 |
code can be included. Simply use a <code class="code">\special</code> beginning with a |
| 3144 |
double quote character ‘<samp class="samp">"</samp>’; there is no matching closing ‘<samp class="samp">"</samp>’. |
| 3145 |
</p> |
| 3146 |
<p>For instance, the following (simple) graphic: |
| 3147 |
</p> |
| 3148 |
|
| 3149 |
<p>was created by typing: |
| 3150 |
</p> |
| 3151 |
<div class="example"> |
| 3152 |
<pre class="example-preformatted">\vbox to 100bp{\vss % a bp is the same as a PostScript unit |
| 3153 |
\special{" newpath 0 0 moveto 100 100 lineto 394 0 lineto |
| 3154 |
closepath gsave 0.8 setgray fill grestore stroke}} |
| 3155 |
</pre></div> |
| 3156 |
|
| 3157 |
<p>You are responsible for leaving space for such literal graphics, as with |
| 3158 |
the <code class="code">\vbox</code> above. |
| 3159 |
</p> |
| 3160 |
|
| 3161 |
<hr> |
| 3162 |
</div> |
| 3163 |
<div class="subsection-level-extent" id="ps-special"> |
| 3164 |
<div class="nav-panel"> |
| 3165 |
<p> |
| 3166 |
Next: <a href="#Literal-headers" accesskey="n" rel="next">Literal headers: ‘<samp class="samp">!</samp>’ <code class="code">\special</code></a>, Previous: <a href="#g_t_0022-special" accesskey="p" rel="prev"><code class="code">"</code> special: Literal PostScript</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3167 |
</div> |
| 3168 |
<h4 class="subsection" id="ps-special-1"><span>5.3.2 ‘<samp class="samp">ps</samp>’ special<a class="copiable-link" href="#ps-special-1"> ¶</a></span></h4> |
| 3169 |
|
| 3170 |
<a class="index-entry-id" id="index-ps-special"></a> |
| 3171 |
|
| 3172 |
<a class="index-entry-id" id="index-save_002frestore_002c-and-specials"></a> |
| 3173 |
<p>Generally, Dvips encloses specials in a PostScript save/restore pair, |
| 3174 |
guaranteeing that the special will have no effect on the rest of the |
| 3175 |
document. The ‘<samp class="samp">ps</samp>’ special, however, allows you to insert literal |
| 3176 |
PostScript instructions without this protective shield; you should |
| 3177 |
understand what you’re doing (and you shouldn’t change the PostScript |
| 3178 |
graphics state unless you are willing to take the consequences). This |
| 3179 |
command can take many forms because it has had a torturous history; any |
| 3180 |
of the following will work: |
| 3181 |
</p> |
| 3182 |
<div class="example"> |
| 3183 |
<pre class="example-preformatted">\special{ps:<var class="var">text</var>} |
| 3184 |
\special{ps::<var class="var">text</var>} |
| 3185 |
\special{ps::[begin]<var class="var">text</var>} |
| 3186 |
\special{ps::[end]<var class="var">text</var>} |
| 3187 |
\special{ps::[nobreak]<var class="var">text</var>} |
| 3188 |
</pre></div> |
| 3189 |
|
| 3190 |
<p>(with longer forms taking precedence over shorter forms, when they are |
| 3191 |
present). ‘<samp class="samp">ps::</samp>’ and ‘<samp class="samp">ps::[end]</samp>’ do no positioning, so they |
| 3192 |
can be used to continue PostScript literals started with ‘<samp class="samp">ps:</samp>’ or |
| 3193 |
‘<samp class="samp">ps::[begin]</samp>’. |
| 3194 |
</p> |
| 3195 |
<p>Literal PostScript instructions after ‘<samp class="samp">ps::[nobreak]</samp>’ are |
| 3196 |
<em class="emph">not</em> broken into lines. This feature may be used to include |
| 3197 |
PostScript comments, for example. |
| 3198 |
</p> |
| 3199 |
<a class="index-entry-id" id="index-plotfile_002c-ps-subspecial"></a> |
| 3200 |
<p>In addition, the variant |
| 3201 |
</p> |
| 3202 |
<div class="example"> |
| 3203 |
<pre class="example-preformatted">\special{ps: plotfile <var class="var">filename</var>} |
| 3204 |
</pre></div> |
| 3205 |
|
| 3206 |
<a class="index-entry-id" id="index-rotate_002etex"></a> |
| 3207 |
<p>inserts the contents of <var class="var">filename</var> verbatim into the output (except |
| 3208 |
for omitting lines that begin with %). An example of the proper use of |
| 3209 |
literal specials can be found in the file <samp class="file">rotate.tex</samp>, which makes |
| 3210 |
it easy to typeset text turned in multiples of 90 degrees. |
| 3211 |
</p> |
| 3212 |
|
| 3213 |
<hr> |
| 3214 |
</div> |
| 3215 |
<div class="subsection-level-extent" id="Literal-headers"> |
| 3216 |
<div class="nav-panel"> |
| 3217 |
<p> |
| 3218 |
Next: <a href="#PostScript-hooks" accesskey="n" rel="next">PostScript hooks</a>, Previous: <a href="#ps-special" accesskey="p" rel="prev">‘<samp class="samp">ps</samp>’ special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3219 |
</div> |
| 3220 |
<h4 class="subsection" id="Literal-headers_003a-_0021-_005cspecial"><span>5.3.3 Literal headers: ‘<samp class="samp">!</samp>’ <code class="code">\special</code><a class="copiable-link" href="#Literal-headers_003a-_0021-_005cspecial"> ¶</a></span></h4> |
| 3221 |
|
| 3222 |
<a class="index-entry-id" id="index-literal-headers"></a> |
| 3223 |
<a class="index-entry-id" id="index-SDict-dictionary"></a> |
| 3224 |
|
| 3225 |
<a class="index-entry-id" id="index-_0021-special-_0028literal-PS-header_0029"></a> |
| 3226 |
<a class="index-entry-id" id="index-dictionary_002c-SDict"></a> |
| 3227 |
<p>You can download literal PostScript header code in your TeX document, |
| 3228 |
for use with (for example) literal graphics code that you include later. |
| 3229 |
The text of a <code class="code">\special</code> beginning with an ‘<samp class="samp">!</samp>’ is copied into |
| 3230 |
the output file. A dictionary <code class="code">SDict</code> will be current when this |
| 3231 |
code is executed; Dvips arranges for <code class="code">SDict</code> to be first on the |
| 3232 |
dictionary stack when any PostScript graphic is included, whether |
| 3233 |
literally (the ‘<samp class="samp">"</samp>’ special) or through macros (e.g., |
| 3234 |
<samp class="file">epsf.tex</samp>). |
| 3235 |
</p> |
| 3236 |
<p>For example: |
| 3237 |
</p> |
| 3238 |
<div class="example"> |
| 3239 |
<pre class="example-preformatted">\special{! /reset { 0 0 moveto} def} |
| 3240 |
</pre></div> |
| 3241 |
|
| 3242 |
|
| 3243 |
<hr> |
| 3244 |
</div> |
| 3245 |
<div class="subsection-level-extent" id="PostScript-hooks"> |
| 3246 |
<div class="nav-panel"> |
| 3247 |
<p> |
| 3248 |
Next: <a href="#Literal-examples" accesskey="n" rel="next">Literal examples</a>, Previous: <a href="#Literal-headers" accesskey="p" rel="prev">Literal headers: ‘<samp class="samp">!</samp>’ <code class="code">\special</code></a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3249 |
</div> |
| 3250 |
<h4 class="subsection" id="PostScript-hooks-1"><span>5.3.4 PostScript hooks<a class="copiable-link" href="#PostScript-hooks-1"> ¶</a></span></h4> |
| 3251 |
|
| 3252 |
<a class="index-entry-id" id="index-PostScript-hooks"></a> |
| 3253 |
|
| 3254 |
<p>Besides including literal PostScript at a particular place in your |
| 3255 |
document (as described in the previous section), you can also arrange to |
| 3256 |
execute arbitrary PostScript code at particular times while the |
| 3257 |
PostScript is printing. |
| 3258 |
</p> |
| 3259 |
<a class="index-entry-id" id="index-bop_002dhook-2"></a> |
| 3260 |
<a class="index-entry-id" id="index-eop_002dhook"></a> |
| 3261 |
<a class="index-entry-id" id="index-start_002dhook"></a> |
| 3262 |
<a class="index-entry-id" id="index-end_002dhook"></a> |
| 3263 |
<p>If any of the PostScript names <code class="code">bop-hook</code>, <code class="code">eop-hook</code>, |
| 3264 |
<code class="code">start-hook</code>, or <code class="code">end-hook</code> are defined in <code class="code">userdict</code>, |
| 3265 |
they will be executed at the beginning of a page, end of a page, start |
| 3266 |
of the document, and end of a document, respectively. |
| 3267 |
</p> |
| 3268 |
<a class="index-entry-id" id="index-draft-copies"></a> |
| 3269 |
<a class="index-entry-id" id="index-dated-output"></a> |
| 3270 |
<p>When these macros are executed, the default PostScript coordinate system |
| 3271 |
and origin is in effect. Such macros can be defined in headers added by |
| 3272 |
the ‘<samp class="samp">-h</samp>’ option or the ‘<samp class="samp">header=</samp>’ special, and might be useful |
| 3273 |
for writing, for instance, ‘DRAFT’ across the entire page, or, with the |
| 3274 |
aid of a shell script, dating the document. These macros are executed |
| 3275 |
outside of the save/restore context of the individual pages, so it is |
| 3276 |
possible for them to accumulate information, but if a document must be |
| 3277 |
divided into sections because of memory constraints, such added |
| 3278 |
information will be lost across section breaks. |
| 3279 |
</p> |
| 3280 |
<a class="index-entry-id" id="index-physical-page-number_002c-and-bop_002dhook"></a> |
| 3281 |
<p>The single argument to <code class="code">bop-hook</code> is the physical page number; the |
| 3282 |
first page gets zero, the second one, etc. <code class="code">bop-hook</code> must leave |
| 3283 |
this number on the stack. None of the other hooks are passed arguments. |
| 3284 |
</p> |
| 3285 |
<p>As an example of what can be done, the following special will write |
| 3286 |
a light grey ‘DRAFT’ across each page in the document: |
| 3287 |
</p> |
| 3288 |
<div class="example"> |
| 3289 |
<pre class="example-preformatted">\special{!userdict begin /bop-hook{gsave 200 30 translate |
| 3290 |
65 rotate /Times-Roman findfont 216 scalefont setfont |
| 3291 |
0 0 moveto 0.7 setgray (DRAFT) show grestore}def end} |
| 3292 |
</pre></div> |
| 3293 |
|
| 3294 |
<a class="index-entry-id" id="index-_0025_0025Page_002c-and-multi_002dpage-information"></a> |
| 3295 |
<p>Using <code class="code">bop-hook</code> or <code class="code">eop-hook</code> to preserve information across |
| 3296 |
pages breaks compliance with the Adobe document structuring conventions, |
| 3297 |
so if you use any such tricks, you may also want to use the ‘<samp class="samp">-N</samp>’ |
| 3298 |
option to turn off structured comments (such as ‘<samp class="samp">%%Page</samp>’). |
| 3299 |
Otherwise, programs that read your file will assume its pages are |
| 3300 |
independent. |
| 3301 |
</p> |
| 3302 |
|
| 3303 |
<hr> |
| 3304 |
</div> |
| 3305 |
<div class="subsection-level-extent" id="Literal-examples"> |
| 3306 |
<div class="nav-panel"> |
| 3307 |
<p> |
| 3308 |
Previous: <a href="#PostScript-hooks" accesskey="p" rel="prev">PostScript hooks</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3309 |
</div> |
| 3310 |
<h4 class="subsection" id="Literal-examples-1"><span>5.3.5 Literal examples<a class="copiable-link" href="#Literal-examples-1"> ¶</a></span></h4> |
| 3311 |
|
| 3312 |
<a class="index-entry-id" id="index-literal-PostScript_002c-examples"></a> |
| 3313 |
<a class="index-entry-id" id="index-examples-of-literal-PostScript"></a> |
| 3314 |
|
| 3315 |
<p>To finish off this section, the following examples of literal PostScript |
| 3316 |
are presented without explanation: |
| 3317 |
</p> |
| 3318 |
<div class="example"> |
| 3319 |
<pre class="example-preformatted">\def\rotninety{\special{ps:currentpoint currentpoint translate 90 |
| 3320 |
rotate neg exch neg exch translate}}\font\huge=cmbx10 at 14.4truept |
| 3321 |
\setbox0=\hbox to0pt{\huge A\hss}\vskip16truept\centerline{\copy0 |
| 3322 |
\special{ps:gsave}\rotninety\copy0\rotninety\copy0\rotninety |
| 3323 |
\box0\special{ps:grestore}}\vskip16truept |
| 3324 |
</pre></div> |
| 3325 |
|
| 3326 |
|
| 3327 |
|
| 3328 |
<div class="example"> |
| 3329 |
<pre class="example-preformatted">\vbox to 2truein{\special{ps:gsave 0.3 setgray}\hrule height 2in |
| 3330 |
width\hsize\vskip-2in\special{ps:grestore}\font\big=cminch\big |
| 3331 |
\vss\special{ps:gsave 1 setgray}\vbox to 0pt{\vskip2pt |
| 3332 |
\line{\hss\hskip4pt NEAT\hss}\vss}\special{ps:0 setgray}% |
| 3333 |
\hbox{\raise2pt\line{\hss NEAT\hss}\special{ps:grestore}}\vss} |
| 3334 |
</pre></div> |
| 3335 |
|
| 3336 |
|
| 3337 |
<a class="index-entry-id" id="index-_005crotninety"></a> |
| 3338 |
<a class="index-entry-id" id="index-gsave_002fgrestore_002c-and-literal-PS"></a> |
| 3339 |
<a class="index-entry-id" id="index-save_002frestore_002c-and-literal-PS"></a> |
| 3340 |
<p>Some caveats are in order, however. Make sure that each <code class="code">gsave</code> is |
| 3341 |
matched with a <code class="code">grestore</code> on the same page. Do not use <code class="code">save</code> |
| 3342 |
and <code class="code">restore</code>; they can interact with the PostScript generated by |
| 3343 |
Dvips if care is not taken. Try to understand what the above macros are |
| 3344 |
doing before writing your own. The <code class="code">\rotninety</code> macro especially |
| 3345 |
has a useful trick that appears again and again. |
| 3346 |
</p> |
| 3347 |
|
| 3348 |
<hr> |
| 3349 |
</div> |
| 3350 |
</div> |
| 3351 |
<div class="section-level-extent" id="Hypertext"> |
| 3352 |
<div class="nav-panel"> |
| 3353 |
<p> |
| 3354 |
Previous: <a href="#Literal-PS" accesskey="p" rel="prev">Literal PostScript</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3355 |
</div> |
| 3356 |
<h3 class="section" id="HyperTeXt"><span>5.4 HyperTeXt<a class="copiable-link" href="#HyperTeXt"> ¶</a></span></h3> |
| 3357 |
|
| 3358 |
<a class="index-entry-id" id="index-hypertext-support"></a> |
| 3359 |
|
| 3360 |
<a class="index-entry-id" id="index-_002dz"></a> |
| 3361 |
<a class="index-entry-id" id="index-html-specials"></a> |
| 3362 |
<a class="index-entry-id" id="index-pdfmark"></a> |
| 3363 |
<p>Dvips has support for producing hypertext PostScript documents. If you |
| 3364 |
specify the ‘<samp class="samp">-z</samp>’ option, the <samp class="file">html:</samp> specials described below |
| 3365 |
will be converted into ‘<samp class="samp">pdfmark</samp>’ PostScript operators to specify |
| 3366 |
links. Without ‘<samp class="samp">-z</samp>’, <samp class="file">html:</samp> specials are ignored. |
| 3367 |
</p> |
| 3368 |
<a class="index-entry-id" id="index-distiller_002c-for-PDF-files"></a> |
| 3369 |
<a class="index-entry-id" id="index-PDF-files_002c-making-1"></a> |
| 3370 |
<p>The resulting PostScript can then be processed by a distiller program to |
| 3371 |
make a PDF file. (It can still be handled by ordinary PostScript |
| 3372 |
interpreters as well.) Various versions of both PC and Unix distillers |
| 3373 |
are supported; Ghostscript includes limited distiller support |
| 3374 |
(see <a class="pxref" href="#Ghostscript-installation">Ghostscript installation</a>). |
| 3375 |
</p> |
| 3376 |
<p>By far the most common LaTeX package used to create hyperlinked |
| 3377 |
output is <code class="code">hyperref</code> (<a class="url" href="https://ctan.org/pkg/hyperref">https://ctan.org/pkg/hyperref</a>). For |
| 3378 |
plain TeX, the Eplain package has some hyperlink support |
| 3379 |
(<a class="url" href="https://tug.org/eplain">https://tug.org/eplain</a>). |
| 3380 |
</p> |
| 3381 |
<a class="index-entry-id" id="index-Doyle_002c-Mark"></a> |
| 3382 |
<a class="index-entry-id" id="index-Bhattacharya_002c-Tanmoy"></a> |
| 3383 |
<a class="index-entry-id" id="index-dvihps_002c-hyperdvi-to-PostScript"></a> |
| 3384 |
<p>This hypertext support (and original form of the documentation) was |
| 3385 |
written by Mark Doyle and Tanmoy Bhattacharya as the ‘<samp class="samp">dvihps</samp>’ |
| 3386 |
program. |
| 3387 |
</p> |
| 3388 |
|
| 3389 |
|
| 3390 |
<ul class="mini-toc"> |
| 3391 |
<li><a href="#Hypertext-caveats" accesskey="1">Hypertext caveats</a></li> |
| 3392 |
<li><a href="#Hypertext-specials" accesskey="2">Hypertext specials</a></li> |
| 3393 |
</ul> |
| 3394 |
<hr> |
| 3395 |
<div class="subsection-level-extent" id="Hypertext-caveats"> |
| 3396 |
<div class="nav-panel"> |
| 3397 |
<p> |
| 3398 |
Next: <a href="#Hypertext-specials" accesskey="n" rel="next">Hypertext specials</a>, Up: <a href="#Hypertext" accesskey="u" rel="up">HyperTeXt</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3399 |
</div> |
| 3400 |
<h4 class="subsection" id="Hypertext-caveats-1"><span>5.4.1 Hypertext caveats<a class="copiable-link" href="#Hypertext-caveats-1"> ¶</a></span></h4> |
| 3401 |
|
| 3402 |
<a class="index-entry-id" id="index-hypertext-caveats"></a> |
| 3403 |
|
| 3404 |
<a class="index-entry-id" id="index-Computer-Modern-in-PostScript"></a> |
| 3405 |
<a class="index-entry-id" id="index-hypertext-and-bitmap-fonts"></a> |
| 3406 |
<a class="index-entry-id" id="index-hypertext-caveats-1"></a> |
| 3407 |
<a class="index-entry-id" id="index-embedding-Type-1-fonts"></a> |
| 3408 |
<a class="index-entry-id" id="index-PDF-files_002c-font-quality"></a> |
| 3409 |
<p>If you intend to go all the way to PDF, you may want to use the standard |
| 3410 |
35 PostScript fonts exclusively, since other fonts are embedded as |
| 3411 |
bitmaps by default. The Adobe PDF readers are extremely slow when |
| 3412 |
dealing with bitmap fonts and the results look terrible on the screen. |
| 3413 |
Printouts will probably look fine, but may not take full advantage of a |
| 3414 |
high-resolution printer. Alternatively, you can have your fonts |
| 3415 |
embedded as Type 1 scalable outlines. The resulting PostScript files |
| 3416 |
may be larger, but can be effectively rasterized at any resolution. |
| 3417 |
They can also be converted to PDF files that can be used effectively at |
| 3418 |
any screen or printer resolution. |
| 3419 |
</p> |
| 3420 |
<p>To get the TeX fonts embedded in the PostScript file as Type 1 fonts, |
| 3421 |
add ‘<samp class="samp">-Ppdf</samp>’ to the dvips command line switches. The printout |
| 3422 |
for a run should look something like this: |
| 3423 |
</p> |
| 3424 |
<div class="example smallexample"> |
| 3425 |
<pre class="example-preformatted"> dvips report -Ppdf -o report.ps |
| 3426 |
This is dvips(k) 5.86 Copyright 1999 Radical Eye Software (www.radicaleye.com) |
| 3427 |
' TeX output 2001.06.15:0837' -> report.ps |
| 3428 |
<tex.pro><alt-rule.pro><texc.pro><texps.pro><special.pro>. |
| 3429 |
<cmbx9.pfb><cmsy6.pfb><cmsy7.pfb><cmr5.pfb><cmex10.pfb><cmr9.pfb> |
| 3430 |
<cmmi7.pfb><cmsy10.pfb><cmmib10.pfb><cmmi10.pfb><cmti10.pfb> |
| 3431 |
<cmr7.pfb><cmbx10.pfb><cmr10.pfb><cmti9.pfb><cmr12.pfb><cmbx12.pfb> |
| 3432 |
[1] [2<mean1.ps>] [3<bounce1-00.ps>] [4] |
| 3433 |
</pre></div> |
| 3434 |
|
| 3435 |
<p>An entry like "<cmr10.pfb>" indicates success: dvips found the Computer |
| 3436 |
Modern Roman 10 point font in a PostScript Font Binary file, translated |
| 3437 |
it to an ASCII encoding, and embedded it. You can confirm this by |
| 3438 |
examining the PostScript output file, looking for the section starting |
| 3439 |
<code class="code">%%BeginFont: CMR10</code> followed by an entry <code class="code">/FontType 1 def</code>. |
| 3440 |
</p> |
| 3441 |
<p>The ‘<samp class="samp">-Ppdf</samp>’ option requires that the relevant outline |
| 3442 |
(<samp class="file">.pfa</samp> or <samp class="file">.pfb</samp>) files be installed (see <a class="pxref" href="#Font-concepts">Font concepts</a>). For example, the <samp class="file">cmr10</samp> file might be in |
| 3443 |
<samp class="file">/usr/share/texmf/fonts/type1/bluesky/cm/cmr10.pfb</samp>. Your TeX |
| 3444 |
distribution may make those fonts available in a separate optional |
| 3445 |
package (e.g., <code class="code">tetex-extra</code> in Debian). Failing that, |
| 3446 |
commercial versions of the Computer Modern fonts are available from |
| 3447 |
Blue Sky; public domain versions, in particular, the lm |
| 3448 |
and cm-super font families, are available from CTAN and in TeX |
| 3449 |
distributions. |
| 3450 |
</p> |
| 3451 |
<p>You can convert a PostScript file to PDF using <code class="code">distill</code>, which |
| 3452 |
comes with Adobe Acrobat, or <code class="code">ps2pdf</code>, which comes with |
| 3453 |
Ghostscript. The <code class="code">ps2pdf</code> that comes with <code class="code">Ghostscript</code> |
| 3454 |
version 6.0 or earlier will not embed Type 1 fonts. Current |
| 3455 |
recommendations are GNU Ghostscript 6.51 or Aladdin Ghostscript 7.0. |
| 3456 |
You can check the fonts in a PDF file with Acrobat Reader by selecting |
| 3457 |
the menu entries ‘<samp class="samp">File|Document Info|Fonts</samp>’. |
| 3458 |
</p> |
| 3459 |
<a class="index-entry-id" id="index-psi-character-missing"></a> |
| 3460 |
<a class="index-entry-id" id="index-trailing-spaces_002c-dropped"></a> |
| 3461 |
<a class="index-entry-id" id="index-spaces_002c-dropped-trailing"></a> |
| 3462 |
<p>Also, the Adobe distillers prior to 2.1 drop trailing space characters |
| 3463 |
(character code 32) from strings. Unfortunately, the PostScript fonts |
| 3464 |
use this character code for characters other than space (notably the |
| 3465 |
Greek letter psi in the <code class="code">Symbol</code> font), and so these characters are |
| 3466 |
dropped. This bug is fixed in version 2.1. |
| 3467 |
</p> |
| 3468 |
<p>If you can’t upgrade, one workaround is to change all the trailing |
| 3469 |
blanks in strings to a character code that isn’t in the font. This works |
| 3470 |
because the default behavior is to substitute a blank for a missing |
| 3471 |
character, i.e., the distiller is fooled into substituting the right |
| 3472 |
character. For instance, with the Blue Sky fonts, you can globally |
| 3473 |
replace ‘<samp class="samp"> )</samp>’ with ‘<samp class="samp">\200)</samp>’ (with <code class="code">sed</code>, for example) and |
| 3474 |
get the desired result. With the public domain fonts, you will probably |
| 3475 |
have to use a character code in the range 128 to 191 since these fonts |
| 3476 |
duplicate the first 32 characters starting at 192 to avoid MS-DOS |
| 3477 |
problems. |
| 3478 |
</p> |
| 3479 |
<p>For more information on the use of TeX to produce PDF files, see the |
| 3480 |
article “Creating quality Adobe PDF files from TeX with DVIPS” by |
| 3481 |
Kendall Whitehouse of Adobe. Adobe seems not to offer the article any |
| 3482 |
more, but copies are available elsewhere: |
| 3483 |
</p><div class="display"> |
| 3484 |
<pre class="display-preformatted"><a class="url" href="http://www.math.hawaii.edu/~ralph/MathOnWeb/TeXPDF.html">http://www.math.hawaii.edu/~ralph/MathOnWeb/TeXPDF.html</a> |
| 3485 |
<a class="url" href="http://www.utdallas.edu/~cantrell/online/543e.html">http://www.utdallas.edu/~cantrell/online/543e.html</a> |
| 3486 |
</pre></div> |
| 3487 |
|
| 3488 |
|
| 3489 |
<hr> |
| 3490 |
</div> |
| 3491 |
<div class="subsection-level-extent" id="Hypertext-specials"> |
| 3492 |
<div class="nav-panel"> |
| 3493 |
<p> |
| 3494 |
Previous: <a href="#Hypertext-caveats" accesskey="p" rel="prev">Hypertext caveats</a>, Up: <a href="#Hypertext" accesskey="u" rel="up">HyperTeXt</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3495 |
</div> |
| 3496 |
<h4 class="subsection" id="Hypertext-specials-1"><span>5.4.2 Hypertext specials<a class="copiable-link" href="#Hypertext-specials-1"> ¶</a></span></h4> |
| 3497 |
|
| 3498 |
<a class="index-entry-id" id="index-hypertext-specials"></a> |
| 3499 |
<a class="index-entry-id" id="index-specials_002c-hypertext"></a> |
| 3500 |
|
| 3501 |
<a class="index-entry-id" id="index-Smith_002c-Arthur"></a> |
| 3502 |
<p>Current support for the World Wide Web in the TeX system does not |
| 3503 |
involve modifying TeX itself. We need only define some specials; |
| 3504 |
Arthur Smith (<a class="email" href="mailto:[email protected]">[email protected]</a>), Tanmoy Bhattacharya, and Paul |
| 3505 |
Ginsparg originally proposed and implemented the following: |
| 3506 |
</p><div class="example"> |
| 3507 |
<pre class="example-preformatted">html:<a href="<var class="var">xurl</var>"> |
| 3508 |
html:<a name="<var class="var">name</var>"> |
| 3509 |
html:</a> |
| 3510 |
html:<img src="<var class="var">xurl</var>"> |
| 3511 |
html:<base href="<var class="var">xurl</var>"> |
| 3512 |
</pre></div> |
| 3513 |
|
| 3514 |
<p>Like all TeX <code class="code">\special</code>’s, these produce no visible output, and |
| 3515 |
are uninterpreted by TeX itself. They are instructions to DVI |
| 3516 |
processors only. |
| 3517 |
</p> |
| 3518 |
<a class="index-entry-id" id="index-uniform-resource-locator"></a> |
| 3519 |
<a class="index-entry-id" id="index-extended-URL"></a> |
| 3520 |
<a class="index-entry-id" id="index-URL_002c-extended-for-TeX"></a> |
| 3521 |
<a class="index-entry-id" id="index-Murphy_002c-Tim"></a> |
| 3522 |
<p>Here, <var class="var">xurl</var> is a standard WWW uniform resource locator (URL), |
| 3523 |
possibly extended with a ‘<samp class="samp">#<var class="var">type</var>.<var class="var">string</var></samp>’ construct, |
| 3524 |
where <var class="var">type</var> is ‘<samp class="samp">page</samp>’, ‘<samp class="samp">section</samp>’, ‘<samp class="samp">equation</samp>’, |
| 3525 |
‘<samp class="samp">reference</samp>’ (for bibliographic references), ‘<samp class="samp">figure</samp>’, |
| 3526 |
‘<samp class="samp">table</samp>’, etc. For example, |
| 3527 |
</p><div class="example smallexample"> |
| 3528 |
<pre class="example-preformatted">\special{html:<a href="http://www.maths.tcd.ie/~tim/ch1.dvi#equation.1.1">} |
| 3529 |
</pre></div> |
| 3530 |
<p>is a link to equation (1.1) in an example document by Tim Murphy. |
| 3531 |
</p> |
| 3532 |
<a class="index-entry-id" id="index-URL_002c-definition"></a> |
| 3533 |
<p>See the URL <a class="url" href="http://www.w3.org/hypertext/WWW/Addressing/Addressing.html">http://www.w3.org/hypertext/WWW/Addressing/Addressing.html</a> |
| 3534 |
for a precise description of base URL’s. |
| 3535 |
</p> |
| 3536 |
<p>Descriptions of the <code class="code">\special</code>’s: |
| 3537 |
</p><dl class="ftable"> |
| 3538 |
<dt><a id="index-href"></a><span>‘<samp class="samp">href</samp>’<a class="copiable-link" href="#index-href"> ¶</a></span></dt> |
| 3539 |
<dd><a class="index-entry-id" id="index-links_002c-hypertext"></a> |
| 3540 |
<p>Creates links in your TeX document. For example: |
| 3541 |
</p><div class="example"> |
| 3542 |
<pre class="example-preformatted">\special{html:<a href="http://www.tug.org/">}\TeX\ Users |
| 3543 |
Group\special{html:</a>} |
| 3544 |
</pre></div> |
| 3545 |
<p>The user will be able to click on the text ‘TeX Users |
| 3546 |
Group’ while running Xdvi and get to the TUG home page. (By the way, |
| 3547 |
this is for illustration. In practice, you most likely want to use |
| 3548 |
macros to insert the <code class="code">\special</code> commands; reference above.) |
| 3549 |
</p> |
| 3550 |
</dd> |
| 3551 |
<dt><a id="index-name"></a><span>‘<samp class="samp">name</samp>’<a class="copiable-link" href="#index-name"> ¶</a></span></dt> |
| 3552 |
<dd><a class="index-entry-id" id="index-Anderson_002c-Laurie"></a> |
| 3553 |
<p>Defines URL targets in your TeX documents, so links can be |
| 3554 |
resolved. For example: |
| 3555 |
</p><div class="example"> |
| 3556 |
<pre class="example-preformatted">\special{html:<a name="paradise">}Paradise\special{html:</a>} |
| 3557 |
is exactly where you are right now. |
| 3558 |
</pre></div> |
| 3559 |
<p>This will resolve an ‘<samp class="samp">href="#paradise"</samp>’. You’ll also have to |
| 3560 |
change the catcode of ‘<samp class="samp">#</samp>’, etc. It’s usually easiest to use |
| 3561 |
existing macro packages which take care of all the details, such as |
| 3562 |
<samp class="file">hyperref</samp> for LaTeX. The <a class="url" href="http://arxiv.org/hypertex/">HyperTeX FAQ</a> has more information. |
| 3563 |
</p> |
| 3564 |
</dd> |
| 3565 |
<dt><a id="index-img"></a><span>‘<samp class="samp">img</samp>’<a class="copiable-link" href="#index-img"> ¶</a></span></dt> |
| 3566 |
<dd><a class="index-entry-id" id="index-mailcap-and-hypertext"></a> |
| 3567 |
<p>Links to an arbitrary external file. Interactively, a viewer is spawned |
| 3568 |
to read the file according to the file extension and your <samp class="file">mailcap</samp> |
| 3569 |
file (see the Xdvi documentation). |
| 3570 |
</p> |
| 3571 |
</dd> |
| 3572 |
<dt><a id="index-base"></a><span>‘<samp class="samp">base</samp>’<a class="copiable-link" href="#index-base"> ¶</a></span></dt> |
| 3573 |
<dd><p>Defines a base URL that is prepended to all the <code class="code">name</code> targets. |
| 3574 |
Typically unnecessary, as the name of the DVI file being read is used by |
| 3575 |
default. |
| 3576 |
</p></dd> |
| 3577 |
</dl> |
| 3578 |
|
| 3579 |
<p>The ‘<samp class="samp">img</samp>’ and ‘<samp class="samp">base</samp>’ tags are not yet implemented in Dvips or |
| 3580 |
the NeXTSTEP DVI viewer. |
| 3581 |
</p> |
| 3582 |
|
| 3583 |
<hr> |
| 3584 |
</div> |
| 3585 |
</div> |
| 3586 |
</div> |
| 3587 |
<div class="chapter-level-extent" id="PostScript-fonts"> |
| 3588 |
<div class="nav-panel"> |
| 3589 |
<p> |
| 3590 |
Next: <a href="#Color" accesskey="n" rel="next">Color</a>, Previous: <a href="#Interaction-with-PostScript" accesskey="p" rel="prev">Interaction with PostScript</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3591 |
</div> |
| 3592 |
<h2 class="chapter" id="PostScript-fonts-1"><span>6 PostScript fonts<a class="copiable-link" href="#PostScript-fonts-1"> ¶</a></span></h2> |
| 3593 |
|
| 3594 |
<a class="index-entry-id" id="index-PostScript-fonts"></a> |
| 3595 |
|
| 3596 |
<p>Dvips supports the use of PostScript fonts in TeX documents. To use |
| 3597 |
a PostScript font conveniently, you need to prepare a corresponding |
| 3598 |
virtual font; the program Afm2tfm, supplied with Dvips, helps |
| 3599 |
with that. |
| 3600 |
</p> |
| 3601 |
<p>All the necessary support for the standard 35 PostScript fonts |
| 3602 |
(‘<samp class="samp">AvantGarde-Book</samp>’ through ‘<samp class="samp">ZapfDingbats</samp>’), plus other freely |
| 3603 |
or commonly available PostScript fonts is available along with Dvips. |
| 3604 |
To use these fonts, you need do nothing beyond what is mentioned in the |
| 3605 |
installation procedure (see <a class="pxref" href="#Installation">Installation</a>). This chapter is |
| 3606 |
therefore relevant only if you are installing new PostScript fonts not |
| 3607 |
supplied with Dvips. (Or if you’re curious.) |
| 3608 |
</p> |
| 3609 |
|
| 3610 |
|
| 3611 |
<ul class="mini-toc"> |
| 3612 |
<li><a href="#Font-concepts" accesskey="1">Font concepts</a></li> |
| 3613 |
<li><a href="#Making-a-font-available" accesskey="2">Making a PostScript font available</a></li> |
| 3614 |
<li><a href="#Invoking-afm2tfm" accesskey="3">Invoking Afm2tfm</a></li> |
| 3615 |
<li><a href="#psfonts_002emap" accesskey="4"><samp class="file">psfonts.map</samp>: PostScript font catalog</a></li> |
| 3616 |
</ul> |
| 3617 |
<hr> |
| 3618 |
<div class="section-level-extent" id="Font-concepts"> |
| 3619 |
<div class="nav-panel"> |
| 3620 |
<p> |
| 3621 |
Next: <a href="#Making-a-font-available" accesskey="n" rel="next">Making a PostScript font available</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3622 |
</div> |
| 3623 |
<h3 class="section" id="Font-concepts-1"><span>6.1 Font concepts<a class="copiable-link" href="#Font-concepts-1"> ¶</a></span></h3> |
| 3624 |
|
| 3625 |
<a class="index-entry-id" id="index-font-concepts"></a> |
| 3626 |
|
| 3627 |
<p>The information needed to typeset using a particular font is contained |
| 3628 |
in two files: a <em class="dfn">metric file</em> that contains shape-independent |
| 3629 |
information and a <em class="dfn">glyph file</em> that contains the actual shapes of |
| 3630 |
the font’s characters. A <em class="dfn">virtual font</em> is an optional additional |
| 3631 |
file that can specify special ways to construct the characters. TeX |
| 3632 |
itself (or LaTeX) look only at the metric file, but DVI drivers such |
| 3633 |
as Dvips look at all three of these files. |
| 3634 |
</p> |
| 3635 |
<p>An <em class="dfn">encoding file</em> defines the correspondence between the code |
| 3636 |
numbers of the characters in a font and their descriptive names. Two |
| 3637 |
encoding files used together can describe a reencoding that rearranges, |
| 3638 |
i.e., renumbers, the characters of a font. |
| 3639 |
</p> |
| 3640 |
|
| 3641 |
|
| 3642 |
<ul class="mini-toc"> |
| 3643 |
<li><a href="#Metric-files" accesskey="1">Metric files</a></li> |
| 3644 |
<li><a href="#Glyph-files" accesskey="2">Glyph files</a></li> |
| 3645 |
<li><a href="#Virtual-fonts" accesskey="3">Virtual fonts</a></li> |
| 3646 |
<li><a href="#Encodings" accesskey="4">Encodings</a></li> |
| 3647 |
<li><a href="#Bitmap-font-encodings" accesskey="5">Bitmap font encodings</a></li> |
| 3648 |
<li><a href="#PostScript-typesetting" accesskey="6">How PostScript typesets a character</a></li> |
| 3649 |
</ul> |
| 3650 |
<hr> |
| 3651 |
<div class="subsection-level-extent" id="Metric-files"> |
| 3652 |
<div class="nav-panel"> |
| 3653 |
<p> |
| 3654 |
Next: <a href="#Glyph-files" accesskey="n" rel="next">Glyph files</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3655 |
</div> |
| 3656 |
<h4 class="subsection" id="Metric-files-1"><span>6.1.1 Metric files<a class="copiable-link" href="#Metric-files-1"> ¶</a></span></h4> |
| 3657 |
|
| 3658 |
<a class="index-entry-id" id="index-metric-files"></a> |
| 3659 |
|
| 3660 |
<p>A <em class="dfn">metric file</em> describes properties of the font that are |
| 3661 |
independent of what the characters actually look like. Aside from |
| 3662 |
general information about the font itself, a metric file has two kinds |
| 3663 |
of information: information about individual characters, organized by |
| 3664 |
character code, and information about sequences of characters. |
| 3665 |
</p> |
| 3666 |
<p>The per-character information specifies the width, height, depth, and |
| 3667 |
italic correction of each character in the font. Any might be zero. |
| 3668 |
</p> |
| 3669 |
<a class="index-entry-id" id="index-kerning_002c-defined"></a> |
| 3670 |
<a class="index-entry-id" id="index-ligature_002c-defined"></a> |
| 3671 |
<p>In addition to information on individual characters, the metric file |
| 3672 |
specifies <em class="dfn">kerning</em>, i.e., adding or removing space between |
| 3673 |
particular character pairs. It further specifies <em class="dfn">ligature</em> |
| 3674 |
information: when a sequence of input characters should be typeset as a |
| 3675 |
single (presumably different) “ligature” character. For example, it’s |
| 3676 |
traditional for the input ‘<samp class="samp">fi</samp>’ to be typeset as ‘fi’, not as |
| 3677 |
‘<span class="r">f</span><span class="r">i</span>’ (with the dot of the ‘i’ colliding with ‘f’). (In English, |
| 3678 |
the only common ligatures are fi, fl, ff, ffi, and ffl.) |
| 3679 |
</p> |
| 3680 |
<p>Different typesetting systems use different metric file formats: |
| 3681 |
</p> |
| 3682 |
<ul class="itemize mark-bullet"> |
| 3683 |
<li><a class="index-entry-id" id="index-afm-files"></a> |
| 3684 |
<a class="index-entry-id" id="index-_002eafm-Adobe-metric-files"></a> |
| 3685 |
Each PostScript font has an <em class="dfn">Adobe font metrics</em> (‘<samp class="samp">.afm</samp>’) |
| 3686 |
file. These files are plain text, so you can inspect them easily. |
| 3687 |
|
| 3688 |
</li><li><a class="index-entry-id" id="index-tfm-files"></a> |
| 3689 |
<a class="index-entry-id" id="index-_002etfm-TeX-font-metric-files"></a> |
| 3690 |
TeX uses <em class="dfn">TeX font metrics</em> (‘<samp class="samp">.tfm</samp>’) files. When you say |
| 3691 |
‘<samp class="samp">\font = <var class="var">font</var></samp>’ in your TeX document, TeX reads a file |
| 3692 |
named ‘<samp class="samp"><var class="var">font</var>.tfm</samp>’. (Well, except for the <samp class="file">texfonts.map</samp> |
| 3693 |
feature; see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Fontmap">Fontmap</a> in <cite class="cite">Kpathsea</cite>). TeX can then |
| 3694 |
calculate the space occupied by characters from the font when |
| 3695 |
typesetting. In addition, the DVI drivers you use to print or view the |
| 3696 |
DVI file produced by TeX may need to look at the TFM file. |
| 3697 |
|
| 3698 |
<a class="index-entry-id" id="index-property-list-files"></a> |
| 3699 |
<a class="index-entry-id" id="index-tftopl"></a> |
| 3700 |
<a class="index-entry-id" id="index-pltotf"></a> |
| 3701 |
<a class="index-entry-id" id="index-_002epl-property-list-files"></a> |
| 3702 |
<p>TFM files are binary (and hence are typically much smaller than AFM |
| 3703 |
files). You can use the <code class="code">tftopl</code> program (see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#tftopl-invocation">tftopl |
| 3704 |
invocation</a> in <cite class="cite">Web2c</cite>) that comes with TeX to transform a TFM |
| 3705 |
file into a human-readable “property list” (‘<samp class="samp">.pl</samp>’) file. You can |
| 3706 |
also edit a PL file and transform it back to a TeX-readable TFM with |
| 3707 |
the companion program <code class="code">pltotf</code> (see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#pltotf-invocation">pltotf invocation</a> in <cite class="cite">Web2c</cite>). Editing metrics by hand is not something you’re likely to want |
| 3708 |
to do often, but the capability is there. |
| 3709 |
</p> |
| 3710 |
</li><li><a class="index-entry-id" id="index-pfm-files"></a> |
| 3711 |
<a class="index-entry-id" id="index-_002epfm-printer-font-metric-files"></a> |
| 3712 |
ATM and other typesetting systems use <em class="dfn">printer font metric</em> |
| 3713 |
(‘<samp class="samp">.pfm</samp>’) files. These are binary files. They are irrelevant in the |
| 3714 |
TeX world, and not freely available, so we will not discuss them |
| 3715 |
further. |
| 3716 |
|
| 3717 |
</li></ul> |
| 3718 |
|
| 3719 |
<p>The Afm2tfm program distributed with Dvips converts an AFM file |
| 3720 |
to a TFM file and performs other useful transformations as well. |
| 3721 |
See <a class="xref" href="#Invoking-afm2tfm">Invoking Afm2tfm</a>. |
| 3722 |
</p> |
| 3723 |
|
| 3724 |
<hr> |
| 3725 |
</div> |
| 3726 |
<div class="subsection-level-extent" id="Glyph-files"> |
| 3727 |
<div class="nav-panel"> |
| 3728 |
<p> |
| 3729 |
Next: <a href="#Virtual-fonts" accesskey="n" rel="next">Virtual fonts</a>, Previous: <a href="#Metric-files" accesskey="p" rel="prev">Metric files</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3730 |
</div> |
| 3731 |
<h4 class="subsection" id="Glyph-files-1"><span>6.1.2 Glyph files<a class="copiable-link" href="#Glyph-files-1"> ¶</a></span></h4> |
| 3732 |
|
| 3733 |
<a class="index-entry-id" id="index-glyph-files"></a> |
| 3734 |
|
| 3735 |
<p>Although a metric file (see the previous section) contains information |
| 3736 |
about the spatial and other properties of the character at position 75, |
| 3737 |
say, it contains nothing about what the character at position 75 |
| 3738 |
actually looks like. The glyphs—the actual shapes of the letterforms |
| 3739 |
in a font—are defined by other files, which we call glyph files. |
| 3740 |
TeX itself only reads the TFM file for a font; it does not need to |
| 3741 |
know character shapes. |
| 3742 |
</p> |
| 3743 |
<p>A <em class="dfn">glyph file</em> is a file that defines the shapes of the characters |
| 3744 |
in a font. The shapes can be defined either by outlines or by bitmaps. |
| 3745 |
</p> |
| 3746 |
<a class="index-entry-id" id="index-outline-fonts"></a> |
| 3747 |
<a class="index-entry-id" id="index-arcs"></a> |
| 3748 |
<a class="index-entry-id" id="index-splines"></a> |
| 3749 |
<p>PostScript fonts are defined as <em class="dfn">outline fonts</em>: Each character in |
| 3750 |
the font is defined by giving the mathematical curves (lines, arcs, and |
| 3751 |
splines) that define its contours. Different sizes of a character are |
| 3752 |
generated by linearly scaling a single shape. For example, a 10-point |
| 3753 |
‘A’ is simply half the size of a 20-point ‘A’. Nowadays, outline fonts |
| 3754 |
usually also contain <em class="dfn">hints</em>—additional information to improve the |
| 3755 |
appearance of the font at small sizes or low resolutions. |
| 3756 |
</p> |
| 3757 |
<a class="index-entry-id" id="index-Type-1-fonts"></a> |
| 3758 |
<a class="index-entry-id" id="index-pfa-files"></a> |
| 3759 |
<a class="index-entry-id" id="index-pfb-files"></a> |
| 3760 |
<a class="index-entry-id" id="index-_002epfa-printer-font-ascii-files"></a> |
| 3761 |
<a class="index-entry-id" id="index-_002epfb-printer-font-binary-files"></a> |
| 3762 |
<p>Although various kinds of PostScript outline fonts exist, by far the |
| 3763 |
most common, and the only one we will consider, is called <em class="dfn">Type 1</em>. |
| 3764 |
The glyph files for PostScript Type 1 fonts typically have names ending |
| 3765 |
in ‘<samp class="samp">.pfa</samp>’ (“printer font ASCII”) or ‘<samp class="samp">.pfb</samp>’ (“printer font |
| 3766 |
binary”). |
| 3767 |
</p> |
| 3768 |
<a class="index-entry-id" id="index-bitmap-fonts"></a> |
| 3769 |
<a class="index-entry-id" id="index-_002emf-Metafont-source-files"></a> |
| 3770 |
<a class="index-entry-id" id="index-Metafont-source-files"></a> |
| 3771 |
<p>In contrast, glyph files for Computer Modern and the other standard |
| 3772 |
TeX fonts are <em class="dfn">bitmap fonts</em>, generated from Metafont |
| 3773 |
(‘<samp class="samp">.mf</samp>’) descriptions. The Metafont program distributed with TeX |
| 3774 |
generates bitmaps from these descriptions. |
| 3775 |
</p> |
| 3776 |
<a class="index-entry-id" id="index-pk-files"></a> |
| 3777 |
<a class="index-entry-id" id="index-_002ennnpk-packed-font-bitmaps"></a> |
| 3778 |
<p>The glyph files for TeX bitmap fonts are usually stored in |
| 3779 |
<em class="dfn">packed font</em> (PK) files. The names of these files end in |
| 3780 |
‘<samp class="samp">.<var class="var">nnn</var>pk</samp>’, where <var class="var">nnn</var> is the resolution of the font in |
| 3781 |
dots per inch. For example, <samp class="file">cmr10.600pk</samp> contains the bitmaps for |
| 3782 |
the ‘<samp class="samp">cmr10</samp>’ font at a resolution of 600<span class="dmn">dpi</span>. (On DOS |
| 3783 |
filesystems, it’s more likely <samp class="file">dpi600\cmr10.pk</samp>.) |
| 3784 |
</p> |
| 3785 |
<a class="index-entry-id" id="index-gf-files"></a> |
| 3786 |
<a class="index-entry-id" id="index-gftopk"></a> |
| 3787 |
<p>Metafont actually outputs <em class="dfn">generic font</em> (GF) files, e.g., |
| 3788 |
<samp class="file">cmr10.600gf</samp>, but the GF files are usually converted immediately |
| 3789 |
to PK format (using the <code class="code">gftopk</code> utility that comes with TeX) |
| 3790 |
since PK files are smaller and contain the same information. (The GF |
| 3791 |
format is a historical artifact.) |
| 3792 |
</p> |
| 3793 |
|
| 3794 |
<hr> |
| 3795 |
</div> |
| 3796 |
<div class="subsection-level-extent" id="Virtual-fonts"> |
| 3797 |
<div class="nav-panel"> |
| 3798 |
<p> |
| 3799 |
Next: <a href="#Encodings" accesskey="n" rel="next">Encodings</a>, Previous: <a href="#Glyph-files" accesskey="p" rel="prev">Glyph files</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3800 |
</div> |
| 3801 |
<h4 class="subsection" id="Virtual-fonts-1"><span>6.1.3 Virtual fonts<a class="copiable-link" href="#Virtual-fonts-1"> ¶</a></span></h4> |
| 3802 |
|
| 3803 |
<a class="index-entry-id" id="index-virtual-fonts"></a> |
| 3804 |
|
| 3805 |
<p>A <em class="dfn">virtual font</em> is constructed by extracting characters from one |
| 3806 |
or more existing fonts and rearranging them, or synthesizing new |
| 3807 |
characters in various ways. The explanation in this manual is |
| 3808 |
intended to suffice for understanding enough about virtual fonts to |
| 3809 |
use them with Dvips. It isn’t a reference manual on virtual fonts. |
| 3810 |
For more information: The primary document on virtual fonts is |
| 3811 |
Donald E. Knuth, <cite class="cite">TUGboat</cite> 11(1), Apr. 1990, pp. 13–23, |
| 3812 |
“Virtual Fonts: More Fun for Grand Wizards” |
| 3813 |
(<a class="url" href="https://mirror.ctan.org/info/virtual-fonts.knuth">https://mirror.ctan.org/info/virtual-fonts.knuth</a>). (Don’t be |
| 3814 |
intimidated by the subtitle.) |
| 3815 |
</p> |
| 3816 |
<a class="index-entry-id" id="index-vf-files"></a> |
| 3817 |
<a class="index-entry-id" id="index-vpl-files"></a> |
| 3818 |
<p>A virtual font (‘<samp class="samp">.vf</samp>’) file specifies, for each character in the |
| 3819 |
virtual font, a recipe for typesetting that character. A VF file, like |
| 3820 |
a TFM file, is in a compressed binary format. The <code class="code">vftovp</code> and |
| 3821 |
<code class="code">vptovf</code> programs convert a VF file to a human-readable VPL |
| 3822 |
(virtual property list) format and back again. See <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#vftovp-invocation">vftovp |
| 3823 |
invocation</a> in <cite class="cite">Web2c</cite>, and <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#vptovf-invocation">vptovf invocation</a> in <cite class="cite">Web2c</cite>. |
| 3824 |
</p> |
| 3825 |
<a class="index-entry-id" id="index-base-fonts"></a> |
| 3826 |
<p>In the case of a PostScript font <var class="var">f</var> being used in a straightforward |
| 3827 |
way, the recipe says: character <var class="var">i</var> in the VF font is character |
| 3828 |
<var class="var">j</var> in font <var class="var">f</var>. The font <var class="var">f</var> is called a <em class="dfn">base font</em>. |
| 3829 |
For example, the VF file could remap the characters of the PostScript |
| 3830 |
font to the positions where TeX expects to find them. |
| 3831 |
See <a class="xref" href="#Encodings">Encodings</a>. |
| 3832 |
</p> |
| 3833 |
<p>Since TeX reads only TFM files, not VF’s, each VF must have a |
| 3834 |
corresponding TFM for use with TeX. This corresponding TFM is |
| 3835 |
created when you run <code class="code">vptovf</code>. |
| 3836 |
</p> |
| 3837 |
<a class="index-entry-id" id="index-expansion_002c-of-virtual-fonts"></a> |
| 3838 |
<a class="index-entry-id" id="index-virtual-font-expansion"></a> |
| 3839 |
<p>You can <em class="dfn">expand</em> virtual fonts into their base fonts with DVIcopy |
| 3840 |
(see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#dvicopy-invocation">dvicopy invocation</a> in <cite class="cite">Web2c</cite>). This is useful if you are |
| 3841 |
using a DVI translator that doesn’t itself understand vf’s. |
| 3842 |
</p> |
| 3843 |
<a class="index-entry-id" id="index-ptex-JFM"></a> |
| 3844 |
<a class="index-entry-id" id="index-uptex-JFM"></a> |
| 3845 |
<a class="index-entry-id" id="index-Japanese-font-metric-file"></a> |
| 3846 |
<a class="index-entry-id" id="index-JFM-file_002c-and-virtual-font-fallback"></a> |
| 3847 |
<p>If a virtual font has no entry at a given codepoint and the first |
| 3848 |
<code class="code">MAPFONT</code> designates an (u)pTeX JFM, we designate the glyph of |
| 3849 |
the same codepoint in the TFM(JFM) with the smallest font ID. This |
| 3850 |
feature helps to reduce the size of Japanese virtual fonts. For more |
| 3851 |
information about the extensive support of Japanese in TeX, see |
| 3852 |
<a class="url" href="https://github.com/texjporg">https://github.com/texjporg</a>. |
| 3853 |
</p> |
| 3854 |
|
| 3855 |
<hr> |
| 3856 |
</div> |
| 3857 |
<div class="subsection-level-extent" id="Encodings"> |
| 3858 |
<div class="nav-panel"> |
| 3859 |
<p> |
| 3860 |
Next: <a href="#Bitmap-font-encodings" accesskey="n" rel="next">Bitmap font encodings</a>, Previous: <a href="#Virtual-fonts" accesskey="p" rel="prev">Virtual fonts</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3861 |
</div> |
| 3862 |
<h4 class="subsection" id="Encodings-1"><span>6.1.4 Encodings<a class="copiable-link" href="#Encodings-1"> ¶</a></span></h4> |
| 3863 |
|
| 3864 |
<a class="index-entry-id" id="index-encodings"></a> |
| 3865 |
|
| 3866 |
<p>Every font, whatever its type, has an <em class="dfn">encoding</em>, that specifies the |
| 3867 |
correspondence between “logical” characters and character codes. For |
| 3868 |
example, the ASCII encoding specifies that the character numbered 65 |
| 3869 |
(decimal) is an uppercase ‘A’. The encoding does not specify what the |
| 3870 |
character at that position looks like; there are lots of ways to draw an |
| 3871 |
‘A’, and a glyph file (see <a class="pxref" href="#Glyph-files">Glyph files</a>) tells how. Nor does it |
| 3872 |
specify how much space that character occupies; that information is in a |
| 3873 |
metric file (see <a class="pxref" href="#Metric-files">Metric files</a>). |
| 3874 |
</p> |
| 3875 |
<a class="index-entry-id" id="index-Computer-Modern_002c-encoding-of"></a> |
| 3876 |
<p>TeX implicitly assumes a particular encoding for the fonts you use |
| 3877 |
with it. For example, the plain TeX macro <code class="code">\'</code>, which typesets |
| 3878 |
an acute accent over the following letter, assumes the acute accent is |
| 3879 |
at position 19 (decimal). This happens to be true of standard TeX |
| 3880 |
fonts such as Computer Modern, as you might expect, but it is not true |
| 3881 |
of normal PostScript fonts. |
| 3882 |
</p> |
| 3883 |
<p>It’s possible but painful to change all the macros that assume |
| 3884 |
particular character positions. A better solution is to create a new |
| 3885 |
font with the information for the acute accent at position 19, where |
| 3886 |
TeX expects it to be. See <a class="xref" href="#Making-a-font-available">Making a PostScript font available</a>. |
| 3887 |
</p> |
| 3888 |
<a class="index-entry-id" id="index-PostScript-encoding"></a> |
| 3889 |
<a class="index-entry-id" id="index-encoding-files"></a> |
| 3890 |
<a class="index-entry-id" id="index-encoding-vectors_002c-defined"></a> |
| 3891 |
|
| 3892 |
<p>PostScript represents encodings as a sequence of 256 character names |
| 3893 |
called an <em class="dfn">encoding vector</em>. An <em class="dfn">encoding file</em> (‘<samp class="samp">.enc</samp>’) |
| 3894 |
gives such a vector, together with ligature and kerning information |
| 3895 |
(with which we are not concerned at the moment). These encoding files |
| 3896 |
are used by the Afm2tfm program. Encoding files are also downloaded to |
| 3897 |
the PostScript interpreter in your printer if you use one of them in |
| 3898 |
place of the default encoding vector for a particular PostScript font. |
| 3899 |
</p> |
| 3900 |
<a class="index-entry-id" id="index-dvips_002eenc"></a> |
| 3901 |
<a class="index-entry-id" id="index-8r_002eenc"></a> |
| 3902 |
<a class="index-entry-id" id="index-texmext_002eenc"></a> |
| 3903 |
<a class="index-entry-id" id="index-texmital_002eenc"></a> |
| 3904 |
<a class="index-entry-id" id="index-texmsym_002eenc"></a> |
| 3905 |
<a class="index-entry-id" id="index-reencode_002f_002a_002eenc"></a> |
| 3906 |
<p>Examples of encodings: the <samp class="file">dvips.enc</samp> encoding file that comes |
| 3907 |
with the Fontname distribution (<a class="url" href="http://tug.org/fontname">http://tug.org/fontname</a>) is a |
| 3908 |
good (but not perfect) approximation to the TeX encoding for |
| 3909 |
TeX’s Computer Modern text fonts. This is the encoding of the |
| 3910 |
fonts that originated with Dvips, such as <samp class="file">ptmr.tfm</samp>. The |
| 3911 |
distribution includes many other encoding files; for example, |
| 3912 |
<samp class="file">8r.enc</samp>, which is the base font for the current PostScript font |
| 3913 |
distribution, and three corresponding to the TeX mathematics fonts: |
| 3914 |
<samp class="file">texmext.enc</samp> for math extensions, <samp class="file">texmital.enc</samp> for math |
| 3915 |
italics, and <samp class="file">texmsym.enc</samp> for math symbols. |
| 3916 |
</p> |
| 3917 |
|
| 3918 |
<hr> |
| 3919 |
</div> |
| 3920 |
<div class="subsection-level-extent" id="Bitmap-font-encodings"> |
| 3921 |
<div class="nav-panel"> |
| 3922 |
<p> |
| 3923 |
Next: <a href="#PostScript-typesetting" accesskey="n" rel="next">How PostScript typesets a character</a>, Previous: <a href="#Encodings" accesskey="p" rel="prev">Encodings</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3924 |
</div> |
| 3925 |
<h4 class="subsection" id="Bitmap-font-encodings-1"><span>6.1.5 Bitmap font encodings<a class="copiable-link" href="#Bitmap-font-encodings-1"> ¶</a></span></h4> |
| 3926 |
|
| 3927 |
<a class="index-entry-id" id="index-bitmap-font-encodings"></a> |
| 3928 |
<a class="index-entry-id" id="index-font-encodings_002c-bitmap"></a> |
| 3929 |
<a class="index-entry-id" id="index-encodings_002c-for-bitmap-fonts"></a> |
| 3930 |
|
| 3931 |
<p>To dvips, bitmapped fonts do not have any notion of linguistics; they |
| 3932 |
are simply a vector of glyphs. By comparison, PostScript fonts are |
| 3933 |
required to contain an encoding vector that at least provides |
| 3934 |
glyph names; these names can permit PostScript and PDF viewers to |
| 3935 |
extract legible text from PostScript and PDF output. |
| 3936 |
</p> |
| 3937 |
<p>Unlike previous versions, dvips versions 2020 and later add glyph |
| 3938 |
naming information to Type 3 bitmapped fonts (if they can locate such |
| 3939 |
information) as an Encoding vector. This provides some support for |
| 3940 |
search, for copy and paste, and even some limited support for |
| 3941 |
accessibility. The ‘<samp class="samp">bitmapfontenc</samp>’ command line option |
| 3942 |
(see <a class="pxref" href="#Option-details">Option details</a> and <code class="code">bitmapfontenc</code> configuration option |
| 3943 |
(see <a class="pxref" href="#Configuration-file-commands">Configuration file commands</a>) enable and disable this |
| 3944 |
functionality; by default it is set to enabled, without warnings. |
| 3945 |
</p> |
| 3946 |
<a class="index-entry-id" id="index-dvips_002dall_002eenc"></a> |
| 3947 |
<p>To do this, dvips must find encoding information for the bitmapped |
| 3948 |
fonts. It does this by first searching for a font-specific encoding |
| 3949 |
file; for instance, for cmr10, it will search for <samp class="file">dvips-cmr10.enc</samp> |
| 3950 |
in the standard encoding path. If it does not find such a file, it |
| 3951 |
will search for a <samp class="file">dvips-all.enc</samp> file which contains a base set of |
| 3952 |
encodings for many fonts. |
| 3953 |
</p> |
| 3954 |
<p>The specific syntax of an encoding file is unspecified, except that it |
| 3955 |
must be a PostScript fragment that leaves exactly one object on the |
| 3956 |
operand stack. (This is different from the encoding files used to |
| 3957 |
define encodings for PostScript fonts, described earlier). Normally |
| 3958 |
that object is just an array of 256 names; in this case, that array is |
| 3959 |
used as the encoding vector for the font. Alternatively, the object |
| 3960 |
can be a procedure that, when executed, leaves a legal encoding vector |
| 3961 |
on the stack. This second option is made available to support future |
| 3962 |
enhancements that may add additional constructs to the font dictionary |
| 3963 |
to enhance the interpretation of font characters. |
| 3964 |
</p> |
| 3965 |
<p>The <samp class="file">dvips-all.enc</samp> file contains encodings for many fonts, and |
| 3966 |
it is loaded by dvips at most once. The format is just a sequence of |
| 3967 |
font names, one per line, each terminated by a colon, followed by the |
| 3968 |
encoding to use for those files. |
| 3969 |
</p> |
| 3970 |
<a class="index-entry-id" id="index-bounding-box_002c-for-bitmap-fonts"></a> |
| 3971 |
<a class="index-entry-id" id="index-coordinate-system_002c-for-bitmap-fonts"></a> |
| 3972 |
<p>As part of its operation, to enable heuristics in PostScript and |
| 3973 |
PDF viewers to properly identify word breaks and column gutters, |
| 3974 |
dvips also generates a modified font bounding box and a modified |
| 3975 |
font coordinate system. |
| 3976 |
</p> |
| 3977 |
|
| 3978 |
<hr> |
| 3979 |
</div> |
| 3980 |
<div class="subsection-level-extent" id="PostScript-typesetting"> |
| 3981 |
<div class="nav-panel"> |
| 3982 |
<p> |
| 3983 |
Previous: <a href="#Bitmap-font-encodings" accesskey="p" rel="prev">Bitmap font encodings</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 3984 |
</div> |
| 3985 |
<h4 class="subsection" id="How-PostScript-typesets-a-character"><span>6.1.6 How PostScript typesets a character<a class="copiable-link" href="#How-PostScript-typesets-a-character"> ¶</a></span></h4> |
| 3986 |
|
| 3987 |
<a class="index-entry-id" id="index-typesetting-in-PostScript"></a> |
| 3988 |
<a class="index-entry-id" id="index-character-lookup-procedure-in-PostScript"></a> |
| 3989 |
|
| 3990 |
<p>The output of Dvips is a program in the PostScript language that |
| 3991 |
instructs your (presumably PostScript-capable) printer how to typeset |
| 3992 |
your document by transforming it into toner on paper. Your printer, in |
| 3993 |
turn, contains a PostScript interpreter that carries out the |
| 3994 |
instructions in this typesetting program. |
| 3995 |
</p> |
| 3996 |
<p>The program must include the definition of any PostScript fonts that you |
| 3997 |
use in your document. Fonts built into your printer (probably the |
| 3998 |
standard 35: ‘<samp class="samp">Times-Roman</samp>’, ‘<samp class="samp">ZapfDingbats</samp>’, …) are |
| 3999 |
defined within the interpreter itself. Other fonts must be downloaded |
| 4000 |
as pfa or pfb files (see <a class="pxref" href="#Glyph-files">Glyph files</a>) from your host (the computer |
| 4001 |
on which you’re running Dvips). |
| 4002 |
</p> |
| 4003 |
<p>You may be wondering exactly how a PostScript interpreter figures out |
| 4004 |
what character to typeset, with this mass of metrics, glyphs, encodings, |
| 4005 |
and other information. (If you’re not wondering, skip this section |
| 4006 |
…) |
| 4007 |
</p> |
| 4008 |
<a class="index-entry-id" id="index-show-PostScript-operator"></a> |
| 4009 |
<p>The basic PostScript operator for imaging characters is |
| 4010 |
<code class="code">show</code>. Suppose you’ve asked TeX to typeset an ‘S’. This will |
| 4011 |
eventually wind up in the Dvips output as the equivalent of this |
| 4012 |
PostScript operation: |
| 4013 |
</p> |
| 4014 |
<div class="example"> |
| 4015 |
<pre class="example-preformatted">(S) show |
| 4016 |
</pre></div> |
| 4017 |
|
| 4018 |
<p>Here is how PostScript typesets the ‘S’: |
| 4019 |
</p> |
| 4020 |
<ol class="enumerate"> |
| 4021 |
<li> <a class="index-entry-id" id="index-ASCII-character-codes_002c-used-by-PostScript"></a> |
| 4022 |
PostScript interpreters use ASCII; therefore ‘S’ is represented as the |
| 4023 |
integer 83. (Any of the 256 possible characters representable in a |
| 4024 |
standard 8-bit byte can be typeset.) |
| 4025 |
|
| 4026 |
</li><li> <a class="index-entry-id" id="index-current-font_002c-in-PostScript"></a> |
| 4027 |
<a class="index-entry-id" id="index-dictionary_002c-PostScript-language"></a> |
| 4028 |
A PostScript <em class="dfn">dictionary</em> is a mapping of names to arbitrary values. |
| 4029 |
A font, to the interpreter, is a dictionary which contains entries for |
| 4030 |
certain names. (If these entries are missing, the interpreter refuses |
| 4031 |
to do anything with that font.) |
| 4032 |
|
| 4033 |
<p>PostScript has a notion of “the current font”—whatever font is |
| 4034 |
currently being typeset in. |
| 4035 |
</p> |
| 4036 |
</li><li> <a class="index-entry-id" id="index-encoding-vectors_002c-in-Type-1-fonts"></a> |
| 4037 |
<a class="index-entry-id" id="index-Encoding-Type-1-dictionary"></a> |
| 4038 |
One of the mandatory entries in a font dictionary is ‘<samp class="samp">Encoding</samp>’, |
| 4039 |
which defines the encoding vector (see <a class="pxref" href="#Encodings">Encodings</a>) for that font. |
| 4040 |
This vector of 256 names maps each possible input character to a name. |
| 4041 |
|
| 4042 |
</li><li> The interpreter retrieves the entry at position 83 of the encoding |
| 4043 |
vector. This value is a PostScript name: <code class="code">/S</code>. |
| 4044 |
|
| 4045 |
</li><li> <a class="index-entry-id" id="index-CharStrings-Type-1-dictionary"></a> |
| 4046 |
<a class="index-entry-id" id="index-dictionary_002c-CharStrings"></a> |
| 4047 |
For Type 1 fonts (we’re not going to discuss anything else), the |
| 4048 |
interpreter now looks up <code class="code">/S</code> as a key in a dictionary named |
| 4049 |
<code class="code">CharStrings</code>, another mandatory entry in a font dictionary. |
| 4050 |
|
| 4051 |
</li><li> <a class="index-entry-id" id="index-hints"></a> |
| 4052 |
<a class="index-entry-id" id="index-character-definitions-in-PostScript"></a> |
| 4053 |
The value of <code class="code">S</code> in <code class="code">CharStrings</code> is the equivalent of a |
| 4054 |
series of standard PostScript commands like ‘<samp class="samp">curveto</samp>’, |
| 4055 |
‘<samp class="samp">lineto</samp>’, ‘<samp class="samp">fill</samp>’, and so on. These commands are executed to |
| 4056 |
draw the character. There can also be <em class="dfn">hint information</em> that helps |
| 4057 |
adapt the character to low-resolution rasters. (See <a class="xref" href="#Glyph-files">Glyph files</a>.) |
| 4058 |
The commands are actually represented in a more compact way than |
| 4059 |
standard PostScript source; see the Type 1 book for details. |
| 4060 |
|
| 4061 |
</li></ol> |
| 4062 |
|
| 4063 |
<p>This method for typesetting characters is used in both Level 1 and Level |
| 4064 |
2 PostScript. See the PostScript reference manuals for more |
| 4065 |
information. |
| 4066 |
</p> |
| 4067 |
|
| 4068 |
<hr> |
| 4069 |
</div> |
| 4070 |
</div> |
| 4071 |
<div class="section-level-extent" id="Making-a-font-available"> |
| 4072 |
<div class="nav-panel"> |
| 4073 |
<p> |
| 4074 |
Next: <a href="#Invoking-afm2tfm" accesskey="n" rel="next">Invoking Afm2tfm</a>, Previous: <a href="#Font-concepts" accesskey="p" rel="prev">Font concepts</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 4075 |
</div> |
| 4076 |
<h3 class="section" id="Making-a-PostScript-font-available"><span>6.2 Making a PostScript font available<a class="copiable-link" href="#Making-a-PostScript-font-available"> ¶</a></span></h3> |
| 4077 |
|
| 4078 |
<a class="index-entry-id" id="index-installing-fonts"></a> |
| 4079 |
<a class="index-entry-id" id="index-fonts_002c-installing"></a> |
| 4080 |
|
| 4081 |
<p>To make a PostScript font available in a TeX document, you need to |
| 4082 |
install the font on your system and then define it within the document. |
| 4083 |
Once you have installed the font, of course, it is available for any |
| 4084 |
document thereafter and you don’t need to reinstall it. You must have |
| 4085 |
an AFM file for any font you install. Unless the font is built into your |
| 4086 |
printer, you must also have a PFA or PFB file. |
| 4087 |
</p> |
| 4088 |
<p>In the following examples, we use the font ‘<samp class="samp">Times-Roman</samp>’ to |
| 4089 |
illustrate the process. But you should use the prebuilt fonts for Times |
| 4090 |
and the other standard fonts, rather than rebuilding them. The prebuilt |
| 4091 |
fonts are made using a more complicated process than that described |
| 4092 |
here, to make them work as well as possible with TeX. So following |
| 4093 |
the steps in this manual will not generate files identical to the |
| 4094 |
distributed ones. See <a class="xref" href="#PostScript-font-installation">PostScript font installation</a>, for pointers to |
| 4095 |
the prebuilt fonts. |
| 4096 |
</p> |
| 4097 |
<p>Installation of a PostScript font proceeds in three steps. See <a class="xref" href="#Font-concepts">Font concepts</a>, for descriptions of the various files involved. |
| 4098 |
</p> |
| 4099 |
<ol class="enumerate"> |
| 4100 |
<li> Run <code class="code">afm2tfm</code> to create a TFM file for the original font, |
| 4101 |
and the VPL form of the virtual font: |
| 4102 |
<div class="example"> |
| 4103 |
<pre class="example-preformatted">afm2tfm Times-Roman -v ptmr rptmr |
| 4104 |
</pre></div> |
| 4105 |
|
| 4106 |
</li><li> Run <code class="code">vptovf</code> to generate a VF and TFM file for the virtual font |
| 4107 |
from the VPL file: |
| 4108 |
<div class="example"> |
| 4109 |
<pre class="example-preformatted">vptovf ptmr.vpl ptmr.vf ptmr.tfm |
| 4110 |
</pre></div> |
| 4111 |
|
| 4112 |
</li><li> Insert an entry for the font in <samp class="file">psfonts.map</samp> (see <a class="pxref" href="#psfonts_002emap"><samp class="file">psfonts.map</samp>: PostScript font catalog</a>): |
| 4113 |
<div class="example"> |
| 4114 |
<pre class="example-preformatted">rptmr Times-Roman <ptmr8a.pfa |
| 4115 |
</pre></div> |
| 4116 |
|
| 4117 |
</li><li> Install the files in the standard locations, as in: |
| 4118 |
<div class="example"> |
| 4119 |
<pre class="example-preformatted">cp ptmr.vf <var class="var">fontdir</var>/vf/... |
| 4120 |
cp *ptmr.tfm <var class="var">fontdir</var>/tfm/... |
| 4121 |
cp ptmr.afm <var class="var">fontdir</var>/afm/... |
| 4122 |
cp ptmr.pf? <var class="var">fontdir</var>/type1/... |
| 4123 |
</pre></div> |
| 4124 |
</li></ol> |
| 4125 |
|
| 4126 |
<p>The simplest invocation of Afm2tfm to make virtual fonts goes something |
| 4127 |
like this: |
| 4128 |
</p> |
| 4129 |
<a class="index-entry-id" id="index-afm2tfm"></a> |
| 4130 |
<div class="example"> |
| 4131 |
<pre class="example-preformatted">afm2tfm Times-Roman -v ptmr rptmr |
| 4132 |
</pre></div> |
| 4133 |
|
| 4134 |
<p>This reads the file <samp class="file">Times-Roman.afm</samp>, and produces two files as |
| 4135 |
output, namely the virtual property list file <samp class="file">ptmr.vpl</samp>, and the |
| 4136 |
“raw” font metric file <samp class="file">rptmr.tfm</samp>. To use the font in TeX, |
| 4137 |
you first run |
| 4138 |
</p> |
| 4139 |
<a class="index-entry-id" id="index-vptovf"></a> |
| 4140 |
<div class="example"> |
| 4141 |
<pre class="example-preformatted">vptovf ptmr.vpl ptmr.vf ptmr.tfm |
| 4142 |
</pre></div> |
| 4143 |
|
| 4144 |
<p>You should then install the virtual font file <samp class="file">ptmr.vf</samp> where Dvips |
| 4145 |
will see it and install <samp class="file">ptmr.tfm</samp> and <samp class="file">rptmr.tfm</samp> where |
| 4146 |
TeX and Dvips will see them. |
| 4147 |
</p> |
| 4148 |
<p>Using these raw fonts is not recommended; there are no raw fonts in the |
| 4149 |
prebuilt PostScript fonts distributed along with Dvips. But |
| 4150 |
nevertheless, that’s how Afm2tfm presently operates, so that’s what we |
| 4151 |
document here. The ‘<samp class="samp">r</samp>’ prefix convention is likewise historical |
| 4152 |
accident. |
| 4153 |
</p> |
| 4154 |
<p>You can also make more complex virtual fonts by editing <samp class="file">ptmr.vpl</samp> |
| 4155 |
before running ‘<samp class="samp">vptovf</samp>’; such editing might add the uppercase Greek |
| 4156 |
characters in the standard TeX positions, for instance. (This has |
| 4157 |
already been done for the prebuilt fonts.) |
| 4158 |
</p> |
| 4159 |
<p>Once the files have been installed, you’re all set. You can now do |
| 4160 |
things like this in TeX: |
| 4161 |
</p><div class="example"> |
| 4162 |
<pre class="example-preformatted">\font\myfont = ptmr at 12pt |
| 4163 |
\myfont Hello, I am being typeset in 12-point Times-Roman. |
| 4164 |
</pre></div> |
| 4165 |
|
| 4166 |
<p>Thus, we have two fonts, one actual (‘<samp class="samp">rptmr</samp>’, which is analogous to |
| 4167 |
the font in the printer) and one virtual (‘<samp class="samp">ptmr</samp>’, which has been |
| 4168 |
remapped to the standard TeX encoding (almost)), and has typesetting |
| 4169 |
know-how added. You could also say |
| 4170 |
</p> |
| 4171 |
<div class="example"> |
| 4172 |
<pre class="example-preformatted">\font\raw = rptmr at 10pt |
| 4173 |
</pre></div> |
| 4174 |
|
| 4175 |
<p>and typeset directly with that, but then you would have no ligatures or |
| 4176 |
kerning, and you would have to use Adobe character positions for special |
| 4177 |
letters like |
| 4178 |
The virtual font ‘<samp class="samp">ptmr</samp>’ not only has ligatures and kerning, and |
| 4179 |
most of the standard accent conventions of TeX, it also has a few |
| 4180 |
additional features not present in the Computer Modern fonts. For |
| 4181 |
example, it includes all the Adobe characters (such as the Polish ogonek |
| 4182 |
and the French guillemots). The only things you lose from ordinary |
| 4183 |
TeX text fonts are the dotless ‘j’ (which can be hacked into the VPL |
| 4184 |
file with literal PostScript specials if you have the patience) and |
| 4185 |
uppercase Greek letters (which just don’t exist unless you buy them |
| 4186 |
separately). See <a class="xref" href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a>. |
| 4187 |
</p> |
| 4188 |
<p>As a final step you need to record information about both the virtual |
| 4189 |
font and the original font (if you ever might want to use it) in the |
| 4190 |
<samp class="file">psfonts.map</samp> file (see <a class="pxref" href="#psfonts_002emap"><samp class="file">psfonts.map</samp>: PostScript font catalog</a>). For our example, you’d |
| 4191 |
insert the following into <samp class="file">psfonts.map</samp>: |
| 4192 |
</p><div class="example"> |
| 4193 |
<pre class="example-preformatted">rptmr Times-Roman <ptmr8a.pfa |
| 4194 |
</pre></div> |
| 4195 |
|
| 4196 |
<p>Of course, <code class="code">Times-Roman</code> is already built in to most every |
| 4197 |
printer, so there’s no need to download any Type 1 file for it. But if |
| 4198 |
you are actually following these instructions for new fonts, most likely |
| 4199 |
they are not built in to the printer. |
| 4200 |
</p> |
| 4201 |
<a class="index-entry-id" id="index-memory_002c-used-by-PostScript-fonts"></a> |
| 4202 |
<a class="index-entry-id" id="index-efficiency_002c-and-fonts"></a> |
| 4203 |
<p>These PostScript fonts can be scaled to any size. Go wild! Using |
| 4204 |
PostScript fonts, however, does use up a great deal of the printer’s |
| 4205 |
memory and it does take time. You may find downloading bitmap fonts |
| 4206 |
(possibly compressed, with the ‘<samp class="samp">Z</samp>’ option) to be faster than using |
| 4207 |
the built-in PostScript fonts. |
| 4208 |
</p> |
| 4209 |
|
| 4210 |
<hr> |
| 4211 |
</div> |
| 4212 |
<div class="section-level-extent" id="Invoking-afm2tfm"> |
| 4213 |
<div class="nav-panel"> |
| 4214 |
<p> |
| 4215 |
Next: <a href="#psfonts_002emap" accesskey="n" rel="next"><samp class="file">psfonts.map</samp>: PostScript font catalog</a>, Previous: <a href="#Making-a-font-available" accesskey="p" rel="prev">Making a PostScript font available</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 4216 |
</div> |
| 4217 |
<h3 class="section" id="Invoking-Afm2tfm"><span>6.3 Invoking Afm2tfm<a class="copiable-link" href="#Invoking-Afm2tfm"> ¶</a></span></h3> |
| 4218 |
|
| 4219 |
<a class="index-entry-id" id="index-afm2tfm-1"></a> |
| 4220 |
|
| 4221 |
<p>The Afm2tfm program converts an AFM file for a PostScript font to a TFM |
| 4222 |
file and a VPL file for a corresponding virtual font (or, in its |
| 4223 |
simplest form, to a TFM file for the PostScript font itself). The |
| 4224 |
results of the conversion are affected by the command-line options and |
| 4225 |
especially by the reencodings you can specify with those options. You |
| 4226 |
can also obtain special effects such as an oblique font. |
| 4227 |
</p> |
| 4228 |
<a class="index-entry-id" id="index-fontinst"></a> |
| 4229 |
<a class="index-entry-id" id="index-virtual-fonts_002c-creating"></a> |
| 4230 |
<a class="index-entry-id" id="index-Jeffrey_002c-Alan"></a> |
| 4231 |
<p>Alternatives to Afm2tfm for creating virtual fonts include |
| 4232 |
<code class="code">fontinst</code> <a class="url" href="https://ctan.org/pkg/fontinst">https://ctan.org/pkg/fontinst</a>, |
| 4233 |
<code class="code">lcdf-typetools</code>, particularly <code class="code">otftotfm</code> |
| 4234 |
(<a class="url" href="https://ctan.org/pkg/lcdf-typetools">https://ctan.org/pkg/lcdf-typetools</a>), and <code class="code">afm2pl</code> |
| 4235 |
(<a class="url" href="http://tex.aanhet.net/afm2pl/">http://tex.aanhet.net/afm2pl/</a>), among others. |
| 4236 |
</p> |
| 4237 |
|
| 4238 |
|
| 4239 |
<ul class="mini-toc"> |
| 4240 |
<li><a href="#Changing-font-encodings" accesskey="1">Changing font encodings</a></li> |
| 4241 |
<li><a href="#Special-font-effects" accesskey="2">Special font effects</a></li> |
| 4242 |
<li><a href="#Afm2tfm-options" accesskey="3">Afm2tfm options</a></li> |
| 4243 |
</ul> |
| 4244 |
<hr> |
| 4245 |
<div class="subsection-level-extent" id="Changing-font-encodings"> |
| 4246 |
<div class="nav-panel"> |
| 4247 |
<p> |
| 4248 |
Next: <a href="#Special-font-effects" accesskey="n" rel="next">Special font effects</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking Afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 4249 |
</div> |
| 4250 |
<h4 class="subsection" id="Changing-font-encodings-1"><span>6.3.1 Changing font encodings<a class="copiable-link" href="#Changing-font-encodings-1"> ¶</a></span></h4> |
| 4251 |
|
| 4252 |
<a class="index-entry-id" id="index-encoding-changes"></a> |
| 4253 |
<a class="index-entry-id" id="index-fonts_002c-changing-encoding-of"></a> |
| 4254 |
|
| 4255 |
<p>Afm2tfm allows you to specify a different encoding for a PostScript font |
| 4256 |
(for a general introduction to encodings, see <a class="pxref" href="#Encodings">Encodings</a>). The |
| 4257 |
‘<samp class="samp">-t</samp>’ option changes the TeX encoding, ‘<samp class="samp">-p</samp>’ changes the |
| 4258 |
PostScript encoding, and ‘<samp class="samp">-T</samp>’ changes both simultaneously, as |
| 4259 |
detailed in the sections below. |
| 4260 |
</p> |
| 4261 |
|
| 4262 |
|
| 4263 |
<ul class="mini-toc"> |
| 4264 |
<li><a href="#Changing-TeX-encodings" accesskey="1">‘<samp class="samp">-t</samp>’: Changing TeX encodings</a></li> |
| 4265 |
<li><a href="#Changing-PostScript-encodings" accesskey="2">‘<samp class="samp">-p</samp>’: Changing PostScript encodings</a></li> |
| 4266 |
<li><a href="#Changing-both-encodings" accesskey="3">‘<samp class="samp">-T</samp>’: Changing both TeX and PostScript encodings</a></li> |
| 4267 |
<li><a href="#Reencoding-with-Afm2tfm" accesskey="4">Reencoding with Afm2tfm</a></li> |
| 4268 |
<li><a href="#Encoding-file-format" accesskey="5">Encoding file format</a></li> |
| 4269 |
</ul> |
| 4270 |
<hr> |
| 4271 |
<div class="subsubsection-level-extent" id="Changing-TeX-encodings"> |
| 4272 |
<div class="nav-panel"> |
| 4273 |
<p> |
| 4274 |
Next: <a href="#Changing-PostScript-encodings" accesskey="n" rel="next">‘<samp class="samp">-p</samp>’: Changing PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 4275 |
</div> |
| 4276 |
<h4 class="subsubsection" id="g_t_002dt_003a-Changing-TeX-encodings"><span>6.3.1.1 ‘<samp class="samp">-t</samp>’: Changing TeX encodings<a class="copiable-link" href="#g_t_002dt_003a-Changing-TeX-encodings"> ¶</a></span></h4> |
| 4277 |
|
| 4278 |
<a class="index-entry-id" id="index-changing-TeX-encodings"></a> |
| 4279 |
<a class="index-entry-id" id="index-TeX-encoding_002c-changing"></a> |
| 4280 |
|
| 4281 |
<a class="index-entry-id" id="index-_002dt-tex_002denc"></a> |
| 4282 |
<p>To build a virtual font with Afm2tfm, you specify the ‘<samp class="samp">-v</samp>’ or |
| 4283 |
‘<samp class="samp">-V</samp>’ option. You can then specify an encoding for that virtual font |
| 4284 |
with ‘<samp class="samp">-t <var class="var">tex-enc</var></samp>’. (‘<samp class="samp">-t</samp>’ is ignored if neither |
| 4285 |
‘<samp class="samp">-v</samp>’ nor ‘<samp class="samp">-V</samp>’ is present.) Any ligature and kerning |
| 4286 |
information you specify in <var class="var">tex-enc</var> will be used in the VPL, in |
| 4287 |
addition to the ligature and kerning information from the AFM file. |
| 4288 |
</p> |
| 4289 |
<p>If the AFM file has no entry for a character specified in <var class="var">tex-enc</var>, |
| 4290 |
that character will be omitted from the output VPL. |
| 4291 |
</p> |
| 4292 |
<a class="index-entry-id" id="index-texmsym_002eenc-1"></a> |
| 4293 |
<p>The ‘<samp class="samp">-t</samp>’ option is likely to be needed when you have a PostScript |
| 4294 |
font corresponding to a TeX font other than a normal text font such |
| 4295 |
as Computer Modern. For instance, if you have a PostScript font that |
| 4296 |
contains math symbols, you’d probably want to use the encoding in the |
| 4297 |
<samp class="file">texmsym.enc</samp> file supplied with Dvips. (For a start; to actually |
| 4298 |
get usable math fonts, you have to define much more than just an |
| 4299 |
encoding.) |
| 4300 |
</p> |
| 4301 |
|
| 4302 |
<hr> |
| 4303 |
</div> |
| 4304 |
<div class="subsubsection-level-extent" id="Changing-PostScript-encodings"> |
| 4305 |
<div class="nav-panel"> |
| 4306 |
<p> |
| 4307 |
Next: <a href="#Changing-both-encodings" accesskey="n" rel="next">‘<samp class="samp">-T</samp>’: Changing both TeX and PostScript encodings</a>, Previous: <a href="#Changing-TeX-encodings" accesskey="p" rel="prev">‘<samp class="samp">-t</samp>’: Changing TeX encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 4308 |
</div> |
| 4309 |
<h4 class="subsubsection" id="g_t_002dp_003a-Changing-PostScript-encodings"><span>6.3.1.2 ‘<samp class="samp">-p</samp>’: Changing PostScript encodings<a class="copiable-link" href="#g_t_002dp_003a-Changing-PostScript-encodings"> ¶</a></span></h4> |
| 4310 |
|
| 4311 |
<a class="index-entry-id" id="index-changing-PostScript-encodings"></a> |
| 4312 |
<a class="index-entry-id" id="index-PostScript-encoding_002c-changing"></a> |
| 4313 |
<a class="index-entry-id" id="index-_002dp-ps_002denc"></a> |
| 4314 |
|
| 4315 |
<p>By default, Afm2tfm uses the encoding it finds in the AFM file. You can |
| 4316 |
specify a different PostScript encoding with ‘<samp class="samp">-p <var class="var">ps-enc</var></samp>’. |
| 4317 |
This makes the raw TFM file (the one output by Afm2tfm) have the |
| 4318 |
encoding specified in the encoding file <var class="var">ps-enc</var>. Any ligature or |
| 4319 |
kern information specified in <var class="var">ps-enc</var> is ignored by Afm2tfm, since |
| 4320 |
ligkern info is always omitted from the raw TFM. |
| 4321 |
</p> |
| 4322 |
<p>If you use this option, you must also arrange to download <var class="var">ps-enc</var> |
| 4323 |
as part of any document that uses this font. You do this by adding a |
| 4324 |
line like the following one to <samp class="file">psfonts.map</samp> (see <a class="pxref" href="#psfonts_002emap"><samp class="file">psfonts.map</samp>: PostScript font catalog</a>): |
| 4325 |
</p><div class="example"> |
| 4326 |
<pre class="example-preformatted">zpopr Optima "MyEncoding ReEncodeFont" <myenc.enc |
| 4327 |
</pre></div> |
| 4328 |
|
| 4329 |
<a class="index-entry-id" id="index-trademark-character_002c-accessing"></a> |
| 4330 |
<a class="index-entry-id" id="index-registered-character_002c-accessing"></a> |
| 4331 |
<a class="index-entry-id" id="index-extra-characters_002c-accessing"></a> |
| 4332 |
<p>Using ‘<samp class="samp">-p</samp>’ is the only way to access characters in a PostScript |
| 4333 |
font that are neither encoded in the AFM file nor constructed from other |
| 4334 |
characters. For instance, Adobe’s ‘<samp class="samp">Times-Roman</samp>’ font contains the |
| 4335 |
extra characters ‘<samp class="samp">trademark</samp>’ and ‘<samp class="samp">registered</samp>’ (among others); |
| 4336 |
these can only be accessed through such a PostScript reencoding. |
| 4337 |
</p> |
| 4338 |
<a class="index-entry-id" id="index-8r-encoding_002c-and-extra-characters"></a> |
| 4339 |
<p>The ‘8r’ base encoding used for the current PostScript font |
| 4340 |
distribution does do this reencoding, for precisely this reason. |
| 4341 |
</p> |
| 4342 |
|
| 4343 |
<hr> |
| 4344 |
</div> |
| 4345 |
<div class="subsubsection-level-extent" id="Changing-both-encodings"> |
| 4346 |
<div class="nav-panel"> |
| 4347 |
<p> |
| 4348 |
Next: <a href="#Reencoding-with-Afm2tfm" accesskey="n" rel="next">Reencoding with Afm2tfm</a>, Previous: <a href="#Changing-PostScript-encodings" accesskey="p" rel="prev">‘<samp class="samp">-p</samp>’: Changing PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 4349 |
</div> |
| 4350 |
<h4 class="subsubsection" id="g_t_002dT_003a-Changing-both-TeX-and-PostScript-encodings"><span>6.3.1.3 ‘<samp class="samp">-T</samp>’: Changing both TeX and PostScript encodings<a class="copiable-link" href="#g_t_002dT_003a-Changing-both-TeX-and-PostScript-encodings"> ¶</a></span></h4> |
| 4351 |
|
| 4352 |
<a class="index-entry-id" id="index-_002dT-enc_002dfile"></a> |
| 4353 |
|
| 4354 |
<p>The option ‘<samp class="samp">-T <var class="var">enc-file</var></samp>’ is equivalent to ‘<samp class="samp">-p |
| 4355 |
<var class="var">enc-file</var> -t <var class="var">enc-file</var></samp>’. If you make regular use of a private |
| 4356 |
non-standard reencoding ‘<samp class="samp">-T</samp>’ is usually a better idea than the |
| 4357 |
individual options, to avoid unexpected inconsistencies in mapping |
| 4358 |
otherwise. An example of when you might use this option is a dingbats |
| 4359 |
font: when you have a TeX encoding that is designed to be used with a |
| 4360 |
particular PostScript font. |
| 4361 |
</p> |
| 4362 |
|
| 4363 |
<hr> |
| 4364 |
</div> |
| 4365 |
<div class="subsubsection-level-extent" id="Reencoding-with-Afm2tfm"> |
| 4366 |
<div class="nav-panel"> |
| 4367 |
<p> |
| 4368 |
Next: <a href="#Encoding-file-format" accesskey="n" rel="next">Encoding file format</a>, Previous: <a href="#Changing-both-encodings" accesskey="p" rel="prev">‘<samp class="samp">-T</samp>’: Changing both TeX and PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 4369 |
</div> |
| 4370 |
<h4 class="subsubsection" id="Reencoding-with-Afm2tfm-1"><span>6.3.1.4 Reencoding with Afm2tfm<a class="copiable-link" href="#Reencoding-with-Afm2tfm-1"> ¶</a></span></h4> |
| 4371 |
|
| 4372 |
<a class="index-entry-id" id="index-reencoding"></a> |
| 4373 |
<a class="index-entry-id" id="index-remapping"></a> |
| 4374 |
|
| 4375 |
<p>The Afm2tfm program creates the TFM and VF files for the virtual font |
| 4376 |
corresponding to a PostScript font by <em class="dfn">reencoding</em> the PostScript |
| 4377 |
font. Afm2tfm generates these files from two encodings: one for TeX |
| 4378 |
and one for PostScript. The TeX encoding is used to map character |
| 4379 |
numbers to character names while the PostScript encoding is used to map |
| 4380 |
each character name to a possibly different number. In combination, you |
| 4381 |
can get access to any character of a PostScript font at any position for |
| 4382 |
TeX typesetting. |
| 4383 |
</p> |
| 4384 |
<p>In the default case, when you specify none of the <code class="code">-t</code>, <code class="code">-p</code>, |
| 4385 |
or <code class="code">-T</code> options, Afm2tfm uses a default TeX encoding (which |
| 4386 |
mostly corresponds to the Computer Modern text fonts) and the PostScript |
| 4387 |
encoding found in the AFM file being read. The reencoding is also |
| 4388 |
sometimes called a <em class="dfn">remapping</em>. |
| 4389 |
</p> |
| 4390 |
<p>For example, the default encodings reencode the acute accent in two |
| 4391 |
steps: first the default TeX encoding maps the number 19 to the |
| 4392 |
character name ‘<samp class="samp">acute</samp>’; then the default PostScript encoding, as |
| 4393 |
found in the AFM file for an ordinary PostScript font, maps the |
| 4394 |
character name ‘<samp class="samp">acute</samp>’ to the number 194. (The PostScript encoding |
| 4395 |
works in reverse, by looking in the encoding vector for the name and |
| 4396 |
then yielding the corresponding number.) The combined mapping of 19 to |
| 4397 |
194 shows up explicitly in the VF file and also implicitly in the fact |
| 4398 |
that the properties of PostScript character 194 appear in position 19 of |
| 4399 |
the TFM file for the virtual font. |
| 4400 |
</p> |
| 4401 |
<a class="index-entry-id" id="index-accents_002c-in-wrong-position"></a> |
| 4402 |
<a class="index-entry-id" id="index-Hungarian-umlaut"></a> |
| 4403 |
<a class="index-entry-id" id="index-dot-accent"></a> |
| 4404 |
<a class="index-entry-id" id="index-Scandinavian-A-ring"></a> |
| 4405 |
<a class="index-entry-id" id="index-A-ring_002c-Scandinavian-letter"></a> |
| 4406 |
<p>The default encoding of the distributed fonts (e.g., <samp class="file">ptmr.tfm</samp>) |
| 4407 |
mostly follows plain TeX conventions for accents. The exceptions: |
| 4408 |
the Hungarian umlaut (which is at position <code class="code">0x7D</code> in ‘<samp class="samp">cmr10</samp>’, |
| 4409 |
but position <code class="code">0xCD</code> in ‘<samp class="samp">ptmr</samp>’); the dot accent (at positions |
| 4410 |
<code class="code">0x5F</code> and <code class="code">0xC7</code>, respectively); and the Scandinavian A ring |
| 4411 |
<code class="code">\AA</code>, whose definition needs different tweaking. In order to use |
| 4412 |
these accents with PostScript fonts or in math mode when |
| 4413 |
<code class="code">\textfont0</code> is a PostScript font, you will need to use the |
| 4414 |
following definitions. These definitions will not work with the |
| 4415 |
Computer Modern fonts for the relevant accents. They are already part |
| 4416 |
of the distributed <samp class="file">psfonts.sty</samp> for use with LaTeX. |
| 4417 |
</p> |
| 4418 |
<a class="index-entry-id" id="index-_005cH"></a> |
| 4419 |
<a class="index-entry-id" id="index-_005c_002e"></a> |
| 4420 |
<a class="index-entry-id" id="index-_005cdot"></a> |
| 4421 |
<a class="index-entry-id" id="index-_005cAA"></a> |
| 4422 |
<div class="example"> |
| 4423 |
<pre class="example-preformatted">\def\H#1{{\accent"CD #1}} |
| 4424 |
\def\.#1{{\accent"C7 #1}} |
| 4425 |
\def\dot{\mathaccent"70C7 } |
| 4426 |
\newdimen\aadimen |
| 4427 |
\def\AA{\leavevmode\setbox0\hbox{h}\aadimen\ht0 |
| 4428 |
\advance\aadimen-1ex\setbox0\hbox{A}\rlap{\raise.67\aadimen |
| 4429 |
\hbox to \wd0{\hss\char'27\hss}}A} |
| 4430 |
</pre></div> |
| 4431 |
|
| 4432 |
<a class="index-entry-id" id="index-CODINGSCHEME"></a> |
| 4433 |
<p>As a kind of summary, here are the ‘<samp class="samp">CODINGSCHEME</samp>’s that result from |
| 4434 |
the various possible choices for reencoding. |
| 4435 |
</p> |
| 4436 |
<dl class="table"> |
| 4437 |
<dt>default encoding</dt> |
| 4438 |
<dd><div class="example"> |
| 4439 |
<pre class="example-preformatted">(CODINGSCHEME TeX text + AdobeStandardEncoding) |
| 4440 |
</pre></div> |
| 4441 |
|
| 4442 |
</dd> |
| 4443 |
<dt>‘<samp class="samp">-p dc.enc</samp>’</dt> |
| 4444 |
<dd><div class="example"> |
| 4445 |
<pre class="example-preformatted">(CODINGSCHEME TeX text + DCEncoding) |
| 4446 |
</pre></div> |
| 4447 |
|
| 4448 |
</dd> |
| 4449 |
<dt>‘<samp class="samp">-t dc.enc</samp>’</dt> |
| 4450 |
<dd><div class="example"> |
| 4451 |
<pre class="example-preformatted">(CODINGSCHEME DCEncoding + AdobeStandardEncoding) |
| 4452 |
</pre></div> |
| 4453 |
|
| 4454 |
</dd> |
| 4455 |
<dt>‘<samp class="samp">-T dc.enc</samp>’</dt> |
| 4456 |
<dd><div class="example"> |
| 4457 |
<pre class="example-preformatted">(CODINGSCHEME DCEncoding + DCEncoding) |
| 4458 |
</pre></div> |
| 4459 |
|
| 4460 |
</dd> |
| 4461 |
</dl> |
| 4462 |
|
| 4463 |
<p>The ‘<samp class="samp">CODINGSCHEME</samp>’ line appears in the VPL file but is |
| 4464 |
ignored by Dvips. |
| 4465 |
</p> |
| 4466 |
|
| 4467 |
<hr> |
| 4468 |
</div> |
| 4469 |
<div class="subsubsection-level-extent" id="Encoding-file-format"> |
| 4470 |
<div class="nav-panel"> |
| 4471 |
<p> |
| 4472 |
Previous: <a href="#Reencoding-with-Afm2tfm" accesskey="p" rel="prev">Reencoding with Afm2tfm</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 4473 |
</div> |
| 4474 |
<h4 class="subsubsection" id="Encoding-file-format-1"><span>6.3.1.5 Encoding file format<a class="copiable-link" href="#Encoding-file-format-1"> ¶</a></span></h4> |
| 4475 |
|
| 4476 |
<a class="index-entry-id" id="index-encoding-file-format"></a> |
| 4477 |
|
| 4478 |
<p>Afm2tfm’s encoding files have the same format as an encoding vector in a |
| 4479 |
PostScript font. Here is a skeletal example: |
| 4480 |
</p> |
| 4481 |
<div class="example"> |
| 4482 |
<pre class="example-preformatted">% <span class="r">Comments are ignored, unless the first word after the percent sign</span> |
| 4483 |
% <span class="r">is ‘<samp class="samp">LIGKERN</samp>’; see below.</span> |
| 4484 |
/MyEncoding [ % <span class="r">exactly 256 entries follow, each with a leading ‘<samp class="samp">/</samp>’</span> |
| 4485 |
/Alpha /Beta /Gamma /Delta ... |
| 4486 |
/A /B ... /Z |
| 4487 |
... /.notdef /xfooaccent /yfooaccent /zfooaccent |
| 4488 |
] def |
| 4489 |
</pre></div> |
| 4490 |
|
| 4491 |
<p>These encoding files are downloaded as part of changing the encoding at |
| 4492 |
the PostScript level (see the previous section). |
| 4493 |
</p> |
| 4494 |
<a class="index-entry-id" id="index-comments_002c-in-encoding-files"></a> |
| 4495 |
<p>Comments, which start with a percent sign and continue until the end |
| 4496 |
of the line, are ignored unless they start with ‘<samp class="samp">LIGKERN</samp>’ (see below). |
| 4497 |
</p> |
| 4498 |
<p>The first non-comment word of the file must start with a forward slash |
| 4499 |
‘<samp class="samp">/</samp>’ (i.e., a PostScript literal name) and defines the name of the |
| 4500 |
encoding. The next word must be an left bracket ‘<samp class="samp">[</samp>’. Following |
| 4501 |
that must be precisely 256 character names; use ‘<samp class="samp">/.notdef</samp>’ for any |
| 4502 |
that you want to leave undefined. Then there must be a matching right |
| 4503 |
bracket <code class="code">]</code>. A final ‘<samp class="samp">def</samp>’ token is optional. All names are |
| 4504 |
case-sensitive. |
| 4505 |
</p> |
| 4506 |
<p>Any ligature or kern information is given as a comment. If the first |
| 4507 |
word after the ‘<samp class="samp">%</samp>’ is ‘<samp class="samp">LIGKERN</samp>’, then the entire rest of the |
| 4508 |
line is parsed for ligature and kern information. This ligature and |
| 4509 |
kern information is given in groups of words: each group is terminated |
| 4510 |
by a space and a semicolon and (unless the semicolon is at the end of a |
| 4511 |
line) another space. |
| 4512 |
</p> |
| 4513 |
<a class="index-entry-id" id="index-LIGKERN-encoding-file-command"></a> |
| 4514 |
<p>In these <code class="code">LIGKERN</code> statements, three types of information may be |
| 4515 |
specified. These three types are ligature pairs, kerns to ignore, and |
| 4516 |
the character value of this font’s boundary character. |
| 4517 |
</p> |
| 4518 |
<a class="index-entry-id" id="index-boundary-character"></a> |
| 4519 |
<p>Throughout a <code class="code">LIGKERN</code> statement, the boundary character is |
| 4520 |
specified as ‘<samp class="samp">||</samp>’. To set the font’s boundary character value for |
| 4521 |
TeX: |
| 4522 |
</p> |
| 4523 |
<div class="example"> |
| 4524 |
<pre class="example-preformatted">% LIGKERN || = 39 ; |
| 4525 |
</pre></div> |
| 4526 |
|
| 4527 |
<p>To indicate a kern to remove, give the names of the two characters |
| 4528 |
(without the leading slash) separated by ‘<samp class="samp">{}</samp>’, as in ‘<samp class="samp">one |
| 4529 |
{} one ;</samp>’. This is intended to be reminiscent of the way you might |
| 4530 |
use ‘<samp class="samp">{}</samp>’ in a TeX file to turn off ligatures or kerns at a |
| 4531 |
particular location. Either or both of the character names can be given |
| 4532 |
as ‘<samp class="samp">*</samp>’, which is a wild card matching any character; thus, all |
| 4533 |
kerns can be removed with ‘<samp class="samp">* {} * ;</samp>’. |
| 4534 |
</p> |
| 4535 |
<a class="index-entry-id" id="index-ligature-operations"></a> |
| 4536 |
<a class="index-entry-id" id="index-Metafont-ligature-operations"></a> |
| 4537 |
<p>To specify a ligature, specify the names of the pair of characters, |
| 4538 |
followed by the ligature operation (as in Metafont), followed by the |
| 4539 |
replacing character name. Either (but not both) of the first two |
| 4540 |
characters can be ‘<samp class="samp">||</samp>’ to indicate a word boundary. |
| 4541 |
</p> |
| 4542 |
<a class="index-entry-id" id="index-_003d_003a-ligature-operation"></a> |
| 4543 |
<p>The most common operation is ‘<samp class="samp">=:</samp>’ meaning that both characters are |
| 4544 |
removed and replaced by the third character, but by adding the ‘<samp class="samp">|</samp>’ |
| 4545 |
character on either side of the ‘<samp class="samp">=:</samp>’, you can retain either or both |
| 4546 |
of the two leading characters. In addition, by suffixing the ligature |
| 4547 |
operation with one or two ‘<samp class="samp">></samp>’ signs, you can make the ligature |
| 4548 |
scanning operation skip that many resulting characters before |
| 4549 |
proceeding. This works just like in Metafont. For example, the ‘fi’ |
| 4550 |
ligature is specified with ‘<samp class="samp">f i =: fi ;</samp>’<!-- /@w -->. A more convoluted |
| 4551 |
ligature is ‘<samp class="samp">one one |=:|>> exclam ;</samp>’ which separates a pair of |
| 4552 |
adjacent <code class="code">1</code>’s with an exclamation point, and then skips over two |
| 4553 |
of the resulting characters before continuing searching for ligatures |
| 4554 |
and kerns. You cannot give more <code class="t">></code>’s than <code class="t">|</code>’s in an ligature |
| 4555 |
operation, so there are a total of eight possibilities: |
| 4556 |
</p> |
| 4557 |
<div class="example"> |
| 4558 |
<pre class="example-preformatted">=: |=: |=:> =:| =:|> |=:| |=:|> |=:|>> |
| 4559 |
</pre></div> |
| 4560 |
|
| 4561 |
<p>The default set of ligatures and kerns built in to Afm2tfm is: |
| 4562 |
</p> |
| 4563 |
<div class="example"> |
| 4564 |
<pre class="example-preformatted">% LIGKERN question quoteleft =: questiondown ; |
| 4565 |
% LIGKERN exclam quoteleft =: exclamdown ; |
| 4566 |
% LIGKERN hyphen hyphen =: endash ; endash hyphen =: emdash ; |
| 4567 |
% LIGKERN quoteleft quoteleft =: quotedblleft ; |
| 4568 |
% LIGKERN quoteright quoteright =: quotedblright ; |
| 4569 |
% LIGKERN space {} * ; * {} space ; 0 {} * ; * {} 0 ; |
| 4570 |
% LIGKERN 1 {} * ; * {} 1 ; 2 {} * ; * {} 2 ; 3 {} * ; * {} 3 ; |
| 4571 |
% LIGKERN 4 {} * ; * {} 4 ; 5 {} * ; * {} 5 ; 6 {} * ; * {} 6 ; |
| 4572 |
% LIGKERN 7 {} * ; * {} 7 ; 8 {} * ; * {} 8 ; 9 {} * ; * {} 9 ; |
| 4573 |
</pre></div> |
| 4574 |
|
| 4575 |
|
| 4576 |
<hr> |
| 4577 |
</div> |
| 4578 |
</div> |
| 4579 |
<div class="subsection-level-extent" id="Special-font-effects"> |
| 4580 |
<div class="nav-panel"> |
| 4581 |
<p> |
| 4582 |
Next: <a href="#Afm2tfm-options" accesskey="n" rel="next">Afm2tfm options</a>, Previous: <a href="#Changing-font-encodings" accesskey="p" rel="prev">Changing font encodings</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking Afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 4583 |
</div> |
| 4584 |
<h4 class="subsection" id="Special-font-effects-1"><span>6.3.2 Special font effects<a class="copiable-link" href="#Special-font-effects-1"> ¶</a></span></h4> |
| 4585 |
|
| 4586 |
<a class="index-entry-id" id="index-oblique-fonts"></a> |
| 4587 |
<a class="index-entry-id" id="index-slanted-fonts"></a> |
| 4588 |
<a class="index-entry-id" id="index-fonts_002c-slanted"></a> |
| 4589 |
<p>Besides the reencodings described in the previous section, Afm2tfm can |
| 4590 |
do other manipulations. (Again, it’s best to use the prebuilt fonts |
| 4591 |
rather than attempting to remake them.) |
| 4592 |
</p> |
| 4593 |
<p>‘<samp class="samp">-s <var class="var">slant</var></samp>’ makes an obliqued variant, as in: |
| 4594 |
</p> |
| 4595 |
<div class="example"> |
| 4596 |
<pre class="example-preformatted">afm2tfm Times-Roman -s .167 -v ptmro rptmro |
| 4597 |
</pre></div> |
| 4598 |
|
| 4599 |
<p>This creates <samp class="file">ptmro.vpl</samp> and <samp class="file">rptmro.tfm</samp>. To use this font, |
| 4600 |
put the line |
| 4601 |
</p> |
| 4602 |
<a class="index-entry-id" id="index-SlantFont"></a> |
| 4603 |
<div class="example"> |
| 4604 |
<pre class="example-preformatted">rptmro Times-Roman ".167 SlantFont" |
| 4605 |
</pre></div> |
| 4606 |
|
| 4607 |
<a class="index-entry-id" id="index-psfonts_002emap-1"></a> |
| 4608 |
<p>into <samp class="file">psfonts.map</samp>. Then ‘<samp class="samp">rptmro</samp>’ (our name for the obliqued |
| 4609 |
Times) will act as if it were a resident font, although it is actually |
| 4610 |
constructed from Times-Roman via the PostScript routine <code class="code">SlantFont</code> |
| 4611 |
(which will slant everything 1/6 to the right, in this case). |
| 4612 |
</p> |
| 4613 |
<a class="index-entry-id" id="index-expanded-fonts"></a> |
| 4614 |
<a class="index-entry-id" id="index-fonts_002c-expanded"></a> |
| 4615 |
<p>Similarly, you can get an expanded font with |
| 4616 |
</p> |
| 4617 |
<div class="example"> |
| 4618 |
<pre class="example-preformatted">afm2tfm Times-Roman -e 1.2 -v ptmrre rptmrre |
| 4619 |
</pre></div> |
| 4620 |
|
| 4621 |
<p>and by recording the pseudo-resident font |
| 4622 |
<a class="index-entry-id" id="index-ExtendFont"></a> |
| 4623 |
</p> |
| 4624 |
<div class="example"> |
| 4625 |
<pre class="example-preformatted">rptmrre Times-Roman "1.2 ExtendFont" |
| 4626 |
</pre></div> |
| 4627 |
|
| 4628 |
<p>in <samp class="file">psfonts.map</samp>. |
| 4629 |
</p> |
| 4630 |
<p>You can also create a small caps font with a command such as |
| 4631 |
<a class="index-entry-id" id="index-small-caps-fonts"></a> |
| 4632 |
<a class="index-entry-id" id="index-fonts_002c-small-caps"></a> |
| 4633 |
</p> |
| 4634 |
<div class="example"> |
| 4635 |
<pre class="example-preformatted">afm2tfm Times-Roman -V ptmrc rptmrc |
| 4636 |
</pre></div> |
| 4637 |
|
| 4638 |
<p>This will generate a set of pseudo-small caps mapped into the usual |
| 4639 |
lowercase positions and scaled down to 0.8 of the normal cap |
| 4640 |
dimensions. You can also specify the scaling as something other than |
| 4641 |
the default 0.8: |
| 4642 |
</p> |
| 4643 |
<div class="example"> |
| 4644 |
<pre class="example-preformatted">afm2tfm Times-Roman -c 0.7 -V ptmrc rptmrc |
| 4645 |
</pre></div> |
| 4646 |
|
| 4647 |
<p>It is unfortunately not possible to increase the width of the small caps |
| 4648 |
independently of the rest of the font. If you want a really |
| 4649 |
professional looking set of small caps, you need to acquire a small caps |
| 4650 |
font. |
| 4651 |
</p> |
| 4652 |
<a class="index-entry-id" id="index-PaintType"></a> |
| 4653 |
<a class="index-entry-id" id="index-outline-fonts-1"></a> |
| 4654 |
<a class="index-entry-id" id="index-fonts_002c-outlined"></a> |
| 4655 |
<p>To change the <code class="code">PaintType</code> in a font from filled (0) to outlined |
| 4656 |
(2), you can add <code class="code">"/PaintType 2 store"</code> to <samp class="file">psfonts.map</samp>, as |
| 4657 |
in the following: |
| 4658 |
</p> |
| 4659 |
<div class="example"> |
| 4660 |
<pre class="example-preformatted">rphvrl Helvetica "/PaintType 2 store" |
| 4661 |
</pre></div> |
| 4662 |
|
| 4663 |
<p>Afm2tfm writes to standard output the line you need to add to |
| 4664 |
<samp class="file">psfonts.map</samp> to use that font, assuming the font is resident in |
| 4665 |
the printer; if the font is not resident, you must add the |
| 4666 |
‘<samp class="samp"><<var class="var">filename</var></samp>’ command to download the font. Each identical |
| 4667 |
line only needs to be specified once in the ‘<samp class="samp">psfonts.map</samp>’ file, |
| 4668 |
even though many different fonts (small caps variants, or ones with |
| 4669 |
different output encodings) may be based on it. |
| 4670 |
</p> |
| 4671 |
|
| 4672 |
<hr> |
| 4673 |
</div> |
| 4674 |
<div class="subsection-level-extent" id="Afm2tfm-options"> |
| 4675 |
<div class="nav-panel"> |
| 4676 |
<p> |
| 4677 |
Previous: <a href="#Special-font-effects" accesskey="p" rel="prev">Special font effects</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking Afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 4678 |
</div> |
| 4679 |
<h4 class="subsection" id="Afm2tfm-options-1"><span>6.3.3 Afm2tfm options<a class="copiable-link" href="#Afm2tfm-options-1"> ¶</a></span></h4> |
| 4680 |
|
| 4681 |
<a class="index-entry-id" id="index-options_002c-to-Afm2tfm"></a> |
| 4682 |
<a class="index-entry-id" id="index-afm2tfm-options"></a> |
| 4683 |
|
| 4684 |
<p>Synopsis: |
| 4685 |
</p><div class="example"> |
| 4686 |
<pre class="example-preformatted">afm2tfm [<var class="var">option</var>]... <var class="var">afmfile</var>[.afm] [<var class="var">tfmfile</var>[.tfm]] |
| 4687 |
</pre></div> |
| 4688 |
|
| 4689 |
<p>Afm2tfm reads <var class="var">afmfile</var> and writes a corresponding (but “raw”, |
| 4690 |
see below) TFM file. If <var class="var">tfmfile</var> is not supplied, the base name |
| 4691 |
of the AFM file is extended with ‘<samp class="samp">.tfm</samp>’ to get the output |
| 4692 |
filename. |
| 4693 |
</p> |
| 4694 |
<p>The simplest example: |
| 4695 |
</p> |
| 4696 |
<div class="example"> |
| 4697 |
<pre class="example-preformatted">afm2tfm Times-Roman rptmr |
| 4698 |
</pre></div> |
| 4699 |
|
| 4700 |
<a class="index-entry-id" id="index-accents_002c-wrong"></a> |
| 4701 |
<a class="index-entry-id" id="index-raw-tfm-files"></a> |
| 4702 |
<p>The TFM file thus created is <em class="dfn">raw</em> because it omits ligature and |
| 4703 |
kern information, and does no character remapping; it contains only |
| 4704 |
the character information in the AFM file in TFM format, which is the form |
| 4705 |
that TeX understands. The characters have the same code in the TFM |
| 4706 |
file as in the AFM file. For text fonts, this means printable ASCII |
| 4707 |
characters will work ok, but little else, because standard PostScript |
| 4708 |
fonts have a different encoding scheme than the one that plain TeX |
| 4709 |
expects (see <a class="pxref" href="#Encodings">Encodings</a>). Although the encodings agree for most |
| 4710 |
printable ASCII characters, other characters such as ligatures and |
| 4711 |
accents vary. Thus, in practice, it’s almost always desirable to create |
| 4712 |
a virtual font as well with the ‘<samp class="samp">-v</samp>’ or ‘<samp class="samp">-V</samp>’ option. |
| 4713 |
See <a class="xref" href="#Making-a-font-available">Making a PostScript font available</a>. |
| 4714 |
</p> |
| 4715 |
<p>The command line options to Afm2tfm: |
| 4716 |
</p> |
| 4717 |
<dl class="table"> |
| 4718 |
<dt><a class="index-entry-id" id="index-accent-height-adjustment_002c-omitting"></a> |
| 4719 |
<a id="index-_002da-1"></a><span>‘<samp class="samp">-a</samp>’<a class="copiable-link" href="#index-_002da-1"> ¶</a></span></dt> |
| 4720 |
<dd><p>By default, Afm2tfm looks for precomposed accented characters, such as |
| 4721 |
tdieresis, and possibly adjusts the height of the basic letter (t) |
| 4722 |
upward so that the result of using <code class="code">\accent</code> (as in <code class="code">\"t</code>) |
| 4723 |
is visually the same as the precomposed characters. The <code class="code">-a</code> |
| 4724 |
option omits such adjustments, so that all characters’ heights remain |
| 4725 |
as they are given in the AFM file. (Until Afm2tfm 8.4, released in |
| 4726 |
2016, heights could also be adjusted downward, but this is no longer |
| 4727 |
the case.) |
| 4728 |
</p> |
| 4729 |
</dd> |
| 4730 |
<dt><a class="index-entry-id" id="index-scaling-small-caps"></a> |
| 4731 |
<a id="index-_002dc-ratio"></a><span>‘<samp class="samp">-c <var class="var">ratio</var></samp>’<a class="copiable-link" href="#index-_002dc-ratio"> ¶</a></span></dt> |
| 4732 |
<dd><p>See ‘<samp class="samp">-V</samp>’; overrides the default ratio of 0.8 for the |
| 4733 |
scaling of small caps. |
| 4734 |
</p> |
| 4735 |
</dd> |
| 4736 |
<dt><a class="index-entry-id" id="index-expanded-fonts-1"></a> |
| 4737 |
<a class="index-entry-id" id="index-condensed-fonts"></a> |
| 4738 |
<a id="index-_002de-ratio"></a><span>‘<samp class="samp">-e <var class="var">ratio</var></samp>’<a class="copiable-link" href="#index-_002de-ratio"> ¶</a></span></dt> |
| 4739 |
<dd><p>Stretch characters horizontally by <var class="var">ratio</var>; if less than 1.0, you |
| 4740 |
get a condensed font. |
| 4741 |
</p> |
| 4742 |
</dd> |
| 4743 |
<dt><a class="index-entry-id" id="index-octal-character-codes"></a> |
| 4744 |
<a id="index-_002dO"></a><span>‘<samp class="samp">-O</samp>’<a class="copiable-link" href="#index-_002dO"> ¶</a></span></dt> |
| 4745 |
<dd><p>Output all character codes in the ‘<samp class="samp">vpl</samp>’ file as octal numbers, not |
| 4746 |
names; this is useful for symbol or other special-purpose fonts where |
| 4747 |
character names such as ‘<samp class="samp">A</samp>’ have no meaning. |
| 4748 |
</p> |
| 4749 |
</dd> |
| 4750 |
<dt><a id="index-_002dp-ps_002denc-1"></a><span>‘<samp class="samp">-p <var class="var">ps-enc</var></samp>’<a class="copiable-link" href="#index-_002dp-ps_002denc-1"> ¶</a></span></dt> |
| 4751 |
<dd><p>Use <var class="var">ps-enc</var> for the destination (PostScript) encoding of the font; |
| 4752 |
<var class="var">ps-enc</var> must be mentioned as a header file for the font in |
| 4753 |
‘<samp class="samp">psfonts.map</samp>’. |
| 4754 |
See <a class="xref" href="#Changing-PostScript-encodings">‘<samp class="samp">-p</samp>’: Changing PostScript encodings</a>. |
| 4755 |
</p> |
| 4756 |
</dd> |
| 4757 |
<dt><a class="index-entry-id" id="index-slanted-fonts_002c-making"></a> |
| 4758 |
<a id="index-_002ds-slant"></a><span>‘<samp class="samp">-s <var class="var">slant</var></samp>’<a class="copiable-link" href="#index-_002ds-slant"> ¶</a></span></dt> |
| 4759 |
<dd><p>Slant characters to the right by <var class="var">slant</var>. If <var class="var">slant</var> is |
| 4760 |
negative, the letters slope to the left (or they might be upright if you |
| 4761 |
start with an italic font). |
| 4762 |
</p> |
| 4763 |
</dd> |
| 4764 |
<dt><a id="index-_002dt-tex_002denc-1"></a><span>‘<samp class="samp">-t <var class="var">tex-enc</var></samp>’<a class="copiable-link" href="#index-_002dt-tex_002denc-1"> ¶</a></span></dt> |
| 4765 |
<dd><p>Use <var class="var">tex-enc</var> for the target (TeX) encoding of the font. |
| 4766 |
Ligature and kern information may also be specified in <var class="var">file</var>. |
| 4767 |
<var class="var">file</var> is not mentioned in <samp class="file">psfonts.map</samp>. |
| 4768 |
</p> |
| 4769 |
</dd> |
| 4770 |
<dt><a id="index-_002dT-ps_002dtex_002denc"></a><span>‘<samp class="samp">-T <var class="var">ps-tex-enc</var></samp>’<a class="copiable-link" href="#index-_002dT-ps_002dtex_002denc"> ¶</a></span></dt> |
| 4771 |
<dd><p>Use <var class="var">ps-tex-enc</var> for both the PostScript and target TeX encodings |
| 4772 |
of the font. Equivalent to ‘<samp class="samp">-p <var class="var">file</var> -t <var class="var">file</var></samp>’. |
| 4773 |
</p> |
| 4774 |
</dd> |
| 4775 |
<dt><a id="index-_002du"></a><span>‘<samp class="samp">-u</samp>’<a class="copiable-link" href="#index-_002du"> ¶</a></span></dt> |
| 4776 |
<dd><p>Use only those characters specified in the TeX encoding, and no |
| 4777 |
others. By default, Afm2tfm tries to include all characters in the |
| 4778 |
input font, even those not present in the TeX encoding (it puts them |
| 4779 |
into otherwise-unused positions, arbitrarily). |
| 4780 |
</p> |
| 4781 |
</dd> |
| 4782 |
<dt><a id="index-_002dv-vpl_002dfile"></a><span>‘<samp class="samp">-v <var class="var">vpl-file</var></samp>’<a class="copiable-link" href="#index-_002dv-vpl_002dfile"> ¶</a></span></dt> |
| 4783 |
<dd><p>Output a VPL (virtual property list) file, as well as a TFM file. |
| 4784 |
</p> |
| 4785 |
</dd> |
| 4786 |
<dt><a id="index-_002dV-vpl_002dfile"></a><span>‘<samp class="samp">-V <var class="var">vpl-file</var></samp>’<a class="copiable-link" href="#index-_002dV-vpl_002dfile"> ¶</a></span></dt> |
| 4787 |
<dd><p>Same as ‘<samp class="samp">-v</samp>’, but the virtual font generated is a pseudo small caps |
| 4788 |
font obtained by scaling uppercase letters by 0.8 to typeset |
| 4789 |
lowercase. This font handles accented letters and retains proper |
| 4790 |
kerning. |
| 4791 |
</p></dd> |
| 4792 |
</dl> |
| 4793 |
|
| 4794 |
|
| 4795 |
<hr> |
| 4796 |
</div> |
| 4797 |
</div> |
| 4798 |
<div class="section-level-extent" id="psfonts_002emap"> |
| 4799 |
<div class="nav-panel"> |
| 4800 |
<p> |
| 4801 |
Previous: <a href="#Invoking-afm2tfm" accesskey="p" rel="prev">Invoking Afm2tfm</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 4802 |
</div> |
| 4803 |
<h3 class="section" id="psfonts_002emap_003a-PostScript-font-catalog"><span>6.4 <samp class="file">psfonts.map</samp>: PostScript font catalog<a class="copiable-link" href="#psfonts_002emap_003a-PostScript-font-catalog"> ¶</a></span></h3> |
| 4804 |
|
| 4805 |
<a class="index-entry-id" id="index-psfonts_002emap-2"></a> |
| 4806 |
<a class="index-entry-id" id="index-non_002dresident-fonts"></a> |
| 4807 |
<a class="index-entry-id" id="index-downloading-PostScript-fonts"></a> |
| 4808 |
<a class="index-entry-id" id="index-fonts_002c-downloading"></a> |
| 4809 |
|
| 4810 |
<p>The <samp class="file">psfonts.map</samp> file associates a PostScript font with related |
| 4811 |
files and constructs. Each line has the format: |
| 4812 |
</p> |
| 4813 |
<div class="example"> |
| 4814 |
<pre class="example-preformatted"><var class="var">filename</var> <var class="var">PostScript-name</var> <var class="var">options</var> |
| 4815 |
</pre></div> |
| 4816 |
|
| 4817 |
<a class="index-entry-id" id="index-_003c-font-downloading"></a> |
| 4818 |
<p>For example, the line |
| 4819 |
</p><div class="example"> |
| 4820 |
<pre class="example-preformatted">rpstrn StoneInformal <StoneInformal.pfb |
| 4821 |
</pre></div> |
| 4822 |
<p>causes Dvips to download <samp class="file">StoneInformal.pfb</samp> (just as if it were |
| 4823 |
a header file, see <a class="pxref" href="#Header-files">PostScript header files</a>) if the DVI file (or a virtual |
| 4824 |
font, see <a class="pxref" href="#Virtual-fonts">Virtual fonts</a>) references the TFM file ‘<samp class="samp">rpstrn</samp>’. |
| 4825 |
The PostScript <code class="code">/FontName</code> of the font defined inside the ‘<samp class="samp">pfb</samp>’ |
| 4826 |
file should be <code class="code">StoneInformal</code>. |
| 4827 |
</p> |
| 4828 |
<a class="index-entry-id" id="index-transforming-downloaded-fonts"></a> |
| 4829 |
<a class="index-entry-id" id="index-expanded-fonts-2"></a> |
| 4830 |
<a class="index-entry-id" id="index-wide-fonts"></a> |
| 4831 |
<a class="index-entry-id" id="index-narrow-fonts"></a> |
| 4832 |
<p>You can generate transformed fonts with a line like this: |
| 4833 |
</p><div class="example"> |
| 4834 |
<pre class="example-preformatted">rpstrc StoneInformal <StoneInformal.pfb ".8 ExtendFont" |
| 4835 |
</pre></div> |
| 4836 |
|
| 4837 |
<p>See <a class="xref" href="#Special-font-effects">Special font effects</a>, for a |
| 4838 |
complete list of font effects. |
| 4839 |
</p> |
| 4840 |
<a class="index-entry-id" id="index-reencoding-PostScript-fonts"></a> |
| 4841 |
<p>You can change the encoding of the Type 1 font at the PostScript |
| 4842 |
level with a ‘<samp class="samp">ReEncodeFont</samp>’ instruction, plus the name of the |
| 4843 |
encoding file. This allows you access to characters that may be present |
| 4844 |
in the Type 1 font file, but not encoded by default—most of the |
| 4845 |
preaccented characters, for example. An example: |
| 4846 |
</p><div class="example smallexample"> |
| 4847 |
<pre class="example-preformatted">pstrn8r StoneInformal "TeXBase1Encoding ReEncodeFont" <8r.enc <pstrn8a.pfb |
| 4848 |
</pre></div> |
| 4849 |
|
| 4850 |
<a class="index-entry-id" id="index-8r-font-encoding"></a> |
| 4851 |
<a class="index-entry-id" id="index-base-encoding_002c-recommended"></a> |
| 4852 |
<p>The ‘<samp class="samp">8r</samp>’ encoding mentioned here has been designed to serve as a |
| 4853 |
base for all downloadable fonts; it allows access to all the characters |
| 4854 |
commonly present in a Type 1 font. For more details, see the |
| 4855 |
<samp class="file">8r.enc</samp> source file that comes with (and is installed with) Dvips. |
| 4856 |
</p> |
| 4857 |
<a class="index-entry-id" id="index-_003c_005b-encoding-vector-downloading"></a> |
| 4858 |
<p>You may notice that the same syntax is used for downloading encoding |
| 4859 |
vectors and Type 1 font files. To make your intentions clear, you can |
| 4860 |
also use ‘<samp class="samp"><[</samp>’ to explicitly indicate you are downloading an |
| 4861 |
encoding vector, as in: |
| 4862 |
</p><div class="example smallexample"> |
| 4863 |
<pre class="example-preformatted">pstrn8r StoneInformal "TeXBase1Encoding ReEncodeFont" <[8r.enc <pstrn8a.pfb |
| 4864 |
</pre></div> |
| 4865 |
|
| 4866 |
<a class="index-entry-id" id="index-_002eenc-extension-for-encoding-vectors"></a> |
| 4867 |
<p>If the filename of your encoding vector does not end in ‘<samp class="samp">.enc</samp>’, and |
| 4868 |
you are using partial font downloading, you must use the ‘<samp class="samp"><[</samp>’ |
| 4869 |
syntax, or Dvips will not download the font properly. |
| 4870 |
</p> |
| 4871 |
<a class="index-entry-id" id="index-_002epfa-extension-required-for-partial-downloading"></a> |
| 4872 |
<a class="index-entry-id" id="index-_002epfb-extension-required-for-partial-downloading"></a> |
| 4873 |
<p>Similarly, the name of the Type 1 font file itself must have extension |
| 4874 |
<samp class="file">.pfa</samp> or <samp class="file">.pfb</samp> for partial downloading to work properly. |
| 4875 |
</p> |
| 4876 |
<a class="index-entry-id" id="index-pfb-files_002c-automatically-unpacked"></a> |
| 4877 |
<p>When using PFB files, Dvips is smart enough to unpack the binary PFB |
| 4878 |
format into printable ASCII so there is no need to perform this |
| 4879 |
conversion yourself. In addition, Dvips scans the font to determine its |
| 4880 |
memory usage, just as it does for other header files (see <a class="pxref" href="#Header-files">PostScript header files</a>). |
| 4881 |
</p> |
| 4882 |
<a class="index-entry-id" id="index-partial-font-downloading"></a> |
| 4883 |
<a class="index-entry-id" id="index-downloading-fonts-partially"></a> |
| 4884 |
<p>If the ‘<samp class="samp">j</samp>’ config file or command-line option is enabled (as it |
| 4885 |
is by default), <samp class="file">StoneInformal.pfb</samp> will be <em class="dfn">partially |
| 4886 |
downloaded</em>—only those characters your document actually uses will |
| 4887 |
be extracted and downloaded, and the remainder discarded. |
| 4888 |
See <a class="xref" href="#Option-details">Option details</a>. |
| 4889 |
</p> |
| 4890 |
<a class="index-entry-id" id="index-whole-font-downloading"></a> |
| 4891 |
<a class="index-entry-id" id="index-multiple-master-fonts"></a> |
| 4892 |
<a class="index-entry-id" id="index-Minion-typeface-family"></a> |
| 4893 |
<a class="index-entry-id" id="index-_003c_003c-whole-font-downloading"></a> |
| 4894 |
<p>Adobe Multiple Master fonts, such as Minion, cannot be partially |
| 4895 |
downloaded. To partially download in general, but avoid partial |
| 4896 |
downloading for individual fonts, use ‘<samp class="samp"><<</samp>’ instead ‘<samp class="samp"><</samp>’: |
| 4897 |
</p><div class="example"> |
| 4898 |
<pre class="example-preformatted">pmnr8r Minion <<Minion.pfb |
| 4899 |
</pre></div> |
| 4900 |
|
| 4901 |
<p>Here is a brief summary of how <samp class="file">psfonts.map</samp> is read: |
| 4902 |
</p> |
| 4903 |
<ol class="enumerate"> |
| 4904 |
<li> If a line is empty or begins with a space, percent, asterisk, |
| 4905 |
semicolon, or hash mark, it is ignored. |
| 4906 |
|
| 4907 |
</li><li> Otherwise, the line is separated into words, where words are |
| 4908 |
separated by spaces or tabs, except that if a word begins with a double |
| 4909 |
quote, it extends until the next double quote or the end of the line. |
| 4910 |
|
| 4911 |
</li><li> If a word starts with ‘<samp class="samp"><<</samp>’, it is taken as a font file to be |
| 4912 |
wholly downloaded. Use this to avoid partial downloading, as described |
| 4913 |
above. |
| 4914 |
|
| 4915 |
</li><li> If a word starts with ‘<samp class="samp"><[</samp>’, it is taken as an encoding file |
| 4916 |
to be downloaded. Use this if the name of the encoding file does end in |
| 4917 |
‘<samp class="samp">.enc</samp>’, also as described above. |
| 4918 |
|
| 4919 |
</li><li> If a word starts with a ‘<samp class="samp"><</samp>’ character, it is |
| 4920 |
treated as a header file that needs to be downloaded. If the name ends |
| 4921 |
in ‘<samp class="samp">.pfa</samp>’ or ‘<samp class="samp">.pfb</samp>’, it is taken as Type 1 font file that will |
| 4922 |
be partially downloaded if the ‘<samp class="samp">j</samp>’ option is in effect. There can |
| 4923 |
be more than one such header for a given font. If a ‘<samp class="samp"><</samp>’ is a word |
| 4924 |
by itself, the next word is taken as the name of the header file. |
| 4925 |
|
| 4926 |
</li><li> If a word starts with a ‘<samp class="samp">"</samp>’ character, it is taken as PostScript |
| 4927 |
code used in generating that font, and is inserted into the output |
| 4928 |
verbatim at the appropriate point. (And the double quotes beginning and |
| 4929 |
ending the word are removed.) |
| 4930 |
|
| 4931 |
</li><li> Otherwise the word is a name. The first such name is the TFM |
| 4932 |
file, that either a DVI file or a virtual font file can refer to. If |
| 4933 |
there is a second name, it is used as the PostScript name and should |
| 4934 |
match what is defined in the downloaded file; if there is only one |
| 4935 |
name, it is used for both the TeX name and the PostScript name. |
| 4936 |
|
| 4937 |
</li></ol> |
| 4938 |
|
| 4939 |
|
| 4940 |
<hr> |
| 4941 |
</div> |
| 4942 |
</div> |
| 4943 |
<div class="chapter-level-extent" id="Color"> |
| 4944 |
<div class="nav-panel"> |
| 4945 |
<p> |
| 4946 |
Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#PostScript-fonts" accesskey="p" rel="prev">PostScript fonts</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 4947 |
</div> |
| 4948 |
<h2 class="chapter" id="Color-1"><span>7 Color<a class="copiable-link" href="#Color-1"> ¶</a></span></h2> |
| 4949 |
|
| 4950 |
<a class="index-entry-id" id="index-color"></a> |
| 4951 |
|
| 4952 |
<a class="index-entry-id" id="index-Hafner_002c-Jim"></a> |
| 4953 |
<p>Dvips supports one-pass multi-color printing of TeX documents on any |
| 4954 |
color PostScript device. Initially added by Jim Hafner, IBM Research, |
| 4955 |
<a class="email" href="mailto:[email protected]">[email protected]</a>, the color support has gone through many |
| 4956 |
changes by Tomas Rokicki. Besides the source code support itself, there |
| 4957 |
are additional TeX macro files: ‘<samp class="samp">colordvi.tex</samp>’ and |
| 4958 |
‘<samp class="samp">blackdvi.tex</samp>’, and corresponding ‘<samp class="samp">.sty</samp>’ versions for use with |
| 4959 |
LaTeX. |
| 4960 |
</p> |
| 4961 |
<p>In this section we describe the use of color from the document |
| 4962 |
preparer’s point of view and then add some instructions on installation |
| 4963 |
for the TeX administrator. |
| 4964 |
</p> |
| 4965 |
|
| 4966 |
|
| 4967 |
<ul class="mini-toc"> |
| 4968 |
<li><a href="#Color-macro-files" accesskey="1">Color macro files</a></li> |
| 4969 |
<li><a href="#User_002ddefinable-colors" accesskey="2">User-definable colors</a></li> |
| 4970 |
<li><a href="#Color-subtleties" accesskey="3">Color subtleties</a></li> |
| 4971 |
<li><a href="#Ted-Turner" accesskey="4">Printing in black/white after colorizing</a></li> |
| 4972 |
<li><a href="#Color-device-configuration" accesskey="5">Color device configuration</a></li> |
| 4973 |
<li><a href="#Color-support-details" accesskey="6">Color support details</a></li> |
| 4974 |
</ul> |
| 4975 |
<hr> |
| 4976 |
<div class="section-level-extent" id="Color-macro-files"> |
| 4977 |
<div class="nav-panel"> |
| 4978 |
<p> |
| 4979 |
Next: <a href="#User_002ddefinable-colors" accesskey="n" rel="next">User-definable colors</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 4980 |
</div> |
| 4981 |
<h3 class="section" id="Color-macro-files-1"><span>7.1 Color macro files<a class="copiable-link" href="#Color-macro-files-1"> ¶</a></span></h3> |
| 4982 |
|
| 4983 |
<a class="index-entry-id" id="index-macros-for-color"></a> |
| 4984 |
<a class="index-entry-id" id="index-color-macros"></a> |
| 4985 |
|
| 4986 |
<p>All the color macro commands are defined in ‘<samp class="samp">colordvi.tex</samp>’ (or |
| 4987 |
‘<samp class="samp">colordvi.sty</samp>’). To access these macros simply add to the top of |
| 4988 |
your plain TeX file the command: |
| 4989 |
</p><div class="example"> |
| 4990 |
<pre class="example-preformatted">\input colordvi |
| 4991 |
</pre></div> |
| 4992 |
<p>For (the obsolete) LaTeX 2.09, add the ‘<samp class="samp">colordvi</samp>’ style option as in: |
| 4993 |
</p><div class="example"> |
| 4994 |
<pre class="example-preformatted">\documentstyle[12pt,colordvi]{article} |
| 4995 |
</pre></div> |
| 4996 |
<p>For LaTeX2e, these examples are not applicable. Instead, please see |
| 4997 |
the documentation for the graphics package |
| 4998 |
(<a class="url" href="https://ctan.org/pkg/graphics">https://ctan.org/pkg/graphics</a>), and the epslatex document |
| 4999 |
(<a class="url" href="https://ctan.org/pkg/epslatex">https://ctan.org/pkg/epslatex</a>). |
| 5000 |
</p> |
| 5001 |
<a class="index-entry-id" id="index-Crayola-crayon-box"></a> |
| 5002 |
<a class="index-entry-id" id="index-Pantone-colors"></a> |
| 5003 |
<a class="index-entry-id" id="index-color-names_002c-mixed-case"></a> |
| 5004 |
<p>These macros provide two basic kinds of color macros: ones for local |
| 5005 |
color changes (a few words, a single symbol) and one for global color |
| 5006 |
changes (the whole document). All the color names use a mixed case |
| 5007 |
scheme to avoid conflicts with other macros. There are 68 predefined |
| 5008 |
colors, with names taken primarily from the Crayola crayon box of 64 |
| 5009 |
colors, and one pair of macros for the user to set his own color pattern |
| 5010 |
(see <a class="pxref" href="#User_002ddefinable-colors">User-definable colors</a>). You can browse the file |
| 5011 |
‘<samp class="samp">colordvi.tex</samp>’ for a list of the predefined colors. The comments |
| 5012 |
in this file also show a rough correspondence between the crayon names |
| 5013 |
and Pantones. |
| 5014 |
</p> |
| 5015 |
<p>A local color command has the form |
| 5016 |
</p> |
| 5017 |
<div class="example"> |
| 5018 |
<pre class="example-preformatted">\<var class="var">ColorName</var>{this is the color <var class="var">ColorName</var>} |
| 5019 |
</pre></div> |
| 5020 |
|
| 5021 |
<a class="index-entry-id" id="index-_005cColorName"></a> |
| 5022 |
<p>where <var class="var">ColorName</var> is the name of a predefined color, e.g., |
| 5023 |
‘<samp class="samp">Blue</samp>’. As shown, these macros take one argument, the text to |
| 5024 |
print in the specified color. This can be used for nested color changes |
| 5025 |
since it restores the original color state when it completes. For |
| 5026 |
example: |
| 5027 |
</p> |
| 5028 |
<div class="example"> |
| 5029 |
<pre class="example-preformatted">This text is normal but here we are \Red{switching to red, |
| 5030 |
\Blue{nesting blue}, recovering the red} and back to original. |
| 5031 |
</pre></div> |
| 5032 |
|
| 5033 |
<a class="index-entry-id" id="index-color-nesting-level"></a> |
| 5034 |
<p>The color nesting level has no hard limit, but it is not advisable to |
| 5035 |
nest too deeply lest you and the reader lose track of the color history. |
| 5036 |
</p> |
| 5037 |
<p>The global color command has the form |
| 5038 |
</p> |
| 5039 |
<div class="example"> |
| 5040 |
<pre class="example-preformatted">\text<var class="var">ColorName</var> |
| 5041 |
</pre></div> |
| 5042 |
|
| 5043 |
<a class="index-entry-id" id="index-_005ctextColorName"></a> |
| 5044 |
<p>These macros take no arguments and changes the default color from that |
| 5045 |
point on to <var class="var">ColorName</var>. This of course can be overridden globally |
| 5046 |
by another such command or locally by local color commands. For example, |
| 5047 |
expanding on the example above, we might have |
| 5048 |
</p> |
| 5049 |
<div class="example"> |
| 5050 |
<pre class="example-preformatted">\textGreen |
| 5051 |
This text is green but here we are \Red{switching to red, |
| 5052 |
\Blue{nesting blue}, recovering the red} and back to |
| 5053 |
original green. |
| 5054 |
\textCyan |
| 5055 |
The text from here on will be cyan until |
| 5056 |
\Yellow{locally changed to yellow}. Now we are back to cyan. |
| 5057 |
</pre></div> |
| 5058 |
|
| 5059 |
<p>The color commands will even work in math mode and across math mode |
| 5060 |
boundaries. This means that if you have a color before going into math |
| 5061 |
mode, the mathematics will be set in that color as well. In alignment |
| 5062 |
environments like <code class="code">\halign</code>, ‘<samp class="samp">tabular</samp>’ or ‘<samp class="samp">eqnarray</samp>’, |
| 5063 |
local color commands cannot extend beyond the alignment characters. |
| 5064 |
</p> |
| 5065 |
<p>Because local color commands respect only some environment and |
| 5066 |
delimiter changes besides their own, care must be taken in setting |
| 5067 |
their scope. It is best not to have them stretch too far. |
| 5068 |
</p> |
| 5069 |
<p>At the present time there are no macros for color environments in LaTeX |
| 5070 |
which might have a larger range. This is primarily to keep the TeX |
| 5071 |
and LaTeX use compatible. |
| 5072 |
</p> |
| 5073 |
|
| 5074 |
<hr> |
| 5075 |
</div> |
| 5076 |
<div class="section-level-extent" id="User_002ddefinable-colors"> |
| 5077 |
<div class="nav-panel"> |
| 5078 |
<p> |
| 5079 |
Next: <a href="#Color-subtleties" accesskey="n" rel="next">Color subtleties</a>, Previous: <a href="#Color-macro-files" accesskey="p" rel="prev">Color macro files</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 5080 |
</div> |
| 5081 |
<h3 class="section" id="User_002ddefinable-colors-1"><span>7.2 User-definable colors<a class="copiable-link" href="#User_002ddefinable-colors-1"> ¶</a></span></h3> |
| 5082 |
|
| 5083 |
<a class="index-entry-id" id="index-user_002ddefinable-colors"></a> |
| 5084 |
<a class="index-entry-id" id="index-colors_002c-user_002ddefinable"></a> |
| 5085 |
|
| 5086 |
<p>There are two ways for the user to specify colors not already defined. |
| 5087 |
For local changes, there is the command <code class="code">\Color</code> which takes two |
| 5088 |
arguments. The first argument is four numbers between zero and one and |
| 5089 |
specifies the intensity of cyan, magenta, yellow and black (CMYK) in |
| 5090 |
that order. The second argument is the text that should appear in the |
| 5091 |
given color. For example, suppose you want the words “this color is |
| 5092 |
pretty” to appear in a color which is 50% cyan, 85% magenta, 40% yellow |
| 5093 |
and 20% black. You would use the command |
| 5094 |
</p> |
| 5095 |
<div class="example"> |
| 5096 |
<pre class="example-preformatted">\Color{.5 .85 .4 .2}{this color is pretty} |
| 5097 |
</pre></div> |
| 5098 |
|
| 5099 |
<p>For global color changes, there is a command <code class="code">\textColor</code> which |
| 5100 |
takes one argument, the CMYK quadruple of relative color intensities. |
| 5101 |
For example, if you want the default color to be as above, then the |
| 5102 |
command |
| 5103 |
</p> |
| 5104 |
<div class="example"> |
| 5105 |
<pre class="example-preformatted">\textColor{.5 .85 .4 .2} |
| 5106 |
The text from now on will be this pretty color |
| 5107 |
</pre></div> |
| 5108 |
|
| 5109 |
<p>will do the trick. |
| 5110 |
</p> |
| 5111 |
<p>Making a global color change in the midst of nested local colors is |
| 5112 |
highly discouraged. Consequently, Dvips will give you warning message |
| 5113 |
and do its best to recover by discarding the current color history. |
| 5114 |
</p> |
| 5115 |
|
| 5116 |
<hr> |
| 5117 |
</div> |
| 5118 |
<div class="section-level-extent" id="Color-subtleties"> |
| 5119 |
<div class="nav-panel"> |
| 5120 |
<p> |
| 5121 |
Next: <a href="#Ted-Turner" accesskey="n" rel="next">Printing in black/white after colorizing</a>, Previous: <a href="#User_002ddefinable-colors" accesskey="p" rel="prev">User-definable colors</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 5122 |
</div> |
| 5123 |
<h3 class="section" id="Color-subtleties-1"><span>7.3 Color subtleties<a class="copiable-link" href="#Color-subtleties-1"> ¶</a></span></h3> |
| 5124 |
|
| 5125 |
<a class="index-entry-id" id="index-color-subtleties"></a> |
| 5126 |
|
| 5127 |
<p>Color macros are defined via <code class="code">\special</code> keywords. As such, they |
| 5128 |
are put in the ‘<samp class="samp">.dvi</samp>’ file only as explicit message strings to the |
| 5129 |
driver. The (unpleasant) result is that certain unprotected regions of |
| 5130 |
the text can have unwanted color side effects. For example, if a color |
| 5131 |
region is split by TeX across a page boundary, then the footers of |
| 5132 |
the current page (e.g., the page number) and the headers of the next |
| 5133 |
page can inherit that color. To avoid this effect globally, users |
| 5134 |
should make sure that these special regions of the text are defined with |
| 5135 |
their own local color commands. For example, to protect the |
| 5136 |
header and footer in plain TeX, use |
| 5137 |
</p> |
| 5138 |
<div class="example"> |
| 5139 |
<pre class="example-preformatted">\headline{\Black{My Header}} |
| 5140 |
\footline{\Black{\hss\tenrm\folio\hss}} |
| 5141 |
</pre></div> |
| 5142 |
|
| 5143 |
<p>This warning also applies to figures and other insertions, so be careful! |
| 5144 |
</p> |
| 5145 |
<p>Of course, in LaTeX, this is much more difficult to do because of the |
| 5146 |
complexity of the macros that control these regions. This is |
| 5147 |
unfortunate but inevitable, because TeX and LaTeX were |
| 5148 |
not written with color in mind. |
| 5149 |
</p> |
| 5150 |
<p>Even when writing your own macros, much care must be taken. The macros |
| 5151 |
that ‘colorize’ a portion of the text work prefix the text work by |
| 5152 |
outputting one <code class="code">\special</code> command to turn the color on before the |
| 5153 |
text, and outputting another <code class="code">\special</code> command afterwards to |
| 5154 |
restore the original color. It is often useful to ensure that TeX is |
| 5155 |
in horizontal mode before the first special command is issued; this can |
| 5156 |
be done by prefixing the color command with <code class="code">\leavevmode</code>. |
| 5157 |
</p> |
| 5158 |
|
| 5159 |
<hr> |
| 5160 |
</div> |
| 5161 |
<div class="section-level-extent" id="Ted-Turner"> |
| 5162 |
<div class="nav-panel"> |
| 5163 |
<p> |
| 5164 |
Next: <a href="#Color-device-configuration" accesskey="n" rel="next">Color device configuration</a>, Previous: <a href="#Color-subtleties" accesskey="p" rel="prev">Color subtleties</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 5165 |
</div> |
| 5166 |
<h3 class="section" id="Printing-in-black_002fwhite-after-colorizing"><span>7.4 Printing in black/white after colorizing<a class="copiable-link" href="#Printing-in-black_002fwhite-after-colorizing"> ¶</a></span></h3> |
| 5167 |
|
| 5168 |
<p>If you have a TeX or LaTeX document written with color macros and |
| 5169 |
you want to print it in black and white there are two options. On all |
| 5170 |
(good) PostScript devices, printing a color file will print in |
| 5171 |
corresponding gray levels. This is useful to get a rough idea of the |
| 5172 |
colors without using expensive color printing devices. The second |
| 5173 |
option is to replace the call to input <samp class="file">colordvi.tex</samp> with |
| 5174 |
‘<samp class="samp">blackdvi.tex</samp>’ (and similarly for the ‘<samp class="samp">.sty</samp>’ files). So in |
| 5175 |
the above example, replacing the word ‘<samp class="samp">colordvi</samp>’ with |
| 5176 |
‘<samp class="samp">blackdvi</samp>’ suffices. <samp class="file">blackdvi.tex</samp> defines the color macros |
| 5177 |
as no-ops, and so will produce normal black/white printing. By this |
| 5178 |
simple mechanism, the user can switch to all black/white printing |
| 5179 |
without having to ferret out the color commands. Also, some device |
| 5180 |
drivers, particularly non-PostScript ones like screen previewers, will |
| 5181 |
simply ignore the color commands and so print in black/white. |
| 5182 |
Hopefully, in the future screen previewers for color displays will be |
| 5183 |
compatible with some form of color support. |
| 5184 |
</p> |
| 5185 |
|
| 5186 |
<hr> |
| 5187 |
</div> |
| 5188 |
<div class="section-level-extent" id="Color-device-configuration"> |
| 5189 |
<div class="nav-panel"> |
| 5190 |
<p> |
| 5191 |
Next: <a href="#Color-support-details" accesskey="n" rel="next">Color support details</a>, Previous: <a href="#Ted-Turner" accesskey="p" rel="prev">Printing in black/white after colorizing</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 5192 |
</div> |
| 5193 |
<h3 class="section" id="Color-device-configuration-1"><span>7.5 Color device configuration<a class="copiable-link" href="#Color-device-configuration-1"> ¶</a></span></h3> |
| 5194 |
|
| 5195 |
<a class="index-entry-id" id="index-color-configuration"></a> |
| 5196 |
<a class="index-entry-id" id="index-configuration_002c-of-color-devices"></a> |
| 5197 |
|
| 5198 |
<p>To configure Dvips for a particular color device you need to fine tune |
| 5199 |
the color parameters to match your device’s color rendition. To do this, |
| 5200 |
you will need a Pantone chart for your device. The header file |
| 5201 |
‘<samp class="samp">color.lpro</samp>’ shows a (rough) correspondence between the Crayola |
| 5202 |
crayon names and the Pantone numbers and also defines default CMYK |
| 5203 |
values for each of the colors. Note that these colors must be defined |
| 5204 |
in CMYK terms and not RGB, as Dvips outputs PostScript color commands in |
| 5205 |
CMYK. This header file also defines (if they are not known to the |
| 5206 |
interpreter) the PostScript commands ‘<samp class="samp">setcmykcolor</samp>’ and |
| 5207 |
‘<samp class="samp">currentcmykcolor</samp>’ in terms of a RGB equivalent so if your device |
| 5208 |
only understands RGB, there should be no problem. |
| 5209 |
</p> |
| 5210 |
<a class="index-entry-id" id="index-Phaser-printer_002c-used-for-color-calibration"></a> |
| 5211 |
<a class="index-entry-id" id="index-Tektronix-Phaser-printer_002c-used-for-color-calibration"></a> |
| 5212 |
<p>The parameters set in this file were determined by comparing the Pantone |
| 5213 |
chart of a Tektronix Phaser printer with the actual Crayola Crayons. |
| 5214 |
Because these were defined for a particular device, the actual color |
| 5215 |
rendition on your device may be very different. There are two ways to |
| 5216 |
adjust this. One is to use the PAntone chart for your device to rewrite |
| 5217 |
‘<samp class="samp">color.lpro</samp>’ prior to compilation and installation. A better |
| 5218 |
alternative, which supports multiple devices, is to add a header file |
| 5219 |
option in the configuration file (see <a class="pxref" href="#Configuration-file-commands">Configuration file commands</a>) |
| 5220 |
for each device that defines, in ‘<samp class="samp">userdict</samp>’, the color parameters |
| 5221 |
for those colors that need redefining. |
| 5222 |
</p> |
| 5223 |
<p>For example, if you need to change the parameters defining |
| 5224 |
‘<samp class="samp">Goldenrod</samp>’ (approximately Pantone 109 on the Phaser) for your |
| 5225 |
device ‘<samp class="samp">mycolordev</samp>’, do the following. In the Pantone chart for |
| 5226 |
your device, find the CMYK values for Pantone 109. Let’s say they are |
| 5227 |
‘<samp class="samp">{\ 0 0.10 0.75 0.03 }</samp>’. Then create a header file named |
| 5228 |
‘<samp class="samp">mycolordev.pro</samp>’ with the commands |
| 5229 |
</p> |
| 5230 |
<div class="example"> |
| 5231 |
<pre class="example-preformatted">userdict begin |
| 5232 |
/Goldenrod { 0 0.10 0.75 0.03 setcmykcolor} bind def |
| 5233 |
</pre></div> |
| 5234 |
|
| 5235 |
<p>Finally, in ‘<samp class="samp">config.mycolordev</samp>’ add the line |
| 5236 |
</p> |
| 5237 |
<div class="example"> |
| 5238 |
<pre class="example-preformatted">h mycolordev.pro |
| 5239 |
</pre></div> |
| 5240 |
|
| 5241 |
<p>This will then define ‘<samp class="samp">Goldenrod</samp>’ in your device’s CMYK values in |
| 5242 |
<samp class="file">userdict</samp> which is checked before defining it in <samp class="file">TeXdict</samp> by |
| 5243 |
<samp class="file">color.pro</samp>. (On MS-DOS, you will have to call this file |
| 5244 |
<samp class="file">mycolordev.cfg</samp>.) |
| 5245 |
</p> |
| 5246 |
<p>This mechanism, together with additions to <samp class="file">colordvi.tex</samp> and |
| 5247 |
<samp class="file">blackdvi.tex</samp> (and the ‘<samp class="samp">.sty</samp>’ files), can also be used to |
| 5248 |
predefine other colors for your users. |
| 5249 |
</p> |
| 5250 |
|
| 5251 |
<hr> |
| 5252 |
</div> |
| 5253 |
<div class="section-level-extent" id="Color-support-details"> |
| 5254 |
<div class="nav-panel"> |
| 5255 |
<p> |
| 5256 |
Previous: <a href="#Color-device-configuration" accesskey="p" rel="prev">Color device configuration</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 5257 |
</div> |
| 5258 |
<h3 class="section" id="Color-support-details-1"><span>7.6 Color support details<a class="copiable-link" href="#Color-support-details-1"> ¶</a></span></h3> |
| 5259 |
|
| 5260 |
<p>To support color, Dvips recognizes a certain set of specials. These |
| 5261 |
specials start with the keyword ‘<samp class="samp">color</samp>’ or the keyword |
| 5262 |
‘<samp class="samp">background</samp>’, followed by a color specification. |
| 5263 |
</p> |
| 5264 |
|
| 5265 |
|
| 5266 |
<ul class="mini-toc"> |
| 5267 |
<li><a href="#Color-specifications" accesskey="1">Color specifications</a></li> |
| 5268 |
<li><a href="#Color-specials" accesskey="2">Color specials</a></li> |
| 5269 |
</ul> |
| 5270 |
<hr> |
| 5271 |
<div class="subsection-level-extent" id="Color-specifications"> |
| 5272 |
<div class="nav-panel"> |
| 5273 |
<p> |
| 5274 |
Next: <a href="#Color-specials" accesskey="n" rel="next">Color specials</a>, Up: <a href="#Color-support-details" accesskey="u" rel="up">Color support details</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 5275 |
</div> |
| 5276 |
<h4 class="subsection" id="Color-specifications-1"><span>7.6.1 Color specifications<a class="copiable-link" href="#Color-specifications-1"> ¶</a></span></h4> |
| 5277 |
|
| 5278 |
<a class="index-entry-id" id="index-color-specifications"></a> |
| 5279 |
|
| 5280 |
<p>What is a color specification? One of three things. First, it might be |
| 5281 |
a PostScript procedure as defined in a PostScript header file. The |
| 5282 |
<samp class="file">color.pro</samp> file defines 64 of these, including ‘<samp class="samp">Maroon</samp>’. |
| 5283 |
This PostScript procedure must set the current color to be some value; |
| 5284 |
in this case, ‘<samp class="samp">Maroon</samp>’ is defined as ‘<samp class="samp">0 0.87 0.68 0.32 |
| 5285 |
setcmykcolor</samp>’. |
| 5286 |
</p> |
| 5287 |
<p>The second possibility is the name of a color model (initially, one of |
| 5288 |
‘<samp class="samp">rgb</samp>’, ‘<samp class="samp">hsb</samp>’, ‘<samp class="samp">cmyk</samp>’, or ‘<samp class="samp">gray</samp>’) followed by the |
| 5289 |
appropriate number of parameters. When Dvips encounters such a macro, |
| 5290 |
it sends out the parameters first, followed by the string created by |
| 5291 |
prefixing ‘<samp class="samp">TeXcolor</samp>’ to the color model. Thus, the color |
| 5292 |
specification ‘<samp class="samp">rgb 0.3 0.4 0.5</samp>’ would generate the PostScript code |
| 5293 |
‘<samp class="samp">0.3 0.4 0.5 TeXrgbcolor</samp>’. Note that the case of zero arguments is |
| 5294 |
disallowed, as that is handled by the single keyword case |
| 5295 |
(‘<samp class="samp">Maroon</samp>’) above, where no changes to the name are made before it |
| 5296 |
is sent to the PostScript file. |
| 5297 |
</p> |
| 5298 |
<p>The third and final type of color specification is a double quote |
| 5299 |
followed by any sequence of PostScript. The double quote is stripped |
| 5300 |
from the output. For instance, the color specification |
| 5301 |
‘<samp class="samp">"AggiePattern setpattern</samp>’ will set the ‘color’ to the Aggie logo |
| 5302 |
pattern (assuming such exists.) |
| 5303 |
</p> |
| 5304 |
|
| 5305 |
<hr> |
| 5306 |
</div> |
| 5307 |
<div class="subsection-level-extent" id="Color-specials"> |
| 5308 |
<div class="nav-panel"> |
| 5309 |
<p> |
| 5310 |
Previous: <a href="#Color-specifications" accesskey="p" rel="prev">Color specifications</a>, Up: <a href="#Color-support-details" accesskey="u" rel="up">Color support details</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 5311 |
</div> |
| 5312 |
<h4 class="subsection" id="Color-specials-1"><span>7.6.2 Color specials<a class="copiable-link" href="#Color-specials-1"> ¶</a></span></h4> |
| 5313 |
|
| 5314 |
<p>We will describe ‘<samp class="samp">background</samp>’ first, since it is the simplest. The |
| 5315 |
‘<samp class="samp">background</samp>’ keyword must be followed by a color specification. |
| 5316 |
That color specification is used as a fill color for the background. |
| 5317 |
The last ‘<samp class="samp">background</samp>’ special on a page is the one that gets |
| 5318 |
issued, and it gets issued at the very beginning of the page, before any |
| 5319 |
text or specials are sent. (This is possible because the prescan phase |
| 5320 |
of Dvips notices all of the color specials so that the appropriate |
| 5321 |
information can be written out during the second phase.) |
| 5322 |
</p> |
| 5323 |
<p>The ‘<samp class="samp">color</samp>’ special itself has three forms. |
| 5324 |
The first is just ‘<samp class="samp">color</samp>’ followed by a color specification. In |
| 5325 |
this case, the current global color is set to that color; the color stack |
| 5326 |
must be empty when such a command is executed. |
| 5327 |
</p> |
| 5328 |
<p>The second form is ‘<samp class="samp">color push</samp>’ followed by a color specification. |
| 5329 |
This saves the current color on the color stack and sets the color to be |
| 5330 |
that given by the color specification. This is the most common way to |
| 5331 |
set a color. |
| 5332 |
</p> |
| 5333 |
<p>The final version of the ‘<samp class="samp">color</samp>’ special is just ‘<samp class="samp">color pop</samp>’, |
| 5334 |
with no color specification; this says to pop the color last pushed on |
| 5335 |
the color stack from the color stack and set the current color to be |
| 5336 |
that color. |
| 5337 |
</p> |
| 5338 |
<p>Dvips correctly handles these color specials across pages, even when the |
| 5339 |
pages are repeated or reversed. |
| 5340 |
</p> |
| 5341 |
<p>These color specials can be used for things such as patterns or screens |
| 5342 |
as well as simple colors. However, note that in the PostScript, only |
| 5343 |
one color specification can be active at a time. For instance, at the |
| 5344 |
beginning of a page, only the bottommost entry on the color stack is |
| 5345 |
sent; also, when a color is popped, all that is done is that the color |
| 5346 |
specification from the previous stack entry is sent. No ‘<samp class="samp">gsave</samp>’ or |
| 5347 |
‘<samp class="samp">grestore</samp>’ is used. This means that you cannot easily mix usage of |
| 5348 |
the ‘<samp class="samp">color</samp>’ specials for screens and colors, just one or the other. |
| 5349 |
This may be addressed in the future by adding support for different |
| 5350 |
categories of color-like state. |
| 5351 |
</p> |
| 5352 |
|
| 5353 |
<hr> |
| 5354 |
</div> |
| 5355 |
</div> |
| 5356 |
</div> |
| 5357 |
<div class="unnumbered-level-extent" id="Index"> |
| 5358 |
<div class="nav-panel"> |
| 5359 |
<p> |
| 5360 |
Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top" accesskey="u" rel="up">Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> |
| 5361 |
</div> |
| 5362 |
<h2 class="unnumbered" id="Index-1"><span>Index<a class="copiable-link" href="#Index-1"> ¶</a></span></h2> |
| 5363 |
|
| 5364 |
<div class="printindex cp-printindex"> |
| 5365 |
<table class="cp-letters-header-printindex"><tr><th>Jump to: </th><td><a class="summary-letter-printindex" href="#Index_cp_symbol-1"><b>-</b></a> |
| 5366 |
|
| 5367 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-2"><b>!</b></a> |
| 5368 |
|
| 5369 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-3"><b>.</b></a> |
| 5370 |
|
| 5371 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-4"><b>"</b></a> |
| 5372 |
|
| 5373 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-5"><b>(</b></a> |
| 5374 |
|
| 5375 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-6"><b>@</b></a> |
| 5376 |
|
| 5377 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-7"><b>/</b></a> |
| 5378 |
|
| 5379 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-8"><b>\</b></a> |
| 5380 |
|
| 5381 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-9"><b>%</b></a> |
| 5382 |
|
| 5383 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-10"><b>+</b></a> |
| 5384 |
|
| 5385 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-11"><b><</b></a> |
| 5386 |
|
| 5387 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-12"><b>=</b></a> |
| 5388 |
|
| 5389 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-13"><b>|</b></a> |
| 5390 |
|
| 5391 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-14"><b>6</b></a> |
| 5392 |
|
| 5393 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-15"><b>8</b></a> |
| 5394 |
|
| 5395 |
<br> |
| 5396 |
<a class="summary-letter-printindex" href="#Index_cp_letter-A"><b>A</b></a> |
| 5397 |
|
| 5398 |
<a class="summary-letter-printindex" href="#Index_cp_letter-B"><b>B</b></a> |
| 5399 |
|
| 5400 |
<a class="summary-letter-printindex" href="#Index_cp_letter-C"><b>C</b></a> |
| 5401 |
|
| 5402 |
<a class="summary-letter-printindex" href="#Index_cp_letter-D"><b>D</b></a> |
| 5403 |
|
| 5404 |
<a class="summary-letter-printindex" href="#Index_cp_letter-E"><b>E</b></a> |
| 5405 |
|
| 5406 |
<a class="summary-letter-printindex" href="#Index_cp_letter-F"><b>F</b></a> |
| 5407 |
|
| 5408 |
<a class="summary-letter-printindex" href="#Index_cp_letter-G"><b>G</b></a> |
| 5409 |
|
| 5410 |
<a class="summary-letter-printindex" href="#Index_cp_letter-H"><b>H</b></a> |
| 5411 |
|
| 5412 |
<a class="summary-letter-printindex" href="#Index_cp_letter-I"><b>I</b></a> |
| 5413 |
|
| 5414 |
<a class="summary-letter-printindex" href="#Index_cp_letter-J"><b>J</b></a> |
| 5415 |
|
| 5416 |
<a class="summary-letter-printindex" href="#Index_cp_letter-K"><b>K</b></a> |
| 5417 |
|
| 5418 |
<a class="summary-letter-printindex" href="#Index_cp_letter-L"><b>L</b></a> |
| 5419 |
|
| 5420 |
<a class="summary-letter-printindex" href="#Index_cp_letter-M"><b>M</b></a> |
| 5421 |
|
| 5422 |
<a class="summary-letter-printindex" href="#Index_cp_letter-N"><b>N</b></a> |
| 5423 |
|
| 5424 |
<a class="summary-letter-printindex" href="#Index_cp_letter-O"><b>O</b></a> |
| 5425 |
|
| 5426 |
<a class="summary-letter-printindex" href="#Index_cp_letter-P"><b>P</b></a> |
| 5427 |
|
| 5428 |
<a class="summary-letter-printindex" href="#Index_cp_letter-Q"><b>Q</b></a> |
| 5429 |
|
| 5430 |
<a class="summary-letter-printindex" href="#Index_cp_letter-R"><b>R</b></a> |
| 5431 |
|
| 5432 |
<a class="summary-letter-printindex" href="#Index_cp_letter-S"><b>S</b></a> |
| 5433 |
|
| 5434 |
<a class="summary-letter-printindex" href="#Index_cp_letter-T"><b>T</b></a> |
| 5435 |
|
| 5436 |
<a class="summary-letter-printindex" href="#Index_cp_letter-U"><b>U</b></a> |
| 5437 |
|
| 5438 |
<a class="summary-letter-printindex" href="#Index_cp_letter-V"><b>V</b></a> |
| 5439 |
|
| 5440 |
<a class="summary-letter-printindex" href="#Index_cp_letter-W"><b>W</b></a> |
| 5441 |
|
| 5442 |
<a class="summary-letter-printindex" href="#Index_cp_letter-X"><b>X</b></a> |
| 5443 |
|
| 5444 |
<a class="summary-letter-printindex" href="#Index_cp_letter-Y"><b>Y</b></a> |
| 5445 |
|
| 5446 |
<a class="summary-letter-printindex" href="#Index_cp_letter-Z"><b>Z</b></a> |
| 5447 |
|
| 5448 |
</td></tr></table> |
| 5449 |
<table class="cp-entries-printindex"> |
| 5450 |
<tr><td></td><th class="entries-header-printindex">Index Entry</th><th class="sections-header-printindex">Section</th></tr> |
| 5451 |
<tr><td colspan="3"><hr></td></tr> |
| 5452 |
<tr><th id="Index_cp_symbol-1">-</th></tr> |
| 5453 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d"><code>-</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5454 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d-as-output-filename"><code>- <span class="r">as output filename</span></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5455 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dhelp"><code>--help</code></a></td><td class="printindex-index-section"><a href="#Option-summary">Option summary</a></td></tr> |
| 5456 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dhelp-1"><code>--help</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5457 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dversion"><code>--version</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5458 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002da"><code>-a</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5459 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dA"><code>-A</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5460 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002da-1"><code>-a</code></a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5461 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dB"><code>-B</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5462 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002db-num"><code>-b <var class="var">num</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5463 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dbitmapfontenc-option"><code>-bitmapfontenc <var class="var">option</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5464 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dc-num"><code>-c <var class="var">num</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5465 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dC-num"><code>-C <var class="var">num</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5466 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dc-ratio"><code>-c <var class="var">ratio</var></code></a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5467 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dd-num"><code>-d <var class="var">num</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5468 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dD-num"><code>-D <var class="var">num</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5469 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dE"><code>-E</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5470 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002de-num"><code>-e <var class="var">num</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5471 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002de-ratio"><code>-e <var class="var">ratio</var></code></a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5472 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002df"><code>-f</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5473 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dF"><code>-F</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5474 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dG"><code>-G</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5475 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dh-name"><code>-h <var class="var">name</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5476 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002di"><code>-i</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5477 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dj-for-partial-font-downloading"><code>-j <span class="r">for partial font downloading</span></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5478 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dK"><code>-K</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5479 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dk-for-cropmarks"><code>-k <span class="r">for cropmarks</span></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5480 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dL"><code>-L</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5481 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dl-_005b_003d_005dnum_005b_002epageseq_005d"><code>-l [=]<var class="var">num</var>[.<var class="var">pageseq</var>]</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5482 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dlandscaperotate"><code>-landscaperotate</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5483 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dm"><code>-m</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5484 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dM"><code>-M</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5485 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dmode-mode"><code>-mode <var class="var">mode</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5486 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dN"><code>-N</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5487 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dn-num"><code>-n <var class="var">num</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5488 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dnoomega"><code>-noomega</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5489 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dnoptex"><code>-noptex</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5490 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dO"><code>-O</code></a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5491 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002do-name"><code>-o <var class="var">name</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5492 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dO-x_002doffset_002cy_002doffset"><code>-O <var class="var">x-offset</var>,<var class="var">y-offset</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5493 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dp-_005b_003d_005dnum_005b_002epageseq_005d"><code>-p [=]<var class="var">num</var>[.<var class="var">pageseq</var>]</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5494 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dP-printer"><code>-P <var class="var">printer</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5495 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dp-ps_002denc"><code>-p <var class="var">ps-enc</var></code></a></td><td class="printindex-index-section"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr> |
| 5496 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dp-ps_002denc-1"><code>-p <var class="var">ps-enc</var></code></a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5497 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dpp-first_002dlast"><code>-pp <var class="var">first</var>-<var class="var">last</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5498 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dpp-range"><code>-pp <var class="var">range</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5499 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dPprinter_002c-and-config-file-searching"><code>-P<var class="var">printer</var><span class="r">, and config file searching</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr> |
| 5500 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dq"><code>-q</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5501 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dr"><code>-r</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5502 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dR"><code>-R</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5503 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ds"><code>-s</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5504 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dS-num"><code>-S <var class="var">num</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5505 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ds-slant"><code>-s <var class="var">slant</var></code></a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5506 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dT-enc_002dfile"><code>-T <var class="var">enc-file</var></code></a></td><td class="printindex-index-section"><a href="#Changing-both-encodings">Changing both encodings</a></td></tr> |
| 5507 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dT-hsize_002cvsize"><code>-T <var class="var">hsize</var>,<var class="var">vsize</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5508 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dt-papertype"><code>-t <var class="var">papertype</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5509 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dT-ps_002dtex_002denc"><code>-T <var class="var">ps-tex-enc</var></code></a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5510 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dt-tex_002denc"><code>-t <var class="var">tex-enc</var></code></a></td><td class="printindex-index-section"><a href="#Changing-TeX-encodings">Changing TeX encodings</a></td></tr> |
| 5511 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dt-tex_002denc-1"><code>-t <var class="var">tex-enc</var></code></a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5512 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dtitle-str"><code>-title <var class="var">str</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5513 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dU"><code>-U</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5514 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002du"><code>-u</code></a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5515 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002du-psmapfile"><code>-u <var class="var">psmapfile</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5516 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dv"><code>-v</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5517 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dV"><code>-V</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5518 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dv-vpl_002dfile"><code>-v <var class="var">vpl-file</var></code></a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5519 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dV-vpl_002dfile"><code>-V <var class="var">vpl-file</var></code></a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5520 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dx-num"><code>-x <var class="var">num</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5521 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dX-num"><code>-X <var class="var">num</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5522 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dY-num"><code>-Y <var class="var">num</var></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5523 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dz"><code>-z</code></a></td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr> |
| 5524 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dZ-for-compressing-bitmap-fonts"><code>-Z <span class="r">for compressing bitmap fonts</span></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5525 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dz-for-recognizing-hyperdvi"><code>-z <span class="r">for recognizing hyperdvi</span></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5526 |
<tr><td colspan="3"><hr></td></tr> |
| 5527 |
<tr><th id="Index_cp_symbol-2">!</th></tr> |
| 5528 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_0021-special-_0028literal-PS-header_0029"><code>! <span class="r">special (literal PS header)</span></code></a></td><td class="printindex-index-section"><a href="#Literal-headers">Literal headers</a></td></tr> |
| 5529 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_0021-starting-output-filename"><code>! <span class="r">starting output filename</span></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5530 |
<tr><td colspan="3"><hr></td></tr> |
| 5531 |
<tr><th id="Index_cp_symbol-3">.</th></tr> |
| 5532 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002e_002e_002drelative-filenames"><samp class="file">..</samp>-relative filenames</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5533 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eafm-Adobe-metric-files"><code>.afm <span class="r">Adobe metric files</span></code></a></td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr> |
| 5534 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002edvipsrc_002c-searched-for"><code>.dvipsrc<span class="r">, searched for</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr> |
| 5535 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eenc-extension-for-encoding-vectors"><code>.enc <span class="r">extension for encoding vectors</span></code></a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 5536 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002elpro-long-prologue-files"><code>.lpro <span class="r">long prologue files</span></code></a></td><td class="printindex-index-section"><a href="#Header-files">Header files</a></td></tr> |
| 5537 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002emf-Metafont-source-files"><code>.mf <span class="r">Metafont source files</span></code></a></td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr> |
| 5538 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ennnpk-packed-font-bitmaps"><code>.<var class="var">nnn</var>pk <span class="r">packed font bitmaps</span></code></a></td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr> |
| 5539 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epfa-extension-required-for-partial-downloading"><code>.pfa <span class="r">extension required for partial downloading</span></code></a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 5540 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epfa-printer-font-ascii-files"><code>.pfa <span class="r">printer font ascii files</span></code></a></td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr> |
| 5541 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epfb-extension-required-for-partial-downloading"><code>.pfb <span class="r">extension required for partial downloading</span></code></a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 5542 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epfb-printer-font-binary-files"><code>.pfb <span class="r">printer font binary files</span></code></a></td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr> |
| 5543 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epfm-printer-font-metric-files"><code>.pfm <span class="r">printer font metric files</span></code></a></td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr> |
| 5544 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epl-property-list-files"><code>.pl <span class="r">property list files</span></code></a></td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr> |
| 5545 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epro-prologue-files"><code>.pro <span class="r">prologue files</span></code></a></td><td class="printindex-index-section"><a href="#Header-files">Header files</a></td></tr> |
| 5546 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002etfm-TeX-font-metric-files"><code>.tfm <span class="r">TeX font metric files</span></code></a></td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr> |
| 5547 |
<tr><td colspan="3"><hr></td></tr> |
| 5548 |
<tr><th id="Index_cp_symbol-4">"</th></tr> |
| 5549 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_0022-special-_0028literal-PostScript_0029"><code>" <span class="r">special (literal PostScript)</span></code></a></td><td class="printindex-index-section"><a href="#g_t_0022-special">" special</a></td></tr> |
| 5550 |
<tr><td colspan="3"><hr></td></tr> |
| 5551 |
<tr><th id="Index_cp_symbol-5">(</th></tr> |
| 5552 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_0028atend_0029_002c-bounding-box-specification"><code>(atend)<span class="r">, bounding box specification</span></code></a></td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr> |
| 5553 |
<tr><td colspan="3"><hr></td></tr> |
| 5554 |
<tr><th id="Index_cp_symbol-6">@</th></tr> |
| 5555 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_0040-config-command-_0028define-paper-sizes_0029"><code>@ <span class="r">config command (define paper sizes)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5556 |
<tr><td colspan="3"><hr></td></tr> |
| 5557 |
<tr><th id="Index_cp_symbol-7">/</th></tr> |
| 5558 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002f_0023copies"><code>/#copies</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5559 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002f_0023copies-1"><code>/#copies</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5560 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002fmagscale"><code>/magscale</code></a></td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr> |
| 5561 |
<tr><td colspan="3"><hr></td></tr> |
| 5562 |
<tr><th id="Index_cp_symbol-8">\</th></tr> |
| 5563 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002e"><code>\.</code></a></td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr> |
| 5564 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cAA"><code>\AA</code></a></td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr> |
| 5565 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cColorName"><code>\<var class="var">ColorName</var></code></a></td><td class="printindex-index-section"><a href="#Color-macro-files">Color macro files</a></td></tr> |
| 5566 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cdot"><code>\dot</code></a></td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr> |
| 5567 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cepsffile-macro"><code>\epsffile <span class="r">macro</span></code></a></td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr> |
| 5568 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cepsfsize"><code>\epsfsize</code></a></td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr> |
| 5569 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cepsfverbosetrue"><code>\epsfverbosetrue</code></a></td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr> |
| 5570 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cepsfxsize"><code>\epsfxsize</code></a></td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr> |
| 5571 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cepsfysize"><code>\epsfysize</code></a></td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr> |
| 5572 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cH"><code>\H</code></a></td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr> |
| 5573 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cincludegraphics-LaTeX-macro">\includegraphics LaTeX macro</a></td><td class="printindex-index-section"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr> |
| 5574 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cleavevmode"><code>\leavevmode</code></a></td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr> |
| 5575 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cmagnification"><code>\magnification</code></a></td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr> |
| 5576 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_005crotninety"><code>\rotninety</code></a></td><td class="printindex-index-section"><a href="#Literal-examples">Literal examples</a></td></tr> |
| 5577 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ctextColorName"><code>\text<var class="var">ColorName</var></code></a></td><td class="printindex-index-section"><a href="#Color-macro-files">Color macro files</a></td></tr> |
| 5578 |
<tr><td colspan="3"><hr></td></tr> |
| 5579 |
<tr><th id="Index_cp_symbol-9">%</th></tr> |
| 5580 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_002aFont"><code>%*Font</code></a></td><td class="printindex-index-section"><a href="#Fonts-in-figures">Fonts in figures</a></td></tr> |
| 5581 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_0025BoundingBox"><code>%%BoundingBox</code></a></td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr> |
| 5582 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_0025Page_002c-and-multi_002dpage-information"><code>%%Page<span class="r">, and multi-page information</span></code></a></td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr> |
| 5583 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_0025Page_002c-not-generating"><code>%%Page<span class="r">, not generating</span></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5584 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_0025Page_002c-removing"><code>%%Page<span class="r">, removing</span></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5585 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_0025Page_002c-required-by-Ghostview"><code>%%Page<span class="r">, required by Ghostview</span></code></a></td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr> |
| 5586 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_0025Title"><code>%%Title</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5587 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_0025VMusage"><code>%%VMusage</code></a></td><td class="printindex-index-section"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr> |
| 5588 |
<tr><td colspan="3"><hr></td></tr> |
| 5589 |
<tr><th id="Index_cp_symbol-10">+</th></tr> |
| 5590 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002bpsmapfile"><code>+<var class="var">psmapfile</var></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5591 |
<tr><td colspan="3"><hr></td></tr> |
| 5592 |
<tr><th id="Index_cp_symbol-11"><</th></tr> |
| 5593 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_003c-font-downloading"><code>< <span class="r">font downloading</span></code></a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 5594 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_003c_005b-encoding-vector-downloading"><code><[ <span class="r">encoding vector downloading</span></code></a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 5595 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_003c_003c-whole-font-downloading"><code><< <span class="r">whole font downloading</span></code></a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 5596 |
<tr><td colspan="3"><hr></td></tr> |
| 5597 |
<tr><th id="Index_cp_symbol-12">=</th></tr> |
| 5598 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_003d_003a-ligature-operation"><code>=: <span class="r">ligature operation</span></code></a></td><td class="printindex-index-section"><a href="#Encoding-file-format">Encoding file format</a></td></tr> |
| 5599 |
<tr><td colspan="3"><hr></td></tr> |
| 5600 |
<tr><th id="Index_cp_symbol-13">|</th></tr> |
| 5601 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_007c-starting-output-filename"><code>| <span class="r">starting output filename</span></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5602 |
<tr><td colspan="3"><hr></td></tr> |
| 5603 |
<tr><th id="Index_cp_symbol-14">6</th></tr> |
| 5604 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-612-792-bounding-box-size"><code>612 792 <span class="r">bounding box size</span></code></a></td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr> |
| 5605 |
<tr><td colspan="3"><hr></td></tr> |
| 5606 |
<tr><th id="Index_cp_symbol-15">8</th></tr> |
| 5607 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-8r-encoding_002c-and-extra-characters"><code>8r <span class="r">encoding, and extra characters</span></code></a></td><td class="printindex-index-section"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr> |
| 5608 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-8r-font-encoding">8r font encoding</a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 5609 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-8r_002eenc"><code>8r.enc</code></a></td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr> |
| 5610 |
<tr><td colspan="3"><hr></td></tr> |
| 5611 |
<tr><th id="Index_cp_letter-A">A</th></tr> |
| 5612 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-a-config-command-_0028conserve-memory_0029"><code>a <span class="r">config command (conserve memory)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5613 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-A-ring_002c-Scandinavian-letter">A ring, Scandinavian letter</a></td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr> |
| 5614 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-a3-papertype">a3 papertype</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5615 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-a4-paper-size"><code>a4 <span class="r">paper size</span></code></a></td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> |
| 5616 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-a4-papertype">a4 papertype</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5617 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-A4size-paper-size"><code>A4size <span class="r">paper size</span></code></a></td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> |
| 5618 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-absolute-filenames_002c-disabling">absolute filenames, disabling</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5619 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-absolute-page-number_002c-and-_002dl">absolute page number, and ‘<samp class="samp">-l</samp>’</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5620 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-absolute-page-number_002c-and-_002dp">absolute page number, and ‘<samp class="samp">-p</samp>’</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5621 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-accent-height-adjustment_002c-omitting">accent height adjustment, omitting</a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5622 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-accents_002c-in-wrong-position">accents, in wrong position</a></td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr> |
| 5623 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-accents_002c-wrong">accents, wrong</a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5624 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-accuracy-in-positioning">accuracy in positioning</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5625 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-afm-files">afm files</a></td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr> |
| 5626 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-afm2tfm"><code>afm2tfm</code></a></td><td class="printindex-index-section"><a href="#Making-a-font-available">Making a font available</a></td></tr> |
| 5627 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-afm2tfm-1"><code>afm2tfm</code></a></td><td class="printindex-index-section"><a href="#Invoking-afm2tfm">Invoking afm2tfm</a></td></tr> |
| 5628 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-afm2tfm-options">afm2tfm options</a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5629 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-after-header_002c-inserting-code">after header, inserting code</a></td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr> |
| 5630 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Aladdin-Ghostscript">Aladdin Ghostscript</a></td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr> |
| 5631 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Anderson_002c-Laurie">Anderson, Laurie</a></td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr> |
| 5632 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-angle-_0028psfile-special-option_0029"><code>angle <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a></td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr> |
| 5633 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-arcs">arcs</a></td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr> |
| 5634 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-ASCII-character-codes_002c-used-by-PostScript">ASCII character codes, used by PostScript</a></td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr> |
| 5635 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-atend_002c-bounding-box-specification"><code>atend<span class="r">, bounding box specification</span></code></a></td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr> |
| 5636 |
<tr><td colspan="3"><hr></td></tr> |
| 5637 |
<tr><th id="Index_cp_letter-B">B</th></tr> |
| 5638 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-b-config-command-_0028_0023copies_0029"><code>b <span class="r">config command (#copies)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5639 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-base"><code>base</code></a></td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr> |
| 5640 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-base-encoding_002c-recommended">base encoding, recommended</a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 5641 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-base-fonts">base fonts</a></td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr> |
| 5642 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bbfig"><code>bbfig</code></a></td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr> |
| 5643 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-before-header_002c-inserting-code">before header, inserting code</a></td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr> |
| 5644 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Bhattacharya_002c-Tanmoy">Bhattacharya, Tanmoy</a></td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr> |
| 5645 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-big-points">big points</a></td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr> |
| 5646 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-binary-files_002c-not-supported">binary files, not supported</a></td><td class="printindex-index-section"><a href="#Including-graphics-fails">Including graphics fails</a></td></tr> |
| 5647 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bitmap-font-encoding">bitmap font encoding</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5648 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bitmap-font-encodings">bitmap font encodings</a></td><td class="printindex-index-section"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr> |
| 5649 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bitmap-fonts">bitmap fonts</a></td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr> |
| 5650 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bitmapfontenc-config-command-_0028bitmap-font-encoding_0029"><code>bitmapfontenc <span class="r">config command (bitmap font encoding)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5651 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bop-undefined-error"><code class="t">bop undefined</code> error</a></td><td class="printindex-index-section"><a href="#Printer-errors">Printer errors</a></td></tr> |
| 5652 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bop_002dhook"><code>bop-hook</code></a></td><td class="printindex-index-section"><a href="#Paper-trays">Paper trays</a></td></tr> |
| 5653 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bop_002dhook-1"><code>bop-hook</code></a></td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr> |
| 5654 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bop_002dhook-2"><code>bop-hook</code></a></td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr> |
| 5655 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bop_002dhook_002c-and-offset-pages"><code>bop-hook<span class="r">, and offset pages</span></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5656 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-boundary-character">boundary character</a></td><td class="printindex-index-section"><a href="#Encoding-file-format">Encoding file format</a></td></tr> |
| 5657 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bounding-box_002c-comment-for">bounding box, comment for</a></td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr> |
| 5658 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bounding-box_002c-defined">bounding box, defined</a></td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr> |
| 5659 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bounding-box_002c-determining">bounding box, determining</a></td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr> |
| 5660 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bounding-box_002c-finding-tight">bounding box, finding tight</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5661 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bounding-box_002c-for-bitmap-fonts">bounding box, for bitmap fonts</a></td><td class="printindex-index-section"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr> |
| 5662 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bounding-box_002c-inaccurate">bounding box, inaccurate</a></td><td class="printindex-index-section"><a href="#EPSF-clipping">EPSF clipping</a></td></tr> |
| 5663 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bounding-box_002c-supplying-to-TeX">bounding box, supplying to TeX</a></td><td class="printindex-index-section"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr> |
| 5664 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-bounding-box_002c-supplying-to-TeX-1">bounding box, supplying to TeX</a></td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr> |
| 5665 |
<tr><td colspan="3"><hr></td></tr> |
| 5666 |
<tr><th id="Index_cp_letter-C">C</th></tr> |
| 5667 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-c-config-command-_0028include-another-config-file_0029"><code>c <span class="r">config command (include another config file)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5668 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-changing-PostScript-encodings">changing PostScript encodings</a></td><td class="printindex-index-section"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr> |
| 5669 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-changing-TeX-encodings">changing TeX encodings</a></td><td class="printindex-index-section"><a href="#Changing-TeX-encodings">Changing TeX encodings</a></td></tr> |
| 5670 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-character-definitions-in-PostScript">character definitions in PostScript</a></td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr> |
| 5671 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-character-lookup-procedure-in-PostScript">character lookup procedure in PostScript</a></td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr> |
| 5672 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-CharStrings-Type-1-dictionary"><code>CharStrings <span class="r">Type 1 dictionary</span></code></a></td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr> |
| 5673 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-clip-_0028psfile-special-option_0029"><code>clip <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a></td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr> |
| 5674 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-clipping-of-EPSF">clipping of EPSF</a></td><td class="printindex-index-section"><a href="#EPSF-clipping">EPSF clipping</a></td></tr> |
| 5675 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-CODINGSCHEME"><code>CODINGSCHEME</code></a></td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr> |
| 5676 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-collated-copies">collated copies</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5677 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-color">color</a></td><td class="printindex-index-section"><a href="#Color">Color</a></td></tr> |
| 5678 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-color-configuration">color configuration</a></td><td class="printindex-index-section"><a href="#Color-device-configuration">Color device configuration</a></td></tr> |
| 5679 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-color-macros">color macros</a></td><td class="printindex-index-section"><a href="#Color-macro-files">Color macro files</a></td></tr> |
| 5680 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-color-names_002c-mixed-case">color names, mixed case</a></td><td class="printindex-index-section"><a href="#Color-macro-files">Color macro files</a></td></tr> |
| 5681 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-color-nesting-level">color nesting level</a></td><td class="printindex-index-section"><a href="#Color-macro-files">Color macro files</a></td></tr> |
| 5682 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-color-separations">color separations</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5683 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-color-specifications">color specifications</a></td><td class="printindex-index-section"><a href="#Color-specifications">Color specifications</a></td></tr> |
| 5684 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-color-subtleties">color subtleties</a></td><td class="printindex-index-section"><a href="#Color-subtleties">Color subtleties</a></td></tr> |
| 5685 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-colors_002c-user_002ddefinable">colors, user-definable</a></td><td class="printindex-index-section"><a href="#User_002ddefinable-colors">User-definable colors</a></td></tr> |
| 5686 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-command-line_002c-including-headers-from">command line, including headers from</a></td><td class="printindex-index-section"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr> |
| 5687 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-command_002dline-options">command-line options</a></td><td class="printindex-index-section"><a href="#Invoking-Dvips">Invoking Dvips</a></td></tr> |
| 5688 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-comments_002c-in-configuration-files">comments, in configuration files</a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5689 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-comments_002c-in-encoding-files">comments, in encoding files</a></td><td class="printindex-index-section"><a href="#Encoding-file-format">Encoding file format</a></td></tr> |
| 5690 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-comments_002c-removing-included">comments, removing included</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5691 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-compilation">compilation</a></td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr> |
| 5692 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-compressed-PostScript">compressed PostScript</a></td><td class="printindex-index-section"><a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></td></tr> |
| 5693 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-compressing-bitmap-fonts">compressing bitmap fonts</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5694 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Computer-Modern-in-PostScript">Computer Modern in PostScript</a></td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr> |
| 5695 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Computer-Modern_002c-encoding-of">Computer Modern, encoding of</a></td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr> |
| 5696 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-condensed-fonts">condensed fonts</a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5697 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-config_002eproto"><code>config.proto</code></a></td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr> |
| 5698 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-config_002eps"><code>config.ps</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5699 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-config_002eps-installation"><code>config.ps <span class="r">installation</span></code></a></td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr> |
| 5700 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-config_002eps-paper-sizes"><code>config.ps <span class="r">paper sizes</span></code></a></td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> |
| 5701 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-config_002eps_002c-searched-for"><code>config.ps<span class="r">, searched for</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr> |
| 5702 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-file-options">configuration file options</a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5703 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-file-paper-size-command">configuration file paper size command</a></td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> |
| 5704 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-file-path">configuration file path</a></td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr> |
| 5705 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-file-searching">configuration file searching</a></td><td class="printindex-index-section"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr> |
| 5706 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-files">configuration files</a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr> |
| 5707 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-files_002c-creating">configuration files, creating</a></td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr> |
| 5708 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-files_002c-prototype">configuration files, prototype</a></td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr> |
| 5709 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration_002c-of-color-devices">configuration, of color devices</a></td><td class="printindex-index-section"><a href="#Color-device-configuration">Color device configuration</a></td></tr> |
| 5710 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-configuration_002c-of-Dvips">configuration, of Dvips</a></td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr> |
| 5711 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-continuation-lines_002c-not-supported">continuation lines, not supported</a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5712 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-control_002dD">control-D</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5713 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-coordinate-system_002c-for-bitmap-fonts">coordinate system, for bitmap fonts</a></td><td class="printindex-index-section"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr> |
| 5714 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-copies_002c-collated">copies, collated</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5715 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-copies_002c-duplicated-page-bodies">copies, duplicated page bodies</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5716 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-copies_002c-uncollated">copies, uncollated</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5717 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Crayola-crayon-box">Crayola crayon box</a></td><td class="printindex-index-section"><a href="#Color-macro-files">Color macro files</a></td></tr> |
| 5718 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-crop_002epro"><code>crop.pro</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5719 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-cropmarks">cropmarks</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5720 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-current-font_002c-in-PostScript">current font, in PostScript</a></td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr> |
| 5721 |
<tr><td colspan="3"><hr></td></tr> |
| 5722 |
<tr><th id="Index_cp_letter-D">D</th></tr> |
| 5723 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-D-config-command-_0028dpi_0029"><code>D <span class="r">config command (dpi)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5724 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-dated-output">dated output</a></td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr> |
| 5725 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-datestamp_002c-in-output">datestamp, in output</a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5726 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-debugging">debugging</a></td><td class="printindex-index-section"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr> |
| 5727 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-debugging-1">debugging</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5728 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-debugging-options">debugging options</a></td><td class="printindex-index-section"><a href="#Debug-options">Debug options</a></td></tr> |
| 5729 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-default-resolutions">default resolutions</a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5730 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-default_005ftexsizes-Make-variable"><code>default_texsizes <span class="r">Make variable</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5731 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Deutsch_002c-Peter">Deutsch, Peter</a></td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr> |
| 5732 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-device-dependency_002c-and-virtual-fonts">device dependency, and virtual fonts</a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5733 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-dictionary_002c-CharStrings">dictionary, <code class="code">CharStrings</code></a></td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr> |
| 5734 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-dictionary_002c-PostScript-language">dictionary, PostScript language</a></td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr> |
| 5735 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-dictionary_002c-SDict">dictionary, <code class="code">SDict</code></a></td><td class="printindex-index-section"><a href="#Literal-headers">Literal headers</a></td></tr> |
| 5736 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-dictionary_002c-userdict">dictionary, <code class="code">userdict</code></a></td><td class="printindex-index-section"><a href="#Header-files">Header files</a></td></tr> |
| 5737 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-distillation_002c-and-_002dz">distillation, and ‘<samp class="samp">-z</samp>’</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5738 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-distiller_002c-for-PDF-files">distiller, for PDF files</a></td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr> |
| 5739 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-document-title_002c-specifying">document title, specifying</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5740 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-dot-accent">dot accent</a></td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr> |
| 5741 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-double_002dsided-printing">double-sided printing</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5742 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-downloading-fonts-partially">downloading fonts partially</a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 5743 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-downloading-PostScript-fonts">downloading PostScript fonts</a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 5744 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Doyle_002c-Mark">Doyle, Mark</a></td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr> |
| 5745 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-draft-copies">draft copies</a></td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr> |
| 5746 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-dual-paper-trays">dual paper trays</a></td><td class="printindex-index-section"><a href="#Paper-trays">Paper trays</a></td></tr> |
| 5747 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-duplex-printers">duplex printers</a></td><td class="printindex-index-section"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr> |
| 5748 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-DVI-magnification">DVI magnification</a></td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr> |
| 5749 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-dvihps_002c-hyperdvi-to-PostScript"><code>dvihps<span class="r">, hyperdvi to PostScript</span></code></a></td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr> |
| 5750 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Dvips-configuration-file-options">Dvips configuration file options</a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5751 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-dvips_002dall_002eenc"><code>dvips-all.enc</code></a></td><td class="printindex-index-section"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr> |
| 5752 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-dvips_002eenc"><code>dvips.enc</code></a></td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr> |
| 5753 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSDEBUG"><code>DVIPSDEBUG</code></a></td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr> |
| 5754 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSFONTS"><code>DVIPSFONTS</code></a></td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr> |
| 5755 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSHEADERS"><code>DVIPSHEADERS</code></a></td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr> |
| 5756 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSHEADERS_002c-overrides-H"><code>DVIPSHEADERS<span class="r">, overrides</span> H</code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5757 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSMAKEPK"><code>DVIPSMAKEPK</code></a></td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr> |
| 5758 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSRC"><code>DVIPSRC</code></a></td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr> |
| 5759 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSSIZES"><code>DVIPSSIZES</code></a></td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr> |
| 5760 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSSIZES_002c-overrides-R"><code>DVIPSSIZES<span class="r">, overrides</span> R</code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5761 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-dynamic-creation-of-graphics">dynamic creation of graphics</a></td><td class="printindex-index-section"><a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></td></tr> |
| 5762 |
<tr><td colspan="3"><hr></td></tr> |
| 5763 |
<tr><th id="Index_cp_letter-E">E</th></tr> |
| 5764 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-e-config-command-_0028maxdrift_0029"><code>e <span class="r">config command (maxdrift)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5765 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-E-config-command-_0028shell-escape_0029"><code>E <span class="r">config command (shell escape)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5766 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-efficiency_002c-and-fonts">efficiency, and fonts</a></td><td class="printindex-index-section"><a href="#Making-a-font-available">Making a font available</a></td></tr> |
| 5767 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-ehandler_002eps"><code>ehandler.ps</code></a></td><td class="printindex-index-section"><a href="#No-output">No output</a></td></tr> |
| 5768 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-embedding-Type-1-fonts">embedding Type 1 fonts</a></td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr> |
| 5769 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding-changes">encoding changes</a></td><td class="printindex-index-section"><a href="#Changing-font-encodings">Changing font encodings</a></td></tr> |
| 5770 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding-file-format">encoding file format</a></td><td class="printindex-index-section"><a href="#Encoding-file-format">Encoding file format</a></td></tr> |
| 5771 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding-files">encoding files</a></td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr> |
| 5772 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Encoding-Type-1-dictionary"><code>Encoding <span class="r">Type 1 dictionary</span></code></a></td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr> |
| 5773 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding-vectors_002c-defined">encoding vectors, defined</a></td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr> |
| 5774 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding-vectors_002c-in-Type-1-fonts">encoding vectors, in Type 1 fonts</a></td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr> |
| 5775 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-encodings">encodings</a></td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr> |
| 5776 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-encodings_002c-for-bitmap-fonts">encodings, for bitmap fonts</a></td><td class="printindex-index-section"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr> |
| 5777 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-end_002dhook"><code>end-hook</code></a></td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr> |
| 5778 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-environment-variables">environment variables</a></td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr> |
| 5779 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-EOF">EOF</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5780 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-eop_002dhook"><code>eop-hook</code></a></td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr> |
| 5781 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-EPS_002c-and-Ghostview">EPS, and Ghostview</a></td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr> |
| 5782 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-EPSF-macros">EPSF macros</a></td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr> |
| 5783 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-EPSF_002c-generating">EPSF, generating</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5784 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-epsf_002esty"><code>epsf.sty</code></a></td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr> |
| 5785 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-epsf_002etex"><code>epsf.tex</code></a></td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr> |
| 5786 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Epson-printers">Epson printers</a></td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr> |
| 5787 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-error-messages-from-printer">error messages from printer</a></td><td class="printindex-index-section"><a href="#Printer-errors">Printer errors</a></td></tr> |
| 5788 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-even-pages-only">even pages only</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5789 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-examples-of-literal-PostScript">examples of literal PostScript</a></td><td class="printindex-index-section"><a href="#Literal-examples">Literal examples</a></td></tr> |
| 5790 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-expanded-fonts">expanded fonts</a></td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr> |
| 5791 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-expanded-fonts-1">expanded fonts</a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5792 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-expanded-fonts-2">expanded fonts</a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 5793 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-expansion_002c-of-virtual-fonts">expansion, of virtual fonts</a></td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr> |
| 5794 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-extended-URL">extended URL</a></td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr> |
| 5795 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-ExtendFont"><code>ExtendFont</code></a></td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr> |
| 5796 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-extra-characters_002c-accessing">extra characters, accessing</a></td><td class="printindex-index-section"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr> |
| 5797 |
<tr><td colspan="3"><hr></td></tr> |
| 5798 |
<tr><th id="Index_cp_letter-F">F</th></tr> |
| 5799 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-f-config-command-_0028filter_0029"><code>f <span class="r">config command (filter)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5800 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-F-config-command-_0028filter_0029"><code>F <span class="r">config command (filter)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5801 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-failure_002c-and-printer-errors">failure, and printer errors</a></td><td class="printindex-index-section"><a href="#Printer-errors">Printer errors</a></td></tr> |
| 5802 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-failure_002c-of-long-documents">failure, of long documents</a></td><td class="printindex-index-section"><a href="#Long-documents-fail">Long documents fail</a></td></tr> |
| 5803 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-failure_002c-to-include-graphics">failure, to include graphics</a></td><td class="printindex-index-section"><a href="#Including-graphics-fails">Including graphics fails</a></td></tr> |
| 5804 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-failure_002c-to-print-at-all">failure, to print at all</a></td><td class="printindex-index-section"><a href="#No-output">No output</a></td></tr> |
| 5805 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-fallback-resolutions">fallback resolutions</a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5806 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-figures-and-fonts">figures and fonts</a></td><td class="printindex-index-section"><a href="#Fonts-in-figures">Fonts in figures</a></td></tr> |
| 5807 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-figures_002c-natural-size">figures, natural size</a></td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr> |
| 5808 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-figures_002c-scaling">figures, scaling</a></td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr> |
| 5809 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-filter_002c-running-as-a">filter, running as a</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5810 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-first-page-printed">first page printed</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5811 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-font-concepts">font concepts</a></td><td class="printindex-index-section"><a href="#Font-concepts">Font concepts</a></td></tr> |
| 5812 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-font-encodings_002c-bitmap">font encodings, bitmap</a></td><td class="printindex-index-section"><a href="#Bitmap-font-encodings">Bitmap font encodings</a></td></tr> |
| 5813 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-font-generation_002c-avoiding">font generation, avoiding</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5814 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-fontinst"><code>fontinst</code></a></td><td class="printindex-index-section"><a href="#Invoking-afm2tfm">Invoking afm2tfm</a></td></tr> |
| 5815 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-as-header-files">fonts, as header files</a></td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr> |
| 5816 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-changing-encoding-of">fonts, changing encoding of</a></td><td class="printindex-index-section"><a href="#Changing-font-encodings">Changing font encodings</a></td></tr> |
| 5817 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-downloading">fonts, downloading</a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 5818 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-expanded">fonts, expanded</a></td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr> |
| 5819 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-in-PostScript-figures">fonts, in PostScript figures</a></td><td class="printindex-index-section"><a href="#Fonts-in-figures">Fonts in figures</a></td></tr> |
| 5820 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-installation-of-PostScript">fonts, installation of PostScript</a></td><td class="printindex-index-section"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr> |
| 5821 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-installing">fonts, installing</a></td><td class="printindex-index-section"><a href="#Making-a-font-available">Making a font available</a></td></tr> |
| 5822 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-outlined">fonts, outlined</a></td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr> |
| 5823 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-slanted">fonts, slanted</a></td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr> |
| 5824 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-small-caps">fonts, small caps</a></td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr> |
| 5825 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-system-PostScript">fonts, system PostScript</a></td><td class="printindex-index-section"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr> |
| 5826 |
<tr><td colspan="3"><hr></td></tr> |
| 5827 |
<tr><th id="Index_cp_letter-G">G</th></tr> |
| 5828 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-G-config-command-_0028character-shifting_0029"><code>G <span class="r">config command (character shifting)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5829 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-gf-files">gf files</a></td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr> |
| 5830 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-gftopk"><code>gftopk</code></a></td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr> |
| 5831 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Ghostscript-installation">Ghostscript installation</a></td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr> |
| 5832 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-ghostview"><code>ghostview</code></a></td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr> |
| 5833 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Ghostview_002c-and-no-N">Ghostview, and no ‘<samp class="samp">N</samp>’</a></td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr> |
| 5834 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph-files">glyph files</a></td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr> |
| 5835 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-GLYPHFONTS_002c-overrides-P"><code>GLYPHFONTS<span class="r">, overrides</span> P</code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5836 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-gnuplot"><code>gnuplot</code></a></td><td class="printindex-index-section"><a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></td></tr> |
| 5837 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-graphics-inclusion-fails">graphics inclusion fails</a></td><td class="printindex-index-section"><a href="#Including-graphics-fails">Including graphics fails</a></td></tr> |
| 5838 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-gs-installation"><code>gs <span class="r">installation</span></code></a></td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr> |
| 5839 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-gsave_002fgrestore_002c-and-literal-PS"><code>gsave<span class="r">/</span>grestore<span class="r">, and literal PS</span></code></a></td><td class="printindex-index-section"><a href="#Literal-examples">Literal examples</a></td></tr> |
| 5840 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-gsftopk"><code>gsftopk</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5841 |
<tr><td colspan="3"><hr></td></tr> |
| 5842 |
<tr><th id="Index_cp_letter-H">H</th></tr> |
| 5843 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-h-config-command-_0028download-additional-header_0029"><code>h <span class="r">config command (download additional header)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5844 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-H-config-command-_0028PostScript-header-path_0029"><code>H <span class="r">config command (PostScript header path)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5845 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Hafner_002c-Jim">Hafner, Jim</a></td><td class="printindex-index-section"><a href="#Color">Color</a></td></tr> |
| 5846 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-header-file_002c-downloading">header file, downloading</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5847 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-header-files_002c-defined">header files, defined</a></td><td class="printindex-index-section"><a href="#Header-files">Header files</a></td></tr> |
| 5848 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-header-path_002c-defining">header path, defining</a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5849 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-header_003dfile-_005cspecial"><code>header=<var class="var">file</var> \special</code></a></td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr> |
| 5850 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-headers-and-memory-usage">headers and memory usage</a></td><td class="printindex-index-section"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr> |
| 5851 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-headers_002c-including-from-the-command-line">headers, including from the command line</a></td><td class="printindex-index-section"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr> |
| 5852 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-headers_002c-including-in-TeX">headers, including in TeX</a></td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr> |
| 5853 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-hints">hints</a></td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr> |
| 5854 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-hoffset-_0028psfile-special-option_0029"><code>hoffset <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a></td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr> |
| 5855 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-HP4Si-printer-and-paper-trays">HP4Si printer and paper trays</a></td><td class="printindex-index-section"><a href="#Paper-trays">Paper trays</a></td></tr> |
| 5856 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-href"><code>href</code></a></td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr> |
| 5857 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-hscale-_0028psfile-special-option_0029"><code>hscale <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a></td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr> |
| 5858 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-hsize-_0028psfile-special-option_0029"><code>hsize <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a></td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr> |
| 5859 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-html-specials"><code>html <span class="r">specials</span></code></a></td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr> |
| 5860 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-html-specials_002c-and-_002dz"><code>html <span class="r">specials, and ‘<samp class="samp">-z</samp>’</span></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5861 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Hungarian-umlaut">Hungarian umlaut</a></td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr> |
| 5862 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-hyperdvi-extensions_002c-enabling">hyperdvi extensions, enabling</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5863 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-hypertext-and-bitmap-fonts">hypertext and bitmap fonts</a></td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr> |
| 5864 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-hypertext-caveats">hypertext caveats</a></td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr> |
| 5865 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-hypertext-caveats-1">hypertext caveats</a></td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr> |
| 5866 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-hypertext-specials">hypertext specials</a></td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr> |
| 5867 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-hypertext-support">hypertext support</a></td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr> |
| 5868 |
<tr><td colspan="3"><hr></td></tr> |
| 5869 |
<tr><th id="Index_cp_letter-I">I</th></tr> |
| 5870 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-i-config-command-_0028pages_002fsection_0029"><code>i <span class="r">config command (pages/section)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5871 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Illustrator_002c-workaround-for">Illustrator, workaround for</a></td><td class="printindex-index-section"><a href="#Including-graphics-fails">Including graphics fails</a></td></tr> |
| 5872 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-img"><code>img</code></a></td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr> |
| 5873 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-including-graphics-fails">including graphics fails</a></td><td class="printindex-index-section"><a href="#Including-graphics-fails">Including graphics fails</a></td></tr> |
| 5874 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-including-headers-from-the-command-line">including headers from the command line</a></td><td class="printindex-index-section"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr> |
| 5875 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-including-headers-in-TeX">including headers in TeX</a></td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr> |
| 5876 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-installation-of-config_002eps">installation of <samp class="file">config.ps</samp></a></td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr> |
| 5877 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-installation-of-PostScript-fonts">installation of PostScript fonts</a></td><td class="printindex-index-section"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr> |
| 5878 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-installation_002c-of-Dvips">installation, of Dvips</a></td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr> |
| 5879 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-installing-fonts">installing fonts</a></td><td class="printindex-index-section"><a href="#Making-a-font-available">Making a font available</a></td></tr> |
| 5880 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-interaction-with-PostScript">interaction with PostScript</a></td><td class="printindex-index-section"><a href="#Interaction-with-PostScript">Interaction with PostScript</a></td></tr> |
| 5881 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-inverted-output">inverted output</a></td><td class="printindex-index-section"><a href="#Small-or-inverted">Small or inverted</a></td></tr> |
| 5882 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-invoking-Dvips">invoking Dvips</a></td><td class="printindex-index-section"><a href="#Invoking-Dvips">Invoking Dvips</a></td></tr> |
| 5883 |
<tr><td colspan="3"><hr></td></tr> |
| 5884 |
<tr><th id="Index_cp_letter-J">J</th></tr> |
| 5885 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-j-config-command-_0028partial-font-downloading_0029"><code>j <span class="r">config command (partial font downloading)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5886 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Japanese-font-metric-file">Japanese font metric file</a></td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr> |
| 5887 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Jeffrey_002c-Alan">Jeffrey, Alan</a></td><td class="printindex-index-section"><a href="#Invoking-afm2tfm">Invoking afm2tfm</a></td></tr> |
| 5888 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-JFM-file_002c-and-virtual-font-fallback">JFM file, and virtual font fallback</a></td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr> |
| 5889 |
<tr><td colspan="3"><hr></td></tr> |
| 5890 |
<tr><th id="Index_cp_letter-K">K</th></tr> |
| 5891 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-K-config-command-_0028comment-removal_0029"><code>K <span class="r">config command (comment removal)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5892 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-kerning_002c-defined">kerning, defined</a></td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr> |
| 5893 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-KPATHSEA_005fDEBUG"><code>KPATHSEA_DEBUG</code></a></td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr> |
| 5894 |
<tr><td colspan="3"><hr></td></tr> |
| 5895 |
<tr><th id="Index_cp_letter-L">L</th></tr> |
| 5896 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-L-config-command-_0028last-paper-size-wins_0029"><code>L <span class="r">config command (last paper size wins)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5897 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-landscape-orientation_002c-defined">landscape orientation, defined</a></td><td class="printindex-index-section"><a href="#Paper-size-and-landscape">Paper size and landscape</a></td></tr> |
| 5898 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-landscape-papertype">landscape papertype</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5899 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-landscape_002c-as-_005cspecial"><code>landscape<span class="r">, as <code class="code">\special</code></span></code></a></td><td class="printindex-index-section"><a href="#papersize-special">‘<samp class="samp">papersize</samp>’ special</a></td></tr> |
| 5900 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-landscaperotate">landscaperotate</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5901 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-landscaperotate-command-line-option">landscaperotate command line option</a></td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> |
| 5902 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-landscaperotate-config-command"><code>landscaperotate <span class="r">config command</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5903 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-landscaperotate-configuration-file-command">landscaperotate configuration file command</a></td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> |
| 5904 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-last-page-printed">last page printed</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5905 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-last_002dresort-font-scaling_002c-with-DVIPSSIZES">last-resort font scaling, with <code class="code">DVIPSSIZES</code></a></td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr> |
| 5906 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-last_002dresort-scaling_002c-with-R">last-resort scaling, with <code class="code">R</code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5907 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-ledger-papertype">ledger papertype</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5908 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-legal-papertype">legal papertype</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5909 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-letter-paper-size"><code>letter <span class="r">paper size</span></code></a></td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> |
| 5910 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-letter-papertype">letter papertype</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5911 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-letterhead-tray">letterhead tray</a></td><td class="printindex-index-section"><a href="#Paper-trays">Paper trays</a></td></tr> |
| 5912 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-letterSize-paper-size"><code>letterSize <span class="r">paper size</span></code></a></td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> |
| 5913 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-ligature-operations">ligature operations</a></td><td class="printindex-index-section"><a href="#Encoding-file-format">Encoding file format</a></td></tr> |
| 5914 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-ligature_002c-defined">ligature, defined</a></td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr> |
| 5915 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-LIGKERN-encoding-file-command"><code>LIGKERN <span class="r">encoding file command</span></code></a></td><td class="printindex-index-section"><a href="#Encoding-file-format">Encoding file format</a></td></tr> |
| 5916 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-lines-in-figures_002c-wrong-width">lines in figures, wrong width</a></td><td class="printindex-index-section"><a href="#EPSF-clipping">EPSF clipping</a></td></tr> |
| 5917 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-links_002c-hypertext">links, hypertext</a></td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr> |
| 5918 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-literal-headers">literal headers</a></td><td class="printindex-index-section"><a href="#Literal-headers">Literal headers</a></td></tr> |
| 5919 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-literal-PostScript_002c-examples">literal PostScript, examples</a></td><td class="printindex-index-section"><a href="#Literal-examples">Literal examples</a></td></tr> |
| 5920 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-literal-PostScript_002c-using">literal PostScript, using</a></td><td class="printindex-index-section"><a href="#Literal-PS">Literal PS</a></td></tr> |
| 5921 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-llx-_0028psfile-special-option_0029"><code>llx <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a></td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr> |
| 5922 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-lly-_0028psfile-special-option_0029"><code>lly <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a></td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr> |
| 5923 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-long-documents-not-printing">long documents not printing</a></td><td class="printindex-index-section"><a href="#Long-documents-fail">Long documents fail</a></td></tr> |
| 5924 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-low-characters_002c-shifting">low characters, shifting</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5925 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-lpr-spooler_002c-MS_002dDOS-emulation">lpr spooler, MS-DOS emulation</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5926 |
<tr><td colspan="3"><hr></td></tr> |
| 5927 |
<tr><th id="Index_cp_letter-M">M</th></tr> |
| 5928 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-m-config-command-_0028available-memory_0029"><code>m <span class="r">config command (available memory)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5929 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-M-config-command-_0028mf-mode_0029"><code>M <span class="r">config command (mf mode)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5930 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-macros-for-color">macros for color</a></td><td class="printindex-index-section"><a href="#Color-macro-files">Color macro files</a></td></tr> |
| 5931 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-macros-for-epsf-inclusion">macros for epsf inclusion</a></td><td class="printindex-index-section"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr> |
| 5932 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-macros-for-epsf-inclusion-1">macros for epsf inclusion</a></td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr> |
| 5933 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-magnification_002c-DVI">magnification, DVI</a></td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr> |
| 5934 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-magnification_002c-overriding-DVI">magnification, overriding DVI</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5935 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-magnification_002c-vertical">magnification, vertical</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5936 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-mailcap-and-hypertext"><code>mailcap <span class="r">and hypertext</span></code></a></td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr> |
| 5937 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-manual-feed">manual feed</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5938 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-maxdrift">maxdrift</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5939 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-maximum-pages-printed">maximum pages printed</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5940 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-media">media</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5941 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-memory-available">memory available</a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5942 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-memory-of-printer-exhausted">memory of printer exhausted</a></td><td class="printindex-index-section"><a href="#Printer-errors">Printer errors</a></td></tr> |
| 5943 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-memory-usage_002c-and-headers">memory usage, and headers</a></td><td class="printindex-index-section"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr> |
| 5944 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-memory_002c-conserving">memory, conserving</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5945 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-memory_002c-used-by-PostScript-fonts">memory, used by PostScript fonts</a></td><td class="printindex-index-section"><a href="#Making-a-font-available">Making a font available</a></td></tr> |
| 5946 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-ligature-operations">Metafont ligature operations</a></td><td class="printindex-index-section"><a href="#Encoding-file-format">Encoding file format</a></td></tr> |
| 5947 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-mode_002c-specifying">Metafont mode, specifying</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5948 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-source-files">Metafont source files</a></td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr> |
| 5949 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-metric-files">metric files</a></td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr> |
| 5950 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Minion-typeface-family">Minion typeface family</a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 5951 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-MISSFONT_005fLOG"><code>MISSFONT_LOG</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5952 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-missfont_002elog"><code>missfont.log</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5953 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Mitsubishi-Shinko-CHC_002dS446i-printer">Mitsubishi Shinko CHC-S446i printer</a></td><td class="printindex-index-section"><a href="#No-output">No output</a></td></tr> |
| 5954 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-mkdvipspapers"><code>mkdvipspapers</code></a></td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> |
| 5955 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-mktexpk_002c-avoiding"><code>mktexpk<span class="r">, avoiding</span></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5956 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-mktexpk_002c-changing-name"><code>mktexpk<span class="r">, changing name</span></code></a></td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr> |
| 5957 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-mode-name_002c-specifying">mode name, specifying</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5958 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-mtpk"><code>mtpk</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5959 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-multiple-master-fonts">multiple master fonts</a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 5960 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-multiple-output-files">multiple output files</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5961 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-multiple-paper-trays">multiple paper trays</a></td><td class="printindex-index-section"><a href="#Paper-trays">Paper trays</a></td></tr> |
| 5962 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Murphy_002c-Tim">Murphy, Tim</a></td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr> |
| 5963 |
<tr><td colspan="3"><hr></td></tr> |
| 5964 |
<tr><th id="Index_cp_letter-N">N</th></tr> |
| 5965 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-N-config-command-_0028disable-EPS_0029"><code>N <span class="r"> config command (disable EPS)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5966 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-name"><code>name</code></a></td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr> |
| 5967 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-narrow-fonts">narrow fonts</a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 5968 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-no-output-at-all">no output at all</a></td><td class="printindex-index-section"><a href="#No-output">No output</a></td></tr> |
| 5969 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-non_002dprinting-characters_002c-shifting">non-printing characters, shifting</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5970 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-non_002dresident-fonts">non-resident fonts</a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 5971 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-nopaper_002c-paper-format-for-_002dt"><code>nopaper<span class="r">, paper format for ‘<samp class="samp">-t</samp>’</span></code></a></td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> |
| 5972 |
<tr><td colspan="3"><hr></td></tr> |
| 5973 |
<tr><th id="Index_cp_letter-O">O</th></tr> |
| 5974 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-o-config-command-_0028output-destination_0029"><code>o <span class="r">config command (output destination)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5975 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-O-config-command-_0028page-offsets_0029"><code>O <span class="r">config command (page offsets)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5976 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-oblique-fonts">oblique fonts</a></td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr> |
| 5977 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-octal-character-codes">octal character codes</a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5978 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-odd-pages-only">odd pages only</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5979 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-offset-pages">offset pages</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5980 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Omega-extensions">Omega extensions</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5981 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-option_002c-details-of">option, details of</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5982 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-options_002c-debugging">options, debugging</a></td><td class="printindex-index-section"><a href="#Debug-options">Debug options</a></td></tr> |
| 5983 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-options_002c-Dvips">options, Dvips</a></td><td class="printindex-index-section"><a href="#Invoking-Dvips">Invoking Dvips</a></td></tr> |
| 5984 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-options_002c-reading-from-standard-input">options, reading from standard input</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5985 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-options_002c-summary">options, summary</a></td><td class="printindex-index-section"><a href="#Option-summary">Option summary</a></td></tr> |
| 5986 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-options_002c-to-Afm2tfm">options, to Afm2tfm</a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 5987 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-outline-fonts">outline fonts</a></td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr> |
| 5988 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-outline-fonts-1">outline fonts</a></td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr> |
| 5989 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-output-file_002c-sectioning-of">output file, sectioning of</a></td><td class="printindex-index-section"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr> |
| 5990 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-output-file_002c-setting">output file, setting</a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 5991 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-output-files_002c-multiple">output files, multiple</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5992 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-output-title_002c-specifying">output title, specifying</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5993 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-inverted">output, inverted</a></td><td class="printindex-index-section"><a href="#Small-or-inverted">Small or inverted</a></td></tr> |
| 5994 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-none">output, none</a></td><td class="printindex-index-section"><a href="#No-output">No output</a></td></tr> |
| 5995 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-redirecting">output, redirecting</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 5996 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-too-small">output, too small</a></td><td class="printindex-index-section"><a href="#Small-or-inverted">Small or inverted</a></td></tr> |
| 5997 |
<tr><td colspan="3"><hr></td></tr> |
| 5998 |
<tr><th id="Index_cp_letter-P">P</th></tr> |
| 5999 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-p-config-command-_0028font-aliases_0029"><code>p <span class="r">config command (font aliases)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6000 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-P-config-command-_0028PK-path_0029"><code>P <span class="r">config command (PK path)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6001 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-page-numbers_002c-multiple-repetitions-of">page numbers, multiple repetitions of</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6002 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-page-range">page range</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6003 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-page_002c-first-printed">page, first printed</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6004 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-page_002c-last-printed">page, last printed</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6005 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-pages_002c-maximum-printed">pages, maximum printed</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6006 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PaintType"><code>PaintType</code></a></td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr> |
| 6007 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Pantone-colors">Pantone colors</a></td><td class="printindex-index-section"><a href="#Color-macro-files">Color macro files</a></td></tr> |
| 6008 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-paper-size-configuration-file-command">paper size configuration file command</a></td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> |
| 6009 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-paper-size_002c-default">paper size, default</a></td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr> |
| 6010 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-paper-size_002c-general">paper size, general</a></td><td class="printindex-index-section"><a href="#Paper-size-and-landscape">Paper size and landscape</a></td></tr> |
| 6011 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-paper-trays">paper trays</a></td><td class="printindex-index-section"><a href="#Paper-trays">Paper trays</a></td></tr> |
| 6012 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-paper-type">paper type</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6013 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-papersize-special"><code>papersize <span class="r">special</span></code></a></td><td class="printindex-index-section"><a href="#papersize-special">‘<samp class="samp">papersize</samp>’ special</a></td></tr> |
| 6014 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-papersize-special_002c-and-no-_002dt">papersize special, and no ‘<samp class="samp">-t</samp>’</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6015 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-papersize-special_002c-first-vs_002e-last">‘<samp class="samp">papersize</samp>’ special, first vs. last</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6016 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-partial-font-downloading">partial font downloading</a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 6017 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PDF-files_002c-font-quality">PDF files, font quality</a></td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr> |
| 6018 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PDF-files_002c-making">PDF files, making</a></td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr> |
| 6019 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PDF-files_002c-making-1">PDF files, making</a></td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr> |
| 6020 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PDF-files_002c-option-for">PDF files, option for</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6021 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-pdfmark"><code>pdfmark</code></a></td><td class="printindex-index-section"><a href="#Hypertext">Hypertext</a></td></tr> |
| 6022 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-pfa-files">pfa files</a></td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr> |
| 6023 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-pfb-files">pfb files</a></td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr> |
| 6024 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-pfb-files_002c-automatically-unpacked">pfb files, automatically unpacked</a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 6025 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-pfm-files">pfm files</a></td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr> |
| 6026 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Phaser-printer_002c-used-for-color-calibration">Phaser printer, used for color calibration</a></td><td class="printindex-index-section"><a href="#Color-device-configuration">Color device configuration</a></td></tr> |
| 6027 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-physical-page-number_002c-and-_002dl">physical page number, and ‘<samp class="samp">-l</samp>’</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6028 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-physical-page-number_002c-and-_002dp">physical page number, and ‘<samp class="samp">-p</samp>’</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6029 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-physical-page-number_002c-and-bop_002dhook">physical page number, and <code class="code">bop-hook</code></a></td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr> |
| 6030 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-pipes_002c-not-readable">pipes, not readable</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6031 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-pk-files">pk files</a></td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr> |
| 6032 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PKFONTS_002c-overrides-P"><code>PKFONTS<span class="r">, overrides</span> P</code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6033 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-plotfile_002c-ps-subspecial"><code>plotfile<span class="r">, ‘<samp class="samp">ps</samp>’ subspecial</span></code></a></td><td class="printindex-index-section"><a href="#ps-special">ps special</a></td></tr> |
| 6034 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-pltotf"><code>pltotf</code></a></td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr> |
| 6035 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-popen-for-output"><code>popen <span class="r">for output</span></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6036 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-portrait-orientation_002c-defined">portrait orientation, defined</a></td><td class="printindex-index-section"><a href="#Paper-size-and-landscape">Paper size and landscape</a></td></tr> |
| 6037 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-positioning-accuracy">positioning accuracy</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6038 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-post-code-after-headers"><code>post <span class="r">code after headers</span></code></a></td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr> |
| 6039 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-code_002c-literal">PostScript code, literal</a></td><td class="printindex-index-section"><a href="#Literal-PS">Literal PS</a></td></tr> |
| 6040 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-encoding">PostScript encoding</a></td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr> |
| 6041 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-encoding_002c-changing">PostScript encoding, changing</a></td><td class="printindex-index-section"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr> |
| 6042 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-font-alias-file">PostScript font alias file</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6043 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-font-alias-file-1">PostScript font alias file</a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6044 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-fonts">PostScript fonts</a></td><td class="printindex-index-section"><a href="#PostScript-fonts">PostScript fonts</a></td></tr> |
| 6045 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-fonts_002c-installing">PostScript fonts, installing</a></td><td class="printindex-index-section"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr> |
| 6046 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-fonts_002c-on-your-system">PostScript fonts, on your system</a></td><td class="printindex-index-section"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr> |
| 6047 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-header-files">PostScript header files</a></td><td class="printindex-index-section"><a href="#Header-files">Header files</a></td></tr> |
| 6048 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-hooks">PostScript hooks</a></td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr> |
| 6049 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-interaction">PostScript interaction</a></td><td class="printindex-index-section"><a href="#Interaction-with-PostScript">Interaction with PostScript</a></td></tr> |
| 6050 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-previewers">PostScript previewers</a></td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr> |
| 6051 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-units">PostScript units</a></td><td class="printindex-index-section"><a href="#Bounding-box">Bounding box</a></td></tr> |
| 6052 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PowerPage-PostScript-implementation">PowerPage PostScript implementation</a></td><td class="printindex-index-section"><a href="#No-output">No output</a></td></tr> |
| 6053 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-pre-code-before-headers"><code>pre <span class="r">code before headers</span></code></a></td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr> |
| 6054 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-previewing-Dvips-output">previewing Dvips output</a></td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr> |
| 6055 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PRINTER"><code>PRINTER</code></a></td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr> |
| 6056 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-printer-configuration">printer configuration</a></td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr> |
| 6057 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-printer-configuration-file_002c-prototype">printer configuration file, prototype</a></td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr> |
| 6058 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-printer-errors">printer errors</a></td><td class="printindex-index-section"><a href="#Printer-errors">Printer errors</a></td></tr> |
| 6059 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-printer-memory">printer memory</a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6060 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-printer-memory-exhausted">printer memory exhausted</a></td><td class="printindex-index-section"><a href="#Printer-errors">Printer errors</a></td></tr> |
| 6061 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-printer-offset">printer offset</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6062 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PRINTER_002c-and-config-file-searching"><code>PRINTER<span class="r">, and config file searching</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr> |
| 6063 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-PRINTER_002c-avoided-with-_002df"><code>PRINTER<span class="r">, avoided with ‘<samp class="samp">-f</samp>’</span></code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6064 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-printer_002c-driving-directly">printer, driving directly</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6065 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-problems">problems</a></td><td class="printindex-index-section"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr> |
| 6066 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-property-list-files">property list files</a></td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr> |
| 6067 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-prototype-printer-configuration-file">prototype printer configuration file</a></td><td class="printindex-index-section"><a href="#config_002eps-installation">config.ps installation</a></td></tr> |
| 6068 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-ps-special"><code>ps <span class="r">special</span></code></a></td><td class="printindex-index-section"><a href="#ps-special">ps special</a></td></tr> |
| 6069 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-psfile-special"><code>psfile <span class="r">special</span></code></a></td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr> |
| 6070 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-psfonts_002emap"><code>psfonts.map</code></a></td><td class="printindex-index-section"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr> |
| 6071 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-psfonts_002emap-1"><code>psfonts.map</code></a></td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr> |
| 6072 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-psfonts_002emap-2"><code>psfonts.map</code></a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 6073 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-psheaderdir"><code>psheaderdir</code></a></td><td class="printindex-index-section"><a href="#Header-files">Header files</a></td></tr> |
| 6074 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-psi-character-missing">psi character missing</a></td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr> |
| 6075 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-pstopk"><code>pstopk</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6076 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-pTeX-extensions">pTeX extensions</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6077 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-pTeX-extensions-1">pTeX extensions</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6078 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-ptex-JFM"><code>ptex <span class="r">JFM</span></code></a></td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr> |
| 6079 |
<tr><td colspan="3"><hr></td></tr> |
| 6080 |
<tr><th id="Index_cp_letter-Q">Q</th></tr> |
| 6081 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-q-config-command-_0028quiet_0029"><code>q <span class="r">config command (quiet)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6082 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Q-config-command-_0028quiet_0029"><code>Q <span class="r">config command (quiet)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6083 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-quiet-operation">quiet operation</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6084 |
<tr><td colspan="3"><hr></td></tr> |
| 6085 |
<tr><th id="Index_cp_letter-R">R</th></tr> |
| 6086 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-R-config-command-_0028fallback-resolution_0029"><code>R <span class="r">config command (fallback resolution)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6087 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-r-config-command-_0028page-reversal_0029"><code>r <span class="r">config command (page reversal)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6088 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-raw-tfm-files">raw tfm files</a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 6089 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-reencode_002f_002a_002eenc"><code>reencode/*.enc</code></a></td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr> |
| 6090 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-reencoding">reencoding</a></td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr> |
| 6091 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-reencoding-PostScript-fonts">reencoding PostScript fonts</a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 6092 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-registered-character_002c-accessing"><code>registered <span class="r">character, accessing</span></code></a></td><td class="printindex-index-section"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr> |
| 6093 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-remapping">remapping</a></td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr> |
| 6094 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-resident-fonts_002c-different-in-different-printers">resident fonts, different in different printers</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6095 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-resident-fonts_002c-different-in-different-printers-1">resident fonts, different in different printers</a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6096 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-resolution">resolution</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6097 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-resolution-1">resolution</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6098 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-resolution_002c-setting">resolution, setting</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6099 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-reverse-pagination">reverse pagination</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6100 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-rhi-_0028psfile-special-option_0029"><code>rhi <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a></td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr> |
| 6101 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Rokicki_002c-Tomas">Rokicki, Tomas</a></td><td class="printindex-index-section"><a href="#Why-Dvips">Why Dvips</a></td></tr> |
| 6102 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-rotate_002etex"><code>rotate.tex</code></a></td><td class="printindex-index-section"><a href="#ps-special">ps special</a></td></tr> |
| 6103 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-rwi-_0028psfile-special-option_0029"><code>rwi <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a></td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr> |
| 6104 |
<tr><td colspan="3"><hr></td></tr> |
| 6105 |
<tr><th id="Index_cp_letter-S">S</th></tr> |
| 6106 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-s-config-command-_0028global-save_002frestore_0029"><code>s <span class="r">config command (global save/restore)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6107 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-S-config-command-_0028pict-path_0029"><code>S <span class="r">config command (pict path)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6108 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-save_002frestore_002c-and-inverted-output">save/restore, and inverted output</a></td><td class="printindex-index-section"><a href="#Small-or-inverted">Small or inverted</a></td></tr> |
| 6109 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-save_002frestore_002c-and-literal-PS"><code>save<span class="r">/</span>restore<span class="r">, and literal PS</span></code></a></td><td class="printindex-index-section"><a href="#Literal-examples">Literal examples</a></td></tr> |
| 6110 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-save_002frestore_002c-and-specials">save/restore, and specials</a></td><td class="printindex-index-section"><a href="#ps-special">ps special</a></td></tr> |
| 6111 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-save_002frestore_002c-generating-global">save/restore, generating global</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6112 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-scaleunit"><code>scaleunit</code></a></td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr> |
| 6113 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-of-figures">scaling of figures</a></td><td class="printindex-index-section"><a href="#EPSF-scaling">EPSF scaling</a></td></tr> |
| 6114 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-small-caps">scaling small caps</a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 6115 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Scandinavian-A-ring">Scandinavian A ring</a></td><td class="printindex-index-section"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr> |
| 6116 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-screen-frequencies_002c-setting">screen frequencies, setting</a></td><td class="printindex-index-section"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr> |
| 6117 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-SDict"><code>SDict</code></a></td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr> |
| 6118 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-SDict-dictionary"><code>SDict <span class="r">dictionary</span></code></a></td><td class="printindex-index-section"><a href="#Literal-headers">Literal headers</a></td></tr> |
| 6119 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-searching-config-files_002c-order-of">searching config files, order of</a></td><td class="printindex-index-section"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr> |
| 6120 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-sections-of-output-file_002c-and-memory">sections of output file, and memory</a></td><td class="printindex-index-section"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr> |
| 6121 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-sections-output_002c-in-separate-files">sections output, in separate files</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6122 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-security">security</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6123 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-shell-command-execution_002c-disabling">shell command execution, disabling</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6124 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-shell-escape_002c-in-config-file">shell escape, in config file</a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6125 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Shinko-CHC_002dS446i-printer">Shinko CHC-S446i printer</a></td><td class="printindex-index-section"><a href="#No-output">No output</a></td></tr> |
| 6126 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-show-PostScript-operator"><code>show <span class="r">PostScript operator</span></code></a></td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr> |
| 6127 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-silent-operation">silent operation</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6128 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-simplex-mode-on-duplex-printers">simplex mode on duplex printers</a></td><td class="printindex-index-section"><a href="#Including-headers-from-the-command-line">Including headers from the command line</a></td></tr> |
| 6129 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-slanted-fonts">slanted fonts</a></td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr> |
| 6130 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-slanted-fonts_002c-making">slanted fonts, making</a></td><td class="printindex-index-section"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr> |
| 6131 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-SlantFont"><code>SlantFont</code></a></td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr> |
| 6132 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-small-caps-fonts">small caps fonts</a></td><td class="printindex-index-section"><a href="#Special-font-effects">Special font effects</a></td></tr> |
| 6133 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Smith_002c-Arthur">Smith, Arthur</a></td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr> |
| 6134 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-spaces_002c-dropped-trailing">spaces, dropped trailing</a></td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr> |
| 6135 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-specials_002c-hypertext">specials, hypertext</a></td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr> |
| 6136 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-splines">splines</a></td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr> |
| 6137 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-spooler_002c-lacking">spooler, lacking</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6138 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-spooling-to-lpr-on-MS_002dDOS">spooling to lpr on MS-DOS</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6139 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-standard-I_002fO">standard I/O</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6140 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-standard-input_002c-reading-options-from">standard input, reading options from</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6141 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-standard-output_002c-output-to">standard output, output to</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6142 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-standard-PostScript_002c-required-by-Ghostview">standard PostScript, required by Ghostview</a></td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr> |
| 6143 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-start_002dhook"><code>start-hook</code></a></td><td class="printindex-index-section"><a href="#PostScript-hooks">PostScript hooks</a></td></tr> |
| 6144 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-structured-comments">structured comments</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6145 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-system-in-config-file"><code>system <span class="r">in config file</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6146 |
<tr><td colspan="3"><hr></td></tr> |
| 6147 |
<tr><th id="Index_cp_letter-T">T</th></tr> |
| 6148 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-T-config-command-_0028TFM-path_0029"><code>T <span class="r">config command (TFM path)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6149 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Tektronix-Phaser-printer_002c-used-for-color-calibration">Tektronix Phaser printer, used for color calibration</a></td><td class="printindex-index-section"><a href="#Color-device-configuration">Color device configuration</a></td></tr> |
| 6150 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-testpage_002etex"><code>testpage.tex</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6151 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-TeX-encoding_002c-changing">TeX encoding, changing</a></td><td class="printindex-index-section"><a href="#Changing-TeX-encodings">Changing TeX encodings</a></td></tr> |
| 6152 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-TeX_002c-including-headers-in">TeX, including headers in</a></td><td class="printindex-index-section"><a href="#Including-headers-from-TeX">Including headers from TeX</a></td></tr> |
| 6153 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXCONFIG"><code>TEXCONFIG</code></a></td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr> |
| 6154 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXFONTS_002c-overrides-P"><code>TEXFONTS<span class="r">, overrides</span> P</code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6155 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXFONTS_002c-overrides-T"><code>TEXFONTS<span class="r">, overrides</span> T</code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6156 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXINPUTS_002c-overrides-S"><code>TEXINPUTS<span class="r">, overrides</span> S</code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6157 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-texmext_002eenc"><code>texmext.enc</code></a></td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr> |
| 6158 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMFOUTPUT"><code>TEXMFOUTPUT</code></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6159 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-texmital_002eenc"><code>texmital.enc</code></a></td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr> |
| 6160 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-texmsym_002eenc"><code>texmsym.enc</code></a></td><td class="printindex-index-section"><a href="#Encodings">Encodings</a></td></tr> |
| 6161 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-texmsym_002eenc-1"><code>texmsym.enc</code></a></td><td class="printindex-index-section"><a href="#Changing-TeX-encodings">Changing TeX encodings</a></td></tr> |
| 6162 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXPICTS"><code>TEXPICTS</code></a></td><td class="printindex-index-section"><a href="#Environment-variables">Environment variables</a></td></tr> |
| 6163 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXPICTS_002c-overrides-S"><code>TEXPICTS<span class="r">, overrides</span> S</code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6164 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXPKS_002c-overrides-P"><code>TEXPKS<span class="r">, overrides</span> P</code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6165 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-TEXSIZES_002c-overrides-R"><code>TEXSIZES<span class="r">, overrides</span> R</code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6166 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-text-in-figures_002c-chopped-off">text in figures, chopped off</a></td><td class="printindex-index-section"><a href="#EPSF-clipping">EPSF clipping</a></td></tr> |
| 6167 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-tfm-files">tfm files</a></td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr> |
| 6168 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-TFMFONTS_002c-overrides-T"><code>TFMFONTS<span class="r">, overrides</span> T</code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6169 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-tftopl"><code>tftopl</code></a></td><td class="printindex-index-section"><a href="#Metric-files">Metric files</a></td></tr> |
| 6170 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Theisen_002c-Tim">Theisen, Tim</a></td><td class="printindex-index-section"><a href="#Ghostscript-installation">Ghostscript installation</a></td></tr> |
| 6171 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-tight-bounding-box_002c-finding">tight bounding box, finding</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6172 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-title_002c-specifying">title, specifying</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6173 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-too_002dsmall-output">too-small output</a></td><td class="printindex-index-section"><a href="#Small-or-inverted">Small or inverted</a></td></tr> |
| 6174 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-trademark-character_002c-accessing"><code>trademark <span class="r">character, accessing</span></code></a></td><td class="printindex-index-section"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr> |
| 6175 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-trailing-spaces_002c-dropped">trailing spaces, dropped</a></td><td class="printindex-index-section"><a href="#Hypertext-caveats">Hypertext caveats</a></td></tr> |
| 6176 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-TranScript">TranScript</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6177 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-transforming-downloaded-fonts">transforming downloaded fonts</a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 6178 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-trouble">trouble</a></td><td class="printindex-index-section"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr> |
| 6179 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Type-1-fonts">Type 1 fonts</a></td><td class="printindex-index-section"><a href="#Glyph-files">Glyph files</a></td></tr> |
| 6180 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-typesetting-in-PostScript">typesetting in PostScript</a></td><td class="printindex-index-section"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr> |
| 6181 |
<tr><td colspan="3"><hr></td></tr> |
| 6182 |
<tr><th id="Index_cp_letter-U">U</th></tr> |
| 6183 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-U-config-command-_0028Xerox-4045_0029"><code>U <span class="r">config command (Xerox 4045)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6184 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-uncollated-copies">uncollated copies</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6185 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-uncompressing-PostScript">uncompressing PostScript</a></td><td class="printindex-index-section"><a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></td></tr> |
| 6186 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-uniform-resource-locator">uniform resource locator</a></td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr> |
| 6187 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-unknown_002c-paper-format-for-_002dt"><code>unknown<span class="r">, paper format for ‘<samp class="samp">-t</samp>’</span></code></a></td><td class="printindex-index-section"><a href="#papersize-special">‘<samp class="samp">papersize</samp>’ special</a></td></tr> |
| 6188 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-unknown_002c-paper-format-for-_002dt-1"><code>unknown<span class="r">, paper format for ‘<samp class="samp">-t</samp>’</span></code></a></td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> |
| 6189 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-uptex-JFM"><code>uptex <span class="r">JFM</span></code></a></td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr> |
| 6190 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-URL_002c-definition">URL, definition</a></td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr> |
| 6191 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-URL_002c-extended-for-TeX">URL, extended for TeX</a></td><td class="printindex-index-section"><a href="#Hypertext-specials">Hypertext specials</a></td></tr> |
| 6192 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-urx-_0028psfile-special-option_0029"><code>urx <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a></td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr> |
| 6193 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-ury-_0028psfile-special-option_0029"><code>ury <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a></td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr> |
| 6194 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-usage_002c-basic">usage, basic</a></td><td class="printindex-index-section"><a href="#Basic-usage">Basic usage</a></td></tr> |
| 6195 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-user_002ddefinable-colors">user-definable colors</a></td><td class="printindex-index-section"><a href="#User_002ddefinable-colors">User-definable colors</a></td></tr> |
| 6196 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-userdict_002c-and-dictionary-files"><code>userdict<span class="r">, and dictionary files</span></code></a></td><td class="printindex-index-section"><a href="#Header-files">Header files</a></td></tr> |
| 6197 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-userdict_002c-used-for-header-files">userdict<span class="r">, used for header files</span></a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6198 |
<tr><td colspan="3"><hr></td></tr> |
| 6199 |
<tr><th id="Index_cp_letter-V">V</th></tr> |
| 6200 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-V-config-command-_0028vf-path_0029"><code>V <span class="r">config command (vf path)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6201 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-verbose-EPSF-processing">verbose EPSF processing</a></td><td class="printindex-index-section"><a href="#EPSF-macros">EPSF macros</a></td></tr> |
| 6202 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-vf-files">vf files</a></td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr> |
| 6203 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-virtual-font-expansion">virtual font expansion</a></td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr> |
| 6204 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-virtual-font-path">virtual font path</a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6205 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-virtual-fonts">virtual fonts</a></td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr> |
| 6206 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-virtual-fonts_002c-creating">virtual fonts, creating</a></td><td class="printindex-index-section"><a href="#Invoking-afm2tfm">Invoking afm2tfm</a></td></tr> |
| 6207 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-VM-exhausted">VM exhausted</a></td><td class="printindex-index-section"><a href="#Printer-errors">Printer errors</a></td></tr> |
| 6208 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-VMusage"><code>VMusage</code></a></td><td class="printindex-index-section"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr> |
| 6209 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-voffset-_0028psfile-special-option_0029"><code>voffset <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a></td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr> |
| 6210 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-vpl-files">vpl files</a></td><td class="printindex-index-section"><a href="#Virtual-fonts">Virtual fonts</a></td></tr> |
| 6211 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-vptovf"><code>vptovf</code></a></td><td class="printindex-index-section"><a href="#Making-a-font-available">Making a font available</a></td></tr> |
| 6212 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-vscale-_0028psfile-special-option_0029"><code>vscale <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a></td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr> |
| 6213 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-vsize-_0028psfile-special-option_0029"><code>vsize <span class="r">(‘<samp class="samp">psfile</samp>’ special option)</span></code></a></td><td class="printindex-index-section"><a href="#psfile-special">psfile special</a></td></tr> |
| 6214 |
<tr><td colspan="3"><hr></td></tr> |
| 6215 |
<tr><th id="Index_cp_letter-W">W</th></tr> |
| 6216 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-W-config-command-_0028emit-warning_0029"><code>W <span class="r">config command (emit warning)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6217 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-warning-messages_002c-defining">warning messages, defining</a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6218 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-warnings_002c-suppressing">warnings, suppressing</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6219 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-whole-font-downloading">whole font downloading</a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 6220 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-wide-fonts">wide fonts</a></td><td class="printindex-index-section"><a href="#psfonts_002emap">psfonts.map</a></td></tr> |
| 6221 |
<tr><td colspan="3"><hr></td></tr> |
| 6222 |
<tr><th id="Index_cp_letter-X">X</th></tr> |
| 6223 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-X-config-command-_0028horizontal-resolution_0029"><code>X <span class="r">config command (horizontal resolution)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6224 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Xerox-4045">Xerox 4045</a></td><td class="printindex-index-section"><a href="#Option-details">Option details</a></td></tr> |
| 6225 |
<tr><td colspan="3"><hr></td></tr> |
| 6226 |
<tr><th id="Index_cp_letter-Y">Y</th></tr> |
| 6227 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Y-config-command-_0028vertical-resolution_0029"><code>Y <span class="r">config command (vertical resolution)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6228 |
<tr><td colspan="3"><hr></td></tr> |
| 6229 |
<tr><th id="Index_cp_letter-Z">Z</th></tr> |
| 6230 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-Z-config-command-_0028compress-fonts_0029"><code>Z <span class="r">config command (compress fonts)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6231 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-z-config-command-_0028secure-mode_0029"><code>z <span class="r">config command (secure mode)</span></code></a></td><td class="printindex-index-section"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr> |
| 6232 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-zero-dimensions-and-setting-paper-size">zero dimensions and setting paper size</a></td><td class="printindex-index-section"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr> |
| 6233 |
<tr><td colspan="3"><hr></td></tr> |
| 6234 |
</table> |
| 6235 |
<table class="cp-letters-footer-printindex"><tr><th>Jump to: </th><td><a class="summary-letter-printindex" href="#Index_cp_symbol-1"><b>-</b></a> |
| 6236 |
|
| 6237 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-2"><b>!</b></a> |
| 6238 |
|
| 6239 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-3"><b>.</b></a> |
| 6240 |
|
| 6241 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-4"><b>"</b></a> |
| 6242 |
|
| 6243 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-5"><b>(</b></a> |
| 6244 |
|
| 6245 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-6"><b>@</b></a> |
| 6246 |
|
| 6247 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-7"><b>/</b></a> |
| 6248 |
|
| 6249 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-8"><b>\</b></a> |
| 6250 |
|
| 6251 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-9"><b>%</b></a> |
| 6252 |
|
| 6253 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-10"><b>+</b></a> |
| 6254 |
|
| 6255 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-11"><b><</b></a> |
| 6256 |
|
| 6257 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-12"><b>=</b></a> |
| 6258 |
|
| 6259 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-13"><b>|</b></a> |
| 6260 |
|
| 6261 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-14"><b>6</b></a> |
| 6262 |
|
| 6263 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-15"><b>8</b></a> |
| 6264 |
|
| 6265 |
<br> |
| 6266 |
<a class="summary-letter-printindex" href="#Index_cp_letter-A"><b>A</b></a> |
| 6267 |
|
| 6268 |
<a class="summary-letter-printindex" href="#Index_cp_letter-B"><b>B</b></a> |
| 6269 |
|
| 6270 |
<a class="summary-letter-printindex" href="#Index_cp_letter-C"><b>C</b></a> |
| 6271 |
|
| 6272 |
<a class="summary-letter-printindex" href="#Index_cp_letter-D"><b>D</b></a> |
| 6273 |
|
| 6274 |
<a class="summary-letter-printindex" href="#Index_cp_letter-E"><b>E</b></a> |
| 6275 |
|
| 6276 |
<a class="summary-letter-printindex" href="#Index_cp_letter-F"><b>F</b></a> |
| 6277 |
|
| 6278 |
<a class="summary-letter-printindex" href="#Index_cp_letter-G"><b>G</b></a> |
| 6279 |
|
| 6280 |
<a class="summary-letter-printindex" href="#Index_cp_letter-H"><b>H</b></a> |
| 6281 |
|
| 6282 |
<a class="summary-letter-printindex" href="#Index_cp_letter-I"><b>I</b></a> |
| 6283 |
|
| 6284 |
<a class="summary-letter-printindex" href="#Index_cp_letter-J"><b>J</b></a> |
| 6285 |
|
| 6286 |
<a class="summary-letter-printindex" href="#Index_cp_letter-K"><b>K</b></a> |
| 6287 |
|
| 6288 |
<a class="summary-letter-printindex" href="#Index_cp_letter-L"><b>L</b></a> |
| 6289 |
|
| 6290 |
<a class="summary-letter-printindex" href="#Index_cp_letter-M"><b>M</b></a> |
| 6291 |
|
| 6292 |
<a class="summary-letter-printindex" href="#Index_cp_letter-N"><b>N</b></a> |
| 6293 |
|
| 6294 |
<a class="summary-letter-printindex" href="#Index_cp_letter-O"><b>O</b></a> |
| 6295 |
|
| 6296 |
<a class="summary-letter-printindex" href="#Index_cp_letter-P"><b>P</b></a> |
| 6297 |
|
| 6298 |
<a class="summary-letter-printindex" href="#Index_cp_letter-Q"><b>Q</b></a> |
| 6299 |
|
| 6300 |
<a class="summary-letter-printindex" href="#Index_cp_letter-R"><b>R</b></a> |
| 6301 |
|
| 6302 |
<a class="summary-letter-printindex" href="#Index_cp_letter-S"><b>S</b></a> |
| 6303 |
|
| 6304 |
<a class="summary-letter-printindex" href="#Index_cp_letter-T"><b>T</b></a> |
| 6305 |
|
| 6306 |
<a class="summary-letter-printindex" href="#Index_cp_letter-U"><b>U</b></a> |
| 6307 |
|
| 6308 |
<a class="summary-letter-printindex" href="#Index_cp_letter-V"><b>V</b></a> |
| 6309 |
|
| 6310 |
<a class="summary-letter-printindex" href="#Index_cp_letter-W"><b>W</b></a> |
| 6311 |
|
| 6312 |
<a class="summary-letter-printindex" href="#Index_cp_letter-X"><b>X</b></a> |
| 6313 |
|
| 6314 |
<a class="summary-letter-printindex" href="#Index_cp_letter-Y"><b>Y</b></a> |
| 6315 |
|
| 6316 |
<a class="summary-letter-printindex" href="#Index_cp_letter-Z"><b>Z</b></a> |
| 6317 |
|
| 6318 |
</td></tr></table> |
| 6319 |
</div> |
| 6320 |
|
| 6321 |
</div> |
| 6322 |
</div> |
| 6323 |
|
| 6324 |
|
| 6325 |
|
| 6326 |
</body> |
| 6327 |
</html> |