A PdfImage object is created via PdfDocument's OpenImage method which takes an image path as an argument. PdfImage can also be created via an overloaded version of OpenImage which opens an image from a byte array. Once an instance of PdfImage is created, it can be displayed multiple times across a PDF document.

The following code segment displays the image painting.jpg three times on a page with various scaling factors:

C#

void Page_Load(Object Source, EventArgs E) { PdfManager objPdf = new PdfManager(); // Create empty document PdfDocument objDoc = objPdf.CreateDocument(); // Add a new page PdfPage objPage = objDoc.Pages.Add(); // Open image PdfImage objImage = objDoc.OpenImage( Server.MapPath( "painting.jpg") ); // Create empty param object PdfParam objParam = objPdf.CreateParam(); for( int i = 1; i <=3; i++ ) { objParam["x"] = (objPage.Width - objImage.Width / i) / 2.0f; objParam["y"] = objPage.Height - objImage.Height * i / 2.0f - 200; objParam["ScaleX"] = 1.0f / i; objParam["ScaleY"] = 1.0f / i; objPage.Canvas.DrawImage( objImage, objParam ); } // Save document, the Save method returns generated file name string strFilename = objDoc.Save( Server.MapPath("image.pdf"), false ); lblResult.Text = "Success! Download your PDF file <A TARGET=_new HREF=" + strFilename + ">here</A>"; }

VB.NET

Sub Page_Load(Source As Object, E As EventArgs) Dim objPdf As PdfManager = New PdfManager() ' Create empty document Dim objDoc As PdfDocument = objPdf.CreateDocument() ' Add a new page Dim objPage As PdfPage = objDoc.Pages.Add() ' Open image Dim objImage As PdfImage = objDoc.OpenImage( Server.MapPath( "painting.jpg") ) ' Create empty param object Dim objParam As PdfParam = objPdf.CreateParam() For i As integer = 1 To 3 objParam("x") = (objPage.Width - objImage.Width / i) / 2.0f objParam("y") = objPage.Height - objImage.Height * i / 2.0f - 200 objParam("ScaleX") = 1.0f / i objParam("ScaleY") = 1.0f / i objPage.Canvas.DrawImage( objImage, objParam ) Next ' Save document, the Save method returns generated file name Dim strFilename As String = objDoc.Save( Server.MapPath("image.pdf"), false ) lblResult.Text = "Success! Download your PDF file <A TARGET=_new HREF=" + strFilename + ">here</A>" End Sub

Here, we pass four arguments to the DrawImage method: X, Y, ScaleX and ScaleY. X and Y are required: they specify the coordinates of the lower-left corner of the image being displayed.

ScaleX and ScaleY are optional: they specify scaling factors along the X and Y coordinates. Both arguments are 1 by default, which means the image size on the page (in user coordinates) will be equal to its pixel size, provided that the image resolution is the standard 72 dots per inch (dpi). For example, if a 72dpi image is 360 x 216 pixels and the ScaleX/ScaleY arguments are not specified, the image will occupy 360 x 216 units of space, or 5" x 3". A 300dpi image with the same pixel size will only occupy 1.2" x .72".

You can optionally specify a rotation Angle (in degrees) by which the image will be rotated counter-clockwise around its lower-left corner.

Click on the links below to run this code sample:

However, it is possible to crop, or "mask out" the background of an image and then place the masked image on a different background, allowing the existing background to show through the masked areas. Two masking methods are available: explicit masking using a separate image, and color key masking.