summaryrefslogtreecommitdiff
path: root/systems/doc/dvipng/dvipng.html
diff options
context:
space:
mode:
Diffstat (limited to 'systems/doc/dvipng/dvipng.html')
-rw-r--r--systems/doc/dvipng/dvipng.html475
1 files changed, 229 insertions, 246 deletions
diff --git a/systems/doc/dvipng/dvipng.html b/systems/doc/dvipng/dvipng.html
index 9ca5f52f44..3c444c6f20 100644
--- a/systems/doc/dvipng/dvipng.html
+++ b/systems/doc/dvipng/dvipng.html
@@ -1,6 +1,6 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
-<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>A DVI-to-PNG translator</title>
@@ -10,17 +10,20 @@
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
<link href="#Top" rel="start" title="Top">
<link href="#Index" rel="index" title="Index">
<link href="#SEC_Contents" rel="contents" title="Table of Contents">
<link href="http://tug.org/texinfohtml" rel="up" title="(dir)">
+<link href="#Introduction" rel="next" title="Introduction">
<style type="text/css">
<!--
+a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em}
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
-div.lisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
@@ -29,6 +32,7 @@ pre.menu-preformatted {font-family: serif}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
+span:hover a.copiable-anchor {visibility: visible}
ul.no-bullet {list-style: none}
-->
</style>
@@ -45,7 +49,28 @@ ul.no-bullet {list-style: none}
-<span id="SEC_Contents"></span>
+
+<div class="top" id="Top">
+<div class="header">
+<p>
+Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="dvipng"></span><h1 class="top">dvipng</h1>
+
+<p>This manual documents dvipng, a program to translate a DVI (DeVice
+Independent) file into PNG (Portable Network Graphics).
+</p>
+<p>This file documents dvipng version 1.17
+</p>
+<p>Corrections or perhaps rewrites of sections are <em>very welcome</em>.
+</p>
+<p>Jan-&Aring;ke Larsson
+</p>
+
+
+
+
+<div class="Contents_element" id="SEC_Contents">
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
@@ -87,53 +112,12 @@ ul.no-bullet {list-style: none}
<li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li>
</ul>
</div>
-
-
-<span id="Top"></span><div class="header">
-<p>
-Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="dvipng"></span><h1 class="top">dvipng</h1>
-
-<p>This manual documents dvipng, a program to translate a DVI (DeVice
-Independent) file into PNG (Portable Network Graphics).
-</p>
-<p>This file documents dvipng version 1.17
-</p>
-<p>Corrections or perhaps rewrites of sections are <em>very welcome</em>.
-</p>
-<p>Jan-&Aring;ke Larsson
-</p>
-
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Introduction" accesskey="1">Introduction</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Introduction
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Installation" accesskey="2">Installation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">How to compile and install dvipng
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Basic-usage" accesskey="3">Basic usage</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">First things first
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Command_002dline-options" accesskey="4">Command-line options</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Advanced usage
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Graphics" accesskey="5">Graphics</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Including PostScript and/or bitmaps
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Color" accesskey="6">Color</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Using color with dvipng
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Diagnosing-problems" accesskey="7">Diagnosing problems</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Problems?
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Credits" accesskey="8">Credits</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">People who have contributed
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Copying" accesskey="9">Copying</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">GNU Lesser General Public License
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Index" rel="index">Index</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">General index
-</td></tr>
-</table>
-
-
-
<hr>
-<span id="Introduction"></span><div class="header">
+<div class="chapter" id="Introduction">
+<div class="header">
<p>
-Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previous: <a href="#Top" accesskey="p" rel="prev">dvipng</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Introduction-1"></span><h2 class="chapter">1 Introduction</h2>
@@ -194,9 +178,11 @@ PNG, JPEG or GIF images.
<hr>
-<span id="Installation"></span><div class="header">
+</div>
+<div class="chapter" id="Installation">
+<div class="header">
<p>
-Next: <a href="#Basic-usage" accesskey="n" rel="next">Basic usage</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Basic-usage" accesskey="n" rel="next">Basic usage of dvipng</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Installation-1"></span><h2 class="chapter">2 Installation</h2>
@@ -209,21 +195,17 @@ Next: <a href="#Basic-usage" accesskey="n" rel="next">Basic usage</a>, Previous:
<p>Installing dvipng should be simple: merely <code>./configure</code>,
<code>make</code>, and <code>make install</code>.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Prerequisites" accesskey="1">Prerequisites</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Configure" accesskey="2">Configure</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Build_002finstall" accesskey="3">Build/install</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Installation-outside-the-texmf-tree" accesskey="4">Installation outside the texmf tree</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Advice-for-non_002dprivileged-users" accesskey="5">Advice for non-privileged users</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Prerequisites" accesskey="1">Prerequisites</a></li>
+<li><a href="#Configure" accesskey="2">Configure</a></li>
+<li><a href="#Build_002finstall" accesskey="3">Build/install</a></li>
+<li><a href="#Installation-outside-the-texmf-tree" accesskey="4">Installation outside the texmf tree</a></li>
+<li><a href="#Advice-for-non_002dprivileged-users" accesskey="5">Installation for non-privileged users</a></li>
+</ul>
<hr>
-<span id="Prerequisites"></span><div class="header">
+<div class="section" id="Prerequisites">
+<div class="header">
<p>
Next: <a href="#Configure" accesskey="n" rel="next">Configure</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -274,7 +256,9 @@ any modern system, if not, download them and install them.
</p></li></ul>
<hr>
-<span id="Configure"></span><div class="header">
+</div>
+<div class="section" id="Configure">
+<div class="header">
<p>
Next: <a href="#Build_002finstall" accesskey="n" rel="next">Build/install</a>, Previous: <a href="#Prerequisites" accesskey="p" rel="prev">Prerequisites</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -341,7 +325,9 @@ are located in e.g., <samp>/sw/local/include</samp>, do
<p>where the backslash denotes a continuation of the line.
</p>
<hr>
-<span id="Build_002finstall"></span><div class="header">
+</div>
+<div class="section" id="Build_002finstall">
+<div class="header">
<p>
Next: <a href="#Installation-outside-the-texmf-tree" accesskey="n" rel="next">Installation outside the texmf tree</a>, Previous: <a href="#Configure" accesskey="p" rel="prev">Configure</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -364,9 +350,11 @@ To install the files into the locations chosen earlier, type
into system directories.
</p>
<hr>
-<span id="Installation-outside-the-texmf-tree"></span><div class="header">
+</div>
+<div class="section" id="Installation-outside-the-texmf-tree">
+<div class="header">
<p>
-Next: <a href="#Advice-for-non_002dprivileged-users" accesskey="n" rel="next">Advice for non-privileged users</a>, Previous: <a href="#Build_002finstall" accesskey="p" rel="prev">Build/install</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Advice-for-non_002dprivileged-users" accesskey="n" rel="next">Installation for non-privileged users</a>, Previous: <a href="#Build_002finstall" accesskey="p" rel="prev">Build/install</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Installation-outside-the-texmf-tree-1"></span><h3 class="section">2.4 Installation outside the texmf tree</h3>
@@ -380,7 +368,9 @@ dvipng adjust these three internally so that kpathsea thinks that
dvipng <em>is</em> installed in the texmf tree.
</p>
<hr>
-<span id="Advice-for-non_002dprivileged-users"></span><div class="header">
+</div>
+<div class="section" id="Advice-for-non_002dprivileged-users">
+<div class="header">
<p>
Previous: <a href="#Installation-outside-the-texmf-tree" accesskey="p" rel="prev">Installation outside the texmf tree</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -403,9 +393,12 @@ access the documentation.
</p>
<hr>
-<span id="Basic-usage"></span><div class="header">
+</div>
+</div>
+<div class="chapter" id="Basic-usage">
+<div class="header">
<p>
-Next: <a href="#Command_002dline-options" accesskey="n" rel="next">Command-line options</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Command_002dline-options" accesskey="n" rel="next">Command-line options</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Basic-usage-of-dvipng"></span><h2 class="chapter">3 Basic usage of dvipng</h2>
@@ -429,7 +422,7 @@ your system before, they may be automatically generated; this process
can take a few minutes, so progress reports appear by default. The next
time the same font is used, it will have been saved on disk, so
rendering will go much faster. (If dvipng tries to endlessly generate
-the same fonts over and over again, something is wrong. See <a href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to
+the same fonts over and over again, something is wrong. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to
generate fonts</a> in <cite>Kpathsea</cite>.)
</p>
<p>Many options are available (see the next section). For a brief summary
@@ -440,9 +433,11 @@ of available options, just type
</pre></div>
<hr>
-<span id="Command_002dline-options"></span><div class="header">
+</div>
+<div class="chapter" id="Command_002dline-options">
+<div class="header">
<p>
-Next: <a href="#Graphics" accesskey="n" rel="next">Graphics</a>, Previous: <a href="#Basic-usage" accesskey="p" rel="prev">Basic usage</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Graphics" accesskey="n" rel="next">Graphics</a>, Previous: <a href="#Basic-usage" accesskey="p" rel="prev">Basic usage of dvipng</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Command_002dline-options-1"></span><h2 class="chapter">4 Command-line options</h2>
@@ -452,16 +447,15 @@ Next: <a href="#Graphics" accesskey="n" rel="next">Graphics</a>, Previous: <a hr
<p>dvipng has a plethora of command line options. Reading through this
section will give a good idea of the capabilities of the driver.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Option-summary" accesskey="1">Option summary</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Quick listing, from dvipng &ndash;help.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Option-details" accesskey="2">Option details</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">More information about each option.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Option-summary" accesskey="1">Option summary</a></li>
+<li><a href="#Option-details" accesskey="2">Option details</a></li>
+</ul>
<hr>
-<span id="Option-summary"></span><div class="header">
+<div class="section" id="Option-summary">
+<div class="header">
<p>
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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -519,7 +513,9 @@ These do not correspond to dvips options:
<hr>
-<span id="Option-details"></span><div class="header">
+</div>
+<div class="section" id="Option-details">
+<div class="header">
<p>
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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -533,26 +529,24 @@ page reversal, use &lsquo;<samp>-r0</samp>&rsquo;. Such options are marked with
&lsquo;<samp>*</samp>&rsquo;.
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>-</samp>&rsquo;</dt>
-<dd><span id="index-options_002c-reading-from-standard-input"></span>
-<span id="index-standard-input_002c-reading-options-from"></span>
+<dt id='index-options_002c-reading-from-standard-input'><span>&lsquo;<samp>-</samp>&rsquo;<a href='#index-options_002c-reading-from-standard-input' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-standard-input_002c-reading-options-from"></span>
<p>Read additional options from standard input after processing the command
line.
</p>
</dd>
-<dt>&lsquo;<samp>--help</samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>--help</samp>&rsquo;</span></dt>
<dd><p>Print a usage message and exit.
</p>
</dd>
-<dt>&lsquo;<samp>--version</samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>--version</samp>&rsquo;</span></dt>
<dd><p>Print the version number and exit.
</p>
</dd>
-<dt>&lsquo;<samp>-bd <var>num</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-bd <var>color_spec</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>-bd '<var>num</var> <var>color_spec</var>'</samp>&rsquo;</dt>
-<dd><span id="index-transparent-border-width"></span>
-<span id="index-transparent-border-fallback-color"></span>
+<dt><span>&lsquo;<samp>-bd <var>num</var></samp>&rsquo;</span></dt>
+<dt><span>&lsquo;<samp>-bd <var>color_spec</var></samp>&rsquo;</span></dt>
+<dt id='index-transparent-border-width'><span>&lsquo;<samp>-bd '<var>num</var> <var>color_spec</var>'</samp>&rsquo;<a href='#index-transparent-border-width' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-transparent-border-fallback-color"></span>
<p>Set the pixel width of the transparent border (default 0). Using this
option will make the image edges transparent, but it only affects pixels
with the background color. Giving a <var>color_spec</var> will set the
@@ -562,18 +556,16 @@ TeX color \special syntax, e.g., &rsquo;rgb 1.0 0.0 0.0&rsquo;. Setting the
fallback color makes the default border width 1 px. See <a href="#Color">Color</a>.
</p>
</dd>
-<dt>&lsquo;<samp>--bdpi <var>num</var></samp>&rsquo;</dt>
-<dd><span id="index-base-resolution_002c-setting"></span>
-<p>This option only has an effect when using bitmapped (PK) fonts. The
+<dt id='index-base-resolution_002c-setting'><span>&lsquo;<samp>--bdpi <var>num</var></samp>&rsquo;<a href='#index-base-resolution_002c-setting' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>This option only has an effect when using bitmapped (PK) fonts. The
option sets the base (Metafont) resolution, both horizontal and
vertical, to <var>num</var> dpi (dots per inch). This option is necessary
when manually selecting Metafont mode with the &ndash;mode option (see
below).
</p>
</dd>
-<dt>&lsquo;<samp>-bg <var>color_spec</var></samp>&rsquo;</dt>
-<dd><span id="index-background-color-_0028option_0029"></span>
-<p>Choose background color for the images. This option will be ignored if
+<dt id='index-background-color-_0028option_0029'><span>&lsquo;<samp>-bg <var>color_spec</var></samp>&rsquo;<a href='#index-background-color-_0028option_0029' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Choose background color for the images. This option will be ignored if
there is a background color \special in the DVI. The color spec should
be in TeX color \special syntax, e.g., &rsquo;rgb 1.0 0.0 0.0&rsquo;. You can
also specify &rsquo;Transparent&rsquo; or &rsquo;transparent&rsquo; which will give you a
@@ -586,17 +578,15 @@ images do not support full alpha transparency, so in case of GIF output,
both variants will use the latter behaviour. See <a href="#Color">Color</a>.
</p>
</dd>
-<dt>&lsquo;<samp>-d <var>num</var></samp>&rsquo;</dt>
-<dd><span id="index-debugging"></span>
-<p>Set the debug flags, showing what dvipng (thinks it) is doing. This will
+<dt id='index-debugging'><span>&lsquo;<samp>-d <var>num</var></samp>&rsquo;<a href='#index-debugging' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Set the debug flags, showing what dvipng (thinks it) is doing. This will
work unless dvipng has been compiled without the <code>DEBUG</code> option
(not recommended). Set the flags as you need them, use &lsquo;<samp>-d -1</samp>&rsquo; as
the first option for maximum output. See <a href="#Debug-options">Debug options</a>.
</p>
</dd>
-<dt>&lsquo;<samp>-D <var>num</var></samp>&rsquo;</dt>
-<dd><span id="index-output-resolution_002c-setting"></span>
-<p>Set the output resolution, both horizontal and vertical, to <var>num</var>
+<dt id='index-output-resolution_002c-setting'><span>&lsquo;<samp>-D <var>num</var></samp>&rsquo;<a href='#index-output-resolution_002c-setting' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Set the output resolution, both horizontal and vertical, to <var>num</var>
dpi (dots per inch).
</p>
<p>One may want to adjust this to fit a certain text font size (e.g., on
@@ -616,9 +606,8 @@ is usually 96 dpi) which means the formula is
<p>On some high-res screens, the value is instead 120 dpi. Good luck!
</p>
</dd>
-<dt>&lsquo;<samp>--depth*</samp>&rsquo;</dt>
-<dd><span id="index-baseline-reporting"></span>
-<span id="index-depth-reporting"></span>
+<dt id='index-baseline-reporting'><span>&lsquo;<samp>--depth*</samp>&rsquo;<a href='#index-baseline-reporting' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-depth-reporting"></span>
<p>Report the depth of the image. This only works reliably when the
LaTeX style <samp>preview.sty</samp> from preview-latex is used with
the &lsquo;<samp>active</samp>&rsquo; option. It reports the number of pixels from the
@@ -632,32 +621,29 @@ would use (Cascading StyleSheets 1)
necessary, and the unit is pixels (px).
</p>
</dd>
-<dt>&lsquo;<samp>--dvinum*</samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>--dvinum*</samp>&rsquo;</span></dt>
<dd><p>Set this option to make the output page number be the TeX page
numbers rather than the physical page number. See the &lsquo;<samp>-o</samp>&rsquo; switch.
</p>
</dd>
-<dt>&lsquo;<samp>-fg <var>color_spec</var></samp>&rsquo;</dt>
-<dd><span id="index-foreground-color-_0028option_0029"></span>
-<p>Choose foreground color for the images. This option will be ignored if
+<dt id='index-foreground-color-_0028option_0029'><span>&lsquo;<samp>-fg <var>color_spec</var></samp>&rsquo;<a href='#index-foreground-color-_0028option_0029' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Choose foreground color for the images. This option will be ignored if
there is a foreground color \special in the DVI. The color spec should
be in TeX color \special syntax, e.g., &rsquo;rgb 1.0 0.0 0.0&rsquo;.
See <a href="#Color">Color</a>.
</p>
</dd>
-<dt>&lsquo;<samp>--follow*</samp>&rsquo;</dt>
-<dd><span id="index-follow-mode"></span>
-<p>Wait for data at end-of-file. One of the benefits of dvipng is that it
+<dt id='index-follow-mode'><span>&lsquo;<samp>--follow*</samp>&rsquo;<a href='#index-follow-mode' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Wait for data at end-of-file. One of the benefits of dvipng is that it
does not read the postamble, so it can be started before TeX
finishes. This switch makes dvipng wait at end-of-file for further
output, unless it finds the POST marker that indicates the end of the
DVI. This is similar to &lsquo;<samp>tail -f</samp>&rsquo; but for DVI-to-PNG conversion.
</p>
</dd>
-<dt>&lsquo;<samp>--freetype*</samp>&rsquo;</dt>
-<dd><span id="index-FreeType-font-rendering"></span>
-<p>Enable/disable FreeType font rendering (default on). This option is
+<dt id='index-FreeType-font-rendering'><span>&lsquo;<samp>--freetype*</samp>&rsquo;<a href='#index-FreeType-font-rendering' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Enable/disable FreeType font rendering (default on). This option is
available if the FreeType2 font library was present at compilation time.
If this is the case, dvipng will have direct support for PostScript
Type1 and TrueType fonts internally, rather than using &lsquo;<samp>gsftopk</samp>&rsquo;
@@ -671,9 +657,8 @@ identical output on different platforms, since FreeType uses the native
renderer and therefore can give slightly different output on each platform.
</p>
</dd>
-<dt>&lsquo;<samp>--gamma <var>num</var></samp>&rsquo;</dt>
-<dd><span id="index-gamma"></span>
-<span id="index-dark-fonts"></span>
+<dt id='index-gamma'><span>&lsquo;<samp>--gamma <var>num</var></samp>&rsquo;<a href='#index-gamma' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-dark-fonts"></span>
<span id="index-light-fonts"></span>
<span id="index-fuzzy-images"></span>
<p>Control the interpolation of colors in the greyscale anti-aliasing
@@ -682,9 +667,8 @@ fonts will be lighter (more like the background), and for <var>num</var> &gt;
1, the fonts will be darker (more like the foreground).
</p>
</dd>
-<dt>&lsquo;<samp>--gif*</samp>&rsquo;</dt>
-<dd><span id="index-GIF-image-format"></span>
-<p>The images are output in the GIF format, if GIF support is enabled.
+<dt id='index-GIF-image-format'><span>&lsquo;<samp>--gif*</samp>&rsquo;<a href='#index-GIF-image-format' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>The images are output in the GIF format, if GIF support is enabled.
This is the default for the &lsquo;<samp>dvigif</samp>&rsquo; binary, which only will be
available when GIF support is enabled. GIF images are palette images
(see the &lsquo;<samp>--palette</samp>&rsquo; option) and does not support true alpha
@@ -692,9 +676,8 @@ channels (see the &lsquo;<samp>--bg</samp>&rsquo; option). See also the &lsquo;<
option.
</p>
</dd>
-<dt>&lsquo;<samp>--height*</samp>&rsquo;</dt>
-<dd><span id="index-baseline-reporting-1"></span>
-<span id="index-height-reporting"></span>
+<dt id='index-baseline-reporting-1'><span>&lsquo;<samp>--height*</samp>&rsquo;<a href='#index-baseline-reporting-1' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-height-reporting"></span>
<p>Report the height of the image. This only works reliably when the
LaTeX style <samp>preview.sty</samp> from preview-latex is used with
the &lsquo;<samp>active</samp>&rsquo; option. It reports the number of pixels from the top
@@ -703,9 +686,8 @@ image is obtained as the sum of the values reported from
&lsquo;<samp>--height</samp>&rsquo; and &lsquo;<samp>--depth</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>-l [=]<var>num</var></samp>&rsquo;</dt>
-<dd><span id="index-last-page-printed"></span>
-<span id="index-page_002c-last-printed"></span>
+<dt id='index-last-page-printed'><span>&lsquo;<samp>-l [=]<var>num</var></samp>&rsquo;<a href='#index-last-page-printed' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-page_002c-last-printed"></span>
<span id="index-physical-page-number_002c-and-_002dl"></span>
<span id="index-absolute-page-number_002c-and-_002dl"></span>
<p>The last page printed will be the first one numbered <var>num</var>. Default
@@ -717,33 +699,29 @@ Thus, using &lsquo;<samp>-l =9</samp>&rsquo; will end with the ninth page of the
no matter what the pages are actually numbered.
</p>
</dd>
-<dt>&lsquo;<samp>--mode <var>mode</var></samp>&rsquo;</dt>
-<dd><span id="index-mode-name_002c-specifying"></span>
-<span id="index-Metafont-mode_002c-specifying"></span>
+<dt id='index-mode-name_002c-specifying'><span>&lsquo;<samp>--mode <var>mode</var></samp>&rsquo;<a href='#index-mode-name_002c-specifying' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-Metafont-mode_002c-specifying"></span>
<p>This option only has an effect when using bitmapped (PK) fonts. Use
<var>mode</var> as the Metafont device name for the PK fonts (both for path
searching and font generation). This needs to be augmented with the base
device resolution, given with the &lsquo;<samp>--bdpi</samp>&rsquo; option. See the file
<a href="ftp://ftp.tug.org/tex/modes.mf">ftp://ftp.tug.org/tex/modes.mf</a> for a list of resolutions and mode
-names for most devices. See <a href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.
+names for most devices. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.
</p>
</dd>
-<dt>&lsquo;<samp>-M*</samp>&rsquo;</dt>
-<dd><span id="index-font-generation_002c-avoiding"></span>
-<span id="index-mktexpk_002c-avoiding"></span>
+<dt id='index-font-generation_002c-avoiding'><span>&lsquo;<samp>-M*</samp>&rsquo;<a href='#index-font-generation_002c-avoiding' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-mktexpk_002c-avoiding"></span>
<p>This option only has an effect when using bitmapped (PK) fonts. It turns
off automatic PK font generation (<samp>mktexpk</samp>).
</p>
</dd>
-<dt>&lsquo;<samp>--nogs*</samp>&rsquo;</dt>
-<dd><span id="index-GhostScript_002c-turning-off"></span>
-<p>This switch prohibits the internal call to GhostScript for displaying
+<dt id='index-GhostScript_002c-turning-off'><span>&lsquo;<samp>--nogs*</samp>&rsquo;<a href='#index-GhostScript_002c-turning-off' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>This switch prohibits the internal call to GhostScript for displaying
PostScript specials. &lsquo;<samp>--nogs0</samp>&rsquo; turns the call back on.
</p>
</dd>
-<dt>&lsquo;<samp>--nogssafer*</samp>&rsquo;</dt>
-<dd><span id="index-GhostScript-and-_002ddSAFER"></span>
-<span id="index-_002ddSAFER"></span>
+<dt id='index-GhostScript-and-_002ddSAFER'><span>&lsquo;<samp>--nogssafer*</samp>&rsquo;<a href='#index-GhostScript-and-_002ddSAFER' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-_002ddSAFER"></span>
<p>Normally, if GhostScript is used to render PostScript specials, the
GhostScript interpreter is run with the option &lsquo;<samp>-dSAFER</samp>&rsquo;. The
&lsquo;<samp>--nogssafer</samp>&rsquo; option runs GhostScript without &lsquo;<samp>-dSAFER</samp>&rsquo;. The
@@ -752,17 +730,15 @@ as deletefile, to prevent possibly malicious PostScript programs from
having any effect.
</p>
</dd>
-<dt>&lsquo;<samp>--norawps*</samp>&rsquo;</dt>
-<dd><span id="index-PostScript_002c-turning-off-raw-PostScript-specials"></span>
-<p>Some packages generate raw PostScript specials, even non-rendering such
+<dt id='index-PostScript_002c-turning-off-raw-PostScript-specials'><span>&lsquo;<samp>--norawps*</samp>&rsquo;<a href='#index-PostScript_002c-turning-off-raw-PostScript-specials' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Some packages generate raw PostScript specials, even non-rendering such
specials. This switch turns off the internal call to GhostScript
intended to display these raw PostScript specials. &lsquo;<samp>--norawps0</samp>&rsquo;
turns the call back on.
</p>
</dd>
-<dt>&lsquo;<samp>-o <var>name</var></samp>&rsquo;</dt>
-<dd><span id="index-output_002c-redirecting"></span>
-<span id="index-standard-output_002c-output-to"></span>
+<dt id='index-output_002c-redirecting'><span>&lsquo;<samp>-o <var>name</var></samp>&rsquo;<a href='#index-output_002c-redirecting' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-standard-output_002c-output-to"></span>
<p>Send output to the file <var>name</var>. A single occurrence of &lsquo;<samp>%d</samp>&rsquo; or
&lsquo;<samp>%01d</samp>&rsquo;, &hellip;, &lsquo;<samp>%09d</samp>&rsquo; will be exchanged for the physical
page number (this can be changed, see the &lsquo;<samp>--dvinum</samp>&rsquo; switch). The
@@ -770,18 +746,16 @@ default output filename is &lsquo;<samp><var>file</var>%d.png</samp>&rsquo; wher
file was &lsquo;<samp><var>file</var>.dvi</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>-O <var>x-offset</var>,<var>y-offset</var></samp>&rsquo;</dt>
-<dd><span id="index-offset-pages"></span>
-<p>Move the origin by <var>x-offset</var>,<var>y-offset</var>, a comma-separated
+<dt id='index-offset-pages'><span>&lsquo;<samp>-O <var>x-offset</var>,<var>y-offset</var></samp>&rsquo;<a href='#index-offset-pages' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Move the origin by <var>x-offset</var>,<var>y-offset</var>, a comma-separated
pair of dimensions such as &lsquo;<samp>.1in,-.3cm</samp>&rsquo;.
The origin of the page is shifted from the default position
(of one inch down, one inch to the right from the upper left corner of
the paper) by this amount.
</p>
</dd>
-<dt>&lsquo;<samp>-p [=]<var>num</var></samp>&rsquo;</dt>
-<dd><span id="index-first-page-printed"></span>
-<span id="index-page_002c-first-printed"></span>
+<dt id='index-first-page-printed'><span>&lsquo;<samp>-p [=]<var>num</var></samp>&rsquo;<a href='#index-first-page-printed' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-page_002c-first-printed"></span>
<span id="index-physical-page-number_002c-and-_002dp"></span>
<span id="index-absolute-page-number_002c-and-_002dp"></span>
<p>The first page printed will be the first one numbered <var>num</var>. Default
@@ -793,9 +767,8 @@ DVI file. Thus, using &lsquo;<samp>-p =3</samp>&rsquo; will start with the thir
the document, no matter what the pages are actually numbered.
</p>
</dd>
-<dt>&lsquo;<samp>--palette*</samp>&rsquo;</dt>
-<dd><span id="index-forcing-palette-output"></span>
-<p>When an external image is included, &lsquo;<samp>dvipng</samp>&rsquo; will automatically
+<dt id='index-forcing-palette-output'><span>&lsquo;<samp>--palette*</samp>&rsquo;<a href='#index-forcing-palette-output' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>When an external image is included, &lsquo;<samp>dvipng</samp>&rsquo; will automatically
switch to truecolor mode, to avoid unnecessary delay and quality
reduction, and enable the EPS translator to draw on a transparent
background and outside of the boundingbox. This switch will force
@@ -804,9 +777,8 @@ clipped image inclusion. This will also override the &lsquo;<samp>--truecolor</s
switch if present.
</p>
</dd>
-<dt>&lsquo;<samp>--picky*</samp>&rsquo;</dt>
-<dd><span id="index-no-erroneous-images"></span>
-<p>No images are output when a warning occurs. Normally, dvipng will
+<dt id='index-no-erroneous-images'><span>&lsquo;<samp>--picky*</samp>&rsquo;<a href='#index-no-erroneous-images' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>No images are output when a warning occurs. Normally, dvipng will
output an image in spite of a warning, but there may be something
missing in this image. One reason to use this option would be if you
have a more complete but slower fallback converter. Mainly, this is
@@ -815,15 +787,13 @@ but warnings will also occur for missing or unknown color specs and
missing PK fonts.
</p>
</dd>
-<dt>&lsquo;<samp>--png*</samp>&rsquo;</dt>
-<dd><span id="index-PNG-image-format"></span>
-<p>The images are output in the PNG format. This is the default for the
+<dt id='index-PNG-image-format'><span>&lsquo;<samp>--png*</samp>&rsquo;<a href='#index-PNG-image-format' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>The images are output in the PNG format. This is the default for the
&lsquo;<samp>dvipng</samp>&rsquo; binary. See also the &lsquo;<samp>--gif</samp>&rsquo; option.
</p>
</dd>
-<dt>&lsquo;<samp>-pp <var>firstpage</var>-<var>lastpage</var></samp>&rsquo;</dt>
-<dd><span id="index-page-range"></span>
-<p>Print pages <var>firstpage</var> through <var>lastpage</var>; but not quite
+<dt id='index-page-range'><span>&lsquo;<samp>-pp <var>firstpage</var>-<var>lastpage</var></samp>&rsquo;<a href='#index-page-range' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Print pages <var>firstpage</var> through <var>lastpage</var>; but not quite
equivalent to &lsquo;<samp>-p <var>firstpage</var> -l <var>lastpage</var></samp>&rsquo;. For example,
when rendering a book, there may be several instances of a page in the
DVI file (one in <code>\frontmatter</code>, one in <code>\mainmatter</code>, and one
@@ -842,17 +812,15 @@ page numbered -1 (only the table of contents, say) put &lsquo;<samp>-pp -1--1</s
or more readable, &lsquo;<samp>-pp -1:-1</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>-q*</samp>&rsquo;</dt>
-<dd><span id="index-quiet-operation"></span>
-<span id="index-silent-operation"></span>
+<dt id='index-quiet-operation'><span>&lsquo;<samp>-q*</samp>&rsquo;<a href='#index-quiet-operation' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-silent-operation"></span>
<span id="index-warnings_002c-suppressing"></span>
<p>Run quietly. Don&rsquo;t chatter about pages converted, etc. to standard
output; report no warnings (only errors) to standard error.
</p>
</dd>
-<dt>&lsquo;<samp>-Q <var>num</var></samp>&rsquo;</dt>
-<dd><span id="index-antialiasing-levels_002c-number-of"></span>
-<span id="index-quality"></span>
+<dt id='index-antialiasing-levels_002c-number-of'><span>&lsquo;<samp>-Q <var>num</var></samp>&rsquo;<a href='#index-antialiasing-levels_002c-number-of' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-quality"></span>
<p>Set the quality to <var>num</var>. That is, choose the number of antialiasing
levels for bitmapped fonts (PK), to be
<var>num</var>*<var>num</var>+1. The default value is 4 which gives 17 levels of
@@ -860,23 +828,21 @@ antialiasing for antialiased fonts from these two. If FreeType is
available, its rendering is unaffected by this option.
</p>
</dd>
-<dt>&lsquo;<samp>-r*</samp>&rsquo;</dt>
-<dd><span id="index-reverse-pagination"></span>
-<p>Toggle output of pages in reverse/forward order. By default, the first
+<dt id='index-reverse-pagination'><span>&lsquo;<samp>-r*</samp>&rsquo;<a href='#index-reverse-pagination' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Toggle output of pages in reverse/forward order. By default, the first
page in the DVI is output first.
</p>
</dd>
-<dt>&lsquo;<samp>--strict*</samp>&rsquo;</dt>
-<dd><span id="index-exit-on-erroneous-images"></span>
-<p>The program exits when a warning occurs. Normally, dvipng will output
+<dt id='index-exit-on-erroneous-images'><span>&lsquo;<samp>--strict*</samp>&rsquo;<a href='#index-exit-on-erroneous-images' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>The program exits when a warning occurs. Normally, dvipng will output
an image in spite of a warning, but there may be something missing in
this image. One reason to use this option would be if you have a more
complete but slower fallback converter. See the &lsquo;<samp>--picky</samp>&rsquo; option
above for a list of when warnings occur.
</p>
</dd>
-<dt>&lsquo;<samp>-T <var>image_size</var></samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>-T <var>image_size</var></samp>&rsquo;</span></dt>
<dd><p>Set the image size to <var>image_size</var> which can be either of
&lsquo;<samp>bbox</samp>&rsquo;, &lsquo;<samp>tight</samp>&rsquo;, or a comma-separated pair of dimensions
<var>hsize</var>,<var>vsize</var> such as &lsquo;<samp>.1in,.3cm</samp>&rsquo;. The default is
@@ -887,31 +853,28 @@ the left in the produced image. The value &lsquo;<samp>tight</samp>&rsquo; will
only include all ink put on the page, producing neat images.
</p>
</dd>
-<dt>&lsquo;<samp>--truecolor*</samp>&rsquo;</dt>
-<dd><span id="index-truecolor-output"></span>
-<p>This will make &lsquo;<samp>dvipng</samp>&rsquo; generate truecolor output. Note that
+<dt id='index-truecolor-output'><span>&lsquo;<samp>--truecolor*</samp>&rsquo;<a href='#index-truecolor-output' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>This will make &lsquo;<samp>dvipng</samp>&rsquo; generate truecolor output. Note that
truecolor output is automatic if you include an external image in your
DVI, e.g., via a PostScript special (i.e., the &lsquo;<samp>graphics</samp>&rsquo; or
&lsquo;<samp>graphicx</samp>&rsquo; package). This switch is overridden by the
&lsquo;<samp>--palette</samp>&rsquo; switch.
</p>
</dd>
-<dt>&lsquo;<samp>-v*</samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>-v*</samp>&rsquo;</span></dt>
<dd><p>Enable verbose operation. This will currently indicate what fonts is
used, in addition to the usual output.
</p>
</dd>
-<dt>&lsquo;<samp>--width*</samp>&rsquo;</dt>
-<dd><span id="index-width-reporting"></span>
-<p>Report the width of the image. See also &lsquo;<samp>--height</samp>&rsquo; and
+<dt id='index-width-reporting'><span>&lsquo;<samp>--width*</samp>&rsquo;<a href='#index-width-reporting' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Report the width of the image. See also &lsquo;<samp>--height</samp>&rsquo; and
&lsquo;<samp>--depth</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>-x <var>num</var></samp>&rsquo;</dt>
-<dd><span id="index-magnification_002c-overriding-DVI"></span>
-<p>This option is deprecated; it should not be used. It is much better to
+<dt id='index-magnification_002c-overriding-DVI'><span>&lsquo;<samp>-x <var>num</var></samp>&rsquo;<a href='#index-magnification_002c-overriding-DVI' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>This option is deprecated; it should not be used. It is much better to
select the output resolution directly with the &lsquo;<samp>-D</samp>&rsquo; option. This
-option sets the magnification ratio to <em><var>num</var>/1000</em> and
+option sets the magnification ratio to <em class='math'><var>num</var>/1000</em> and
overrides the magnification specified in the DVI file. Must be between
10 and 100000. It is recommended that you use standard magstep values
(1095, 1200, 1440, 1728, 2074, 2488, 2986, and so on) to help reduce the
@@ -919,9 +882,8 @@ total number of PK files generated. <var>num</var> may be a real number, not
an integer, for increased precision.
</p>
</dd>
-<dt>&lsquo;<samp>-z <var>num</var></samp>&rsquo;</dt>
-<dd><span id="index-compression"></span>
-<p>Set the PNG compression level to <var>num</var>. This option is enabled if
+<dt id='index-compression'><span>&lsquo;<samp>-z <var>num</var></samp>&rsquo;<a href='#index-compression' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Set the PNG compression level to <var>num</var>. This option is enabled if
your &lsquo;<samp>libgd</samp>&rsquo; is new enough. The default compression level is 1,
which selects maximum speed at the price of slightly larger PNGs. For an
older &lsquo;<samp>libgd</samp>&rsquo;, the hard-soldered value 5 is used. The include file
@@ -938,9 +900,12 @@ correspond directly to the zlib compression levels.
</dl>
<hr>
-<span id="Graphics"></span><div class="header">
+</div>
+</div>
+<div class="chapter" id="Graphics">
+<div class="header">
<p>
-Next: <a href="#Color" accesskey="n" rel="next">Color</a>, Previous: <a href="#Command_002dline-options" accesskey="p" rel="prev">Command-line options</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Color" accesskey="n" rel="next">Color</a>, Previous: <a href="#Command_002dline-options" accesskey="p" rel="prev">Command-line options</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Graphics-1"></span><h2 class="chapter">5 Graphics</h2>
@@ -952,17 +917,15 @@ also able (from version 1.8) to include bitmapped graphics. It also
tries to handle some of the raw PostScript that is output from various
packages. Some of the possibilities and problems are mentioned below.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Encapsulated-PostScript" accesskey="1">Encapsulated PostScript</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">An internal call to GhostScript
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Bitmapped-graphics" accesskey="2">Bitmapped graphics</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">PNG, JPEG and GIF
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Raw-PostScript" accesskey="3">Raw PostScript</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Ignore or give to GhostScript
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Encapsulated-PostScript" accesskey="1">Encapsulated PostScript</a></li>
+<li><a href="#Bitmapped-graphics" accesskey="2">Bitmapped graphics</a></li>
+<li><a href="#Raw-PostScript" accesskey="3">Raw PostScript</a></li>
+</ul>
<hr>
-<span id="Encapsulated-PostScript"></span><div class="header">
+<div class="section" id="Encapsulated-PostScript">
+<div class="header">
<p>
Next: <a href="#Bitmapped-graphics" accesskey="n" rel="next">Bitmapped graphics</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -996,7 +959,9 @@ in this example (using &lsquo;<samp>graphicx</samp>&rsquo;):
<hr>
-<span id="Bitmapped-graphics"></span><div class="header">
+</div>
+<div class="section" id="Bitmapped-graphics">
+<div class="header">
<p>
Next: <a href="#Raw-PostScript" accesskey="n" rel="next">Raw PostScript</a>, Previous: <a href="#Encapsulated-PostScript" accesskey="p" rel="prev">Encapsulated PostScript</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1030,7 +995,9 @@ wide:
</pre></div>
<hr>
-<span id="Raw-PostScript"></span><div class="header">
+</div>
+<div class="section" id="Raw-PostScript">
+<div class="header">
<p>
Previous: <a href="#Bitmapped-graphics" accesskey="p" rel="prev">Bitmapped graphics</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1074,9 +1041,12 @@ is turned off, it gives a warning. It is now possible to use the switch
the slower fallback for these pages.
</p>
<hr>
-<span id="Color"></span><div class="header">
+</div>
+</div>
+<div class="chapter" id="Color">
+<div class="header">
<p>
-Next: <a href="#Diagnosing-problems" accesskey="n" rel="next">Diagnosing problems</a>, Previous: <a href="#Graphics" accesskey="p" rel="prev">Graphics</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Diagnosing-problems" accesskey="n" rel="next">Diagnosing problems</a>, Previous: <a href="#Graphics" accesskey="p" rel="prev">Graphics</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Color-1"></span><h2 class="chapter">6 Color</h2>
@@ -1085,16 +1055,15 @@ generated by the &lsquo;<samp>color</samp>&rsquo; and &lsquo;<samp>xcolor</samp>
specials start with the keyword &lsquo;<samp>color</samp>&rsquo; or the keyword
&lsquo;<samp>background</samp>&rsquo;, followed by a color specification.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Color-specifications" accesskey="1">Color specifications</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Color-specials" accesskey="2">Color specials</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Color-specifications" accesskey="1">Color specifications</a></li>
+<li><a href="#Color-specials" accesskey="2">Color specials</a></li>
+</ul>
<hr>
-<span id="Color-specifications"></span><div class="header">
+<div class="section" id="Color-specifications">
+<div class="header">
<p>
Next: <a href="#Color-specials" accesskey="n" rel="next">Color specials</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1123,7 +1092,9 @@ an argument to &lsquo;<samp>--bg</samp>&rsquo; to choose transparent background.
See <a href="#Option-details">Option details</a>.
</p>
<hr>
-<span id="Color-specials"></span><div class="header">
+</div>
+<div class="section" id="Color-specials">
+<div class="header">
<p>
Previous: <a href="#Color-specifications" accesskey="p" rel="prev">Color specifications</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1156,9 +1127,12 @@ that color.
the pages are rendered repeatedly or in reverse order.
</p>
<hr>
-<span id="Diagnosing-problems"></span><div class="header">
+</div>
+</div>
+<div class="chapter" id="Diagnosing-problems">
+<div class="header">
<p>
-Next: <a href="#Credits" accesskey="n" rel="next">Credits</a>, Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Credits" accesskey="n" rel="next">Credits</a>, Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Diagnosing-problems-1"></span><h2 class="chapter">7 Diagnosing problems</h2>
@@ -1171,15 +1145,14 @@ all the instructions in this manual, and still can&rsquo;t get something to
work. The following sections provide some helpful hints if you find
yourself in such a situation.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Contact-information" accesskey="1">Contact information</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Who to ask.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Debug-options" accesskey="2">Debug options</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Getting diagnostics.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Contact-information" accesskey="1">Contact information</a></li>
+<li><a href="#Debug-options" accesskey="2">Debug options</a></li>
+</ul>
<hr>
-<span id="Contact-information"></span><div class="header">
+<div class="section" id="Contact-information">
+<div class="header">
<p>
Next: <a href="#Debug-options" accesskey="n" rel="next">Debug options</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1198,11 +1171,13 @@ body to <a href="mailto:dvipng-request@nongnu.org">dvipng-request@nongnu.org</a>
access, ask on <a href="mailto:dvipng@nongnu.org">dvipng@nongnu.org</a>.
</p>
<p>For details on the TeX path-searching library, and <code>mktexpk</code>
-problems, see <a href="https://tug.org/texinfohtml/kpathsea.html#Common-problems">Common problems</a> in <cite>Kpathsea</cite>.
+problems, see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Common-problems">Common problems</a> in <cite>Kpathsea</cite>.
</p>
<hr>
-<span id="Debug-options"></span><div class="header">
+</div>
+<div class="section" id="Debug-options">
+<div class="header">
<p>
Previous: <a href="#Contact-information" accesskey="p" rel="prev">Contact information</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing problems</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1216,56 +1191,59 @@ multiple classes, sum the numbers of the classes you wish to track. To
track all classes, you can use <code>-1</code>.
</p>
<p>Some of these debugging options are actually provided by Kpathsea
-(see <a href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>).
+(see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>).
</p>
<p>The classes are:
</p><dl compact="compact">
-<dt>1</dt>
+<dt><span>1</span></dt>
<dd><p>Normal dvi op-codes
</p></dd>
-<dt>2</dt>
+<dt><span>2</span></dt>
<dd><p>Virtual fonts
</p></dd>
-<dt>4</dt>
+<dt><span>4</span></dt>
<dd><p>PK fonts
</p></dd>
-<dt>8</dt>
+<dt><span>8</span></dt>
<dd><p>TFM files
</p></dd>
-<dt>16</dt>
+<dt><span>16</span></dt>
<dd><p>Glyph rendering
</p></dd>
-<dt>32</dt>
+<dt><span>32</span></dt>
<dd><p>FreeType calls
</p></dd>
-<dt>64</dt>
+<dt><span>64</span></dt>
<dd><p>Encoding loads
</p></dd>
-<dt>128</dt>
+<dt><span>128</span></dt>
<dd><p>Color specials
</p></dd>
-<dt>256</dt>
+<dt><span>256</span></dt>
<dd><p>GhostScript specials
</p></dd>
-<dt>512</dt>
+<dt><span>512</span></dt>
<dd><p>Kpathsea <code>stat</code> calls
</p></dd>
-<dt>1024</dt>
+<dt><span>1024</span></dt>
<dd><p>Kpathsea hash table lookups
</p></dd>
-<dt>2048</dt>
+<dt><span>2048</span></dt>
<dd><p>Kpathsea path element expansion
</p></dd>
-<dt>4096</dt>
+<dt><span>4096</span></dt>
<dd><p>Kpathsea path searches
</p>
</dd>
</dl>
<hr>
-<span id="Credits"></span><div class="header">
+</div>
+</div>
+<div class="chapter" id="Credits">
+<div class="header">
<p>
-Next: <a href="#Copying" accesskey="n" rel="next">Copying</a>, Previous: <a href="#Diagnosing-problems" accesskey="p" rel="prev">Diagnosing problems</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Copying" accesskey="n" rel="next">Copying</a>, Previous: <a href="#Diagnosing-problems" accesskey="p" rel="prev">Diagnosing problems</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Credits-1"></span><h2 class="chapter">8 Credits</h2>
@@ -1289,9 +1267,11 @@ Waldeck Schutzer, Ahzo, and Andy Nguyen.
</p>
<hr>
-<span id="Copying"></span><div class="header">
+</div>
+<div class="chapter" id="Copying">
+<div class="header">
<p>
-Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Credits" accesskey="p" rel="prev">Credits</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Credits" accesskey="p" rel="prev">Credits</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Copying-1"></span><h2 class="chapter">9 Copying</h2>
@@ -1314,9 +1294,11 @@ License along with this program. If not, see
<p>Copyright &copy; 2002-2015, 2019 Jan-&Aring;ke Larsson
</p>
<hr>
-<span id="Index"></span><div class="header">
+</div>
+<div class="unnumbered" id="Index">
+<div class="header">
<p>
-Previous: <a href="#Copying" accesskey="p" rel="prev">Copying</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Copying" accesskey="p" rel="prev">Copying</a>, Up: <a href="#Top" accesskey="u" rel="up">dvipng</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Index-1"></span><h2 class="unnumbered">Index</h2>
@@ -1515,7 +1497,8 @@ Previous: <a href="#Copying" accesskey="p" rel="prev">Copying</a>, Up: <a href="
<a class="summary-letter" href="#Index_cp_letter-W"><b>W</b></a>
&nbsp;
</td></tr></table>
-<hr>
+</div>
+</div>