Documentation – Trabalhar com Gráficos PDF em Python

Python-Net: Adicionar formas de arco ao PDF em Python

Mon, 18 May 2026 00:00:00 +0000

Adicionar objeto Arc

Aspose.PDF for Python via .NET permite que você adicione Arc formas nas páginas PDF usando o Graph classe. Você pode desenhar arcos contornados e segmentos de arco preenchidos para diagramas e ilustrações técnicas.

Siga os passos abaixo:

Criar Document instância.
Criar Graph object com certas dimensões.
Definir border para o objeto Graph.
Crie um objeto de arco correspondente.
Adicione este objeto à coleção Shapes no objeto graph.
Adicionar Graph objeto à coleção de parágrafos da página.
Salve nosso arquivo PDF.

O trecho de código a seguir mostra como adicionar um Arc objeto.

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)

Criar Objeto de Arco Preenchido

Este exemplo mostra como adicionar um segmento de arco preenchido com cor.

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)

Resultado da adição de um arco preenchido:

Tópicos Relacionados ao Gráfico

Python-Net: Adicionar formas de círculo ao PDF em Python

Mon, 18 May 2026 00:00:00 +0000

Adicionar objeto de círculo

Aspose.PDF for Python via .NET permite que você adicione Circle formas para páginas PDF através do Graph classe. Use círculos para diagramas, anotações e elementos visuais simples.

Siga os passos abaixo:

Criar Document instância.
Criar Graph com certas dimensões.
Definir border para o objeto Graph.
Adicionar Graph objeto à coleção de parágrafos da página.
Salve nosso arquivo 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)

Nosso círculo desenhado ficará assim:

Criar Objeto de Círculo Preenchido

Este exemplo mostra como adicionar um círculo e preenchê‑lo com cor.

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)

Resultado da adição de um círculo preenchido:

Tópicos Relacionados ao Gráfico

Python-Net: Adicionar formas de curva ao PDF em Python

Mon, 18 May 2026 00:00:00 +0000

Adicionar objeto Curve

Aspose.PDF for Python via .NET permite que você adicione Curve formas para páginas PDF através do Graph classe.

Este artigo mostra como criar curvas contornadas e preenchidas.

Siga os passos abaixo:

Criar Document instância.
Criar Graph object com certas dimensões.
Definir border para o objeto Graph.
Adicionar Graph objeto à coleção de parágrafos da página.
Salve nosso arquivo 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)

A imagem a seguir mostra o resultado executado com nosso trecho de código:

Criar Objeto de Curva Preenchida

Este exemplo mostra como adicionar um objeto Curva que está preenchido com cor.

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)

Resultado da adição de uma curva preenchida:

Tópicos Relacionados ao Gráfico

Python-Net: Adicionar formas de linha ao PDF em Python

Mon, 18 May 2026 00:00:00 +0000

Adicionar objeto Line

Aspose.PDF for Python via .NET permite que você adicione Line formas nas páginas PDF usando o Graph classe. Você pode controlar a cor da linha, o padrão de traço e o posicionamento.

Siga os passos abaixo:

Criar Document instância.
Criar um Objeto de Gráfico
Adicionar Graph objeto à coleção de parágrafos da página.
Criar e Configurar a Linha
Adicionar o Line ao Gráfico
Salve nosso arquivo 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)

Como adicionar linha pontilhada tracejada ao seu documento 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)

Resultado da adição de uma linha pontilhada tracejada:

Desenhar Linha Através da Página

Você também pode desenhar linhas através da página para formar uma cruz.

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)

Tópicos Relacionados ao Gráfico

Python-Net: Adicionar formas de retângulo ao PDF em Python

Mon, 18 May 2026 00:00:00 +0000

Adicionar objeto Rectangle

Aspose.PDF for Python via .NET permite que você adicione Rectangle formas para páginas PDF através do Graph classe. Você pode desenhar retângulos contornados e aplicar preenchimentos sólidos, gradientes ou transparentes.

Siga os passos abaixo:

Criar um novo PDF Document.
Adicionar Page para a coleção de páginas do arquivo PDF.
Adicionar TextFragment para a coleção de parágrafos da instância da página.
Criar Graph instância.
Definir borda para Graph objeto.
Adicionar Rectangle objeto para a coleção de formas do objeto Graph.
Adicionar objeto de gráfico à coleção de parágrafos da instância de página.
Adicionar TextFragment para a coleção de parágrafos da instância da página.
E salve seu arquivo 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)

Criar Objeto Retângulo Preenchido

Aspose.PDF for Python via .NET também oferece o recurso de preencher o objeto retângulo com uma certa cor.

O trecho de código a seguir mostra como adicionar um Rectangle objeto que está preenchido com cor.

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)

Resultado do retângulo preenchido com uma cor sólida:

Adicionar Desenho com Preenchimento em Degradê

O Aspose.PDF for Python via .NET oferece o recurso de adicionar objetos de gráfico a documentos PDF e, às vezes, é necessário preencher os objetos de gráfico com Cor em Degradê.

O trecho de código a seguir mostra como adicionar um Rectangle objeto que está preenchido com Cor em Degradê.

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)

Criar Retângulo com Canal de Cor Alfa

Aspose.PDF for Python via .NET também suporta transparência por meio de um canal de cor alfa.

O trecho de código a seguir mostra como adicionar um Rectangle objeto com valores alfa.

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)

Controlar a Ordem Z das formas

Aspose.PDF for .NET suporta o recurso de adicionar objetos gráficos (por exemplo gráfico, linha, retângulo etc.) a documentos PDF. Ao adicionar mais de uma instância do mesmo objeto dentro do arquivo PDF, podemos controlar sua renderização especificando a Ordem Z. A Ordem Z também é usada quando precisamos renderizar objetos um sobre o outro.

O fragmento de código a seguir mostra as etapas para renderizar Rectangle objetos uns sobre os outros.

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)

Tópicos Relacionados ao Gráfico

Python-Net: Adicionar formas de elipse ao PDF em Python

Mon, 18 May 2026 00:00:00 +0000

Adicionar objeto Elipse

Aspose.PDF for Python via .NET permite que você adicione Ellipse formas para páginas PDF com o Graph classe. Você pode desenhar contornos de elipse, aplicar cores de preenchimento e colocar texto dentro de objetos elipse.

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)

Criar Objeto Elipse Preenchida

O trecho de código a seguir mostra como adicionar um Ellipse objeto que está preenchido com cor.

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)

Adicionar texto dentro da elipse

O Aspose.PDF for Python via .NET também permite colocar texto dentro de objetos de forma. O exemplo a seguir adiciona texto a formas de elipse.

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)

Tópicos Relacionados ao Gráfico

Python-Net: Verificar limites de forma em gráficos PDF com Python

Mon, 18 May 2026 00:00:00 +0000

Verificar limites de forma em um Graph

Quando você adiciona formas a um Graph, você pode habilitar a validação de limites para garantir que cada forma caiba na área do gráfico.

Usar BoundsCheckMode para definir o comportamento quando uma forma está fora do intervalo. Neste exemplo, THROW_EXCEPTION_IF_DOES_NOT_FIT é usado para gerar uma exceção.

Siga os passos abaixo:

Criar um novo PDF Document.
Adicionar um Page.
Criar um Graph e adicioná-lo à página.
Criar um Rectangle que se estende fora dos limites do gráfico.
Definir modo de verificação de limites para THROW_EXCEPTION_IF_DOES_NOT_FIT.
Adicione o retângulo e trate a exceção.
Salve o documento.

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)

Observações

Usar THROW_EXCEPTION_IF_DOES_NOT_FIT quando a validação estrita de layout é necessária.
Para comportamento permissivo, escolha outro BoundsCheckMode opção baseada nas suas necessidades de layout.