Documentation – 在 Python 中使用 PDF 图形

Python-Net: 在 Python 中向 PDF 添加弧形

Mon, 08 Jun 2026 00:00:00 +0000

添加 Arc 对象

Aspose.PDF for Python via .NET 允许您添加弧形状到 PDF 页面，使用 Graph 类。您可以绘制带轮廓的弧形和填充的弧形段，用于图表和技术插图。

请按照以下步骤：

创建文档实例。
创建 Graph 对象具有特定尺寸。
设置边框针对 Graph 对象。
创建对应的弧对象。
将此对象添加到图形对象的 Shapes 集合中。
添加 Graph 对象添加到页面的 paragraphs 集合。
保存我们的 PDF 文件。

以下代码片段展示了如何添加 a。弧对象。

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: 在 Python 中向 PDF 添加圆形形状

Mon, 08 Jun 2026 00:00:00 +0000

添加圆形对象

Aspose.PDF for Python via .NET 允许您添加圆形通过该方式将形状添加到 PDF 页面 Graph 类。使用圆形用于图表、批注和简单的可视元素。

请按照以下步骤：

创建文档实例。
创建 Graph 对象具有特定尺寸。
设置边框针对 Graph 对象。
添加 Graph 对象添加到页面的 paragraphs 集合。
保存我们的 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: 在 Python 中向 PDF 添加曲线形状

Mon, 08 Jun 2026 00:00:00 +0000

添加曲线对象

Aspose.PDF for Python via .NET 允许您添加曲线通过该方式将形状添加到 PDF 页面 Graph 类。

本文展示了如何创建带轮廓和填充的曲线。

请按照以下步骤：

创建文档实例。
创建 Graph 对象具有特定尺寸。
设置边框针对 Graph 对象。
添加 Graph 对象添加到页面的 paragraphs 集合。
保存我们的 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: 在 Python 中向 PDF 添加线形状

Mon, 08 Jun 2026 00:00:00 +0000

添加线对象

Aspose.PDF for Python via .NET 允许您添加线形状到 PDF 页面，使用 Graph 类。您可以控制线的颜色、虚线模式和位置。

请按照以下步骤：

创建文档实例。
创建图形对象
添加 Graph 对象添加到页面的 paragraphs 集合。
创建并配置线条
添加线到图形
保存我们的 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: 在 Python 中向 PDF 添加矩形形状

Mon, 08 Jun 2026 00:00:00 +0000

添加 Rectangle 对象

Aspose.PDF for Python via .NET 允许您添加矩形通过该方式将形状添加到 PDF 页面 Graph 类。您可以绘制带轮廓的矩形并应用实色、渐变或透明填充。

请按照以下步骤：

创建一个新的 PDF 文档.
添加页面到 PDF 文件的 pages 集合。
添加文本片段到页面实例的段落集合。
创建 Graph 实例。
设置边框 Graph 对象.
添加矩形对象到 Graph 对象的形状集合。
将图形对象添加到页面实例的段落集合中。
添加文本片段到页面实例的段落集合。
并保存您的 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 还提供了用特定颜色填充矩形对象的功能。

以下代码片段展示了如何添加 a。矩形被颜色填充的对象。

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 文档添加图形对象的功能，有时需要用渐变颜色填充图形对象。

以下代码片段展示了如何添加 a。矩形填充了渐变颜色的对象。

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)

创建带 Alpha 颜色通道的矩形

Aspose.PDF for Python via .NET 也支持通过 Alpha 颜色通道实现透明度。

以下代码片段展示了如何添加 a。矩形带有 Alpha 值的对象。

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 还用于需要将对象相互叠加渲染的情况。

以下代码片段展示了渲染的步骤矩形相互叠加的对象。

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: 在 Python 中向 PDF 添加椭圆形状

Mon, 08 Jun 2026 00:00:00 +0000

添加 Ellipse 对象

Aspose.PDF for Python via .NET 允许您添加 Ellipse 使用 the 将形状添加到 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)

创建填充椭圆对象

以下代码片段展示了如何添加 a。 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: 使用 Python 检查 PDF 图形中的形状边界

Mon, 08 Jun 2026 00:00:00 +0000

检查图形中的形状边界

当您向 a 添加形状时 Graph，您可以启用边界验证，以确保每个形状都适合图形区域。

使用 BoundsCheckMode 定义形状超出范围时的行为。在本例中， THROW_EXCEPTION_IF_DOES_NOT_FIT 用于引发异常。

请按照以下步骤：

创建一个新的 PDF 文档.
添加一个页面.
创建一个 Graph 并将其添加到页面。
创建一个矩形其超出图形边界。
将边界检查模式设置为 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 基于您的布局需求的选项。

Documentation – 在 Python 中使用 PDF 图形

Python-Net: 在 Python 中向 PDF 添加弧形

添加 Arc 对象

创建填充弧形对象

相关图形主题

Python-Net: 在 Python 中向 PDF 添加圆形形状

添加圆形对象

创建填充圆对象

相关图形主题

Python-Net: 在 Python 中向 PDF 添加曲线形状

添加曲线对象

创建填充曲线对象

相关图形主题

Python-Net: 在 Python 中向 PDF 添加线形状

添加线对象

如何在 PDF 文档中添加点划线

在页面上绘制线条

相关图形主题

Python-Net: 在 Python 中向 PDF 添加矩形形状

添加 Rectangle 对象

创建填充矩形对象

添加带渐变填充的绘图

创建带 Alpha 颜色通道的矩形

控制形状的 Z-Order

相关图形主题

Python-Net: 在 Python 中向 PDF 添加椭圆形状

添加 Ellipse 对象

创建填充椭圆对象

在椭圆内添加文本

相关图形主题

Python-Net: 使用 Python 检查 PDF 图形中的形状边界

检查图形中的形状边界

备注

相关图形主题