Documentation – Anotações de desenho

Python-Net: Adicionar Anotação de Círculo

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

Anotações de círculo são úteis para destacar áreas de interesse em um documento PDF. Com PdfContentEditor, você pode criar formas circulares especificando o retângulo que define os limites do círculo, juntamente com o texto da anotação, cor, opções de preenchimento, número da página e largura da borda.

Crie o objeto PdfContentEditor.
Vincular o PDF de entrada.
Defina os limites do círculo.
Adicione a anotação de círculo.
Salvar o Document atualizado.

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: Adicionar Anotação de Curva

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

Anotações de curva são usadas para destacar caminhos ou formas irregulares em um PDF, proporcionando ênfase visual ou marcando áreas importantes. Usando PdfContentEditor, você pode desenhar curvas especificando uma sequência de vértices, estilo de borda, visibilidade, retângulo da anotação e texto descritivo.

Crie o objeto PdfContentEditor.
Vincular o PDF onput.
Configure as propriedades da Curve.
Desenhe a anotação Curve.
Salvar o Document atualizado.

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: Adicionar Anotação de Linha

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

Anotações de linha são úteis para enfatizar texto, destacar relacionamentos ou chamar a atenção para áreas específicas em um PDF. Com PdfContentEditor, você pode criar programaticamente anotações de linha especificando os pontos inicial e final, o retângulo delimitador, a cor, o estilo da borda e as pontas da linha.

Crie o objeto PdfContentEditor.
Vincular o PDF de entrada.
Defina as propriedades da Anotação de Linha.
Adicione a anotação de Linha.
Salvar o Document atualizado.

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: Adicionar Anotação de Polígono

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

Anotações de polígonos são usadas para destacar áreas ou formas irregulares em um PDF, proporcionando ênfase visual ou marcando regiões específicas. Usando PdfContentEditor, você pode criar polígonos especificando as coordenadas dos vértices, o estilo da borda, o número da página e o retângulo da anotação.

Crie o objeto PdfContentEditor.
Vincular o PDF de entrada.
Configure as propriedades do Polígono.
Adicione a anotação de Polígono.
Salvar o Document atualizado.

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: Adicionar Anotação de Polilinha

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

Anotações de polilinha permitem que você destaque uma série de segmentos de linha conectados em um PDF. Usando PdfContentEditor, você pode desenhar uma polilinha especificando as coordenadas dos vértices, o estilo da borda, o número da página e os limites da anotação. Isso é útil para representar visualmente caminhos, tendências ou conexões em diagramas e documentos.

Crie o objeto PdfContentEditor.
Vincular o PDF de entrada.
Configurar propriedades da Polilinha.
Adicionar a anotação de Polilinha.
Salvar o Document atualizado.

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: Adicionar Anotação Quadrada

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

Anotações quadradas são comumente usadas para destacar áreas de interesse, marcar seções importantes ou fornecer pistas visuais em um documento PDF. Usando PdfContentEditor, você pode criar anotações quadradas (ou circulares) especificando o retângulo delimitador, o texto de conteúdo, a cor da borda, a opção de preenchimento, o número da página e a espessura da borda.

Crie o objeto PdfContentEditor.
Vincular o PDF de entrada.
Defina a anotação Square.
Adicione a anotação Square.
Salvar o Document atualizado.

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)