Quickstart

Quickstart Aspose.BarCode FOSS para Python

Este guia percorre a geração de códigos de barras usando as três simbologias mais comuns: Código 128, QR Code e EAN-13. Cada exemplo demonstra o API de alto nível, opções de codificação por simbolização e controles de renderização.

Gerar um código de barras 128

O código 128 é uma simbologia 1D de comprimento variável utilizada na logística e no transporte marítimo. code128() auxiliar aceita uma cadeia de dados e opcional Code128Options:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import Code128Options, Code128EncodeMode

bc = barcode.code128(
    "1234567890",
    encode=Code128Options(encode_mode=Code128EncodeMode.CODE_C),
)
svg = bc.to_svg()

with open("code128.svg", "w") as f:
    f.write(svg)

Code128EncodeMode.CODE_C é otimizado para dados apenas de dígitos codifica pares de digitos como pontos de código único, produzindo um código-barras mais curto.

Gerar um código QR

O QR Code é uma simbologia 2D que suporta a correção de erros e vários modos de codificação. QrOptions Controla o nível de correcção dos erros, modo de codificação, versão e padrão da máscara:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel, QrEncodeMode

bc = barcode.qr(
    "https://example.com/product/12345",
    encode=QrOptions(
        error_correction_level=QrErrorCorrectionLevel.Q,
        encoding_mode=QrEncodeMode.BYTE,
    ),
)

with open("qr.png", "wb") as f:
    f.write(bc.to_png())

Níveis de correcção dos erros: L (recuperação de 7%), M (15%), Q 25%), H (30%).

Gerar um código de barras EAN-13

EAN-13 é uma simbologia 1D de comprimento fixo usada no varejo. Forneça 12 dígitos da carga útil a biblioteca calcula o 13o dígrito automaticamente:

import aspose_barcode_foss as barcode

bc = barcode.ean13("590123412345")
svg = bc.to_svg()

with open("ean13.svg", "w") as f:
    f.write(svg)

Para fornecer o seu próprio dígito de verificação pré-computado (13 díjitos no total), definir allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

bc = barcode.ean13(
    "5901234123457",
    encode=Ean13Options(allow_check_digit_input=True),
)

Personalize a reprodução

RenderOptions Aplica-se a todas as simbologias e controla o resultado visual. Passa para to_svg() ou a) to_png():

import aspose_barcode_foss as barcode
from aspose_barcode_foss import RenderOptions

bc = barcode.upca("01234567890")
png = bc.to_png(options=RenderOptions(
    scale=3.0,
    dpi=300,
    foreground_color="#1a1a1a",
    background_color="#ffffff",
    show_text=True,
    font_family="Courier New",
))

with open("upca.png", "wb") as f:
    f.write(png)

Propriedades disponíveis: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

Utilize a generar API genérica (Generic)

A Comissão generate() função aceita uma cadeia de nomes simbologia em vez de chamar um auxiliar dedicado:

import aspose_barcode_foss as barcode

bc = barcode.generate("code128", "ABC123")
svg = bc.to_svg()

Nome de simbologia válido: "code128", "code39", "ean13", "ean8", "qr", "upca", "upce".

Tratamento de erros

Toda a validação ocorre antes da codificação. Se dados inválidos ou opções incompatíveis forem fornecidos, a biblioteca levantará uma exceção digitada:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import InvalidInputError

try:
    bc = barcode.ean13("ABC")  # EAN-13 requires digits
except InvalidInputError as e:
    print(f"Invalid input: {e}")

Hierarquia de exceções:

Todas as classes de exceção herdam do BarcodeError.

Simbolias apoiadas

Formatos de saída: SVG e PNG.

Pasos seguintes

• Guia de Desenvolvedores:Opções de codificação por simbologia, controles de renderização e arquitetura.
• Features: Visão geral completa das características com exemplos de código
• KB Artigos:Guia de instruções e FAQs

See Also

• Aspose.BarCode for Python — Enterprise Documentation