Adds a copy of an existing image in the Doc, to the current page.




int AddImageCopy(int id)

[Visual Basic]
Function AddImageCopy(id As Integer) As Integer

Throws Exceptions may throw Exception()



Name Description

An existing image object ID to be copied to the page again.

return The ID of the newly added Image Object.




Adds a copy of an image which has already been inserted elsewhere in the document.

You can use this facility to add commonly used graphics such as watermarks. The raw image data is inserted only once which means that PDF size is greatly reduced.

This method only works with raster or bitmap images. So your ID must have been obtained from a previous call to AddImageFile, AddImageData or AddImageObject.

The image is scaled to fill the current Rect. It is transformed using the current Transform.




This example shows how to read an existing PDF document and insert a background image into every page.

We start by reading our template PDF document and finding out core information we will need to reference each page.

Doc theDoc = new Doc();
int theCount = theDoc.PageCount;

[Visual Basic]
Dim theDoc As Doc = New Doc()
Dim theCount As Integer = theDoc.PageCount

We cycle through the pages inserting images as we go.

We set the layer property to ensure that the image gets added in the background rather than on top of existing content.

The first time we add an image file. Subsequent times we reference the image ID. This means that we embed only one copy of the image data and simply reference that data from each page.

Finally we save the modified PDF.

int theID = 0;
for (int i = 1; i <= theCount; i++) {
  theDoc.PageNumber = i;
  theDoc.Layer = theDoc.LayerCount + 1;
  if (i == 1) {
    string thePath = Server.MapPath("../mypics/light.jpg");
    theID = theDoc.AddImageFile(thePath, 1);

[Visual Basic]
Dim theID As Integer = 0
For i As Integer = 1 To theCount
  theDoc.PageNumber = i
  theDoc.Layer = theDoc.LayerCount + 1
  If i = 1 Then
    Dim thePath As String = Server.MapPath("../mypics/light.jpg")
    theID = theDoc.AddImageFile(thePath, 1)
  End If

Given the following document.

sample.pdf - [Page 1]

sample.pdf - [Page 2]

sample.pdf - [Page 3]

sample.pdf - [Page 4]

And the following image.

This is the kind of output you might expect.

watermark.pdf - [Page 1]

watermark.pdf - [Page 2]

watermark.pdf - [Page 3]

watermark.pdf - [Page 4]