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-2009 Jan-AAke Larsson

Todo
====

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

   * Add more color models for xcolor compatibility

   * Fix T1lib and PK rendering so it is on par with Freetype.

   * 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	2008-02-08 02:51:56
COPYING.LESSER	7639	2008-02-08 01:45:14
ChangeLog	27380	2010-10-23 02:02:45
ChangeLog.0	19540	2005-01-17 03:08:38
INSTALL	6446	2009-02-23 02:48:50
Makefile.in	4721	2010-12-06 08:53:01
README	4170	2009-02-23 02:48:50
RELEASE	569	2010-12-14 10:33:28
aclocal.m4	7610	2008-05-07 02:55:41
color.c	13405	2010-09-22 03:13:34
commands.h	8604	2008-02-08 02:45:25
config.h.in	5910	2009-03-28 04:17:31
configure	198985	2010-12-14 10:35:32
configure.ac	8653	2010-10-22 08:15:24
draw.c	13471	2010-03-17 02:02:35
dvi.c	13650	2010-03-17 10:43:09
dvipng.1	22753	2010-10-23 02:01:04
dvipng.c	4262	2008-02-08 02:45:25
dvipng.h	18434	2010-10-14 09:27:42
dvipng.texi	39279	2010-12-06 09:07:18
enc.c	3419	2010-09-22 03:13:34
font.c	10825	2010-03-17 10:41:29
fontmap.c	10319	2010-09-22 03:13:34
ft.c	5919	2010-02-11 03:09:10
install-sh	5598	2003-10-19 10:33:26
install.texi	7107	2009-02-23 02:48:50
macros.texi	1485	2008-02-08 02:45:24
miktex.h	7787	2008-02-08 02:45:24
miktex.mak	6760	2006-11-07 09:40:36
misc.c	25828	2010-09-30 12:13:40
mkinstalldirs	1861	2003-10-19 10:33:26
papersiz.c	2162	2010-09-29 11:14:40
pk.c	11614	2010-02-11 03:09:10
ppagelist.c	5644	2010-03-17 10:40:00
readme.texi	4589	2009-02-23 02:48:50
set.c	9503	2010-03-17 02:02:35
sfd.c	5420	2010-09-22 03:13:33
special.c	28257	2010-12-06 11:14:22
t1.c	6410	2010-02-11 03:09:10
test_dvipng.tex	1341	2010-03-17 10:37:29
tfm.c	2392	2009-03-26 11:14:01
vf.c	4453	2010-03-17 02:02:35