Schnellstart

Schnellstart — Aspose.BarCode FOSS für Python

Dieses Handbuch führt durch die Erstellung von Barcodes mit den drei gebräuchlichsten Symbolen: Code 128, QR Code und EAN-13. Jedes Beispiel demonstriert die übergeordnete API, die kodierungsbezogenen Optionen pro Symbol und die Rendering-Steuerungen.

Erstelle einen Code 128 Barcode

Code 128 ist eine variabel lange 1D-Symbologie, die in Logistik und Versand verwendet wird. Der code128()-Helper akzeptiert einen Datenstring und optionale 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 ist für ausschließlich numerische Daten optimiert — es codiert Ziffernpaarungen als einzelne Codepunkte und erzeugt damit einen kürzeren Barcode.

Erstelle einen QR Code

QR Code ist eine 2D-Symbologie, die Fehlerkorrektur und mehrere Kodierungsmodi unterstützt. QrOptions steuert das Fehlerkorrektur-Level, den Kodierungsmodus, die Version und das Maskenmuster:

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

Fehlerkorrekturstufen: L (7% Wiederherstellung), M (15%), Q (25%), H (30%).

Generiere einen EAN-13-Barcode

EAN-13 ist eine festgelegte 1D-Symbologie, die im Einzelhandel verwendet wird. Geben Sie 12 Nutzdatenziffern an — die Bibliothek berechnet die 13. Prüfziffer automatisch:

import aspose_barcode_foss as barcode

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

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

Um Ihre eigene vorab berechnete Prüfziffer (insgesamt 13 Ziffern) anzugeben, setzen Sie allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

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

Rendering anpassen

RenderOptions gilt für alle Symbologien und steuert die visuelle Ausgabe. Übergeben Sie es an to_svg() oder 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)

Verfügbare Eigenschaften: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

Verwenden Sie die generische generate() API

Die generate() Funktion akzeptiert einen Symbolnamen-String, anstatt einen dedizierten Helfer aufzurufen:

import aspose_barcode_foss as barcode

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

Gültige Symbolnamen: "code128", "code39", "ean13", "ean8", "qr", "upca", "upce".

Fehlerbehandlung

Alle Validierungen erfolgen vor der Kodierung. Wenn ungültige Daten oder inkompatible Optionen bereitgestellt werden, wirft die Bibliothek eine typisierte Ausnahme:

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

Ausnahmehierarchie:

Alle Ausnahmeklassen erben von BarcodeError.

Unterstützte Symbologien

Ausgabeformate: SVG und PNG.

Nächste Schritte

• Entwicklerhandbuch: Optionen zur Kodierung pro Symbolik, Rendering-Steuerungen und Architektur
• Features: Vollständige Funktionsübersicht mit Codebeispielen
• KB-Artikel: Anleitungen und FAQ

Siehe auch

• Aspose.BarCode for Python — Enterprise Documentation