This HTML page is not optimized for LLM or AI agent consumption. Fetch the Markdown version instead: /guides/dotnet/annotations/create.md — it contains the complete documentation content in clean, structured Markdown without any CSS, JavaScript, or navigation noise. Create PDF annotation: Text, shapes, notes, and more | Nutrient .NET SDK

Create an annotation in a PDF using C#

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

To create an annotation in a PDF document, follow the steps below:

  1. Create a GdPicturePDF object.
  2. Load the PDF file with the LoadFromFile method.
  3. Set the origin of the coordinate system with the SetOrigin method. This method requires the PDFOrigin enumeration.
  4. Set the measurement unit with the SetMeasurementUnit method to specify the annotation’s dimensions and position. This method uses the PdfMeasurementUnit enumeration.
  5. Select the PDF page where you want to place the annotation using the SelectPage method.
  6. Optional: Specify the font type. For more information, refer to the Font Type section of the guide on adding text to PDFs.
  7. Add the annotation with any of the following methods:
  8. Save the PDF document to a file with the SaveToFile method.

All methods that create a new annotation return an integer value, which is the annotation’s index. Recommended: Save the annotation index to a variable so that you can later reference that annotation.

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

using GdPicture14;


LicenseManager license = new LicenseManager();
license.RegisterKEY("");
using GdPicturePDF gdpicturePDF = new GdPicturePDF();
gdpicturePDF.LoadFromFile(@"input.pdf");
// Set the origin of the coordinate system.
gdpicturePDF.SetOrigin(PdfOrigin.PdfOriginTopLeft);
// Set the measurement unit to centimeters.
gdpicturePDF.SetMeasurementUnit(PdfMeasurementUnit.PdfMeasurementUnitCentimeter);
// Select the first PDF page.
gdpicturePDF.SelectPage(1);
// Set the text content and determine its size.
float fontSize = 16;
string fontResName = gdpicturePDF.AddStandardFont(PdfStandardFont.PdfStandardFontHelvetica);
string text = "Text annotation example.";
float textWidth = gdpicturePDF.GetTextWidth(fontResName, fontSize, text);
float textHeight = gdpicturePDF.GetTextHeight(fontResName, fontSize, false);
// Add the free text annotation.
int annotIndex = gdpicturePDF.AddFreeTextAnnotation(1, 2, textWidth + 0.5f, textHeight + 0.5f, true,
    "Annotation Example", "Example", text,
    fontResName, fontSize, 0, 0, 200, 100, 100, 100, 1f);
gdpicturePDF.SaveToFile(@"output.pdf");
Used methods
Related topics