Documentation – Рисование аннотаций

Python-Net: Добавить круговую аннотацию

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

Круговые аннотации полезны для выделения областей интереса в PDF‑документе. С помощью PdfContentEditor, вы можете создавать круглые формы, указывая прямоугольник, определяющий границы круга, а также текст аннотации, цвет, параметры заливки, номер страницы и ширину рамки.

Создайте объект PdfContentEditor.
Привязать входной PDF.
Определить границы круга.
Добавить аннотацию круга.
Сохранить обновлённый 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: Добавить аннотацию кривой

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

Аннотации кривой используются для выделения нерегулярных путей или форм в PDF, обеспечивая визуальное акцентирование или маркировку важных областей. Используя PdfContentEditor, вы можете рисовать кривые, задавая последовательность вершин, стиль границы, видимость, прямоугольник аннотации и описательный текст.

Создайте объект PdfContentEditor.
Привяжите onput PDF.
Настройте свойства Curve.
Нарисуйте аннотацию Curve.
Сохраните обновлённый 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: Добавить аннотацию линий

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

Аннотации линий полезны для акцентирования текста, выделения взаимосвязей или привлечения внимания к определённым областям в PDF. С PdfContentEditor, вы можете программно создавать аннотации линий, указывая начальные и конечные точки, ограничивающий прямоугольник, цвет, стиль границы и окончания линий.

Создайте объект PdfContentEditor.
Привяжите входной PDF.
Определите свойства аннотации линии.
Добавьте аннотацию линии.
Сохраните обновлённый 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: Добавить аннотацию полигога

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

Аннотации полигона используются для выделения неправильных областей или форм в PDF, обеспечивая визуальное акцентирование или маркировку конкретных регионов. Используя PdfContentEditor, вы можете создавать полигоны, указывая координаты вершин, стиль границы, номер страницы и прямоугольник аннотации.

Создайте объект PdfContentEditor.
Привяжите входной PDF.
Настройте свойства Polygon.
Добавьте аннотацию Polygon.
Сохраните обновлённый 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: Добавить аннотацию полилиний

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

Аннотации полилиний позволяют выделять серию соединённых отрезков линий в PDF. Используя PdfContentEditor", вы можете нарисовать полилинию, указав координаты вершин, стиль границы, номер страницы и границы аннотации. Это полезно для визуального представления путей, тенденций или соединений в диаграммах и документах.

Создайте объект PdfContentEditor.
Привяжите входной PDF.
Настройте свойства Polyline.
Добавьте аннотацию Polyline.
Сохраните обновлённый 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: Добавить аннотацию квадрата

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

Аннотации квадрата обычно используются для выделения интересующих областей, пометок важных разделов или предоставления визуальных подсказок в PDF‑документе. Используя PdfContentEditor, вы можете создавать аннотации квадрата, указывая ограничивающий прямоугольник, текст содержимого, цвет границы, параметр заливки, номер страницы и ширину границы.

Создайте объект PdfContentEditor.
Привяжите входной PDF.
Определите квадратную аннотацию.
Добавьте квадратную аннотацию.
Сохраните обновлённый 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)