diff options
Diffstat (limited to 'Build/source/texk/dvipng/dvipng.info.orig')
-rw-r--r-- | Build/source/texk/dvipng/dvipng.info.orig | 1084 |
1 files changed, 0 insertions, 1084 deletions
diff --git a/Build/source/texk/dvipng/dvipng.info.orig b/Build/source/texk/dvipng/dvipng.info.orig deleted file mode 100644 index 0b9be7c8220..00000000000 --- a/Build/source/texk/dvipng/dvipng.info.orig +++ /dev/null @@ -1,1084 +0,0 @@ -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 -* DVI-to-PNG: (dvipng). Translating TeX DVI files to Portable Network Graphics (PNG). -* dvipng: (dvipng). A DVI-to-PNG translator. -END-INFO-DIR-ENTRY - - -File: dvipng.info, Node: Top, Next: Introduction, Up: (dir) - -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.11 - - Corrections or perhaps rewrites of sections are _very welcome_. - - Jan-AAke Larsson - -* Menu: - -* Introduction:: Introduction -* Installation:: How to compile and install dvipng -* Basic usage:: First things first -* Command-line options:: Advanced usage -* Graphics:: Including PostScript and/or bitmaps -* Color:: Using color with dvipng -* Diagnosing problems:: Problems? -* Credits:: People who have contributed -* Copying:: GNU Lesser General Public License -* Index:: General index - - -File: dvipng.info, Node: Introduction, Next: Installation, Prev: Top, Up: Top - -1 Introduction -************** - -This program makes PNG and/or GIF graphics from DVI files as obtained -from TeX and its relatives. - - If GIF support is enabled, GIF output is chosen by using the -`dvigif' binary or with the `--gif' option. - - It is intended to produce anti-aliased screen-resolution images as -fast 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 `http://www.gnu.org/software/auctex/preview-latex.html'. - - Another example is WeBWorK, an internet-based method for delivering -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. - - The benefits of `dvipng'/`dvigif' include - - * 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. - - * It does not read the postamble, so it can be started before TeX - finishes. There is a `--follow' 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. - - * 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. - - * 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. - - * and more... - - - -File: dvipng.info, Node: Installation, Next: Basic usage, Prev: Introduction, Up: Top - -2 Installation -************** - -Installing dvipng should be simple: merely `./configure', `make', and -`make install'. - -* Menu: - -* Prerequisites:: -* Configure:: -* Build/install:: -* Installation outside the texmf tree:: -* Advice for non-privileged users:: - - -File: dvipng.info, Node: Prerequisites, Next: Configure, Up: Installation - -2.1 Prerequisites -================= - - * The GD Graphics Draw library, libgd - - The drawing library `libgd' is necessary, and is downloadable at - `http://www.boutell.com/gd', and there are binary packages for - most operating systems from their respective distributors. In any - case, the latest version of the library installs using `autoconf' - so it should not be difficult for you to install it from source, - and then proceed with installing dvipng. - - * The path-searching library kpathsea - - Kpathsea is most likely included in your LaTeX installation, but it - may happen that ./configure does not find it; see below. If you do - not have it, download it from `http://www.ctan.org' and compile it. - I have no experience with this, so I cannot help much here. - - * The font-rendering library FreeType 2 - - 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. - 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. - - * libpng and libz - - To be able to compress and write PNG files to disk, dvipng (or - really libgd) uses libpng which in turn uses libz. These should be - available on any modern system, if not, download them and install - them. - - * The `texinfo' package - - This is needed for building the documentation. - - -File: dvipng.info, Node: Configure, Next: Build/install, Prev: Prerequisites, Up: Installation - -2.2 Configure -============= - -The first step is to configure the source code, telling it where -various files will be. To do so, run - - ./configure OPTIONS - - (Note: if you have fetched dvipng from CVS rather than a regular -release, you will have to first generate `./configure' by running -`autoconf' 2.53 or later.) - - On many machines, you will not need to specify any options, but if -`configure' cannot determine something on its own, you'll need to help -it out. For a list of the options type - - ./configure --help - - On some machines, the libraries will be installed in directories that -are not in the linker's search path. This will generate an error when -running `./configure', indicating that it cannot find libgd or -libkpathsea (most likely). You then need to specify the path to the -respective library's object files. They are typically called e.g., -`libgd.a' or `libgd.so'. If they are located in e.g., `/sw/local/lib', -do - - ./configure LDFLAGS=-L/sw/local/lib - - If the library is available as a shared object file (`.so'), the -runtime linker may also need to be told where to find the library, then -use - - ./configure LDFLAGS='-L/sw/local/lib -R/sw/local/lib' - - When either of these is necessary, it is likely that the C header -files are also installed in directories that are not in the C -preprocessor's search path. This will also generate an error when -running `./configure', indicating that it cannot find e.g., `gd.h' or -`kpathsea.h' (most likely). You then need to specify the path to the -respective library's C header files. If they are located in e.g., -`/sw/local/include', do - - ./configure CPPFLAGS=-I/sw/local/include - - On my SUN Solaris workstation, I had to combine this into - - ./configure CPPFLAGS='-I/sw/local/include -I/sw/tex/teTeX/1.0/include'\ - LDFLAGS='-L/sw/local/lib -R/sw/local/lib -L/sw/tex/teTeX/1.0/lib/' - -where the backslash denotes a continuation of the line. - - -File: dvipng.info, Node: Build/install, Next: Installation outside the texmf tree, Prev: Configure, Up: Installation - -2.3 Build/install -================= - -Once `configure' has been run, simply enter - - make - -at the prompt to compile the C code, and build the documentation files. -To install the files into the locations chosen earlier, type - - make install - -You may need special privileges to install, e.g., if you are installing -into system directories. - - -File: dvipng.info, Node: Installation outside the texmf tree, Next: Advice for non-privileged users, Prev: Build/install, Up: Installation - -2.4 Installation outside the texmf tree -======================================= - -In some cases, a dvipng binary installed outside the texmf tree will -not be able to find virtual fonts, or the PostScript font maps -(normally used by dvips). This may be because _only_ $SELFAUTOLOC, -$SELFAUTODIR, and $SELFAUTOPARENT are used in the texmf tree -configuration file `texmf.cnf'. If so, give the switch -`--enable-selfauto-set' to `./configure'. This will make dvipng adjust -these three internally so that kpathsea thinks that dvipng _is_ -installed in the texmf tree. - - -File: dvipng.info, Node: Advice for non-privileged users, Prev: Installation outside the texmf tree, Up: Installation - -2.5 Installation for non-privileged users -========================================= - -Often people without system administration privileges want to install -software for their private use. In that case you need to specify more -options to the `configure' script, usually this is done by using the -`--prefix' option to the `configure' script, and let it point to the -personal home directory. In that way, resulting binaries will be -installed under the `bin' subdirectory of your home directory, manual -pages under `man' and so on. That way, it is reasonably easy to -maintain a bunch of additional packages, since the prefix argument is -supported by most `configure' scripts. - - You'll have to add something like `/home/myself/bin' to your `PATH' -shell variable, if it isn't there already, and similarly set the -`INFOPATH' and `MANPATH' variables to be able to access the -documentation. - - -File: dvipng.info, Node: Basic usage, Next: Command-line options, Prev: Installation, Up: Top - -3 Basic usage of dvipng -*********************** - -To use dvipng at its simplest, simply type - - dvipng foo - -where `foo.dvi' is the output of TeX that you want to convert to PNG -format. If there are four pages in `foo.dvi', those pages will be -output as `foo1.png', `foo2.png', `foo3.png', and `foo4.png', -respectively. - - If you have enabled the PostScript font support (via FreeType or -T1lib), fonts will be rendered as they are needed. Otherwise, if you -use fonts that have not been used on 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. *Note Unable to generate fonts: -(kpathsea)Unable to generate fonts.) - - Many options are available (see the next section). For a brief -summary of available options, just type - - dvipng --help - - -File: dvipng.info, Node: Command-line options, Next: Graphics, Prev: Basic usage, Up: Top - -4 Command-line options -********************** - -dvipng has a plethora of command line options. Reading through this -section will give a good idea of the capabilities of the driver. - -* Menu: - -* Option summary:: Quick listing, from dvipng --help. -* Option details:: More information about each option. - - -File: dvipng.info, Node: Option summary, Next: Option details, Up: Command-line options - -4.1 Option summary -================== - -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.10 Copyright 2002-2008 Jan-Ake Larsson - - 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 - -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 - -T c Image size (also accepts '-T bbox' and '-T tight') - -v* Verbose operation - - 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) - -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* 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 - - # = number f = file s = string * = suffix, '0' to turn off - c = comma-separated dimension pair (e.g., 3.2in,-32.1cm) - - -File: dvipng.info, Node: Option details, Prev: Option summary, Up: Command-line options - -4.2 Option details -================== - -Many of the parameterless options listed here can be turned off by -suffixing the option with a zero (`0'); for instance, to turn off page -reversal, use `-r0'. Such options are marked with a trailing `*'. - -`-' - Read additional options from standard input after processing the - command line. - -`--help' - Print a usage message and exit. - -`--version' - Print the version number and exit. - -`-bd NUM' - -`-bd COLOR_SPEC' - -`-bd 'NUM COLOR_SPEC'' - 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 COLOR_SPEC will - set the fallback color, to be used in viewers that cannot handle - transparency (the default is the background color). The color spec - should be in TeX color \special syntax, e.g., 'rgb 1.0 0.0 0.0'. - Setting the fallback color makes the default border width 1 px. - *Note Color::. - -`--bdpi NUM' - Set the base (Metafont) resolution, both horizontal and vertical, - to NUM dpi (dots per inch). This option is necessary when manually - selecting Metafont mode with the -mode option (see below). - -`-bg COLOR_SPEC' - 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., 'rgb 1.0 - 0.0 0.0'. You can also specify 'Transparent' or 'transparent' - which will give you a transparent background with the normal - background as a fallback color. A capitalized 'Transparent' will - give a full-alpha transparency, while an all-lowercase - 'transparent' will give a simple fully transparent background with - non-transparent antialiased pixels. The latter would be suitable - for viewers who cannot cope with a true alpha channel. GIF images - do not support full alpha transparency, so in case of GIF output, - both variants will use the latter behaviour. *Note Color::. - -`-d NUM' - Set the debug flags, showing what dvipng (thinks it) is doing. - This will work unless dvipng has been compiled without the `DEBUG' - option (not recommended). Set the flags as you need them, use `-d - -1' as the first option for maximum output. *Note Debug options::. - -`-D NUM' - Set the output resolution, both horizontal and vertical, to NUM - dpi (dots per inch). - - 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 FONT_PX pixels (in - Mozilla) the correct formula is - DPI = FONT_PX * 72.27 / 10 [px * TeXpt/in / TeXpt] - The last division by ten is due to the standard font height 10pt in - your document, if you use 12pt, divide by 12. Unfortunately, some - 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 - FONT_PX = FONT_PT * 96 / 72 [pt * px/in / (pt/in)] - On some high-res screens, the value is instead 120 dpi. Good luck! - -`--depth*' - Report the depth of the image. This only works reliably when the - 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). - -`--dvinum*' - Set this option to make the output page number be the TeX page - numbers rather than the physical page number. See the `-o' switch. - -`-fg COLOR_SPEC' - 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., 'rgb 1.0 - 0.0 0.0'. *Note Color::. - -`--follow*' - 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 `tail -f' but for DVI-to-PNG - conversion. - -`--freetype*' - 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 - `gsftopk' 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. If - you for some reason would want to use T1lib rendering, use this - option. - -`--gamma NUM' - Control the interpolation of colors in the greyscale anti-aliasing - color palette. Default value is 1.0. For 0 < NUM < 1, the fonts - will be lighter (more like the background), and for NUM > 1, the - fonts will be darker (more like the foreground). - -`--gif*' - The images are output in the GIF format, if GIF support is enabled. - This is the default for the `dvigif' binary, which only will be - available when GIF support is enabled. GIF images are palette - images (see the `--palette' option) and does not support true alpha - channels (see the `--bg' option). See also the `--png' option. - -`--height*' - Report the height of the image. This only works reliably when the - 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 - is the last page in the document. If NUM is prefixed by an equals - sign, then it (and the argument to the `-p' option, if specified) - is treated as a physical (absolute) page number, rather than a - value to compare with the TeX `\count0' values stored in the DVI - file. Thus, using `-l =9' will end with the ninth page of the - document, no matter what the pages are actually numbered. - -`--mode MODE' - Use MODE 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 `--bdpi' option. - See the file `ftp://ftp.tug.org/tex/modes.mf' for a list of - resolutions and mode names for most devices. *Note Unable to - generate fonts: (kpathsea)Unable to generate fonts. - -`-M*' - Turns off automatic PK font generation (`mktexpk'). This will have - no effect when using PostScript fonts, since no PK font generation - will be done anyway. - -`--noghostscript*' - This switch prohibits the internal call to GhostScript for - displaying PostScript specials. `--noghostscript0' turns the call - back on. - -`--nogssafer*' - Normally, if GhostScript is used to render PostScript specials, the - GhostScript interpreter is run with the option `-dSAFER'. The - `--nogssafer' option runs GhostScript without `-dSAFER'. The - `-dSAFER' option in Ghostscript disables PostScript operators such - as deletefile, to prevent possibly malicious PostScript programs - from having any effect. - -`-o NAME' - Send output to the file NAME. A single occurrence of `%d' or - `%01d', ..., `%09d' will be exchanged for the physical page number - (this can be changed, see the `--dvinum' switch). The default - output filename is `FILE%d.png' where the input DVI file was - `FILE.dvi'. - -`-O X-OFFSET,Y-OFFSET' - Move the origin by X-OFFSET,Y-OFFSET, a comma-separated pair of - dimensions such as `.1in,-.3cm'. 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 [=]NUM' - The first page printed will be the first one numbered NUM. Default - is the first page in the document. If NUM is prefixed by an - equals sign, then it (and the argument to the `-l' option, if - specified) is treated as a physical (absolute) page number, rather - than a value to compare with the TeX `\count0' values stored in the - DVI file. Thus, using `-p =3' will start with the third page of - the document, no matter what the pages are actually numbered. - -`--palette*' - Starting from `dvipng' 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 `dvipng' revert to - the old behaviour, where included images were opaque and always - clipped to the boundingbox. This will also override the - `--truecolor' switch if present. - -`--picky*' - 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 useful for failed figure inclusion and unknown \special - occurrences, but warnings will also occur for missing or unknown - color specs and missing PK fonts. - -`--png*' - The images are output in the PNG format. This is the default for - the `dvipng' binary. See also the `--gif' option. - -`-pp FIRSTPAGE-LASTPAGE' - Print pages FIRSTPAGE through LASTPAGE; but not quite equivalent - to `-p FIRSTPAGE -l LASTPAGE'. For example, when rendering a book, - there may be several instances of a page in the DVI file (one in - `\frontmatter', one in `\mainmatter', and one in `\backmatter'). - In case of several pages matching, `-pp FIRSTPAGE-LASTPAGE' will - render _all_ pages that matches the specified range, while `-p - FIRSTPAGE -l LASTPAGE' will render the pages from the _first_ - occurrence of FIRSTPAGE to the _first_ occurrence of LASTPAGE. - This is the (undocumented) behaviour of dvips. In dvipng you can - give both kinds of options, in which case you get all pages that - matches the range in `-pp' between the pages from `-p' to `-l'. - Also multiple `-pp' options accumulate, unlike `-p' and `-l'. The - `-' separator can also be `:'. Note that `-pp -1' 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 `-pp -1--1', - or more readable, `-pp -1:-1'. - -`-q*' - Run quietly. Don't chatter about pages converted, etc. to standard - output; report no warnings (only errors) to standard error. - -`-Q NUM' - Set the quality to NUM. That is, choose the number of antialiasing - levels for PK and T1lib rendering to be NUM*NUM+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. - -`-r*' - Toggle output of pages in reverse/forward order. By default, the - first page in the DVI is output first. - -`--strict*' - 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 - `--picky' option above for a list of when warnings occur. - -`-T IMAGE_SIZE' - Set the image size to IMAGE_SIZE which can be either of `bbox', - `tight', or a comma-separated pair of dimensions HSIZE,VSIZE such - as `.1in,.3cm'. The default is `bbox' which produces a PNG that - includes all ink put on the page and in addition the DVI origin, - located 1in from the top and 1in from the left edge of the paper. - This usually gives whitespace above and to the left in the - produced image. The value `tight' will make dvipng only include - all ink put on the page, producing neat images. - -`--t1lib*' - 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 `gsftopk' 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 - `--freetype0' (see above). - -`--truecolor*' - This will make `dvipng' 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 `graphics' or - `graphicx' package). This switch is overridden by the `--palette' - switch. - -`-v*' - Enable verbose operation. This will currently indicate what fonts - is used, in addition to the usual output. - -`-x NUM' - Set the x magnification ratio to NUM/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. NUM may be a real - number, not an integer, for increased precision. - -`-z NUM' - Set the PNG compression level to NUM. This option is enabled if - your `libgd' is new enough. The default compression level is 1, - which selects maximum speed at the price of slightly larger PNGs. - For an older `libgd', the hard-soldered value 5 is used. The - include file `png.h' says - - Currently, valid values range from 0 - 9, corresponding - directly to the zlib compression levels 0 - 9 (0 - no - compression, 9 - "maximal" compression). Note that tests have - shown that zlib compression levels 3-6 usually perform as - well as level 9 for PNG images, and do considerably fewer - calculations. In the future, these values may not correspond - directly to the zlib compression levels. - - -File: dvipng.info, Node: Graphics, Next: Color, Prev: Command-line options, Up: Top - -5 Graphics -********** - -`dvipng' attempts to handle graphics as included by the `graphicx' and -`graphics' packages, without the need of specifying a driver to these -packages. This means that it recognizes the encapsulated postscript -inclusion meant for `dvips', but is also able (from version 1.8) to -include bitmapped graphics, see the details below. - -* Menu: - -* Encapsulated PostScript:: An internal call to GhostScript -* Bitmapped graphics:: PNG, JPEG and GIF - - -File: dvipng.info, Node: Encapsulated PostScript, Next: Bitmapped graphics, Up: Graphics - -5.1 Encapsulated PostScript -=========================== - -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. - - This conversion needs the `pngalpha' output device to be present in -your copy of GhostScript. If that device is not present, or you use the -`--palette' switch or request GIF output, the fallback is to use the -`png16m' device to produce a cropped opaque image for inclusion. Other -relevant switches are `--noghostscript' and `--nogssafer'. *Note Option -details::. - - 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 `\includegraphics' call, as in this example -(using `graphicx'): - - \includegraphics[bb=10 20 100 200]{imagename.eps} - - -File: dvipng.info, Node: Bitmapped graphics, Prev: Encapsulated PostScript, Up: Graphics - -5.2 Bitmapped graphics -====================== - -dvipng can include PNG, JPEG and GIF graphics. When including such -images via `\includegraphics' 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 `0 0 w h' in pixels, e.g., if the -file `imagename.png' is 300x400 pixels, the inclusion would read - - \includegraphics[bb=0 0 300 400]{imagename.png} - - The default size is the image size in bp ("big points" 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). - - 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: - - \includegraphics[bb=0 0 300 400,witdh=1.5in]{imagename.png} - - -File: dvipng.info, Node: Color, Next: Diagnosing problems, Prev: Graphics, Up: Top - -6 Color -******* - -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: - -* Color specifications:: -* Color specials:: - - -File: dvipng.info, Node: Color specifications, Next: Color specials, Up: Color - -6.1 Color specifications -======================== - -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 `rgb', -`hsb', `cmy', `cmyk', or `gray') followed by the appropriate number of -parameters. Thus, the color specification `rgb 0.3 0.4 0.5' would -correspond to the color that is `0.3 0.4 0.5' in its red, blue and -green values. The color model used internally in dvipng is `RGB' -(discretized to 256 levels), for details on the formulas used in -conversion, see the `xcolor' documentation. - - By-name color specifications are single (case-dependent) words and -are compared with color names defined in `dvipsnam.def' (from the -`graphics' bundle), `svgnam.def' and `xcolor.sty' (from the `xcolor' -bundle). See the `xcolor' documentation for a list of names and the -corresponding colors. - - On the command-line, the name `Transparent' can also be used as an -argument to `--bg' to choose transparent background. *Note Option -details::. - - -File: dvipng.info, Node: Color specials, Prev: Color specifications, Up: Color - -6.2 Color specials -================== - -We will describe `background' first, since it is the simplest. The -`background' keyword must be followed by a color specification. That -color specification is used as a fill color for the background. The -last `background' special on a page is the one that gets used, and is -used for the whole of the page image. (This is possible because the -prescan phase of dvipng notices all of the color specials so that the -appropriate information can be written out during the second phase.) - - The `color' special itself has three forms. The first is just -`color' followed by a color specification. In this case, the current -global color is set to that color; the color stack must be empty when -such a command is executed. - - The second form is `color push' followed by a color specification. -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. - - The final form of the `color' special is just `color pop', 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. - - dvipng correctly handles these color specials across pages, even when -the pages are rendered repeatedly or in reverse order. - - -File: dvipng.info, Node: Diagnosing problems, Next: Credits, Prev: Color, Up: Top - -7 Diagnosing problems -********************* - -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. - -* Menu: - -* Contact information:: Who to ask. -* Debug options:: Getting diagnostics. - - -File: dvipng.info, Node: Contact information, Next: Debug options, Up: Diagnosing problems - -7.1 Contact information -======================= - -Bug reports should be sent to <dvipng@nongnu.org>. - - Questions, suggestions for new features, pleas for help, and/or -praise should go to <dvipng@nongnu.org>. For more information on this -mailing list, send a message with just the word `help' as subject or -body to <dvipng-request@nongnu.org> or look at -`http://lists.nongnu.org/mailman/listinfo/dvipng'. - - Offers to support further development will be appreciated. For -developer access, ask on <dvipng@nongnu.org>. - - For details on the TeX path-searching library, and `mktexpk' -problems, *note Common problems: (kpathsea)Common problems. - - -File: dvipng.info, Node: Debug options, Prev: Contact information, Up: Diagnosing problems - -7.2 Debug options -================= - -The `-d' 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 `-1'. - - Some of these debugging options are actually provided by Kpathsea -(*note Debugging: (kpathsea)Debugging.). - - The classes are: -1 - Normal dvi op-codes - -2 - Virtual fonts - -4 - PK fonts - -8 - TFM files - -16 - Glyph rendering - -32 - FreeType calls - -64 - Encoding loads - -128 - Color specials - -256 - GhostScript specials - -512 - T1lib calls - -1024 - Kpathsea `stat' calls - -2048 - Kpathsea hash table lookups - -4096 - Kpathsea path element expansion - -8192 - Kpathsea path searches - - - -File: dvipng.info, Node: Credits, Next: Copying, Prev: Diagnosing problems, Up: Top - -8 Credits -********* - -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), 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 Ridderstro"m, Ezra Peisach, -William H Wheeler, Thomas Klausner, Harald Koenig, Adrian Bunk, Kevin -Smith, Jason Riedy, Wolfram Krause, Reinhard Kotucha, and Takeshi Abe. - - -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 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 Lesser -General Public License for more details. - - 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-2008 Jan-AAke Larsson - - -File: dvipng.info, Node: Index, Prev: Copying, Up: Top - -Index -***** - - -* Menu: - -* -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) -* color specifications: Color specifications. - (line 6) -* command-line options: Command-line options. - (line 6) -* compilation: Installation. (line 6) -* 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 253) -* first page printed: Option details. (line 188) -* follow mode: Option details. (line 97) -* 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 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 140) -* light fonts: Option details. (line 119) -* 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 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 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 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 284) -* warnings, suppressing: Option details. (line 238) - - - -Tag Table: -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 |