summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/dvipng
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2007-01-14 19:48:04 +0000
committerKarl Berry <karl@freefriends.org>2007-01-14 19:48:04 +0000
commitd5dbd8ae587b13260ac2fd8ff1c39d67b18035bc (patch)
treef15175c23a55a8704e87422f299282f76bed3d3c /Master/texmf/doc/dvipng
parentc6716c453c9eba23e5cffa6be76cc53576d313b6 (diff)
update texinfo output files
git-svn-id: svn://tug.org/texlive/trunk@3474 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc/dvipng')
-rw-r--r--Master/texmf/doc/dvipng/dvipng.html514
1 files changed, 310 insertions, 204 deletions
diff --git a/Master/texmf/doc/dvipng/dvipng.html b/Master/texmf/doc/dvipng/dvipng.html
index 47f94e695be..3d2347dcc94 100644
--- a/Master/texmf/doc/dvipng/dvipng.html
+++ b/Master/texmf/doc/dvipng/dvipng.html
@@ -40,18 +40,23 @@
<li><a href="#Option-summary">4.1 Option summary</a>
<li><a href="#Option-details">4.2 Option details</a>
</li></ul>
-<li><a name="toc_Diagnosing-problems" href="#Diagnosing-problems">5 Diagnosing problems</a>
+<li><a name="toc_Graphics" href="#Graphics">5 Graphics</a>
<ul>
-<li><a href="#Debug-options">5.1 Debug options</a>
-<li><a href="#Included-graphics-problems">5.2 Included graphics problems</a>
+<li><a href="#Encapsulated-PostScript">5.1 Encapsulated PostScript</a>
+<li><a href="#Bitmapped-graphics">5.2 Bitmapped graphics</a>
</li></ul>
<li><a name="toc_Color" href="#Color">6 Color</a>
<ul>
<li><a href="#Color-specifications">6.1 Color specifications</a>
<li><a href="#Color-specials">6.2 Color specials</a>
</li></ul>
-<li><a name="toc_Credits" href="#Credits">7 Credits</a>
-<li><a name="toc_Copying" href="#Copying">8 Copying</a>
+<li><a name="toc_Diagnosing-problems" href="#Diagnosing-problems">7 Diagnosing problems</a>
+<ul>
+<li><a href="#Contact-information">7.1 Contact information</a>
+<li><a href="#Debug-options">7.2 Debug options</a>
+</li></ul>
+<li><a name="toc_Credits" href="#Credits">8 Credits</a>
+<li><a name="toc_Copying" href="#Copying">9 Copying</a>
<li><a name="toc_Index" href="#Index">Index</a>
</li></ul>
</div>
@@ -71,7 +76,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#dir">(dir)</a>
<p>This manual documents dvipng, a program to translate a DVI (DeVice
Independent) file into PNG (Portable Network Graphics).
- <p>This file documents dvipng version 1.6
+ <p>This file documents dvipng version 1.9
<p>Corrections or perhaps rewrites of sections are <em>very welcome</em>.
@@ -82,11 +87,12 @@ Independent) file into PNG (Portable Network Graphics).
<li><a accesskey="2" href="#Installation">Installation</a>: How to compile and install dvipng
<li><a accesskey="3" href="#Basic-usage">Basic usage</a>: First things first
<li><a accesskey="4" href="#Command_002dline-options">Command-line options</a>: Advanced usage
-<li><a accesskey="5" href="#Diagnosing-problems">Diagnosing problems</a>: Problems?
+<li><a accesskey="5" href="#Graphics">Graphics</a>: Including PostScript and/or bitmaps
<li><a accesskey="6" href="#Color">Color</a>: Using color with dvipng
-<li><a accesskey="7" href="#Copying">Copying</a>: GNU General Public License
+<li><a accesskey="7" href="#Diagnosing-problems">Diagnosing problems</a>: Problems?
<li><a accesskey="8" href="#Credits">Credits</a>: People who have contributed
-<li><a accesskey="9" href="#Index">Index</a>: General index
+<li><a accesskey="9" href="#Copying">Copying</a>: GNU General Public License
+<li><a href="#Index">Index</a>: General index
</ul>
<div class="node">
@@ -115,7 +121,7 @@ as is possible. The target audience is people who need to generate and
regenerate many images again and again. The primary target is the
preview-latex (X)Emacs package, a package to preview formulas from
within (X)Emacs. Yes, you get to see your formulas in the (X)Emacs
-buffer, see <a href="http://preview-latex.sf.net">http://preview-latex.sf.net</a>.
+buffer, see <a href="http://www.gnu.org/software/auctex/preview-latex.html">http://www.gnu.org/software/auctex/preview-latex.html</a>.
<p>Another example is WeBWorK, an internet-based method for delivering
homework problems to students over the internet, giving students
@@ -128,23 +134,22 @@ and WYSIWYG editors like LyX.
<p>The benefits of `<samp><span class="samp">dvipng</span></samp>'/`<samp><span class="samp">dvigif</span></samp>' include
<ul>
-<li>Speed. It is a very fast bitmap-rendering code for DVI files. On a
-fairly low-end laptop, it takes less than a second to generate 150
-one-formula images. This makes dvipng suitable for generating large
-amounts of images on-the-fly, as needed in preview-latex, WeBWorK and
-others.
+<li>Speed. It is a very fast bitmap-rendering code for DVI files, which
+makes it suitable for generating large amounts of images on-the-fly,
+as needed in preview-latex, WeBWorK and others.
<li>It does not read the postamble, so it can be started before TeX
-finishes. There is a &ndash;follow switch that makes dvipng wait at EOF for
-further output, unless it finds the POST marker that indicates the end
-of the DVI.
+finishes. There is a `<samp><span class="samp">--follow</span></samp>' switch that makes dvipng wait at
+end-of-file for further output, unless it finds the POST marker that
+indicates the end of the DVI.
<li>Interactive query of options. dvipng can read options interactively
through stdin, and all options are usable. It is even possible to change
the input file through this interface.
- <li>Supports PK, VF, PostScript Type1, and TrueType fonts, color specials
-and simple PostScript inclusion specials.
+ <li>Supports PK, VF, PostScript Type1, and TrueType fonts, subfonts (i.e.,
+as used in CJK-LaTeX), color specials, and inclusion of PostScript,
+PNG, JPEG or GIF images.
<li>and more...
@@ -205,16 +210,26 @@ may happen that ./configure does not find it; see below. If you do not
have it, download it from <a href="http://www.ctan.org">http://www.ctan.org</a> and compile it.
I have no experience with this, so I cannot help much here.
- <li>FreeType 2 and/or T1lib
-
- <p>While not strictly necessary, you may want to have FreeType 2 or T1lib
-available. Their presence will enable direct support for PostScript
-fonts in dvipng, rather than using `<samp><span class="samp">gsftopk</span></samp>' for rendering the
-fonts. If you have PostScript versons of Computer Modern installed,
-there will be no need to generate bitmapped variants on disk of
-these. Then, you can render images at different (and unusual)
-resolutions without cluttering the disk with lots of bitmapped fonts.
-If both FreeType 2 and T1lib are present, FreeType will be internally
+ <li>The font-rendering library FreeType 2
+
+ <p>While not strictly necessary, FreeType 2 is recommended since dvipng
+currently will produce better-quality images with this library
+available. It will also enable direct support for PostScript and
+TrueType fonts, and subfont support in dvipng. That is, if you want to
+render CJK-LaTeX characters, you must have FreeType 2 installed.
+With FreeType 2, dvipng will not need to generate bitmapped variants
+on disk of the TeX fonts since modern TeX distributions include
+PostScript versions of them. Then, you can render images at different
+(and unusual) resolutions without cluttering the disk with lots of
+bitmapped fonts.
+
+ <li>The font-rendering library T1lib
+
+ <p>An alternative to FreeType 2 is T1lib, but this will enable only
+PostScript fonts in dvipng, and will not include subfont support. Also
+here, you can render images at different (and unusual) resolutions
+without cluttering the disk with lots of bitmapped fonts. If both
+FreeType 2 and T1lib are present, FreeType will be internally
preferred by dvipng, but T1lib can be chosen at runtime.
<li>libpng and libz
@@ -246,7 +261,7 @@ various files will be. To do so, run
</pre>
<p>(Note: if you have fetched dvipng from CVS rather than a regular
release, you will have to first generate <samp><span class="file">./configure</span></samp> by running
-<code>autoconf</code> 2.53 or later in the <samp><span class="file">preview</span></samp> directory.)
+<code>autoconf</code> 2.53 or later.)
<p>On many machines, you will not need to specify any options, but if
<code>configure</code> cannot determine something on its own, you'll need to
@@ -353,8 +368,9 @@ reasonably easy to maintain a bunch of additional packages, since the
prefix argument is supported by most <samp><span class="file">configure</span></samp> scripts.
<p>You'll have to add something like <samp><span class="file">/home/myself/bin</span></samp> to your
-<code>PATH</code> shell variable, if it isn't there already, and similarly set
-the <code>INFOPATH</code> variable to be able to access the documentation.
+<code>PATH</code> shell variable, if it isn't there already, and similarly
+set the <code>INFOPATH</code> and <code>MANPATH</code> variables to be able to
+access the documentation.
<div class="node">
<p><hr>
@@ -395,7 +411,7 @@ of available options, just type
<p><hr>
<a name="Command-line-options"></a>
<a name="Command_002dline-options"></a>
-Next:&nbsp;<a rel="next" accesskey="n" href="#Diagnosing-problems">Diagnosing problems</a>,
+Next:&nbsp;<a rel="next" accesskey="n" href="#Graphics">Graphics</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Basic-usage">Basic usage</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
@@ -425,45 +441,38 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Command_002dline-options">Command-line
<p><a name="index-options_002c-summary-7"></a>Here is a handy summary of the options; it is printed out when you run
dvipng with no arguments or with the standard `<samp><span class="samp">--help</span></samp>' option.
-<pre class="example"> This is dvipng 1.6 Copyright 2002-2005 Jan-Ake Larsson
+<pre class="example"> This is ./dvipng 1.9 Copyright 2002-2006 Jan-Ake Larsson
- Usage: dvipng [OPTION]... FILENAME[.dvi]
+ Usage: ./dvipng [OPTION]... FILENAME[.dvi]
Options are chosen to be similar to dvips' options where possible:
-d # Debug (# is the debug bitmap, 1 if not given)
-D # Output resolution
-l # Last page to be output
- --mode s MetaFont mode (default 'cx')
- -M* Don't make PK fonts
-o f Output file, '%d' is pagenumber
-O c Image offset
-p # First page to be output
-pp #,#.. Page list to be output
-q* Quiet operation
- -r* Reverse order of pages
-T c Image size (also accepts '-T bbox' and '-T tight')
-v* Verbose operation
- -x # Override dvi magnification
- Interactive query of options
These do not correspond to dvips options:
-bd # Transparent border width in dots
-bd s Transparent border fallback color (TeX-style color)
- --bdpi # Set the base (Metafont) resolution
-bg s Background color (TeX-style color or 'Transparent')
--depth* Output the image depth on stdout
--dvinum* Use TeX page numbers in output filenames
-fg s Foreground color (TeX-style color)
- --follow* Follow mode
+ --follow* Wait for data at end-of-file
+ --freetype* FreeType font rendering (default on)
--gamma # Control color interpolation
- --gif Output GIF images (dvigif default)
--height* Output the image height on stdout
--noghostscript* Don't use ghostscript for PostScript specials
--nogssafer* Don't use -dSAFER in ghostscript calls
--picky When a warning occurs, don't output image
- --png Output PNG images (dvipng default)
--strict When a warning occurs, exit
--t1lib* T1lib font rendering (default on)
- --truecolor* Truecolor output
-Q # Quality (T1lib and PK subsampling)
-z # PNG compression level
@@ -521,7 +530,7 @@ 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>.
<br><dt>`<samp><span class="samp">-d </span><var>num</var></samp>'<dd><a name="index-debugging-15"></a>Set the debug flags, showing what dvipng (thinks it) is doing. This will
-work unless dvipng has been compiled without the `<samp><span class="samp">DEBUG</span></samp>' option
+work unless dvipng has been compiled without the <code>DEBUG</code> option
(not recommended). Set the flags as you need them, use `<samp><span class="samp">-d -1</span></samp>' as
the first option for maximum output. See <a href="#Debug-options">Debug options</a>.
@@ -543,7 +552,7 @@ is usually 96 dpi) which means the formula is
<p>On some high-res screens, the value is instead 120 dpi. Good luck!
<br><dt>`<samp><span class="samp">--depth*</span></samp>'<dd><a name="index-baseline-reporting-17"></a><a name="index-depth-reporting-18"></a>Report the depth of the image. This only works reliably when the
-LaTeX style `<samp><span class="samp">preview.sty</span></samp>' from preview-latex is used. It
+LaTeX style <samp><span class="file">preview.sty</span></samp> from preview-latex is used. It
reports the number of pixels from the bottom of the image to the
baseline of the image. This can be used for vertical positioning of the
image in, e.g., web documents, where one would use (Cascading
@@ -561,11 +570,11 @@ there is a foreground color \special in the DVI. The color spec should
be in TeX color \special syntax, e.g., 'rgb 1.0 0.0 0.0'.
See <a href="#Color">Color</a>.
- <br><dt>`<samp><span class="samp">--follow*</span></samp>'<dd><a name="index-follow-mode-20"></a>Enable follow mode. 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 EOF for further output, unless it finds the
-POST marker that indicates the end of the DVI. This is similar to
-`<samp><span class="samp">tail -f</span></samp>' but for DVI-to-PNG conversion.
+ <br><dt>`<samp><span class="samp">--follow*</span></samp>'<dd><a name="index-follow-mode-20"></a>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 `<samp><span class="samp">tail -f</span></samp>' but for DVI-to-PNG conversion.
<br><dt>`<samp><span class="samp">--freetype*</span></samp>'<dd><a name="index-FreeType-font-rendering-21"></a>Enable/disable FreeType font rendering (default on). This option is
available if the FreeType2 font library was present at compilation time.
@@ -584,16 +593,18 @@ color palette. Default value is 1.0. For 0 &lt; <var>num</var> &lt; 1, the
fonts will be lighter (more like the background), and for <var>num</var> &gt;
1, the fonts will be darker (more like the foreground).
- <br><dt>`<samp><span class="samp">--gif*</span></samp>'<dd><a name="index-GIF-image-format-26"></a>The images are output in the GIF format, if GIF support is
-enabled. This is the default for the `<samp><span class="samp">dvigif</span></samp>' binary, which only
-will be available when GIF support is enabled. See also the
-`<samp><span class="samp">--png</span></samp>' option.
+ <br><dt>`<samp><span class="samp">--gif*</span></samp>'<dd><a name="index-GIF-image-format-26"></a>The images are output in the GIF format, if GIF support is enabled.
+This is the default for the `<samp><span class="samp">dvigif</span></samp>' binary, which only will be
+available when GIF support is enabled. GIF images are palette images
+(see the `<samp><span class="samp">--palette</span></samp>' option) and does not support true alpha
+channels (see the `<samp><span class="samp">--bg</span></samp>' option). See also the `<samp><span class="samp">--png</span></samp>'
+option.
<br><dt>`<samp><span class="samp">--height*</span></samp>'<dd><a name="index-baseline-reporting-27"></a><a name="index-height-reporting-28"></a>Report the height of the image. This only works reliably when the
-LaTeX style `<samp><span class="samp">preview.sty</span></samp>' from preview-latex is used. It
+LaTeX style <samp><span class="file">preview.sty</span></samp> from preview-latex is used. It
reports the number of pixels from the top of the image to the
baseline of the image. The total height of the image is obtained as the
-sum of the values reported from &ndash;height and the &ndash;depth.
+sum of the values reported from `<samp><span class="samp">--height</span></samp>' and `<samp><span class="samp">--depth</span></samp>'.
<br><dt>`<samp><span class="samp">-l [=]</span><var>num</var></samp>'<dd><a name="index-last-page-printed-29"></a><a name="index-page_002c-last-printed-30"></a><a name="index-physical-page-number_002c-and-_0040samp_007b_002dl_007d-31"></a><a name="index-absolute-page-number_002c-and-_0040samp_007b_002dl_007d-32"></a>The last page printed will be the first one numbered <var>num</var>. Default
is the last page in the document. If <var>num</var> is prefixed by an equals
@@ -619,7 +630,7 @@ PostScript specials. `<samp><span class="samp">--noghostscript0</span></samp>' t
<br><dt>`<samp><span class="samp">--nogssafer*</span></samp>'<dd><a name="index-GhostScript-and-_002ddSAFER-38"></a><a name="index-g_t_002ddSAFER-39"></a>Normally, if GhostScript is used to render PostScript specials, the
GhostScript interpreter is run with the option `<samp><span class="samp">-dSAFER</span></samp>'. The
-`<samp><span class="samp">-nogssafer</span></samp>' option runs GhostScript without `<samp><span class="samp">-dSAFER</span></samp>'. The
+`<samp><span class="samp">--nogssafer</span></samp>' option runs GhostScript without `<samp><span class="samp">-dSAFER</span></samp>'. The
`<samp><span class="samp">-dSAFER</span></samp>' option in Ghostscript disables PostScript operators such
as deletefile, to prevent possibly malicious PostScript programs from
having any effect.
@@ -645,7 +656,16 @@ a value to compare with the TeX `<samp><span class="samp">\count0</span></samp>'
DVI file. Thus, using `<samp><span class="samp">-p =3</span></samp>' will start with the third page of
the document, no matter what the pages are actually numbered.
- <br><dt>`<samp><span class="samp">--picky*</span></samp>'<dd><a name="index-no-erroneous-images-47"></a>No images are output when a warning occurs. Normally, dvipng will
+ <br><dt>`<samp><span class="samp">--palette*</span></samp>'<dd><a name="index-forcing-palette-output-47"></a>Starting from `<samp><span class="samp">dvipng</span></samp>' 1.8, the output PNG will be a truecolor
+png when an external image is included, 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 palette (256-color) output and make `<samp><span class="samp">dvipng</span></samp>' revert to
+the old behaviour, where included images were opaque and always
+clipped to the boundingbox. This will also override the
+`<samp><span class="samp">--truecolor</span></samp>' switch if present.
+
+ <br><dt>`<samp><span class="samp">--picky*</span></samp>'<dd><a name="index-no-erroneous-images-48"></a>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
@@ -653,10 +673,10 @@ useful for failed figure inclusion and unknown \special occurrences,
but warnings will also occur for missing or unknown color specs and
missing PK fonts.
- <br><dt>`<samp><span class="samp">--png*</span></samp>'<dd><a name="index-PNG-image-format-48"></a>The images are output in the PNG format. This is the default for the
+ <br><dt>`<samp><span class="samp">--png*</span></samp>'<dd><a name="index-PNG-image-format-49"></a>The images are output in the PNG format. This is the default for the
`<samp><span class="samp">dvipng</span></samp>' binary. See also the `<samp><span class="samp">--gif</span></samp>' option.
- <br><dt>`<samp><span class="samp">-pp </span><var>firstpage</var><span class="samp">-</span><var>lastpage</var></samp>'<dd><a name="index-page-range-49"></a>Print pages <var>firstpage</var> through <var>lastpage</var>; but not quite
+ <br><dt>`<samp><span class="samp">-pp </span><var>firstpage</var><span class="samp">-</span><var>lastpage</var></samp>'<dd><a name="index-page-range-50"></a>Print pages <var>firstpage</var> through <var>lastpage</var>; but not quite
equivalent to `<samp><span class="samp">-p </span><var>firstpage</var><span class="samp"> -l </span><var>lastpage</var></samp>'. 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
@@ -674,18 +694,24 @@ will be interpreted as "all pages up to and including 1", if you want a
page numbered -1 (only the table of contents, say) put `<samp><span class="samp">-pp -1--1</span></samp>',
or more readable, `<samp><span class="samp">-pp -1:-1</span></samp>'.
- <br><dt>`<samp><span class="samp">-q*</span></samp>'<dd><a name="index-quiet-operation-50"></a><a name="index-silent-operation-51"></a><a name="index-warnings_002c-suppressing-52"></a>Run quietly. Don't chatter about pages converted, etc. to standard
+ <br><dt>`<samp><span class="samp">-q*</span></samp>'<dd><a name="index-quiet-operation-51"></a><a name="index-silent-operation-52"></a><a name="index-warnings_002c-suppressing-53"></a>Run quietly. Don't chatter about pages converted, etc. to standard
output; report no warnings (only errors) to standard error.
- <br><dt>`<samp><span class="samp">-Q </span><var>num</var></samp>'<dd><a name="index-antialiasing-levels_0040r_007b_002c-number-of_007d-53"></a><a name="index-quality-54"></a>Set the quality to <var>num</var>. That is, choose the number of antialiasing
-levels for PK and T1lib rendering to be <var>num</var>*<var>num</var>. The default
-value is 4 which gives 16 levels of antialiasing for antialiased fonts
+ <br><dt>`<samp><span class="samp">-Q </span><var>num</var></samp>'<dd><a name="index-antialiasing-levels_0040r_007b_002c-number-of_007d-54"></a><a name="index-quality-55"></a>Set the quality to <var>num</var>. That is, choose the number of antialiasing
+levels for PK and T1lib rendering to be <var>num</var>*<var>num</var>+1. The default
+value is 4 which gives 17 levels of antialiasing for antialiased fonts
from these two. If FreeType is available, its rendering is unaffected by
this option.
- <br><dt>`<samp><span class="samp">-r*</span></samp>'<dd><a name="index-reverse-pagination-55"></a>Toggle output of pages in reverse/forward order. By default, the first
+ <br><dt>`<samp><span class="samp">-r*</span></samp>'<dd><a name="index-reverse-pagination-56"></a>Toggle output of pages in reverse/forward order. By default, the first
page in the DVI is output first.
+ <br><dt>`<samp><span class="samp">--strict*</span></samp>'<dd><a name="index-exit-on-erroneous-images-57"></a>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 `<samp><span class="samp">--picky</span></samp>' option
+above for a list of when warnings occur.
+
<br><dt>`<samp><span class="samp">-T </span><var>image_size</var></samp>'<dd>Set the image size to <var>image_size</var> which can be either of
`<samp><span class="samp">bbox</span></samp>', `<samp><span class="samp">tight</span></samp>', or a comma-separated pair of dimensions
<var>hsize</var>,<var>vsize</var> such as `<samp><span class="samp">.1in,.3cm</span></samp>'. The default is
@@ -695,9 +721,9 @@ the left edge of the paper. This usually gives whitespace above and to
the left in the produced image. The value `<samp><span class="samp">tight</span></samp>' will make dvipng
only include all ink put on the page, producing neat images.
<!-- (@pxref{papersize special}). -->
-This option overrides any papersize special in the DVI file.
+<!-- This option overrides any papersize special in the DVI file. -->
- <br><dt>`<samp><span class="samp">--t1lib*</span></samp>'<dd><a name="index-T1lib-font-rendering-56"></a>Enable/disable T1lib font rendering (default on). This option is
+ <br><dt>`<samp><span class="samp">--t1lib*</span></samp>'<dd><a name="index-T1lib-font-rendering-58"></a>Enable/disable T1lib font rendering (default on). This option is
available if the T1lib font library was present at compilation time. If
this is the case, dvipng will have direct support for PostScript Type1
fonts internally, rather than using `<samp><span class="samp">gsftopk</span></samp>' for rendering the
@@ -709,23 +735,23 @@ you have both FreeType and T1lib on your system FreeType will be
preferred by dvipng, and if you for some reason rather want to use
T1lib, give the option `<samp><span class="samp">--freetype0</span></samp>' (see above).
- <br><dt>`<samp><span class="samp">--truecolor*</span></samp>'<dd><a name="index-truecolor-output-57"></a>On systems with a fairly new `<samp><span class="samp">libgd</span></samp>', one can choose to generate
-truecolor output. This will not be necessary in general unless you
-include truecolor images via a PostScript special (i.e., the
-`<samp><span class="samp">graphics</span></samp>' or `<samp><span class="samp">graphicx</span></samp>' package). It will lead to longer
-execution time, mostly because more data is written to disk.
+ <br><dt>`<samp><span class="samp">--truecolor*</span></samp>'<dd><a name="index-truecolor-output-59"></a>This will make `<samp><span class="samp">dvipng</span></samp>' 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 `<samp><span class="samp">graphics</span></samp>' or
+`<samp><span class="samp">graphicx</span></samp>' package). This switch is overridden by the
+`<samp><span class="samp">--palette</span></samp>' switch.
<br><dt>`<samp><span class="samp">-v*</span></samp>'<dd>Enable verbose operation. This will currently indicate what fonts is
used, in addition to the usual output.
- <br><dt>`<samp><span class="samp">-x </span><var>num</var></samp>'<dd><a name="index-magnification_002c-overriding-DVI-58"></a>Set the x magnification ratio to <var>num</var>/1000. Overrides
+ <br><dt>`<samp><span class="samp">-x </span><var>num</var></samp>'<dd><a name="index-magnification_002c-overriding-DVI-60"></a>Set the x magnification ratio to <var>num</var>/1000. 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 total
number of PK files generated. <var>num</var> may be a real number, not an
integer, for increased precision.
- <br><dt>`<samp><span class="samp">-z </span><var>num</var></samp>'<dd><a name="index-compression-59"></a>Set the PNG compression level to <var>num</var>. This option is enabled if
+ <br><dt>`<samp><span class="samp">-z </span><var>num</var></samp>'<dd><a name="index-compression-61"></a>Set the PNG compression level to <var>num</var>. This option is enabled if
your `<samp><span class="samp">libgd</span></samp>' is new enough. The default compression level is 1,
which selects maximum speed at the price of slightly larger PNGs. For an
older `<samp><span class="samp">libgd</span></samp>', the hard-soldered value 5 is used. The include file
@@ -743,109 +769,98 @@ correspond directly to the zlib compression levels.
<div class="node">
<p><hr>
-<a name="Diagnosing-problems"></a>
+<a name="Graphics"></a>
Next:&nbsp;<a rel="next" accesskey="n" href="#Color">Color</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="#Command_002dline-options">Command-line options</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
</div>
-<h2 class="chapter">5 Diagnosing problems</h2>
-
-<p><a name="index-problems-60"></a><a name="index-trouble-61"></a><a name="index-debugging-62"></a>
-You've gone through all the trouble of installing dvipng, carefully read
-all the instructions in this manual, and still can't get something to
-work. The following sections provide some helpful hints if you find
-yourself in such a situation.
-
- <p>Bug reports should be sent to
-<a href="mailto:dvipng@nongnu.org">dvipng@nongnu.org</a>.
+<h2 class="chapter">5 Graphics</h2>
- <p>Questions, suggestions for new features, pleas for help, and/or praise
-should go to <a href="mailto:dvipng@nongnu.org">dvipng@nongnu.org</a>. For more information on this
-mailing list, send a message with just the word `help' as subject or
-body to <a href="mailto:dvipng-request@nongnu.org">dvipng-request@nongnu.org</a> or look at
-<a href="http://lists.nongnu.org/mailman/listinfo/dvipng">http://lists.nongnu.org/mailman/listinfo/dvipng</a>.
-
- <p>Offers to support further development will be appreciated. For developer
-access, ask on <a href="mailto:dvipng@nongnu.org">dvipng@nongnu.org</a>.
-
- <p>For details on the TeX path-searching library, and <code>mktexpk</code>
-problems, see <a href="kpathsea.html#Common-problems">Common problems</a>.
+<p>`<samp><span class="samp">dvipng</span></samp>' attempts to handle graphics as included by the
+`<samp><span class="samp">graphicx</span></samp>' and `<samp><span class="samp">graphics</span></samp>' packages, without the need of
+specifying a driver to these packages. This means that it recognizes
+the encapsulated postscript inclusion meant for `<samp><span class="samp">dvips</span></samp>', but is
+also able (from version 1.8) to include bitmapped graphics, see the
+details below.
<ul class="menu">
-<li><a accesskey="1" href="#Debug-options">Debug options</a>: Getting diagnostics.
-<li><a accesskey="2" href="#Included-graphics-problems">Included graphics problems</a>: Figures are wrongly rendered.
+<li><a accesskey="1" href="#Encapsulated-PostScript">Encapsulated PostScript</a>: An internal call to GhostScript
+<li><a accesskey="2" href="#Bitmapped-graphics">Bitmapped graphics</a>: PNG, JPEG and GIF
</ul>
<div class="node">
<p><hr>
-<a name="Debug-options"></a>
-Next:&nbsp;<a rel="next" accesskey="n" href="#Included-graphics-problems">Included graphics problems</a>,
-Up:&nbsp;<a rel="up" accesskey="u" href="#Diagnosing-problems">Diagnosing problems</a>
+<a name="Encapsulated-PostScript"></a>
+Next:&nbsp;<a rel="next" accesskey="n" href="#Bitmapped-graphics">Bitmapped graphics</a>,
+Up:&nbsp;<a rel="up" accesskey="u" href="#Graphics">Graphics</a>
</div>
-<h3 class="section">5.1 Debug options</h3>
-
-<p><a name="index-debugging-options-63"></a><a name="index-options_002c-debugging-64"></a>
-The `<samp><span class="samp">-d</span></samp>' flag to dvipng helps in tracking down certain errors. The
-parameter to this flag is an integer that tells what errors are
-currently being tracked. To track a certain class of debug messages,
-simply provide the appropriate number given below; if you wish to track
-multiple classes, sum the numbers of the classes you wish to track. To
-track all classes, you can use <code>-1</code>.
-
- <p>Some of these debugging options are actually provided by Kpathsea
-(see <a href="kpathsea.html#Debugging">Debugging</a>).
-
- <p>The classes are:
- <dl>
-<dt>1<dd>Normal dvi op-codes
-<br><dt>2<dd>Virtual fonts
-<br><dt>4<dd>PK fonts
-<br><dt>8<dd>TFM files
-<br><dt>16<dd>Glyph rendering
-<br><dt>32<dd>FreeType calls
-<br><dt>64<dd>Encoding loads
-<br><dt>128<dd>Color specials
-<br><dt>256<dd>GhostScript specials
-<br><dt>512<dd>T1lib calls
-<br><dt>1024<dd>Kpathsea <code>stat</code> calls
-<br><dt>2048<dd>Kpathsea hash table lookups
-<br><dt>4096<dd>Kpathsea path element expansion
-<br><dt>8192<dd>Kpathsea path searches
-
- </dl>
-
-<div class="node">
+<h3 class="section">5.1 Encapsulated PostScript</h3>
+
+<p>When an EPS file is included, a call to GhostScript is performed to
+produce a bitmapped image that can be included. The default is to
+produce an image with transparent background, at the same size as the
+DVI page currently being converted to PNG, and include that as
+foreground on the PNG. Of course, if the image is to be cropped, that
+is done. The included image will be a truecolor image, so for maximum
+performance the output PNG will be in truecolor mode as well.
+
+ <p>This conversion needs the `<samp><span class="samp">pngalpha</span></samp>' output device to be present
+in your copy of GhostScript. If that device is not present, or you use
+the `<samp><span class="samp">--palette</span></samp>' switch or request GIF output, the fallback is to
+use the `<samp><span class="samp">png16m</span></samp>' device to produce a cropped opaque image for
+inclusion. Other relevant switches are `<samp><span class="samp">--noghostscript</span></samp>' and
+`<samp><span class="samp">--nogssafer</span></samp>'. See <a href="#Option-details">Option details</a>.
+
+ <p><a name="index-PostScript-inclusion-problems-62"></a>The most common problem with including graphics is an incorrect
+bounding box. Complain to whoever wrote the software that generated
+the file if the bounding box is indeed incorrect. An adjusted
+boundingbox can be specified in the `<samp><span class="samp">\includegraphics</span></samp>' call, as
+in this example (using `<samp><span class="samp">graphicx</span></samp>'):
+
+<pre class="example"> \includegraphics[bb=10 20 100 200]{imagename.eps}
+</pre>
+ <div class="node">
<p><hr>
-<a name="Included-graphics-problems"></a>
-Previous:&nbsp;<a rel="previous" accesskey="p" href="#Debug-options">Debug options</a>,
-Up:&nbsp;<a rel="up" accesskey="u" href="#Diagnosing-problems">Diagnosing problems</a>
+<a name="Bitmapped-graphics"></a>
+Previous:&nbsp;<a rel="previous" accesskey="p" href="#Encapsulated-PostScript">Encapsulated PostScript</a>,
+Up:&nbsp;<a rel="up" accesskey="u" href="#Graphics">Graphics</a>
</div>
-<h3 class="section">5.2 Included graphics problems</h3>
+<h3 class="section">5.2 Bitmapped graphics</h3>
-<p><a name="index-graphics-inclusion-problems-65"></a>
-The most common problem with including graphics is an incorrect bounding
-box.
-<!-- (@pxref{Bounding box}). -->
-Complain to whoever wrote the software that generated the file if the
-bounding box is indeed incorrect.
+<p>dvipng can include PNG, JPEG and GIF graphics. When including such
+images via `<samp><span class="samp">\includegraphics</span></samp>' you need to specify the bounding
+box since TeX itself cannot read them from the files in question.
+The bounding box size should be given as `<samp><span class="samp">0 0 w h</span></samp>' in pixels,
+e.g., if the file `<samp><span class="samp">imagename.png</span></samp>' is 300x400 pixels, the
+inclusion would read
- <p>An additional problem is that the image in dvipng is always clipped to
-the bounding box. This is because the image is rendered by GhostScript
-by an internal call and then copied to the dvipng image. At present no
-workaround is known, but there may be one for a future GhostScript.
-We'll see.
-
-<div class="node">
+<pre class="example"> \includegraphics[bb=0 0 300 400]{imagename.png}
+</pre>
+ <p>The default size is the image size in bp (&ldquo;big points&rdquo; in TeX
+nomenclature or PostScript points as other people have it, 72 per inch).
+That is, default resolution will be 72 dpi for included bitmaps, which
+is the default size in the few other bitmap-capable drivers that are
+known to me (dvipdfm and PDFLaTeX).
+
+ <p>If you want 100 dpi you need to specify the width accordingly. You
+just divide your image width by 100: a 135 pixel wide image at 100 dpi
+will take up 1.35 inches. If you want 200 dpi you divide by 200, and
+so on. Simple, eh? The example above at 200 dpi would be 1.5 inches
+wide:
+
+<pre class="example"> \includegraphics[bb=0 0 300 400,witdh=1.5in]{imagename.png}
+</pre>
+ <div class="node">
<p><hr>
<a name="Color"></a>
-Next:&nbsp;<a rel="next" accesskey="n" href="#Copying">Copying</a>,
-Previous:&nbsp;<a rel="previous" accesskey="p" href="#Diagnosing-problems">Diagnosing problems</a>,
+Next:&nbsp;<a rel="next" accesskey="n" href="#Diagnosing-problems">Diagnosing problems</a>,
+Previous:&nbsp;<a rel="previous" accesskey="p" href="#Graphics">Graphics</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
</div>
@@ -871,22 +886,24 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Color">Color</a>
<h3 class="section">6.1 Color specifications</h3>
-<p><a name="index-color-specifications-66"></a>
+<p><a name="index-color-specifications-63"></a>
The color specification supported by dvipng is by-value or by-name. The
by-value spec starts with the name of a color model (one of `<samp><span class="samp">rgb</span></samp>',
`<samp><span class="samp">hsb</span></samp>', `<samp><span class="samp">cmy</span></samp>', `<samp><span class="samp">cmyk</span></samp>', or `<samp><span class="samp">gray</span></samp>') followed by the
appropriate number of parameters. Thus, the color specification
`<samp><span class="samp">rgb 0.3 0.4 0.5</span></samp>' would correspond to the color that is `<samp><span class="samp">0.3
-0.4 0.5</span></samp>' in its red, blue and green values. The color used internally in
-dvipng is `<samp><span class="samp">RGB</span></samp>' (discretized to 256 levels), for details on the
-formulas used in conversion, see the `<samp><span class="samp">xcolor</span></samp>' documentation.
+0.4 0.5</span></samp>' in its red, blue and green values. The color model used
+internally in dvipng is `<samp><span class="samp">RGB</span></samp>' (discretized to 256 levels), for
+details on the formulas used in conversion, see the `<samp><span class="samp">xcolor</span></samp>'
+documentation.
<p>By-name color specifications are single (case-dependent) words and are
compared with color names defined in `<samp><span class="samp">dvipsnam.def</span></samp>' (from the
`<samp><span class="samp">graphics</span></samp>' bundle), `<samp><span class="samp">svgnam.def</span></samp>' and `<samp><span class="samp">xcolor.sty</span></samp>' (from
-the `<samp><span class="samp">xcolor</span></samp>' bundle).
+the `<samp><span class="samp">xcolor</span></samp>' bundle). See the `<samp><span class="samp">xcolor</span></samp>' documentation for a
+list of names and the corresponding colors.
- <p>On the command-line, the name `<samp><span class="samp">Transparent</span></samp>' can also be used in as
+ <p>On the command-line, the name `<samp><span class="samp">Transparent</span></samp>' can also be used as
an argument to `<samp><span class="samp">--bg</span></samp>' to choose transparent background.
See <a href="#Option-details">Option details</a>.
@@ -918,7 +935,7 @@ This saves the current color on the color stack and sets the color to be
that given by the color specification. This is the most common way to
set a color.
- <p>The final version of the `<samp><span class="samp">color</span></samp>' special is just `<samp><span class="samp">color pop</span></samp>',
+ <p>The final form of the `<samp><span class="samp">color</span></samp>' special is just `<samp><span class="samp">color pop</span></samp>',
with no color specification; this says to pop the color last pushed on
the color stack from the color stack and set the current color to be
that color.
@@ -928,40 +945,128 @@ the pages are rendered repeatedly or in reverse order.
<div class="node">
<p><hr>
+<a name="Diagnosing-problems"></a>
+Next:&nbsp;<a rel="next" accesskey="n" href="#Credits">Credits</a>,
+Previous:&nbsp;<a rel="previous" accesskey="p" href="#Color">Color</a>,
+Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
+
+</div>
+
+<h2 class="chapter">7 Diagnosing problems</h2>
+
+<p><a name="index-problems-64"></a><a name="index-trouble-65"></a><a name="index-debugging-66"></a>
+You've gone through all the trouble of installing dvipng, carefully read
+all the instructions in this manual, and still can't get something to
+work. The following sections provide some helpful hints if you find
+yourself in such a situation.
+
+<ul class="menu">
+<li><a accesskey="1" href="#Contact-information">Contact information</a>: Who to ask.
+<li><a accesskey="2" href="#Debug-options">Debug options</a>: Getting diagnostics.
+</ul>
+
+<div class="node">
+<p><hr>
+<a name="Contact-information"></a>
+Next:&nbsp;<a rel="next" accesskey="n" href="#Debug-options">Debug options</a>,
+Up:&nbsp;<a rel="up" accesskey="u" href="#Diagnosing-problems">Diagnosing problems</a>
+
+</div>
+
+<h3 class="section">7.1 Contact information</h3>
+
+<p>Bug reports should be sent to
+<a href="mailto:dvipng@nongnu.org">dvipng@nongnu.org</a>.
+
+ <p>Questions, suggestions for new features, pleas for help, and/or praise
+should go to <a href="mailto:dvipng@nongnu.org">dvipng@nongnu.org</a>. For more information on this
+mailing list, send a message with just the word `help' as subject or
+body to <a href="mailto:dvipng-request@nongnu.org">dvipng-request@nongnu.org</a> or look at
+<a href="http://lists.nongnu.org/mailman/listinfo/dvipng">http://lists.nongnu.org/mailman/listinfo/dvipng</a>.
+
+ <p>Offers to support further development will be appreciated. For developer
+access, ask on <a href="mailto:dvipng@nongnu.org">dvipng@nongnu.org</a>.
+
+ <p>For details on the TeX path-searching library, and <code>mktexpk</code>
+problems, see <a href="kpathsea.html#Common-problems">Common problems</a>.
+
+<div class="node">
+<p><hr>
+<a name="Debug-options"></a>
+Previous:&nbsp;<a rel="previous" accesskey="p" href="#Contact-information">Contact information</a>,
+Up:&nbsp;<a rel="up" accesskey="u" href="#Diagnosing-problems">Diagnosing problems</a>
+
+</div>
+
+<h3 class="section">7.2 Debug options</h3>
+
+<p>The `<samp><span class="samp">-d</span></samp>' flag to dvipng helps in tracking down certain errors. The
+parameter to this flag is an integer that tells what errors are
+currently being tracked. To track a certain class of debug messages,
+simply provide the appropriate number given below; if you wish to track
+multiple classes, sum the numbers of the classes you wish to track. To
+track all classes, you can use <code>-1</code>.
+
+ <p>Some of these debugging options are actually provided by Kpathsea
+(see <a href="kpathsea.html#Debugging">Debugging</a>).
+
+ <p>The classes are:
+ <dl>
+<dt>1<dd>Normal dvi op-codes
+<br><dt>2<dd>Virtual fonts
+<br><dt>4<dd>PK fonts
+<br><dt>8<dd>TFM files
+<br><dt>16<dd>Glyph rendering
+<br><dt>32<dd>FreeType calls
+<br><dt>64<dd>Encoding loads
+<br><dt>128<dd>Color specials
+<br><dt>256<dd>GhostScript specials
+<br><dt>512<dd>T1lib calls
+<br><dt>1024<dd>Kpathsea <code>stat</code> calls
+<br><dt>2048<dd>Kpathsea hash table lookups
+<br><dt>4096<dd>Kpathsea path element expansion
+<br><dt>8192<dd>Kpathsea path searches
+
+ </dl>
+
+<div class="node">
+<p><hr>
<a name="Credits"></a>
-Next:&nbsp;<a rel="next" accesskey="n" href="#Index">Index</a>,
-Previous:&nbsp;<a rel="previous" accesskey="p" href="#Copying">Copying</a>,
+Next:&nbsp;<a rel="next" accesskey="n" href="#Copying">Copying</a>,
+Previous:&nbsp;<a rel="previous" accesskey="p" href="#Diagnosing-problems">Diagnosing problems</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
</div>
-<h2 class="chapter">7 Credits</h2>
+<h2 class="chapter">8 Credits</h2>
-<p>A number of persons have contributed, if I forget to mention someone, I
-apologize. First and foremost we have David Kastrup whose
+<p>A number of persons have contributed, if I forget to mention someone,
+I apologize. First and foremost we have David Kastrup whose
preview-latex project provided the incentive to write this program.
-There is also a number of people who have contributed by reporting bugs
-and suggesting improvements as the thing has evolved. These include but
-is perhaps not limited to (in semi-random order): Thomas Esser
-(teTeX), Christian Schenk (MIKTeX), Brian R Furry (debian
-package), Angus Leeming (LyX), Thomas Boutell (libgd), John Jones (first
-user report), Uwe Kern (xcolor), Alan Shutko, Reiner Stieb, Nick Alcock,
-Adam Buchbinder, Svend Tollak Munkejord, James Longstreet, Bernhard
-Simon, Bob McElrath, Georg Schwarz, Jason Farmer, Brian V. Smith, Samuel
-Hathaway, Thomas R. Shemanske, Stephen Gibson, Christian Ridderstr&ouml;m,
-Ezra Peisach, William H Wheeler, Thomas Klausner, Harald Koenig, Adrian
-Bunk, Kevin Smith, and Jason Riedy.
+There is also a number of people who have contributed by reporting
+bugs and suggesting improvements as the thing has evolved. These
+include but is perhaps not limited to (in semi-random order): Thomas
+Esser (teTeX), Christian Schenk (MIKTeX), Brian R Furry (debian
+package), Angus Leeming (LyX), Thomas Boutell (libgd), John Jones
+(first user report), Uwe Kern (xcolor), Karl Berry (TeX Live),
+David Harvey (hinting in Freetype), Neal Harmon, Alan Shutko, Reiner
+Stieb, Nick Alcock, Adam Buchbinder, Svend Tollak Munkejord, James
+Longstreet, Bernhard Simon, Bob McElrath, Georg Schwarz, Jason Farmer,
+Brian V. Smith, Samuel Hathaway, Thomas R. Shemanske, Stephen Gibson,
+Christian Ridderstr&ouml;m, Ezra Peisach, William H Wheeler, Thomas
+Klausner, Harald Koenig, Adrian Bunk, Kevin Smith, Jason Riedy,
+Wolfram Krause, and Reinhard Kotucha.
<div class="node">
<p><hr>
<a name="Copying"></a>
-Next:&nbsp;<a rel="next" accesskey="n" href="#Credits">Credits</a>,
-Previous:&nbsp;<a rel="previous" accesskey="p" href="#Color">Color</a>,
+Next:&nbsp;<a rel="next" accesskey="n" href="#Index">Index</a>,
+Previous:&nbsp;<a rel="previous" accesskey="p" href="#Credits">Credits</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
</div>
-<h2 class="chapter">8 Copying</h2>
+<h2 class="chapter">9 Copying</h2>
<p>This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
@@ -975,18 +1080,19 @@ GNU General Public License for more details.
<p>You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
-Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+02110-1301 USA.
<pre class="sp">
</pre>
-Copyright &copy; 2002-2005 Jan-&Aring;ke Larsson
+Copyright &copy; 2002-2006 Jan-&Aring;ke Larsson
<div class="node">
<p><hr>
<a name="Index"></a>
-Previous:&nbsp;<a rel="previous" accesskey="p" href="#Credits">Credits</a>,
+Previous:&nbsp;<a rel="previous" accesskey="p" href="#Copying">Copying</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
</div>
@@ -997,23 +1103,24 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-g_t_002ddSAFER-39">-dSAFER</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-absolute-page-number_002c-and-_0040samp_007b_002dl_007d-32">absolute page number, and `<samp><span class="samp">-l</span></samp>'</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-absolute-page-number_002c-and-_0040samp_007b_002dp_007d-46">absolute page number, and `<samp><span class="samp">-p</span></samp>'</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-antialiasing-levels_0040r_007b_002c-number-of_007d-53">antialiasing levels<span class="roman">, number of</span></a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-antialiasing-levels_0040r_007b_002c-number-of_007d-54">antialiasing levels<span class="roman">, number of</span></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-background-color-_0028option_0029-14">background color (option)</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-base-resolution_002c-setting-13">base resolution, setting</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-baseline-reporting-17">baseline reporting</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-color-specifications-66">color specifications</a>: <a href="#Color-specifications">Color specifications</a></li>
+<li><a href="#index-color-specifications-63">color specifications</a>: <a href="#Color-specifications">Color specifications</a></li>
<li><a href="#index-command_002dline-options-5">command-line options</a>: <a href="#Command_002dline-options">Command-line options</a></li>
<li><a href="#index-compilation-2">compilation</a>: <a href="#Installation">Installation</a></li>
-<li><a href="#index-compression-59">compression</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-compression-61">compression</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-configuration_002c-of-dvipng-1">configuration, of dvipng</a>: <a href="#Installation">Installation</a></li>
<li><a href="#index-dark-fonts-23">dark fonts</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-debugging-62">debugging</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
+<li><a href="#index-debugging-66">debugging</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
<li><a href="#index-debugging-15">debugging</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-debugging-options-63">debugging options</a>: <a href="#Debug-options">Debug options</a></li>
<li><a href="#index-depth-reporting-18">depth reporting</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-exit-on-erroneous-images-57">exit on erroneous images</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-first-page-printed-43">first page printed</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-follow-mode-20">follow mode</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-font-generation_002c-avoiding-35">font generation, avoiding</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-forcing-palette-output-47">forcing palette output</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-foreground-color-_0028option_0029-19">foreground color (option)</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-FreeType-font-rendering-21">FreeType font rendering</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-fuzzy-images-25">fuzzy images</a>: <a href="#Option-details">Option details</a></li>
@@ -1021,43 +1128,42 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-GhostScript-and-_002ddSAFER-38">GhostScript and -dSAFER</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-GhostScript_002c-turning-off-37">GhostScript, turning off</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-GIF-image-format-26">GIF image format</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-graphics-inclusion-problems-65">graphics inclusion problems</a>: <a href="#Included-graphics-problems">Included graphics problems</a></li>
<li><a href="#index-height-reporting-28">height reporting</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-installation_002c-of-dvipng-3">installation, of dvipng</a>: <a href="#Installation">Installation</a></li>
<li><a href="#index-invoking-dvipng-4">invoking dvipng</a>: <a href="#Basic-usage">Basic usage</a></li>
<li><a href="#index-last-page-printed-29">last page printed</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-light-fonts-24">light fonts</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-magnification_002c-overriding-DVI-58">magnification, overriding DVI</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-magnification_002c-overriding-DVI-60">magnification, overriding DVI</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-Metafont-mode_002c-specifying-34">Metafont mode, specifying</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-mktexpk_0040r_007b_002c-avoiding_007d-36"><code>mktexpk</code><span class="roman">, avoiding</span></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-mode-name_002c-specifying-33">mode name, specifying</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-no-erroneous-images-47">no erroneous images</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-no-erroneous-images-48">no erroneous images</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-offset-pages-42">offset pages</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-option_002c-details-of-8">option, details of</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-options_002c-debugging-64">options, debugging</a>: <a href="#Debug-options">Debug options</a></li>
<li><a href="#index-options_002c-dvipng-6">options, dvipng</a>: <a href="#Command_002dline-options">Command-line options</a></li>
<li><a href="#index-options_002c-reading-from-standard-input-9">options, reading from standard input</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-options_002c-summary-7">options, summary</a>: <a href="#Option-summary">Option summary</a></li>
<li><a href="#index-output-resolution_002c-setting-16">output resolution, setting</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-output_002c-redirecting-40">output, redirecting</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-page-range-49">page range</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-page-range-50">page range</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-page_002c-first-printed-44">page, first printed</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-page_002c-last-printed-30">page, last printed</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-physical-page-number_002c-and-_0040samp_007b_002dl_007d-31">physical page number, and `<samp><span class="samp">-l</span></samp>'</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-physical-page-number_002c-and-_0040samp_007b_002dp_007d-45">physical page number, and `<samp><span class="samp">-p</span></samp>'</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-PNG-image-format-48">PNG image format</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-problems-60">problems</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
-<li><a href="#index-quality-54">quality</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-quiet-operation-50">quiet operation</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-reverse-pagination-55">reverse pagination</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-silent-operation-51">silent operation</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-PNG-image-format-49">PNG image format</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-PostScript-inclusion-problems-62">PostScript inclusion problems</a>: <a href="#Encapsulated-PostScript">Encapsulated PostScript</a></li>
+<li><a href="#index-problems-64">problems</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
+<li><a href="#index-quality-55">quality</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-quiet-operation-51">quiet operation</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-reverse-pagination-56">reverse pagination</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-silent-operation-52">silent operation</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-standard-input_002c-reading-options-from-10">standard input, reading options from</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-standard-output_002c-output-to-41">standard output, output to</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-T1lib-font-rendering-56">T1lib font rendering</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-T1lib-font-rendering-58">T1lib font rendering</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-transparent-border-fallback-color-12">transparent border fallback color</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-transparent-border-width-11">transparent border width</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-trouble-61">trouble</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
-<li><a href="#index-truecolor-output-57">truecolor output</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-warnings_002c-suppressing-52">warnings, suppressing</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-trouble-65">trouble</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
+<li><a href="#index-truecolor-output-59">truecolor output</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-warnings_002c-suppressing-53">warnings, suppressing</a>: <a href="#Option-details">Option details</a></li>
</ul></body></html>