Quickstart

Quickstart — Aspose.BarCode FOSS pour Python

Ce guide passe par la génération de codes bars en utilisant les trois symboles les plus courants: Code 128, QR Code et EAN-13. Chaque exemple montre l’API à haut niveau, les options de code par symbologie et les contrôles de rendement.

Créer un code 128 barcode

Code 128 est une symbologie 1D de longueur variable utilisée dans la logistique et le transport. code128() l’assistant accepte une bande de données et optionnelle 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 est optimisé pour les données numériques uniquement - il encode des paires de chiffres comme points de code unique, produisant un code bar plus court.

Créer un code QR

QR Code est une symbologie 2D qui prend en charge la correction d’erreur et les modes de codage multiples. QrOptions contrôle le niveau de correction d’erreur, mode de codage, version et modèle masque:

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())

Niveaux de correction d’erreur : L 7 % de récupération, M (à partir de 15 % ), Q et 25 % ;, H et 30 %).

Créer un code bar EAN-13

EAN-13 est une symbologie 1D de longueur fixe utilisée dans le commerce en détail. Fournir 12 chiffres de charge - la bibliothèque compte automatiquement le 13e numéro d’inspection:

import aspose_barcode_foss as barcode

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

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

Pour fournir votre propre numéro de vérification précomputé (13 chiffres total), allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

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

Customiser le rendu

RenderOptions applique à toutes les symboles et contrôle la sortie visuelle. to_svg() ou 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)

Propriétés disponibles : scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

Utilisez le générique générateur( API)

Le generate() La fonction accepte une ligne de nom symbologique au lieu d’appeler un assistant dédié :

import aspose_barcode_foss as barcode

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

Nom de symbologie : "code128", "code39", "ean13", "ean8", "qr", "upca", "upce".

Gestion des erreurs

Si des données infaillibles ou des options incompatibles sont fournies, la bibliothèque soulève une exception typiquement :

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

Hierarchie exceptionnelle :

Tous les types d’héritage hérités de BarcodeError.

Symbologies soutenues

Formats de sortie : SVG et PNG.

Les prochains pas

• Guide de développeur: Options de codage par symbologie, contrôles de rendement et architecture
• Features: Résumé complet des fonctionnalités avec exemples de code
• Les articles KB:Comment faire des guides et FAQ

See Also

• Aspose.BarCode for Python — Enterprise Documentation