This HTML page is not optimized for LLM or AI agent consumption. Fetch the Markdown version instead: /guides/dotnet/editor/add-page.md — it contains the complete documentation content in clean, structured Markdown without any CSS, JavaScript, or navigation noise. Add a page to PDF or TIFF image in C# .NET | Nutrient .NET SDK

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

Markdown version of this page, suitable for AI agents and automation

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

Download sample

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 the current units, which are points by default.
  • The PdfPageSizes enumeration with predefined values.

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

Register the SDK license before running SDK operations. For setup details, refer to the getting started with .NET SDK guide.

using GdPicture14;
using GdPicture14.Imaging;


LicenseManager license = new LicenseManager();
license.RegisterKEY("");
{
using GdPicturePDF gdpicturePDF = new GdPicturePDF();
gdpicturePDF.LoadFromFile(@"input.pdf");
// Insert a square blank page at the beginning of the PDF.
gdpicturePDF.InsertPage(PageWidth: 500, PageHeight: 500, PageNo: 1);
// Insert an A5 blank page at the end of the PDF.
gdpicturePDF.InsertPage(PdfPageSizes.PdfPageSizeA5, gdpicturePDF.GetPageCount() + 1);
gdpicturePDF.SaveToFile(@"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();
GdPictureColor backColor = GdPictureColor.White;
int imageID = gdpictureImaging.TiffCreateMultiPageFromFile(@"multipage-tiff.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, @"output.tif",
    TiffCompression.TiffCompressionAUTO);
gdpictureImaging.ReleaseGdPictureImage(imageBlankID);
gdpictureImaging.ReleaseGdPictureImage(imageID);
}

The GetPageCount method runs before the page is inserted, so it returns the original number of pages. Inserting the new page at that position moves the original last page one position down, and the new page becomes the second-to-last page.

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 a GdPictureColor object or using the ARGB method.

Use the following code to create an empty image:

{
using GdPictureImaging gdpictureImaging = new GdPictureImaging();
GdPictureColor backColor = GdPictureColor.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, @"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("multipage-tiff.tif");
// Extract the last TIFF page to a temp.tif file.
gdpictureImaging.TiffExtractPage(tiffID, gdpictureImaging.GetPageCount(tiffID),
    @"temp.tif");
// Append the extracted page to the end of the TIFF image.
gdpictureImaging.TiffAppendPageFromFile(tiffID, @"temp.tif");
gdpictureImaging.TiffSaveMultiPageToFile(tiffID, @"output.tif",
    TiffCompression.TiffCompressionAUTO);
gdpictureImaging.ReleaseGdPictureImage(tiffID);
}
Used methods
Related topics