Documentation – Anotaciones de dibujo

Python-Net: Agregar anotación de círculo

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

Las anotaciones de círculo son útiles para resaltar áreas de interés en un documento PDF. Con PdfContentEditor, puedes crear formas circulares especificando el rectángulo que define los límites del círculo, junto con el texto de la anotación, el color, las opciones de relleno, el número de página y el ancho del borde.

Crea el objeto PdfContentEditor.
Vincular el PDF de entrada.
Definir los límites del círculo.
Agregar la anotación de círculo.
Guardar el documento actualizado.

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: Agregar anotación de curva

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

Las anotaciones de curva se utilizan para resaltar rutas o formas irregulares en un PDF, proporcionando énfasis visual o señalando áreas importantes. Usando PdfContentEditor, puedes dibujar curvas especificando una secuencia de vértices, estilo de borde, visibilidad, rectángulo de anotación y texto descriptivo.

Crea el objeto PdfContentEditor.
Vincular el PDF onput.
Configure las propiedades de la Curve.
Dibuje la anotación de la Curve.
Guardar el documento actualizado.

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: Agregar anotación de línea

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

Las anotaciones de línea son útiles para enfatizar texto, resaltar relaciones o llamar la atención sobre áreas específicas en un PDF. Con PdfContentEditor, puedes crear programáticamente anotaciones de línea especificando los puntos de inicio y fin, el rectángulo delimitador, el color, el estilo de borde y las terminaciones de línea.

Crear el objeto PdfContentEditor.
Vincular el PDF de entrada.
Definir propiedades de la anotación de línea.
Agregar la anotación de línea.
Guarda el Documento actualizado.

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: Agregar anotación de polígono

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

Las anotaciones de polígono se utilizan para resaltar áreas o formas irregulares en un PDF, proporcionando énfasis visual o marcando regiones específicas. Usando PdfContentEditor, puedes crear polígonos especificando las coordenadas de los vértices, el estilo del borde, el número de página y el rectángulo de la anotación.

Crea el objeto PdfContentEditor.
Vincular el PDF de entrada.
Configura las propiedades del polígono.
Añade la anotación Polygon.
Guardar el documento actualizado.

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: Agregar anotación de polilínea

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

Las anotaciones de polilínea le permiten resaltar una serie de segmentos de línea conectados en un PDF. Usando PdfContentEditor, puede dibujar una polilínea especificando las coordenadas de los vértices, el estilo de borde, el número de página y los límites de la anotación. Esto es útil para representar visualmente rutas, tendencias o conexiones en diagramas y documentos.

Crear el objeto PdfContentEditor.
Vincular el PDF de entrada.
Configure las propiedades de la polilínea.
Agregue la anotación de polilínea.
Guarda el Documento actualizado.

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: Agregar anotación cuadrada

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

Las anotaciones cuadradas se usan comúnmente para resaltar áreas de interés, marcar secciones importantes o proporcionar indicaciones visuales en un documento PDF. Usando PdfContentEditor, puedes crear anotaciones cuadradas (o circulares) especificando el rectángulo delimitador, el texto de contenido, el color del borde, la opción de relleno, el número de página y el ancho del borde.

Crear el objeto PdfContentEditor.
Vincular el PDF de entrada.
Definir la anotación Square.
Agregar la anotación Square.
Guarda el Documento actualizado.

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)