Documentation – Работа с Graphs в PDF в Python

Python-Net: Добавить объекты дуг в PDF на Python

Thu, 16 Apr 2026 00:00:00 +0000

Добавить объект дуги

Aspose.PDF for Python via .NET позволяет вам добавлять Arc фигуры в страницы PDF с использованием Graph класс. Вы можете рисовать контурные дуги и заполненные сегменты дуг для схем и технических иллюстраций.

Выполните следующие шаги:

Создайте Document экземпляр.
Создайте объект Graph с определенными размерами.
Установите Border для объекта Graph.
Создайте соответствующий объект дуги.
Добавьте этот объект в коллекцию Shapes в объекте graph.
Добавьте Graph объект в коллекцию paragraphs страницы.
Сохраните наш PDF‑файл.

Следующий фрагмент кода показывает, как добавить Дуга объект.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_arc(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    arc1 = drawing.Arc(100, 100, 95, 0, 90)
    arc1.graph_info.color = ap.Color.green_yellow
    graph.shapes.add(arc1)

    arc2 = drawing.Arc(100, 100, 90, 70, 180)
    arc2.graph_info.color = ap.Color.dark_blue
    graph.shapes.add(arc2)

    arc3 = drawing.Arc(100, 100, 85, 120, 210)
    arc3.graph_info.color = ap.Color.red
    graph.shapes.add(arc3)

    page.paragraphs.add(graph)
    document.save(outfile)

Создать заполненный объект дуги

В этом примере показано, как добавить сегмент дуги, заполненный цветом.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_arc_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    arc = drawing.Arc(100, 100, 95, 0, 90)

    arc.graph_info.fill_color = ap.Color.green_yellow
    graph.shapes.add(arc)

    line = drawing.Line([195, 100, 100, 100, 100, 195])
    line.graph_info.fill_color = ap.Color.green_yellow
    graph.shapes.add(line)

    page.paragraphs.add(graph)
    document.save(outfile)

Результат добавления залитой дуги:

Связанные темы графов

Python-Net: Добавить круглые формы в PDF на Python

Thu, 16 Apr 2026 00:00:00 +0000

Добавить объект круга

Aspose.PDF for Python via .NET позволяет вам добавлять Круг фигуры на страницы PDF через Graph class. Используйте круги для схем, аннотаций и простых визуальных элементов.

Следуйте указаниям ниже:

Создайте Document экземпляр.
Создайте объект Graph с определенными размерами.
Установите Border для объекта Graph.
Добавьте Graph объект в коллекцию абзацев страницы.
Сохраните наш PDF-файл.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_circle(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 200)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    circle = drawing.Circle(100, 100, 40)
    circle.graph_info.color = ap.Color.green_yellow
    graph.shapes.add(circle)

    page.paragraphs.add(graph)
    document.save(outfile)

Нарисованный нами круг будет выглядеть так:

Создать объект заполненного круга

Этот пример показывает, как добавить круг и заполнить его цветом.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_circle_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 200)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    circle = drawing.Circle(100, 100, 40)
    circle.graph_info.color = ap.Color.green_yellow
    circle.graph_info.fill_color = ap.Color.green
    circle.text = ap.text.TextFragment("Circle")
    graph.shapes.add(circle)

    page.paragraphs.add(graph)
    document.save(outfile)

Результат добавления заполненного круга:

Связанные темы графиков

Python-Net: Добавить кривые формы в PDF на Python

Thu, 16 Apr 2026 00:00:00 +0000

Добавить объект Curve

Aspose.PDF for Python via .NET позволяет добавлять Curve фигуры на страницы PDF через Graph класс.

В этой статье показано, как создать как контурные, так и залитые кривые.

Следуйте приведённым ниже шагам:

Создайте Document экземпляр.
Создайте объект Graph с определёнными размерами.
Установите Border для объекта Graph.
Добавьте Graph объект в коллекцию абзацев страницы.
Сохраните наш PDF‑файл.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_curve(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 200)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    curve1 = drawing.Curve([10, 10, 50, 60, 70, 10, 100, 120])
    curve1.graph_info.color = ap.Color.green_yellow
    graph.shapes.add(curve1)

    page.paragraphs.add(graph)
    document.save(outfile)

На следующем изображении показан результат, выполненный с помощью нашего фрагмента кода:

Создать объект заполненной кривой

Этот пример показывает, как добавить объект Curve, заполненный цветом.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing


def add_curve_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 200)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    curve1 = drawing.Curve([10, 10, 50, 60, 70, 10, 100, 120])
    curve1.graph_info.fill_color = ap.Color.green_yellow
    graph.shapes.add(curve1)

    page.paragraphs.add(graph)
    document.save(outfile)

Результат добавления заполненной кривой:

Связанные темы графиков

Python-Net: Добавить линейные фигуры в PDF на Python

Thu, 16 Apr 2026 00:00:00 +0000

Добавить объект Line

Aspose.PDF for Python via .NET позволяет вам добавить Line формы в страницы PDF с использованием Graph класс. Вы можете управлять цветом линии, пунктирным шаблоном и размещением.

Выполните следующие шаги:

Создайте Документ экземпляр.
Создайте объект Graph
Добавьте Graph объект в коллекцию абзацев страницы.
Создайте и настройте строку
Добавьте Line к графу
Сохраните наш PDF-файл.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing


def add_line(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(100, 400)
    page.paragraphs.add(graph)

    line = drawing.Line([100, 100, 200, 100])
    line.graph_info.dash_array = [0, 1, 0]
    line.graph_info.dash_phase = 1
    graph.shapes.add(line)

    document.save(outfile)

Как добавить пунктирно‑штриховую линию в ваш PDF‑документ

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_dotted_dashed_line(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(100, 400)
    page.paragraphs.add(graph)

    line = drawing.Line([100, 100, 200, 100])
    line.graph_info.color = ap.Color.red
    line.graph_info.dash_array = [0, 1, 0]
    line.graph_info.dash_phase = 1
    graph.shapes.add(line)

    document.save(outfile)

Результат добавления пунктирно‑точечной линии:

Нарисовать линию поперек страницы

Вы также можете нарисовать линии поперек страницы, чтобы сформировать крест.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def draw_line_across_page(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    page.page_info.margin.left = 0
    page.page_info.margin.right = 0
    page.page_info.margin.bottom = 0
    page.page_info.margin.top = 0

    graph = drawing.Graph(page.page_info.width, page.page_info.height)
    line = drawing.Line([page.rect.llx, 0, page.page_info.width, page.rect.ury])
    graph.shapes.add(line)
    line2 = drawing.Line([0, page.rect.ury, page.page_info.width, page.rect.llx])
    graph.shapes.add(line2)
    page.paragraphs.add(graph)

    document.save(outfile)

Связанные темы графов

Python-Net: Добавить прямоугольные фигуры в PDF на Python

Thu, 16 Apr 2026 00:00:00 +0000

Добавить объект Rectangle

Aspose.PDF for Python via .NET позволяет добавлять Rectangle формы в страницы PDF через Graph класс. Вы можете рисовать обводные прямоугольники и применять сплошные, градиентные или прозрачные заполнения.

Следуйте инструкциям ниже:

Создайте новый PDF Document.
Добавьте Page в коллекцию страниц PDF‑файла.
Добавьте TextFragment в коллекцию абзацев экземпляра страницы.
Создайте Graph экземпляр.
Установите границу для Объект Graph.
Добавьте Rectangle объект в коллекцию фигур объекта Graph.
Добавьте объект графика в коллекцию абзацев экземпляра страницы.
Добавьте TextFragment в коллекцию абзацев экземпляра страницы.
И сохраните ваш PDF‑файл

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_rectangle(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    text_fragment = ap.text.TextFragment("Rectangle")
    page.paragraphs.add(text_fragment)

    graph = drawing.Graph(400, 300)
    page.paragraphs.add(graph)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.red)

    rect = drawing.Rectangle(20, 20, 350, 250)
    graph.shapes.add(rect)
    page.paragraphs.add(text_fragment)

    document.save(outfile)

Создать объект заполненного прямоугольника

Aspose.PDF for Python via .NET также предлагает возможность заполнять объект прямоугольника определённым цветом.

Следующий фрагмент кода показывает, как добавить Rectangle объект, заполненный цветом.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def create_rectangle_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(100, 400)
    page.paragraphs.add(graph)

    rect = drawing.Rectangle(100, 100, 200, 120)
    rect.graph_info.fill_color = ap.Color.red
    graph.shapes.add(rect)

    document.save(outfile)

Результат прямоугольника, залитого сплошным цветом:

Добавить рисунок с градиентной заливкой

Aspose.PDF for Python via .NET поддерживает возможность добавлять графические объекты в PDF‑документы, и иногда требуется заполнять графические объекты градиентным цветом.

Следующий фрагмент кода показывает, как добавить Rectangle объект, заполненный градиентным цветом.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_drawing_with_gradient_fill(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    page.paragraphs.add(graph)

    rect = drawing.Rectangle(0, 0, 300, 300)
    gradient_color = ap.Color()
    gradient_settings = drawing.GradientAxialShading(ap.Color.red, ap.Color.blue)
    gradient_settings.start = ap.Point(0, 0)
    gradient_settings.end = ap.Point(350, 350)
    gradient_color.pattern_color_space = gradient_settings
    rect.graph_info.fill_color = gradient_color
    graph.shapes.add(rect)

    document.save(outfile)

Создать прямоугольник с альфа‑каналом цвета

Aspose.PDF for Python via .NET также поддерживает прозрачность через альфа‑канал цвета.

Следующий фрагмент кода показывает, как добавить Rectangle объект с альфа‑значениями.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def create_rectangle_with_alpha_color_channel(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(100, 400)
    page.paragraphs.add(graph)

    rect = drawing.Rectangle(100, 100, 200, 120)
    rect.graph_info.fill_color = ap.Color.from_argb(128, 244, 180, 0)
    graph.shapes.add(rect)

    rect1 = drawing.Rectangle(200, 150, 200, 100)
    rect1.graph_info.fill_color = ap.Color.from_argb(160, 120, 0, 120)
    graph.shapes.add(rect1)

    document.save(outfile)

Управление Z-Order фигур

Aspose.PDF for .NET поддерживает функцию добавления графических объектов (например граф, линия, прямоугольник и т.д.) в PDF‑документы. При добавлении более одного экземпляра одного и того же объекта в PDF‑файл мы можем управлять их отрисовкой, указывая Z-Order. Z-Order также используется, когда необходимо отрисовывать объекты друг над другом.

Следующий фрагмент кода показывает шаги рендеринга Rectangle объекты один над другим.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing


def _add_rectangle_to_page(
    page: ap.Page,
    x: float,
    y: float,
    width: float,
    height: float,
    color: ap.Color,
    zindex: int,
):
    graph = drawing.Graph(width, height)
    graph.is_change_position = False
    graph.left = x
    graph.top = y
    rect = drawing.Rectangle(0, 0, width, height)
    rect.graph_info.fill_color = color
    rect.graph_info.color = color
    graph.shapes.add(rect)
    graph.z_index = zindex
    page.paragraphs.add(graph)


def control_z_order_of_rectangle(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    page.set_page_size(375, 300)
    page.page_info.margin.left = 0
    page.page_info.margin.top = 0

    _add_rectangle_to_page(page, 50, 40, 60, 40, ap.Color.red, 2)
    _add_rectangle_to_page(page, 20, 20, 30, 30, ap.Color.blue, 1)
    _add_rectangle_to_page(page, 40, 40, 60, 30, ap.Color.green, 0)

    document.save(outfile)

Связанные темы графа

Python-Net: Добавить эллиптические формы в PDF на Python

Thu, 16 Apr 2026 00:00:00 +0000

Добавить объект Ellipse

Aspose.PDF for Python via .NET позволяет добавлять Ellipse формы в PDF‑страницы с Graph класс. Вы можете рисовать контуры эллипсов, применять цвета заливки и размещать текст внутри объектов эллипсов.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_ellipse(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    ellipse1 = drawing.Ellipse(150, 100, 120, 60)
    ellipse1.graph_info.color = ap.Color.green_yellow
    ellipse1.text = ap.text.TextFragment("Ellipse")
    graph.shapes.add(ellipse1)

    ellipse2 = drawing.Ellipse(50, 50, 18, 300)
    ellipse2.graph_info.color = ap.Color.dark_red
    graph.shapes.add(ellipse2)

    page.paragraphs.add(graph)
    document.save(outfile)

Создать заполненный объект эллипса

Следующий фрагмент кода показывает, как добавить Ellipse объект, заполненный цветом.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def create_ellipse_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    ellipse1 = drawing.Ellipse(100, 100, 120, 180)
    ellipse1.graph_info.fill_color = ap.Color.green_yellow
    graph.shapes.add(ellipse1)

    ellipse2 = drawing.Ellipse(200, 150, 180, 120)
    ellipse2.graph_info.fill_color = ap.Color.dark_red
    graph.shapes.add(ellipse2)

    page.paragraphs.add(graph)
    document.save(outfile)

Добавить текст внутри Эллипса

Aspose.PDF for Python via .NET также позволяет размещать текст внутри объектов фигур. Следующий пример добавляет текст к фигурам-эллипсам.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_text_inside_ellipse(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    text_fragment = ap.text.TextFragment("Ellipse")
    text_fragment.text_state.font = ap.text.FontRepository.find_font("Helvetica")
    text_fragment.text_state.font_size = 24

    ellipse1 = ap.drawing.Ellipse(100, 100, 120, 180)
    ellipse1.graph_info.fill_color = ap.Color.green_yellow
    ellipse1.text = text_fragment
    graph.shapes.add(ellipse1)

    ellipse2 = ap.drawing.Ellipse(200, 150, 180, 120)
    ellipse2.graph_info.fill_color = ap.Color.dark_red
    ellipse2.text = text_fragment
    graph.shapes.add(ellipse2)

    page.paragraphs.add(graph)
    document.save(outfile)

Связанные темы графов

Python-Net: Проверка границ фигур в графах PDF с Python

Thu, 16 Apr 2026 00:00:00 +0000

Проверьте границы фигур в Graph

Когда вы добавляете фигуры к Graph, вы можете включить проверку границ, чтобы убедиться, что каждая фигура помещается в область графа.

Используйте BoundsCheckMode для определения поведения, когда фигура выходит за пределы. В этом примере, THROW_EXCEPTION_IF_DOES_NOT_FIT используется для вызова исключения.

Выполните следующие шаги:

Создайте новый PDF Document.
Добавьте Page.
Создайте Graph и добавьте его на страницу.
Создайте Rectangle который выходит за пределы границ графика.
Установите режим проверки границ в THROW_EXCEPTION_IF_DOES_NOT_FIT.
Добавьте прямоугольник и обработайте исключение.
Сохраните документ.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing


def check_shape_bounds(outfile: str):
    document = ap.Document()
    page = document.pages.add()

    graph = drawing.Graph(100, 100)
    graph.top = 10
    graph.left = 15
    graph.border = ap.BorderInfo(ap.BorderSide.BOX, 1, ap.Color.black)
    page.paragraphs.add(graph)

    rect = drawing.Rectangle(-1, 0, 50, 50)
    rect.graph_info.fill_color = ap.Color.tomato

    try:
        graph.shapes.update_bounds_check_mode(
            ap.BoundsCheckMode.THROW_EXCEPTION_IF_DOES_NOT_FIT
        )
        graph.shapes.add(rect)
    except Exception as e:
        print(e)

    document.save(outfile)

Примечания

Используйте THROW_EXCEPTION_IF_DOES_NOT_FIT когда требуется строгая проверка макета.
Для разрешительного поведения выберите другое BoundsCheckMode вариант в зависимости от ваших требований к макету.