CTAN
Comprehensive TeX Archive Network

Direc­tory tex-archive/dviware/dvipng

dvipng
******

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.

Benefits of dvipng
==================

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...

Installation
============

Read 'INSTALL', included in the distribution.

Usage
=====

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.

   Many options are available (see the info manual).  For a brief
summary of available options, just type

     dvipng --help

Availability
============

The dvipng package is available at Savannah, the GNU project site.
Since dvipng is not part of the GNU project, although released under the
GNU GPL, the web address is
<http://savannah.nongnu.org/projects/dvipng>.  Instructions for
anonymous CVS access can be found at
<http://savannah.nongnu.org/cvs/?group=dvipng>.

Contacts
========

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>.

Copying
=======

This program is released under the GNU Lesser General Public License
version 3, see the COPYING file in the dvipng distribution or
<http://www.gnu.org/licenses/>.

   Copyright (C) 2002-2014 Jan-AAke Larsson

Todo
====

   * Use gs interpreter library for speed and possibly for
     functionality.

   * Add more color models for xcolor compatibility

   * Enable a named pipe as DVI

   * Further speed improvements.

   * Other output specials and source specials.

   * Clean internal structures.  Overhaul file handling.

   * Fix the SELFAUTO stuff at runtime rather than at build time

Files

Name Size Date Notes
COPYING 35147 2015-03-02 20:33
COPYING.LESSER 7639 2015-03-02 20:33
COPYING.gd 2197 2015-03-02 20:33
ChangeLog 28431 2015-03-02 20:33
ChangeLog.0 19540 2015-03-02 20:33
INSTALL 6009 2015-03-02 20:33
Make­file.in 4776 2015-03-02 20:33
README 4114 2015-03-02 20:33
RELEASE 529 2015-03-02 20:33
aclo­cal.m4 7610 2015-03-02 20:33
color.c 13422 2015-03-02 20:33
com­mands.h 8604 2015-03-02 20:33
con­fig.h 6075 2015-03-02 20:33
con­fig.h.in 5705 2015-03-02 20:33
con­fig­ure 195930 2015-03-02 20:33
con­fig­ure.ac 8447 2015-03-02 20:33
draw.c 13426 2015-03-02 20:33
dvi.c 13850 2015-03-02 20:33
dvipng.1 21943 2015-03-02 20:33
dvipng.c 4019 2015-03-02 20:33
dvipng.h 17392 2015-03-02 20:33
dvipng.texi 38225 2015-03-02 20:33
enc.c 3419 2015-03-02 20:33
font.c 10600 2015-03-02 20:33
fontmap.c 9773 2015-03-02 20:33
ft.c 6094 2015-03-02 20:33
in­stall-sh 5598 2015-03-02 20:33
in­stall.texi 6624 2015-03-02 20:33
macros.texi 1485 2015-03-02 20:33
mik­tex.h 7634 2015-03-02 20:33
mik­tex.mak 6760 2015-03-02 20:33
misc.c 25165 2015-03-02 20:33
mkin­stalldirs 1809 2015-03-02 20:33
pa­per­siz.c 2162 2015-03-02 20:33
pk.c 11648 2015-03-02 20:33
ppage­list.c 5644 2015-03-02 20:33
readme.texi 4513 2015-03-02 20:33
set.c 9613 2015-03-02 20:33
sfd.c 5545 2015-03-02 20:33
spe­cial.c 28666 2015-03-02 20:33
test_dvipng.tex 1341 2015-03-02 20:33
tfm.c 2592 2015-03-02 20:33
vf.c 4504 2015-03-02 20:33

Down­load the con­tents of this pack­age in one zip archive (187.5k).

dvipng – A fast DVI to PNG/GIF con­verter

This pro­gram makes PNG and/or GIF graph­ics from DVI files as ob­tained from TeX and its rel­a­tives. Its ben­e­fits in­clude:

  • Speed. It of­fers very fast ren­der­ing of DVI as bitmap files, which makes it suit­able for gen­er­at­ing large amounts of im­ages on-the-fly, as needed in pre­view-la­tex, WeBWorK and oth­ers;
  • It does not read the postam­ble, so it can be started be­fore TeX fin­ishes. There is a --fol­low switch that makes dvipng wait at end-of-file for fur­ther out­put, un­less it finds the POST marker that in­di­cates the end of the DVI;
  • In­ter­ac­tive query of op­tions. dvipng can read op­tions in­ter­ac­tively through stdin, and all op­tions are us­able. It is even pos­si­ble to change the in­put file through this in­ter­face.
  • Sup­port for PK, VF, PostScript Type1, and TrueType fonts, colour spe­cials, and in­clu­sion of PostScript, PNG, JPEG or GIF im­ages.

Pack­age De­tailsdvipng
Home pagehttp://sa­van­nah.nongnu.org/projects/dvipng/
Ver­sion1.15
Li­censeGNU Li­brary Gen­eral Public Li­cense
Main­tainerJan-Åke Lars­son
Con­tained inTeX Live as dvipng
MiKTeX as mik­tex-dvipng-bin-2.9
Topics gen­er­ate graphic bitmaps from DVI files
See also dvi2bitmap
Guest Book Sitemap Contact Contact Author