Documentation – Trabajar con gráficos PDF en Python

Python-Net: Agregar formas de arco a PDF en Python

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

Agregar objeto Arc

Aspose.PDF for Python via .NET le permite agregar Arco formas a páginas PDF usando el Graph clase. Puede dibujar arcos contorneados y segmentos de arco rellenos para diagramas e ilustraciones técnicas.

Siga los pasos a continuación:

Crear Documento instancia.
Crear Objeto de gráfico con ciertas dimensiones.
Establecer borde para el objeto Graph.
Cree un objeto arco correspondiente.
Agregue este objeto a la colección Shapes del objeto graph.
Agregar Graph objeto a la colección de párrafos de la página.
Guarde nuestro archivo PDF.

El siguiente fragmento de código muestra cómo agregar un Arco 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)

Crear objeto de arco relleno

Este ejemplo muestra cómo agregar un segmento de arco relleno de color.

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 de agregar un arco relleno:

Temas relacionados con gráficos

Python-Net: Agregar formas de círculo a PDF en Python

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

Agregar objeto círculo

Aspose.PDF for Python via .NET le permite agregar Círculo formas a páginas PDF a través del Graph clase. Utiliza círculos para diagramas, anotaciones y elementos visuales simples.

Siga los pasos a continuación:

Crear Documento instancia.
Crear Objeto de gráfico con ciertas dimensiones.
Establecer borde para el objeto Graph.
Agregar Graph objeto a la colección de párrafos de la página.
Guarde nuestro archivo 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)

Nuestro círculo dibujado se verá así:

Crear objeto de círculo relleno

Este ejemplo muestra cómo agregar un círculo y rellenarlo con color.

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 de agregar un círculo relleno:

Temas relacionados con gráficos

Python-Net: Agregar formas de curva a PDF en Python

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

Agregar objeto de curva

Aspose.PDF for Python via .NET le permite agregar Curva formas a páginas PDF a través del Graph clase.

Este artículo muestra cómo crear curvas con contorno y rellenas.

Siga los pasos a continuación:

Crear Documento instancia.
Crear Objeto de gráfico con ciertas dimensiones.
Establecer borde para el objeto Graph.
Agregar Graph objeto a la colección de párrafos de la página.
Guarde nuestro archivo 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)

La siguiente imagen muestra el resultado ejecutado con nuestro fragmento de código:

Crear objeto de Curva rellena

Este ejemplo muestra cómo agregar un objeto de Curva que está relleno de color.

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 de añadir una curva rellena:

Temas relacionados con gráficos

Python-Net: Agregar formas de línea al PDF en Python

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

Agregar objeto Line

Aspose.PDF for Python via .NET le permite agregar Línea formas a páginas PDF usando el Graph clase. Puede controlar el color de la línea, el patrón de guiones y la ubicación.

Siga los pasos a continuación:

Crear Documento instancia.
Crear un objeto de gráfico
Agregar Graph objeto a la colección de párrafos de la página.
Crear y configurar la línea
Agregar el Línea al gráfico
Guarde nuestro archivo 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)

Cómo agregar una línea punteada y discontinua a su 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 de agregar una línea punteada y discontinua:

Dibujar línea a través de la página

También puedes dibujar líneas a través de la página para formar una 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)

Temas relacionados con gráficos

Python-Net: Agregar formas de rectángulo a PDF en Python

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

Agregar objeto Rectangle

Aspose.PDF for Python via .NET le permite agregar Rectángulo formas a páginas PDF a través del Graph clase. Puede dibujar rectángulos contorneados y aplicar rellenos sólidos, degradados o transparentes.

Siga los pasos a continuación:

Crea un nuevo PDF Documento.
Agregar Página a la colección de páginas del archivo PDF.
Agregar Fragmento de texto a la colección de párrafos de la instancia de página.
Crear Graph instancia.
Establecer borde para Objeto de gráfico.
Agregar Rectángulo objeto a la colección de shapes del objeto Graph.
Agregar objeto gráfico a la colección de párrafos de la instancia de página.
Agregar Fragmento de texto a la colección de párrafos de la instancia de página.
Y guarde su archivo 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)

Crear objeto de rectángulo relleno

Aspose.PDF for Python via .NET también ofrece la funcionalidad de rellenar el objeto de rectángulo con un color determinado.

El siguiente fragmento de código muestra cómo agregar un Rectángulo objeto que está relleno de color.

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 del rectángulo rellenado con un color sólido:

Agregar dibujo con relleno degradado

Aspose.PDF for Python via .NET admite la función de agregar objetos de gráfico a documentos PDF y, a veces, es necesario rellenar los objetos de gráfico con Color degradado.

El siguiente fragmento de código muestra cómo agregar un Rectángulo objeto que está rellenado con Color degradado.

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)

Crear rectángulo con canal de color alfa

Aspose.PDF for Python via .NET también admite la transparencia a través de un canal de color alfa.

El siguiente fragmento de código muestra cómo agregar un Rectángulo objeto con 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 Z-Order de las formas

Aspose.PDF for .NET admite la función de agregar objetos gráficos (por ejemplo gráfico, línea, rectángulo, etc.) a documentos PDF. Al agregar más de una instancia del mismo objeto dentro del archivo PDF, podemos controlar su renderizado especificando el Z-Order. Z-Order también se utiliza cuando necesitamos renderizar objetos uno encima del otro.

El siguiente fragmento de código muestra los pasos para renderizar Rectángulo objetos uno encima del otro.

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)

Temas relacionados con gráficos

Python-Net: Agregar formas de elipse a PDF en Python

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

Agregar objeto Ellipse

Aspose.PDF for Python via .NET le permite agregar Elipse formas a páginas PDF con el Graph clase. Puedes dibujar contornos de elipse, aplicar colores de relleno y colocar texto dentro de los 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)

Crear objeto elipse relleno

El siguiente fragmento de código muestra cómo agregar un Elipse objeto que está relleno de color.

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)

Agregar texto dentro de la elipse

Aspose.PDF for Python via .NET también te permite colocar texto dentro de objetos de forma. El siguiente ejemplo agrega texto a las 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)

Temas relacionados con gráficos

Python-Net: Comprobar límites de forma en gráficos PDF con Python

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

Comprobar límites de forma en un Graph

Cuando agregas formas a un Graph, puedes habilitar la validación de límites para asegurar que cada forma encaje dentro del área del gráfico.

Usar BoundsCheckMode para definir el comportamiento cuando una forma está fuera de rango. En este ejemplo, THROW_EXCEPTION_IF_DOES_NOT_FIT se usa para generar una excepción.

Siga los pasos a continuación:

Crea un nuevo PDF Documento.
Añadir un Página.
Cree un Graph y añádelo a la página.
Cree un Rectángulo que se extiende fuera de los límites del gráfico.
Establecer modo de verificación de límites a THROW_EXCEPTION_IF_DOES_NOT_FIT.
Agregue el rectángulo y maneje la excepción.
Guarde el 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)

Notas

Usar THROW_EXCEPTION_IF_DOES_NOT_FIT cuando se requiere una validación estricta del diseño.
Para un comportamiento permisivo, elige otro BoundsCheckMode opción basada en sus necesidades de diseño.