PdfImages as PNG in Wiki

Description

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.

Examples:

[[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")]]
[[PdfImg(ticket:1:file.pdf)]]

Acknowledgement

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)

Requirements

• 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:6.6.2.6-1ubuntu
Ubuntu 10.04.4 LTS	0.12.2 (easy_install)	7:6.5.7.8-1ubuntu
Win64 Server 2003 R2	0.12.2 (Bitnami)	​ImageMagick-6.7.5-6-Q16-windows-x64-dll.exe ​Ghostscript gs902w64.exe

Parameters

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

Parameters:

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

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

Source

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

Example

[[PdfImg(Book.pdf,width=400,page=100,caption="Page 100 from Book Example")]]
[[PdfImg(sketch.svg,cache=False)]] 
[[PdfImg(OtherPage:foo.pdf)]]
[[PdfImg(file:relpath/to/foo.pdf)]]

Configuration

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

Assume your server is ​http://example.com 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:

[pdfimg]
file.prepath = /absolute/entry/directory
file.preurl  = http://example.com/entrydir

Recent Changes

11408 by ursaw on 2012-03-21 08:10:12

changed external convert command according
ticket:9874#comment:5

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

(more)

Author/Contributors

Author: ursaw
Maintainer: ursaw
Contributors: