2009-03-06 03:20:46 +00:00
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
< html >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=ISO-8859-1" >
< title > Image< / title >
< link type = "text/css" rel = "stylesheet" href = "../fpdf.css" >
< / head >
< body >
< h1 > Image< / h1 >
< code > Image(< b > string< / b > file [, < b > float< / b > x [, < b > float< / b > y [, < b > float< / b > w [, < b > float< / b > h [, < b > string< / b > type [, < b > mixed< / b > link]]]]]])< / code >
< h2 > Description< / h2 >
Puts an image. The size it will take on the page can be specified in different ways:
< ul >
2011-11-03 02:25:38 +00:00
< li > explicit width and height (expressed in user unit or dpi)< / li >
2009-03-06 03:20:46 +00:00
< li > one explicit dimension, the other being calculated automatically in order to keep the original proportions< / li >
2011-11-03 02:25:38 +00:00
< li > no explicit dimension, in which case the image is put at 96 dpi< / li >
2009-03-06 03:20:46 +00:00
< / ul >
Supported formats are JPEG, PNG and GIF. The GD extension is required for GIF.
< br >
< br >
For JPEGs, all flavors are allowed:
< ul >
< li > gray scales< / li >
< li > true colors (24 bits)< / li >
< li > CMYK (32 bits)< / li >
< / ul >
For PNGs, are allowed:
< ul >
< li > gray scales on at most 8 bits (256 levels)< / li >
< li > indexed colors< / li >
< li > true colors (24 bits)< / li >
< / ul >
2011-11-03 02:25:38 +00:00
For GIFs: in case of an animated GIF, only the first frame is displayed.< br >
2009-03-06 03:20:46 +00:00
< br >
2011-11-03 02:25:38 +00:00
Transparency is supported.< br >
2009-03-06 03:20:46 +00:00
< br >
The format can be specified explicitly or inferred from the file extension.< br >
2011-11-03 02:25:38 +00:00
< br >
2009-03-06 03:20:46 +00:00
It is possible to put a link on the image.< br >
< br >
Remark: if an image is used several times, only one copy is embedded in the file.
< h2 > Parameters< / h2 >
< dl class = "param" >
< dt > < code > file< / code > < / dt >
< dd >
Path or URL of the image.
< / dd >
< dt > < code > x< / code > < / dt >
< dd >
Abscissa of the upper-left corner. If not specified or equal to < code > null< / code > , the current abscissa
is used.
< / dd >
< dt > < code > y< / code > < / dt >
< dd >
Ordinate of the upper-left corner. If not specified or equal to < code > null< / code > , the current ordinate
is used; moreover, a page break is triggered first if necessary (in case automatic page breaking is enabled)
and, after the call, the current ordinate is moved to the bottom of the image.
< / dd >
< dt > < code > w< / code > < / dt >
< dd >
2011-11-03 02:25:38 +00:00
Width of the image in the page. There are three cases:
< ul >
< li > If the value is positive, it represents the width in user unit< / li >
< li > If the value is negative, the absolute value represents the horizontal resolution in dpi< / li >
< li > If the value is not specified or equal to zero, it is automatically calculated< / li >
< / ul >
2009-03-06 03:20:46 +00:00
< / dd >
< dt > < code > h< / code > < / dt >
< dd >
2011-11-03 02:25:38 +00:00
Height of the image in the page. There are three cases:
< ul >
< li > If the value is positive, it represents the height in user unit< / li >
< li > If the value is negative, the absolute value represents the vertical resolution in dpi< / li >
< li > If the value is not specified or equal to zero, it is automatically calculated< / li >
< / ul >
2009-03-06 03:20:46 +00:00
< / dd >
< dt > < code > type< / code > < / dt >
< dd >
Image format. Possible values are (case insensitive): < code > JPG< / code > , < code > JPEG< / code > , < code > PNG< / code > and < code > GIF< / code > .
If not specified, the type is inferred from the file extension.
< / dd >
< dt > < code > link< / code > < / dt >
< dd >
URL or identifier returned by AddLink().
< / dd >
< / dl >
2011-11-03 02:25:38 +00:00
< h2 > Example< / h2 >
< div class = "doc-source" >
< pre > < code > // Insert a logo in the top-left corner at 300 dpi
$pdf-> Image('logo.png',10,10,-300);
// Insert a dynamic image from a URL
$pdf-> Image('http://chart.googleapis.com/chart?cht=p3& chd=t:60,40& chs=250x100& chl=Hello|World',60,30,90,0,'PNG');< / code > < / pre >
< / div >
2009-03-06 03:20:46 +00:00
< h2 > See also< / h2 >
< a href = "addlink.htm" > AddLink()< / a > .
< hr style = "margin-top:1.5em" >
< div style = "text-align:center" > < a href = "index.htm" > Index< / a > < / div >
< / body >
< / html >
