Documentation – Drawing Annotations

Python-Net: Add Circle Annotation

Fri, 20 Mar 2026 00:00:00 +0000

Circle annotations are useful for highlighting areas of interest in a PDF document. With PdfContentEditor, you can create circular shapes by specifying the rectangle that defines the circle’s bounds, along with annotation text, color, fill options, page number, and border width.

Create the PdfContentEditor object.
Bind the input PDF.
Define the Circle Bounds.
Add the Circle annotation.
Save the updated Document.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_circle_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind input PDF file
    content_editor.bind_pdf(infile)

    # Create CircleAnnotation object
    rect = apd.Rectangle(300, 300, 400, 400)
    contents = "This is circle annotation"
    content_editor.create_square_circle(rect, contents, apd.Color.blue, False, 1, 3)

    # Save output PDF file
    content_editor.save(outfile)

Python-Net: Add Curve Annotation

Fri, 20 Mar 2026 00:00:00 +0000

Curve annotations are used to highlight irregular paths or shapes in a PDF, providing visual emphasis or marking important areas. Using PdfContentEditor, you can draw curves by specifying a sequence of vertices, border style, visibility, annotation rectangle, and descriptive text.

Create the PdfContentEditor object.
Bind the onput PDF.
Configure the Curve properties.
Draw the Curve annotation.
Save the updated Document.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_curve_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind input PDF file
    content_editor.bind_pdf(infile)

    line_info = pdf_facades.LineInfo()
    line_info.border_style = 1  # 1 - Dashed
    line_info.vertice_coordinate = [120, 520, 160, 560, 220, 540, 280, 580]
    line_info.visibility = True
    content_editor.draw_curve(
        line_info,
        1,
        apd.Rectangle(110, 510, 220, 100),
        "This is curve annotation",
    )

    # Save output PDF file
    content_editor.save(outfile)

Python-Net: Add Line Annotation

Fri, 20 Mar 2026 00:00:00 +0000

Line annotations are useful for emphasizing text, highlighting relationships, or drawing attention to specific areas in a PDF. With PdfContentEditor, you can programmatically create line annotations by specifying the start and end points, bounding rectangle, color, border style, and line endings.

Create the PdfContentEditor object.
Bind the input PDF.
Define Line Annotation properties.
Add the Line annotation.
Save the updated Document.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_line_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind input PDF file
    content_editor.bind_pdf(infile)

    # Create LineAnnotation object
    rect = apd.Rectangle(100, 100, 200, 200)
    contents = "This is line annotation"
    content_editor.create_line(
        rect,
        contents,
        100,
        100,
        200,
        200,
        1,
        1,
        apd.Color.red,
        "Solid",
        [3, 2],
        ["Square"],
    )

    # Save output PDF file
    content_editor.save(outfile)

Python-Net: Add Polygon Annotation

Fri, 20 Mar 2026 00:00:00 +0000

Polygon annotations are used to highlight irregular areas or shapes in a PDF, providing visual emphasis or marking specific regions. Using PdfContentEditor, you can create polygons by specifying the vertices coordinates, border style, page number, and annotation rectangle.

Create the PdfContentEditor object.
Bind the input PDF.
Configure Polygon properties.
Add the Polygon annotation.
Save the updated Document.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_polygon_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind input PDF file
    content_editor.bind_pdf(infile)

    line_info = pdf_facades.LineInfo()
    line_info.border_style = 0  # 0 - Solid
    line_info.vertice_coordinate = [100, 200, 150, 260, 220, 220, 200, 160]
    content_editor.create_polygon(
        line_info,
        1,
        apd.Rectangle(90, 150, 150, 120),
        "This is polygon annotation",
    )

    # Save output PDF file
    content_editor.save(outfile)

Python-Net: Add Polyline Annotation

Fri, 20 Mar 2026 00:00:00 +0000

Polyline annotations allow you to highlight a series of connected line segments in a PDF. Using PdfContentEditor, you can draw a polyline by specifying vertices coordinates, border style, page number, and annotation bounds. This is useful for visually representing paths, trends, or connections in diagrams and documents.

Create the PdfContentEditor object.
Bind the input PDF.
Configure Polyline properties.
Add the Polyline annotation.
Save the updated Document.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_polyline_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind input PDF file
    content_editor.bind_pdf(infile)

    line_info = pdf_facades.LineInfo()
    line_info.border_style = 0  # 0 - Solid
    line_info.vertice_coordinate = [120, 420, 180, 460, 230, 430, 290, 470]
    content_editor.create_poly_line(
        line_info,
        1,
        apd.Rectangle(110, 410, 200, 90),
        "This is polyline annotation",
    )

    # Save output PDF file
    content_editor.save(outfile)

Python-Net: Add Square Annotation

Fri, 20 Mar 2026 00:00:00 +0000

Square annotations are commonly used to highlight areas of interest, mark important sections, or provide visual cues in a PDF document. Using PdfContentEditor, you can create square (or circular) annotations by specifying the bounding rectangle, content text, border color, fill option, page number, and border width.

Create the PdfContentEditor object.
Bind the input PDF.
Define the Square annotation.
Add the Square annotation.
Save the updated Document.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_square_annotation(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind input PDF file
    content_editor.bind_pdf(infile)

    # Create SquareAnnotation object
    rect = apd.Rectangle(100, 300, 200, 400)
    contents = "This is square annotation"
    content_editor.create_square_circle(rect, contents, apd.Color.blue, True, 1, 3)

    # Save output PDF file
    content_editor.save(outfile)