[[PageOutline(2-5,Contents,pullout)]]

= PdfImage =

== Description ==

Insert PDFs or vectorgraphics like SVGs as PNG-Image into a wikipage. This is somehow an extension of the base Image-Macro.
    
Requires convert from [http://www.imagemagick.org ImageMagick].
    
The handling and the parameters are inspired by LaTeX includegraphics. 

The Location of the file can only be an attachment sofar. Locations in the SVN could lead into authentification Problems. External Locations means first downloading the resource. 
      
=== Parameters ===
||= Parameter =||= Value                 =||= default =||                         || 
|| `pdffile`   || location 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   ||                         ||
    
  
=== Examples ===
{{{
[[PdfImg(Book.pdf,width=400,page=100,caption="Page 100 from Book Example")]]
[[PdfImg(sketch.svg,cache=False)]] 
}}}

== Bugs/Feature Requests == 

Existing bugs and feature requests for PdfImagePlugin are 
[report:9?COMPONENT=PdfImagePlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=PdfImagePlugin&owner=ursaw new ticket].

== Download ==

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

== Source ==

You can check out PdfImagePlugin from [http://trac-hacks.org/svn/pdfimageplugin here] using Subversion, or [source:pdfimageplugin browse the source] with Trac.

== Example ==

{{{
[[PdfImg(Book.pdf,width=400,page=100,caption="Page 100 from Book Example")]]
[[PdfImg(sketch.svg,cache=False)]] 
}}}

== Recent Changes ==

[[ChangeLog(pdfimageplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:ursaw] [[BR]]
'''Maintainer:''' [wiki:ursaw] [[BR]]
'''Contributors:'''