NAME
pdftopng - a PDF to PNG converter
SYNOPSIS
pdftopng [OPTIONS] file.pdf
DESCRIPTION
PDFtoPNG converts a PDF file (or multiple PDF files) into individual PNG files, one file per page. It can also convert PDF files into *.cbz and *.tar.bz2 archives as used by comic book readers, and write valid XHTML 1.0 strict pages.
The sizes of the resulting files will often be quite a bit larger than the original PDFs, but will be faster to view (especially for graphically intensive documents such as eComics).
OPTIONS
- -h, --help
Display the help screen
- -z, --zip
Create a *.cbz archive instead of writing the PNG files to the current directory. This is useful when you want to view the converted PDF in a comic book reader. Creates one archive for each pdf file.
- -t, --tbz
Create a *.tar.bz2 archive instead of writing the PNG files to the current directory. This is useful when you want to view the converted PDF in a comic book reader. This usually achieves better compression than --zip but is not as well supported by all comic book readers as --zip. Creates one archive for each pdf file.
- -c, --bestcomp
Compress files created with --tbz and --zip as much as possible. This is slower than normal operation but might save more diskspace. In many cases however, the gain from using --bestcomp is not really noticeable.
- -x, --xhtml
Creates one additional page per page named documentname_PAGENUMBER.html. This is a valid XHTML 1.0 Strict HTML document that can be used to view the images in a webbrowser. By default the document is set to fit the image to the width of the browser, some browsers end up with unreadable images when this is used, if it is a problem use --noresizehtml to disable that feature.
- -s,--singlehtml
The same as --xhtml except that this writes all pages to one single large XHTML file.
NOTE: This mode requires a fairly good computer (1GHz and above with a good chunk of memory) to read the document on for PDFs above 20-30 pages. Use --xhtml for these machines.
- --noresizehtml
Tells PDFtoPNG not to add a CSS tag to the HTML documents that makes the images get resized to fit the width of the browser window.
- -v, --version
Display version information and exit.
BUGS AND LIMITATIONS
There is a limitation in the free PDF readers that causes some pages to not render like they should (claiming ``Error in JPX stream''), thus this limitation is transferred over to PDFtoPNG. So there might be pages (especially for comics) that will be partly not rendered or not rendered at all. There is nothing PDFtoPNG can do with this problem, it must be fixed upstream.
DEPENDENCIES
Requires pdftoppm, pdfinfo and the Image::Magick perl module. zip is required for --zip. tar and bzip2 is required for --tbz.
AUTHOR
PDFtoPNG is written by Eskild Hustvedt <eskild at zerodogg dot org>
LICENSE AND COPYRIGHT
Copyright (C) Eskild Hustvedt 2007
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.