diff options
Diffstat (limited to 'Master/texmf-dist/doc/dvipng/dvipng.html')
| -rw-r--r-- | Master/texmf-dist/doc/dvipng/dvipng.html | 143 |
1 files changed, 27 insertions, 116 deletions
diff --git a/Master/texmf-dist/doc/dvipng/dvipng.html b/Master/texmf-dist/doc/dvipng/dvipng.html index 982b70f087f..12f72d2da95 100644 --- a/Master/texmf-dist/doc/dvipng/dvipng.html +++ b/Master/texmf-dist/doc/dvipng/dvipng.html @@ -13,7 +13,7 @@ <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="dir.html#Top" rel="up" title="(dir)"> +<link href="http://tug.org/texinfohtml" rel="up" title="(dir)"> <style type="text/css"> <!-- a.summary-letter {text-decoration: none} @@ -102,7 +102,7 @@ ul.no-bullet {list-style: none} <a name="Top"></a> <div class="header"> <p> -Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="dvipng"></a> <h1 class="top">dvipng</h1> @@ -110,7 +110,7 @@ Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a <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.14 +<p>This file documents dvipng version 1.15 </p> <p>Corrections or perhaps rewrites of sections are <em>very welcome</em>. </p> @@ -155,7 +155,7 @@ Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previou <p>This program makes PNG and/or GIF graphics from DVI files as obtained -from TeX and its relatives. +from TeX and its relatives. </p> <p>If GIF support is enabled, GIF output is chosen by using the ‘<samp>dvigif</samp>’ binary or with the ‘<samp>--gif</samp>’ option. @@ -166,7 +166,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://www.gnu.org/software/auctex/preview-latex.html">http://www.gnu.org/software/auctex/preview-latex.html</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> <p>Another example is WeBWorK, an internet-based method for delivering homework problems to students over the internet, giving students @@ -223,7 +223,7 @@ 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>. +<code>make</code>, and <code>make install</code>. </p> <table class="menu" border="0" cellspacing="0"> <tr><td align="left" valign="top">• <a href="#Prerequisites" accesskey="1">Prerequisites</a>:</td><td> </td><td align="left" valign="top"> @@ -280,15 +280,6 @@ resolutions without cluttering the disk with lots of bitmapped fonts. <p>Finally, it will enable subfont support in dvipng. That is, if you want to render CJK-LaTeX characters, you must have FreeType 2 installed. </p> -</li><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. -</p> </li><li> libpng and libz <p>To be able to compress and write PNG files to disk, dvipng (or really @@ -297,7 +288,7 @@ any modern system, if not, download them and install them. </p> </li><li> The <code>texinfo</code> package -<p>This is needed for building the documentation. +<p>This is needed for building the documentation. </p></li></ul> <hr> @@ -459,7 +450,7 @@ PNG format. If there are four pages in <samp>foo.dvi</samp>, those pages will be output as <samp>foo1.png</samp>, <samp>foo2.png</samp>, <samp>foo3.png</samp>, and <samp>foo4.png</samp>, respectively. </p> -<p>If you have enabled the PostScript font support (via FreeType or T1lib), +<p>If you have enabled the PostScript font support (via FreeType), fonts will be rendered as they are needed. Otherwise, dvipng will use bitmapped (PK) fonts, and if you use PK fonts that have not been used on your system before, they may be automatically generated; this process @@ -513,7 +504,7 @@ Next: <a href="#Option-details" accesskey="n" rel="next">Option details</a>, Up: dvipng with no arguments or with the standard ‘<samp>--help</samp>’ option. </p> <div class="example"> -<pre class="example">This is ./dvipng (TeX Live) 1.14 Copyright 2002-2010 Jan-Ake Larsson +<pre class="example">This is ./dvipng (TeX Live) 1.15 Copyright 2002-2015 Jan-Ake Larsson Usage: ./dvipng [OPTION]... FILENAME[.dvi] Options are chosen to be similar to dvips' options where possible: @@ -549,7 +540,7 @@ These do not correspond to dvips options: --png Output PNG images (dvipng default) --strict When a warning occurs, exit --truecolor* Truecolor output - -Q # Quality (T1lib and PK subsampling) + -Q # Quality (PK subsampling) --width* Output the image width on stdout -z # PNG compression level @@ -634,13 +625,13 @@ both variants will use the latter behaviour. See <a href="#Color">Color</a>. <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 ‘<samp>-d -1</samp>’ as -the first option for maximum output. See <a href="#Debug-options">Debug options</a>. +the first option for maximum output. See <a href="#Debug-options">Debug options</a>. </p> </dd> <dt>‘<samp>-D <var>num</var></samp>’</dt> <dd><a name="index-output-resolution_002c-setting"></a> <p>Set the output resolution, both horizontal and vertical, to <var>num</var> -dpi (dots per inch). +dpi (dots per inch). </p> <p>One may want to adjust this to fit a certain text font size (e.g., on a web page), and for a text font height of <var>font_px</var> pixels (in @@ -654,7 +645,7 @@ proprietary browsers have font height in pt (points), not pixels. You have to rescale that to pixels, using the screen resolution (default is usually 96 dpi) which means the formula is </p><div class="example"> -<pre class="example"><var>font_px</var> = <var>font_pt</var> * 96 / 72 [pt * px/in / (pt/in)] +<pre class="example"><var>font_px</var> = <var>font_pt</var> * 96 / 72 [pt * px/in / (pt/in)] </pre></div> <p>On some high-res screens, the value is instead 120 dpi. Good luck! </p> @@ -708,9 +699,7 @@ for rendering the fonts. If you have PostScript versions of Computer Modern installed, there will be no need to generate bitmapped (PK) variants on disk of these. Then, you can render images at different (and unusual) resolutions without cluttering the disk with lots of bitmapped -fonts. Note that if you have both FreeType and T1lib on your system, -FreeType will be preferred by dvipng. If you for some reason would want -to use T1lib rendering, use this option. +fonts. </p> </dd> <dt>‘<samp>--gamma <var>num</var></samp>’</dt> @@ -774,7 +763,7 @@ names for most devices. See <a href="kpathsea.html#Unable-to-generate-fonts">Una <dd><a name="index-font-generation_002c-avoiding"></a> <a name="index-mktexpk_002c-avoiding"></a> <p>This option only has an effect when using bitmapped (PK) fonts. It turns -off automatic PK font generation (<samp>mktexpk</samp>). +off automatic PK font generation (<samp>mktexpk</samp>). </p> </dd> <dt>‘<samp>--nogs*</samp>’</dt> @@ -818,7 +807,7 @@ file was ‘<samp><var>file</var>.dvi</samp>’. pair of dimensions such as ‘<samp>.1in,-.3cm</samp>’. 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. +the paper) by this amount. </p> </dd> <dt>‘<samp>-p [=]<var>num</var></samp>’</dt> @@ -896,7 +885,7 @@ output; report no warnings (only errors) to standard error. <dd><a name="index-antialiasing-levels_002c-number-of"></a> <a name="index-quality"></a> <p>Set the quality to <var>num</var>. That is, choose the number of antialiasing -levels for bitmapped fonts (PK) and fonts rendered using T1lib, to be +levels for bitmapped fonts (PK), 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. @@ -929,21 +918,6 @@ the left in the produced image. The value ‘<samp>tight</samp>’ will only include all ink put on the page, producing neat images. </p> </dd> -<dt>‘<samp>--t1lib*</samp>’</dt> -<dd><a name="index-T1lib-font-rendering"></a> -<p>Enable 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>gsftopk</samp>’ for rendering the fonts. If -you have PostScript versions 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. Note that if 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>--freetype0</samp>’ (see above). -</p> -</dd> <dt>‘<samp>--truecolor*</samp>’</dt> <dd><a name="index-truecolor-output"></a> <p>This will make ‘<samp>dvipng</samp>’ generate truecolor output. Note that @@ -951,7 +925,7 @@ truecolor output is automatic if you include an external image in your DVI, e.g., via a PostScript special (i.e., the ‘<samp>graphics</samp>’ or ‘<samp>graphicx</samp>’ package). This switch is overridden by the ‘<samp>--palette</samp>’ switch. -</p> +</p> </dd> <dt>‘<samp>-v*</samp>’</dt> <dd><p>Enable verbose operation. This will currently indicate what fonts is @@ -1176,9 +1150,9 @@ by-value spec starts with the name of a color model (one of ‘<samp>rgb</sa ‘<samp>hsb</samp>’, ‘<samp>cmy</samp>’, ‘<samp>cmyk</samp>’, or ‘<samp>gray</samp>’) followed by the appropriate number of parameters. Thus, the color specification ‘<samp>rgb 0.3 0.4 0.5</samp>’ would correspond to the color that is ‘<samp>0.3 -0.4 0.5</samp>’ in its red, blue and green values. The color model used -internally in dvipng is ‘<samp>RGB</samp>’ (discretized to 256 levels), for -details on the formulas used in conversion, see the ‘<samp>xcolor</samp>’ +0.4 0.5</samp>’ in its red, blue and green values. The color model used +internally in dvipng is ‘<samp>RGB</samp>’ (discretized to 256 levels), for +details on the formulas used in conversion, see the ‘<samp>xcolor</samp>’ documentation. </p> <p>By-name color specifications are single (case-dependent) words and are @@ -1261,7 +1235,7 @@ Next: <a href="#Debug-options" accesskey="n" rel="next">Debug options</a>, Up: < <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>. +<a href="mailto:dvipng@nongnu.org">dvipng@nongnu.org</a>. </p> <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 @@ -1290,7 +1264,7 @@ 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>. +track all classes, you can use <code>-1</code>. </p> <p>Some of these debugging options are actually provided by Kpathsea (see <a href="kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). @@ -1325,18 +1299,15 @@ track all classes, you can use <code>-1</code>. <dd><p>GhostScript specials </p></dd> <dt>512</dt> -<dd><p>T1lib calls -</p></dd> -<dt>1024</dt> <dd><p>Kpathsea <code>stat</code> calls </p></dd> -<dt>2048</dt> +<dt>1024</dt> <dd><p>Kpathsea hash table lookups </p></dd> -<dt>4096</dt> +<dt>2048</dt> <dd><p>Kpathsea path element expansion </p></dd> -<dt>8192</dt> +<dt>4096</dt> <dd><p>Kpathsea path searches </p> </dd> @@ -1369,65 +1340,6 @@ William H Wheeler, Thomas Klausner, Harald Koenig, Adrian Bunk, Kevin Smith, Jason Riedy, Wolfram Krause, Reinhard Kotucha, Takeshi Abe, and Waldeck Schutzer. </p> -<p>Use of the <code>gd</code> library requires inclusion of the following -copyright notice, which applies to the <code>gd</code> library: -</p> -<blockquote> - -<p>Portions copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, - 2002 by Cold Spring Harbor Laboratory. Funded under Grant - P41-RR02188 by the National Institutes of Health. -</p> -<p>Portions copyright 1996, 1997, 1998, 1999, 2000, 2001, 2002 by - Boutell.Com, Inc. -</p> -<p>Portions relating to GD2 format copyright 1999, 2000, 2001, 2002 - Philip Warner. -</p> -<p>Portions relating to PNG copyright 1999, 2000, 2001, 2002 Greg - Roelofs. -</p> -<p>Portions relating to gdttf.c copyright 1999, 2000, 2001, 2002 John - Ellson (ellson@lucent.com). -</p> -<p>Portions relating to gdft.c copyright 2001, 2002 John Ellson - (ellson@lucent.com). -</p> -<p>Portions copyright 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007 - Pierre-Alain Joye (pierre@libgd.org). -</p> -<p>Portions relating to JPEG and to color quantization copyright 2000, - 2001, 2002, Doug Becker and copyright (C) 1994, 1995, 1996, 1997, - 1998, 1999, 2000, 2001, 2002, Thomas G. Lane. This software is - based in part on the work of the Independent JPEG Group. See the - file README-JPEG.TXT for more information. -</p> -<p>Portions relating to WBMP copyright 2000, 2001, 2002 Maurice - Szmurlo and Johan Van den Brande. -</p> -<p>Permission has been granted to copy, distribute and modify gd in - any context without fee, including a commercial application, - provided that this notice is present in user-accessible supporting - documentation. -</p> -<p>This does not affect your ownership of the derived work itself, and - the intent is to assure proper credit for the authors of gd, not to - interfere with your productive use of gd. If you have questions, - ask. "Derived works" includes all programs that utilize the - library. Credit must be given in user-accessible documentation. -</p> -<p>This software is provided "AS IS." The copyright holders disclaim - all warranties, either express or implied, including but not - limited to implied warranties of merchantability and fitness for a - particular purpose, with respect to this code and accompanying - documentation. -</p> -<p>Although their code does not appear in gd, the authors wish to thank - David Koblas, David Rowley, and Hutchison Avenue Software Corporation - for their prior contributions. -</p> -</blockquote> - <hr> <a name="Copying"></a> @@ -1454,7 +1366,7 @@ License along with this program. If not, see </p> <br> <br> -<p>Copyright © 2002-2010 Jan-Åke Larsson +<p>Copyright © 2002-2015 Jan-Åke Larsson </p> <hr> <a name="Index"></a> @@ -1608,7 +1520,6 @@ Previous: <a href="#Copying" accesskey="p" rel="prev">Copying</a>, Up: <a href=" <tr><td></td><td valign="top"><a href="#index-standard-output_002c-output-to">standard output, output to</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td colspan="4"> <hr></td></tr> <tr><th><a name="Index_cp_letter-T">T</a></th><td></td><td></td></tr> -<tr><td></td><td valign="top"><a href="#index-T1lib-font-rendering">T1lib font rendering</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-transparent-border-fallback-color">transparent border fallback color</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-transparent-border-width">transparent border width</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr> <tr><td></td><td valign="top"><a href="#index-trouble">trouble</a>:</td><td> </td><td valign="top"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr> |