Version 24 (modified by anonymous, 8 years ago) (diff)

fixed query table

PdfImages as PNG in Wiki


Insert vector graphics like PDFs or SVGs as PNG-images into a wikipage or ticket.

Requires convert from ImageMagick, convert may fail on specific files. Additionally, Ghostscript is required for convert on Windows, which is available here. The handling and the parameters are inspired by LaTeX includegraphics and the trac ImageMacro.


[[PdfImg(Book.pdf,width=400,page=100,caption="Page 100 from Book Example")]]
[[PdfImg(source:testpro/drawing.svg@10,width=600,caption="SVG-image from repository in version 10")]]


Attention: PDF conversion with ImageMagick-convert:

  1. may fail on specific PDF s. This is not a problem of the plugin, this is a problem of convert. In this case you will get an error like " Can't display foo.pdf, ImageMagick->convert failed with errorcode=... , command=convert ... "
  2. if not restricted to certain pages, it can take very long; Example: Converting a PDF file of 400 pages by simply [[PdfImg(test.pdf)]] took several minutes! (see #9874, #9875)


  • Install convert from the ImageMagick-suite.
  • Tested -so far only- on Linux

Tested on this configurations:

OS trac imagemagick
Ubuntu 11.04 0.11.7-4 (deb) 7:
Ubuntu 10.04.4 LTS 0.12.2 (easy_install) 7:
Win64 Server 2003 R2 0.12.2 (Bitnami) ImageMagick-6.7.5-6-Q16-windows-x64-dll.exe
Ghostscript gs902w64.exe


Possible trac links for resource: The Location of the file can be an attachment (wikipage, ticket, svn) or a local file (keyword "file:").

trac link (resource) alternatives comment
wiki JustPageName Attachment in wikipage
ticket #1
source browser,repos
file need configuration file.prepath


Parameter Value default
pdffile resource of PDF-file required
page Page to display 1 starting with 1
width width in pixel 600 must be absolute value
caption Caption under Image none
label anchor to link to
cache build once or each time True time consumption or changing vectorgraphics
align left|right nothing

Bugs/Feature Requests

Existing bugs and feature requests for PdfImagePlugin are here.

Open Bugs

Ticket Summary Component Type Status Priority Owner Severity Reporter
#9874 PdfImg macro runs with 100% cpu load PdfImagePlugin enhancement new normal ursaw critical falkb
#9875 calling PdfImg macro for PDF files of many pages takes very long PdfImagePlugin enhancement new normal ursaw major falkb
#10004 support of pdf file ressource path for Apache location PdfImagePlugin enhancement new high ursaw normal falkb
#10358 Resolution of image after convert is horrid PdfImagePlugin defect assigned low ursaw minor anonymous
#12958 Rendering issue in ticket when aligning side by side 2 pictures PdfImagePlugin defect new normal ursaw normal ntmlod

If you have any issues, create a new ticket.


Download the zipped source from [download:pdfimageplugin here].


You can check out PdfImagePlugin from here using Subversion, or browse the source with Trac.


[[PdfImg(Book.pdf,width=400,page=100,caption="Page 100 from Book Example")]]

Screenshot with PDF and SVG


No configuration is needed except to use the Resource 'file:' the following configuration must set:

Assume your server is and the webserver config mapped your local directory /absolute/entry/directory to the public directory entrydir then your configuration for the file:-resource looks like:

file.prepath = /absolute/entry/directory
file.preurl  =

Recent Changes

11408 by ursaw on 2012-03-21 08:10:12
changed external convert command according
11356 by ursaw on 2012-03-02 21:13:38
#9842 single quotes in convert command are optional under Linux, Windows dont like them..
11343 by ursaw on 2012-02-29 19:14:47
changed files and folders to lowercase


Author: ursaw
Maintainer: ursaw

Attachments (1)

Download all attachments as: .zip