Adding Images

Show All

Hide All

Adding images to PDF for .NET documents is also easy, all the work is done by the DrawImage method.

DrawImage draws a given image at a specified location and has parameters that provide control over the image alignment and scaling. In the following example, this image is:

Stretched to fill the given rectangle
Center-aligned within the rectangle, scaled to keep the aspect ratio
Aligned to the top-left corner of the rectangle, with the original size

This code is used to draw the same image three times:

Visual Basic	Copy Code
Dim rect As RectangleF = pdf.PageRectangle rect.Inflate(- 72, - 72) ' Stretch image to fill the rectangle. pdf.DrawImage(pictureBox1.Image, rect) ' Center image within the rectangle, scale keeping aspect ratio. pdf.DrawImage(pictureBox1.Image, rect, ContentAlignment.MiddleCenter, C1.C1Pdf.ImageSizeModeEnum.Scale) ' Render the image to the top left corner of the rectangle. pdf.DrawImage(pictureBox1.Image, rect, ContentAlignment.TopLeft, C1.C1Pdf.ImageSizeModeEnum.Clip)

Visual Basic

Copy Code

Dim rect As RectangleF = pdf.PageRectangle
rect.Inflate(- 72, - 72)
 ' Stretch image to fill the rectangle.
pdf.DrawImage(pictureBox1.Image, rect)
 ' Center image within the rectangle, scale keeping aspect ratio.
pdf.DrawImage(pictureBox1.Image, rect, ContentAlignment.MiddleCenter, C1.C1Pdf.ImageSizeModeEnum.Scale)
 ' Render the image to the top left corner of the rectangle.
pdf.DrawImage(pictureBox1.Image, rect, ContentAlignment.TopLeft, C1.C1Pdf.ImageSizeModeEnum.Clip)

C#	Copy Code
RectangleF rect = pdf.PageRectangle; rect.Inflate(-72, -72); // Stretch image to fill the rectangle. pdf.DrawImage(pictureBox1.Image, rect); // Center image within the rectangle, scale keeping aspect ratio. pdf.DrawImage(pictureBox1.Image, rect, ContentAlignment.MiddleCenter, C1.C1Pdf.ImageSizeModeEnum.Scale); // Render the image to the top left corner of the rectangle. pdf.DrawImage(pictureBox1.Image, rect, ContentAlignment.TopLeft, 1.C1Pdf.ImageSizeModeEnum.Clip);

Copy Code

RectangleF rect = pdf.PageRectangle;
rect.Inflate(-72, -72);
 // Stretch image to fill the rectangle.
pdf.DrawImage(pictureBox1.Image, rect);
 // Center image within the rectangle, scale keeping aspect ratio.
pdf.DrawImage(pictureBox1.Image, rect, ContentAlignment.MiddleCenter, C1.C1Pdf.ImageSizeModeEnum.Scale);
 // Render the image to the top left corner of the rectangle.
pdf.DrawImage(pictureBox1.Image, rect, ContentAlignment.TopLeft, 1.C1Pdf.ImageSizeModeEnum.Clip);

The PDF document will look similar to this:

Notice that you can render any regular .NET Image object, including Metafiles. Metafiles are not converted into bitmaps; they are played into the document and thus retain the best possible resolution. If you want to add charts or technical drawings to your PDF document, Metafiles are better than bitmap images. PDF for .NET also supports EMF+ metafiles.

Bitmap images are managed automatically by PDF for .NET. If you render the same image several times (in a page header for example), only one copy of the image is saved into the PDF file. You can control the quality of the images using the C1PdfDocumentBase.ImageQuality property, which allows you to trade-off image quality versus file size.