Quickstart

Inicio de la página: Aspose.BarCode FOSS para Python

Este guía se realiza a través de la generación de códigos de bar con los tres símbolos más comunes: Código 128, Códigos QR y EAN-13. Cada ejemplo demuestra el API de alto nivel, opciones de codificación por símbolo, y controles de rendimiento.

Crea un código de barcode 128

El código 128 es una simbología de longitud variable 1D utilizada en logística y transporte. code128() El asistente acepta una línea de datos y 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 Se optimiza para los datos digitales únicamente: codifica pares de números como puntos de código, produciendo un código de barras más corto.

Generar un código QR

El código QR es una simbología 2D que soporta la corrección de errores y múltiples modos de codificación. QrOptions control de nivel de corrección del error, modo de codificación, versión y patrón de 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())

Nivel de corrección del error: L (el 7% de la recuperación), M El 15 %), Q El 25 %, H El 30 %).

Generar un código de barras EAN-13

EAN-13 es una simbología de longitud fijo 1D utilizada en el retail. suministra 12 dígitos de carga — la biblioteca computa automáticamente el 13o dígado de control:

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 proporcionar su propio número de verificación precomputado (13 dígitos en total), se establece allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

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

Custodificación Rendering

RenderOptions se aplica a todas las simbologías y controla la salida visual. to_svg() o 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)

Propiedades disponibles: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

Utilice el Generate() API generador

El generate() La función acepta una rama de nombre simbológico en lugar de llamar a un ayudante dedicado:

import aspose_barcode_foss as barcode

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

Nombres de la simbología: "code128", "code39", "ean13", "ean8", "qr", "upca", "upce".

Manejo de Errores

Si se proporcionan datos inadecuados o opciones incompatibles, la biblioteca pone una excepción tipificada:

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}")

La hierarquía excepcional:

Todas las clases excepcionales heredadas de BarcodeError.

Simbolos apoyados

Formatos de salida: SVG y PNG.

Siguiente pasos

• Guía de desarrollador: Opciones de codificación per-símbolo, controles de rendimiento y arquitectura
• Features: Revisión completa de la función con ejemplos de código
• Kb Artículos:Cómo hacer guías y FAQ

See Also

• Aspose.BarCode for Python — Enterprise Documentation