Incorporar códigos de barras diretamente em arquivos PDF é uma necessidade comum para rastreamento de inventário, bilhetagem e fluxos de trabalho de documentos seguros. Aspose.PDF for Python via .NET fornece um SDK robusto que simplifica a adição de códigos de barras a PDFs em Python. Neste tutorial, você aprenderá como gerar imagens de códigos de barras, posicioná‑las em PDFs existentes e personalizar sua aparência. Ao final, você será capaz de adicionar códigos de barras programaticamente a documentos PDF únicos ou múltiplos com confiança.

Como adicionar código de barras ao PDF em Python - Passo a passo

  1. Instale os pacotes necessários: Use o pip para instalar Aspose.PDF e Aspose.BarCode.
    pip install aspose-pdf
pip install aspose-barcode-for-python-via-net
  2. Gere a imagem do código de barras: Crie um código de barras usando Aspose.BarCode. A imagem gerada pode ser salva em um fluxo de memória.
    from aspose.barcode import generation

Generate the barcode image

generator = generation.BarcodeGenerator(generation.EncodeTypes.CODE39_STANDARD, “1234567”) generator.save(barcode_image, generation.BarCodeImageFormat.PNG)

<!--[CODE_SNIPPET_END]-->
3. **Crie o documento PDF de destino**: Abra o PDF existente com Aspose.PDF.  
<!--[CODE_SNIPPET_START]-->
```python
import aspose.pdf as ap

# Create a new PDF document and add a page
document = ap.Document("input.pdf")
page = document.pages.add()
page.set_page_size(595, 842)
  1. Insira a imagem do código de barras na página desejada: Use um ImageStamp para colocar o código de barras. Ajuste a posição e o tamanho conforme necessário.
    # Add the barcode image at the specified coordinates
page.add_image(barcode_image, ap.Rectangle(100, 650, 300, 750, True))
  2. Salve o PDF atualizado (ou faça loop para processamento em massa): Persista as alterações ou itere sobre vários PDFs para adicionar códigos de barras em lote ao PDF em Python.
    document.save(output_pdf)

Incorporando Código de Barras em PDF com Python - Exemplo de Código Completo

O exemplo a seguir demonstra um fluxo de trabalho completo que gera um código de barras, o incorpora em um PDF existente e salva o resultado.

import aspose.pdf as ap
from aspose.barcode import generation

def add_barcode_to_new_pdf(output_pdf, barcode_image):
    # Generate the barcode image
    generator = generation.BarcodeGenerator(generation.EncodeTypes.CODE39_STANDARD, "1234567")
    generator.save(barcode_image, generation.BarCodeImageFormat.PNG)

# Create a new PDF document and add a page
    document = ap.Document()
    page = document.pages.add()
    page.set_page_size(595, 842)

# Add the barcode image at the specified coordinates
    page.add_image(barcode_image, ap.Rectangle(100, 650, 300, 750, True))

# Save the resulting PDF document
    document.save(output_pdf)

if __name__ == "__main__":
    add_barcode_to_new_pdf("AddBarcodeToNewPDF.pdf", "barcode.png")

Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar os caminhos dos arquivos para corresponder aos locais reais dos seus arquivos, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Aspose.PDF for Python via .NET - Pré-requisitos e Configuração

Para começar a usar o SDK, certifique‑se de que você tem o Python 3.6+ e o runtime .NET instalados. Em seguida, instale os pacotes via pip:

pip install aspose-pdf aspose-barcode

Você também pode baixar os binários mais recentes na página de download. Não é necessário código de licença adicional para avaliação, mas uma licença válida é necessária para uso em produção (veja a página de licença temporária e a página de preços).

Ler código de barras de documento PDF usando Python

Podemos reconhecer qualquer imagem de código de barras incorporada em qualquer uma das páginas do documento PDF usando a coleção resources.images de uma page. Isso permite extrair imagens do PDF e, em seguida, ler as informações do código de barras a partir da imagem extraída. Podemos ler códigos de barras dos documentos PDF seguindo os passos descritos abaixo:

  1. Primeiro, carregue o documento PDF de entrada usando a classe Document.
  2. Em seguida, selecione a página de destino e obtenha sua coleção resources.images.
  3. Então, salve cada imagem incorporada em um arquivo em um loop.
  4. Em seguida, crie uma instância da classe BarCodeReader com o caminho da imagem e DecodeType como argumentos.
  5. Depois disso, chame o método read_bar_codes() para obter os resultados do reconhecimento.
  6. Finalmente, percorra os resultados e exiba as informações do código de barras.

O exemplo de código a seguir demonstra como ler uma imagem de código de barras de um documento PDF usando Python.

import aspose.pdf as ap
from aspose.barcode import recognition
from io import FileIO

def read_barcode_from_pdf(input_pdf, extracted_image):
    # Load the input PDF document
    document = ap.Document(input_pdf)
    page = document.pages[1]

# Extract the first image from the page resources
    x_image = page.resources.images[1]
    with FileIO(extracted_image, "wb") as image_stream:
        x_image.save(image_stream)

# Read the barcode from the extracted image
    reader = recognition.BarCodeReader(extracted_image, recognition.DecodeType.CODE39_STANDARD)
    for result in reader.read_bar_codes():
        print(f"Codetext found: {result.code_text}")
        print(f"Symbology: {result.code_type_name}")

if __name__ == "__main__":
    read_barcode_from_pdf("AddBarcodeToExistingPDF.pdf", "extracted_barcode.png")

Codetext found: 1234567
Symbology: Code39Standard

Conclusão

Adicionar um código de barras a um PDF em Python torna‑se simples com Aspose.PDF for Python via .NET. Os recursos poderosos de manipulação de PDF do SDK combinados com a geração de códigos de barras do Aspose.BarCode permitem que você implemente um fluxo completo de adição de código de barras ao PDF em apenas algumas linhas de código. Seja atualizando um único documento ou realizando a adição em massa de códigos de barras ao PDF em Python para grandes lotes, a biblioteca oferece o desempenho e a flexibilidade de que você precisa. Lembre‑se de adquirir uma licença adequada para uso em produção; você pode explorar as opções de preços acessíveis na página de preços ou obter uma licença de avaliação temporária na página de licença temporária.

Perguntas Frequentes

  • Como adiciono um código de barras a um PDF existente em Python?
    Use Aspose.PDF para carregar o PDF, gerar o código de barras com Aspose.BarCode e incorporá‑lo usando um add_image(). O processo completo é ilustrado no exemplo de código acima.

  • Qual é a abordagem recomendada para adicionar em massa códigos de barras a PDF em Python?
    Percorra sua coleção de PDFs, reutilize um único BarcodeGenerator e trabalhe com streams. Aplique as dicas de desempenho da seção “Considerações de Desempenho” para manter o uso de memória baixo.

  • Existe uma maneira de personalizar o tamanho e a posição do código de barras programaticamente?
    Com certeza. Ajuste as propriedades width, height, x, y e rotation do barcode.

Leia Mais