Add a page to a PDF or a TIFF image in C# .NET

Nutrient .NET SDK (formerly GdPicture.NET) enables you to add pages to files that support pagination, such as PDFs and TIFF files.

Adding a blank page to a PDF

To add a blank page to a PDF, use the InsertPage method. This method requires the page size and the page location where it’ll be inserted. The page size can be defined in one of the following ways:

  • The page width and height in pixels.
  • The PdfPageSizes enumeration with predefined values.

To add a square blank page of 500×500 pixels to the beginning and an A5 blank page to the end of a PDF file, use the following code:

using GdPicturePDF gdpicturePDF = new GdPicturePDF();
gdpicturePDF.LoadFromFile(@"C:\temp\source.pdf");
// Insert a square blank page at the beginning of the PDF.
gdpicturePDF.InsertPage(PdfPageSizes.PdfPageSizeA5, 1);
// Insert an A5 blank page at the end of the PDF.
gdpicturePDF.InsertPage(PageWidth: 500, PageHeight: 500,
    gdpicturePDF.GetPageCount());
gdpicturePDF.SaveToFile(@"C:\temp\output.pdf");
Used methods
Related topics

Adding an existing page to a PDF

To add an existing page to the currently loaded PDF, use the ClonePage method. This method adds the copied page to the end of the file. For more information, refer to the copying a PDF page section of the guide on moving and copying pages.

To place the copied page to a specific location after using the ClonePage method, use the MovePage method to specify the final location of the copied page. For more information, refer to the section on copying a PDF page to a specified location in the guide on moving and copying pages.

Adding a blank page to a TIFF

To add a blank page to a TIFF file, follow the steps outlined below.

  1. Create a GdPictureImaging object.
  2. Create an empty GdPicture image by using the CreateNewGdPictureImage method.
  3. Add the empty GdPicture image to the TIFF file in one of the following ways:

To insert an empty image into the second-to-last position of a TIFF image, use the following code:

using GdPictureImaging gdpictureImaging = new GdPictureImaging();
Color backColor = Color.White;
int imageID = gdpictureImaging.TiffCreateMultiPageFromFile(@"C:\temp\source.tif");
// Create an empty image.
int imageBlankID = gdpictureImaging.CreateNewGdPictureImage(Width: 500, Height: 500,
    BitDepth: 32, BackColor: backColor);
// Insert the empty image into the second-to-last position of the TIFF image.
gdpictureImaging.TiffInsertPageFromGdPictureImage(imageID,
    gdpictureImaging.GetPageCount(imageID), imageBlankID);
gdpictureImaging.TiffSaveMultiPageToFile(imageID, @"C:\temp\output.tif",
    TiffCompression.TiffCompressionAUTO);
gdpictureImaging.ReleaseGdPictureImage(imageBlankID);
gdpictureImaging.ReleaseGdPictureImage(imageID);

The GetPageCount method returns the number of pages of the TIFF image after executing the TiffInsertPageFromGdPictureImage method. This means that the last page is GetPageCount + 1, and the second-to-last page is GetPageCount.

Used methods

Creating an empty image

The CreateNewGdPictureImage method enables you to create an empty image. It requires the following parameters:

  • Width — Sets the image width in pixels.
  • Height — Sets the image height in pixels.
  • BitDepth or PixelFormat — Sets the image bit depth or the PixelFormat enumeration defining the pixel format.
  • BackColor — Sets the image background color defined by either the Color object or using the ARGB method.

Use the following code to create an empty image:

using GdPictureImaging gdpictureImaging = new GdPictureImaging();
Color backColor = Color.White;
// Create an empty image with a white background and the size of 500×500 pixels.
int imageID = gdpictureImaging.CreateNewGdPictureImage(Width: 500, Height: 500, BitDepth: 32, BackColor: backColor);
gdpictureImaging.SaveAsJPEG(imageID, @"C:\temp\output.jpg");
gdpictureImaging.ReleaseGdPictureImage(imageID);
Used methods

Adding an existing page to a TIFF

To add an existing page to a TIFF image, follow the steps outlined below.

  1. Create a GdPictureImaging object.
  2. Extract the page you want to add with the TiffExtractPage method.
  3. Add the extracted page to the TIFF image in one of the following ways:
using GdPictureImaging gdpictureImaging = new GdPictureImaging();
int tiffID = gdpictureImaging.TiffCreateMultiPageFromFile("C:\temp\source.tif");
// Extract the last TIFF page to a temp.jpg file.
gdpictureImaging.TiffExtractPage(tiffID, gdpictureImaging.GetPageCount(tiffID),
    @"C:\temp\temp.jpg");
// Open a GdPicture image from the temp.jpg file.
int imageTempID = gdpictureImaging.CreateGdPictureImageFromFile(@"C:\temp\temp.jpg");
// Append the GdPicture image to the TIFF file.
gdpictureImaging.TiffAppendPageFromFile(tiffID, @"C:\temp\temp.jpg");
gdpictureImaging.TiffSaveMultiPageToFile(tiffID, @"C:\temp\output.tif",
    TiffCompression.TiffCompressionAUTO);
gdpictureImaging.ReleaseGdPictureImage(imageTempID);
Used methods
Related topics