summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/info/dvipng.info
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/doc/info/dvipng.info')
-rw-r--r--Master/texmf/doc/info/dvipng.info208
1 files changed, 112 insertions, 96 deletions
diff --git a/Master/texmf/doc/info/dvipng.info b/Master/texmf/doc/info/dvipng.info
index e2f4323ec73..0b9be7c8220 100644
--- a/Master/texmf/doc/info/dvipng.info
+++ b/Master/texmf/doc/info/dvipng.info
@@ -1,5 +1,5 @@
-This is dvipng.info, produced by makeinfo version 4.8 from
-../../../texk/dvipng/dvipng.texi.
+This is dvipng.info, produced by makeinfo version 4.12 from
+../../../TeXlive-svn/texk/dvipng/dvipng.texi.
INFO-DIR-SECTION TeX
START-INFO-DIR-ENTRY
@@ -16,7 +16,7 @@ dvipng
This manual documents dvipng, a program to translate a DVI (DeVice
Independent) file into PNG (Portable Network Graphics).
- This file documents dvipng version 1.9
+ This file documents dvipng version 1.11
Corrections or perhaps rewrites of sections are _very welcome_.
@@ -32,7 +32,7 @@ Independent) file into PNG (Portable Network Graphics).
* Color:: Using color with dvipng
* Diagnosing problems:: Problems?
* Credits:: People who have contributed
-* Copying:: GNU General Public License
+* Copying:: GNU Lesser General Public License
* Index:: General index

@@ -59,6 +59,11 @@ homework problems to students over the internet, giving students
instant feedback as to whether or not their answers are correct, see
`http://webwork.math.rochester.edu'.
+ A more recent addition to the dvipng-using applications out there is
+MediaWiki, the software behind Wikipedia and many other wikis out
+there. Dvipng is used to render mathematical formulae from version
+1.8.0 of MediaWiki, see `http://www.mediawiki.org'.
+
Other applications may also benefit, like web applications as
latex2html and WYSIWYG editors like LyX.
@@ -125,25 +130,30 @@ File: dvipng.info, Node: Prerequisites, Next: Configure, Up: Installation
* The font-rendering library FreeType 2
- 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.
+ While not strictly necessary, a recent FreeType 2 is recommended
+ since dvipng currently will produce better-quality images when
+ this library is available. To take advantage of this, you should
+ have at least FreeType 2.1.9.
+
+ FreeType 2 will enable direct support for PostScript and TrueType
+ fonts, so that 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.
+
+ Finally, it will enable subfont support in dvipng. That is, if you
+ want to render CJK-LaTeX characters, you must have FreeType 2
+ installed.
* The font-rendering library T1lib
An alternative to FreeType 2 is T1lib, but this will enable only
- PostScript fonts in dvipng, and will not include subfont support.
+ 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.
+ internally preferred by dvipng but T1lib can be chosen at runtime.
* libpng and libz
@@ -317,7 +327,7 @@ File: dvipng.info, Node: Option summary, Next: Option details, Up: Command-li
Here is a handy summary of the options; it is printed out when you run
dvipng with no arguments or with the standard `--help' option.
- This is ./dvipng 1.9 Copyright 2002-2006 Jan-Ake Larsson
+ This is ./dvipng 1.10 Copyright 2002-2008 Jan-Ake Larsson
Usage: ./dvipng [OPTION]... FILENAME[.dvi]
Options are chosen to be similar to dvips' options where possible:
@@ -343,12 +353,16 @@ dvipng with no arguments or with the standard `--help' option.
--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
+ --palette* Force palette output
--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
@@ -432,11 +446,11 @@ reversal, use `-r0'. Such options are marked with a trailing `*'.
`--depth*'
Report the depth of the image. This only works reliably when the
- LaTeX style `preview.sty' 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
- StyleSheets 1)
+ LaTeX style `preview.sty' from preview-latex is used with the
+ `active' option. 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 StyleSheets 1)
<IMG SRC="FILENAME.PNG" STYLE="vertical-align: -DEPTHpx">
The depth is a negative offset in this case, so the minus sign is
necessary, and the unit is pixels (px).
@@ -488,10 +502,11 @@ reversal, use `-r0'. Such options are marked with a trailing `*'.
`--height*'
Report the height of the image. This only works reliably when the
- LaTeX style `preview.sty' 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 `--height' and `--depth'.
+ LaTeX style `preview.sty' from preview-latex is used with the
+ `active' option. 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
+ `--height' and `--depth'.
`-l [=]NUM'
The last page printed will be the first one numbered NUM. Default
@@ -750,9 +765,10 @@ File: dvipng.info, Node: Color, Next: Diagnosing problems, Prev: Graphics, U
6 Color
*******
-To support color, dvipng recognizes a certain set of specials. These
-specials start with the keyword `color' or the keyword `background',
-followed by a color specification.
+To support color, dvipng recognizes a certain set of specials as
+generated by the `color' and `xcolor' style files. These specials start
+with the keyword `color' or the keyword `background', followed by a
+color specification.
* Menu:
@@ -932,7 +948,7 @@ Svend Tollak Munkejord, James Longstreet, Bernhard Simon, Bob McElrath,
Georg Schwarz, Jason Farmer, Brian V. Smith, Samuel Hathaway, Thomas R.
Shemanske, Stephen Gibson, Christian Ridderstro"m, Ezra Peisach,
William H Wheeler, Thomas Klausner, Harald Koenig, Adrian Bunk, Kevin
-Smith, Jason Riedy, Wolfram Krause, and Reinhard Kotucha.
+Smith, Jason Riedy, Wolfram Krause, Reinhard Kotucha, and Takeshi Abe.

File: dvipng.info, Node: Copying, Next: Index, Prev: Credits, Up: Top
@@ -940,23 +956,23 @@ File: dvipng.info, Node: Copying, Next: Index, Prev: Credits, Up: Top
9 Copying
*********
-This program is free software; you can redistribute it and/or modify it
-under the terms of the GNU General Public License as published by the
-Free Software Foundation; either version 2 of the License, or (at your
-option) any later version.
+This program is free software: you can redistribute it and/or modify it
+under the terms of the GNU Lesser General Public License as published
+by the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
General Public License for more details.
- 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+ You should have received a copy of the GNU Lesser General Public
+License along with this program. If not, see
+<http://www.gnu.org/licenses/>.
-Copyright (C) 2002-2006 Jan-AAke Larsson
+Copyright (C) 2002-2008 Jan-AAke Larsson

File: dvipng.info, Node: Index, Prev: Copying, Up: Top
@@ -967,10 +983,10 @@ Index
* Menu:
-* -dSAFER: Option details. (line 166)
-* absolute page number, and -l: Option details. (line 139)
-* absolute page number, and -p: Option details. (line 187)
-* antialiasing levels, number of: Option details. (line 241)
+* -dSAFER: Option details. (line 167)
+* absolute page number, and -l: Option details. (line 140)
+* absolute page number, and -p: Option details. (line 188)
+* antialiasing levels, number of: Option details. (line 242)
* background color (option): Option details. (line 40)
* base resolution, setting: Option details. (line 35)
* baseline reporting: Option details. (line 76)
@@ -979,90 +995,90 @@ Index
* command-line options: Command-line options.
(line 6)
* compilation: Installation. (line 6)
-* compression: Option details. (line 302)
+* compression: Option details. (line 303)
* configuration, of dvipng: Installation. (line 6)
* dark fonts: Option details. (line 119)
* debugging <1>: Diagnosing problems. (line 6)
* debugging: Option details. (line 54)
* depth reporting: Option details. (line 76)
-* exit on erroneous images: Option details. (line 252)
-* first page printed: Option details. (line 187)
+* exit on erroneous images: Option details. (line 253)
+* first page printed: Option details. (line 188)
* follow mode: Option details. (line 97)
-* font generation, avoiding: Option details. (line 156)
-* forcing palette output: Option details. (line 196)
+* font generation, avoiding: Option details. (line 157)
+* forcing palette output: Option details. (line 197)
* foreground color (option): Option details. (line 91)
* FreeType font rendering: Option details. (line 105)
* fuzzy images: Option details. (line 119)
* gamma: Option details. (line 119)
-* GhostScript and -dSAFER: Option details. (line 166)
-* GhostScript, turning off: Option details. (line 161)
+* GhostScript and -dSAFER: Option details. (line 167)
+* GhostScript, turning off: Option details. (line 162)
* GIF image format: Option details. (line 125)
* height reporting: Option details. (line 132)
* installation, of dvipng: Installation. (line 6)
* invoking dvipng: Basic usage. (line 6)
-* last page printed: Option details. (line 139)
+* last page printed: Option details. (line 140)
* light fonts: Option details. (line 119)
-* magnification, overriding DVI: Option details. (line 294)
-* Metafont mode, specifying: Option details. (line 148)
-* mktexpk, avoiding: Option details. (line 156)
-* mode name, specifying: Option details. (line 148)
-* no erroneous images: Option details. (line 206)
-* offset pages: Option details. (line 181)
+* magnification, overriding DVI: Option details. (line 295)
+* Metafont mode, specifying: Option details. (line 149)
+* mktexpk, avoiding: Option details. (line 157)
+* mode name, specifying: Option details. (line 149)
+* no erroneous images: Option details. (line 207)
+* offset pages: Option details. (line 182)
* option, details of: Option details. (line 6)
* options, dvipng: Command-line options.
(line 6)
* options, reading from standard input: Option details. (line 11)
* options, summary: Option summary. (line 6)
* output resolution, setting: Option details. (line 60)
-* output, redirecting: Option details. (line 174)
-* page range: Option details. (line 219)
-* page, first printed: Option details. (line 187)
-* page, last printed: Option details. (line 139)
-* physical page number, and -l: Option details. (line 139)
-* physical page number, and -p: Option details. (line 187)
-* PNG image format: Option details. (line 215)
+* output, redirecting: Option details. (line 175)
+* page range: Option details. (line 220)
+* page, first printed: Option details. (line 188)
+* page, last printed: Option details. (line 140)
+* physical page number, and -l: Option details. (line 140)
+* physical page number, and -p: Option details. (line 188)
+* PNG image format: Option details. (line 216)
* PostScript inclusion problems: Encapsulated PostScript.
(line 21)
* problems: Diagnosing problems. (line 6)
-* quality: Option details. (line 241)
-* quiet operation: Option details. (line 237)
-* reverse pagination: Option details. (line 248)
-* silent operation: Option details. (line 237)
+* quality: Option details. (line 242)
+* quiet operation: Option details. (line 238)
+* reverse pagination: Option details. (line 249)
+* silent operation: Option details. (line 238)
* standard input, reading options from: Option details. (line 11)
-* standard output, output to: Option details. (line 174)
-* T1lib font rendering: Option details. (line 269)
+* standard output, output to: Option details. (line 175)
+* T1lib font rendering: Option details. (line 270)
* transparent border fallback color: Option details. (line 25)
* transparent border width: Option details. (line 25)
* trouble: Diagnosing problems. (line 6)
-* truecolor output: Option details. (line 283)
-* warnings, suppressing: Option details. (line 237)
+* truecolor output: Option details. (line 284)
+* warnings, suppressing: Option details. (line 238)

Tag Table:
-Node: Top317
-Node: Introduction1204
-Node: Installation3185
-Node: Prerequisites3532
-Node: Configure5914
-Node: Build/install7953
-Node: Installation outside the texmf tree8421
-Node: Advice for non-privileged users9128
-Node: Basic usage10136
-Node: Command-line options11263
-Node: Option summary11687
-Node: Option details13807
-Node: Graphics29131
-Node: Encapsulated PostScript29696
-Node: Bitmapped graphics31039
-Node: Color32239
-Node: Color specifications32574
-Node: Color specials33673
-Node: Diagnosing problems35085
-Node: Contact information35568
-Node: Debug options36309
-Node: Credits37344
-Node: Copying38493
-Node: Index39322
+Node: Top330
+Node: Introduction1225
+Node: Installation3464
+Node: Prerequisites3811
+Node: Configure6301
+Node: Build/install8340
+Node: Installation outside the texmf tree8808
+Node: Advice for non-privileged users9515
+Node: Basic usage10523
+Node: Command-line options11650
+Node: Option summary12074
+Node: Option details14383
+Node: Graphics29762
+Node: Encapsulated PostScript30327
+Node: Bitmapped graphics31670
+Node: Color32870
+Node: Color specifications33258
+Node: Color specials34357
+Node: Diagnosing problems35769
+Node: Contact information36252
+Node: Debug options36993
+Node: Credits38028
+Node: Copying39190
+Node: Index39970

End Tag Table