Häufig gestellte Fragen

Häufig gestellte Fragen

Lizenzierung & Open Source

Welche Lizenz verwendet Aspose.BarCode FOSS für Python?

Aspose.BarCode FOSS für Python wird unter der MIT-Lizenz veröffentlicht. Der vollständige Lizenztext ist in der LICENSE-Datei enthalten, die mit dem Paket verteilt wird. Sie dürfen die Bibliothek sowohl in Open-Source- als auch in proprietären Projekten verwenden, modifizieren und weiterverbreiten.

Kann ich Aspose.BarCode FOSS in kommerziellen Produkten verwenden?

Ja. Die MIT-Lizenz erlaubt kommerzielle Nutzung ohne Lizenzgebühren oder Attributionspflichten, außer dem Einfügen des ursprünglichen Lizenzhinweises. Sie müssen Ihre Anwendung nicht als Open Source veröffentlichen.


Installation & Anforderungen

Wie installiere ich Aspose.BarCode FOSS für Python?

Installieren Sie es mit dem untenstehenden Befehl:

git clone https://github.com/aspose-barcode-foss/Aspose.BarCode-FOSS-for-Python.git
cd Aspose.BarCode-FOSS-for-Python
pip install -e .

Die Bibliothek erfordert Python 3.12 oder höher.

Sind native Abhängigkeiten oder Systempakete erforderlich?

Nein. Aspose.BarCode FOSS für Python ist ein reines Python-Paket. Es hat keine nativen Erweiterungen, keine C-Abhängigkeiten und keine systemweiten Pakete zu installieren. Es läuft unter Windows, macOS und Linux — einschließlich schlanker Docker-Images wie python:3.12-slim.


Symbologie-Unterstützung

Welche Barcode-Symbologien werden unterstützt?

Die Bibliothek unterstützt sieben Symbologien:

SymbologyTypOptions-Klasse
Code 1281DCode128Options
Code 391DCode39Options
EAN-131DEan13Options
EAN-81DEan8Options
QR Code2DQrOptions
UPC-A1DUpcaOptions
UPC-E1DUpceOptions

Jede Symbolik hat eine dedizierte Hilfsfunktion (code128(), code39(), ean13(), ean8(), qr(), upca(), upce()) und eine generische generate()-Funktion, die einen Symboliknamen-String akzeptiert.

Welche Ausgabeformate sind verfügbar?

Die Bibliothek rendert Barcodes als SVG und PNG:

  • to_svg() — gibt einen SVG-String zurück
  • to_png() — gibt PNG-Bytes zurück

Beide Methoden akzeptieren einen optionalen RenderOptions-Parameter zur Steuerung von Skalierung, DPI, Farben, Quiet-Zone und menschenlesbarem Text.


API Usage

Wie erstelle ich einen Barcode?

Verwenden Sie eine pro-Symbologie-Hilfsfunktion:

import aspose_barcode_foss as barcode

bc = barcode.code128("Hello World")
svg = bc.to_svg()

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

Oder verwenden Sie die generische generate()-Funktion:

bc = barcode.generate("qr", "https://example.com")

Wie konfiguriere ich die Encode-Optionen?

Jede Symbologie hat eine eigene Optionsklasse. Übergeben Sie sie als encode-Parameter:

from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel

bc = barcode.qr(
    "https://example.com",
    encode=QrOptions(error_correction_level=QrErrorCorrectionLevel.H),
)

Wie kann ich das visuelle Erscheinungsbild des Barcodes steuern?

Verwenden Sie RenderOptions mit to_svg() oder to_png():

from aspose_barcode_foss import RenderOptions

bc = barcode.code128("DATA")
png = bc.to_png(options=RenderOptions(
    scale=3.0,
    dpi=300,
    foreground_color="#003366",
    show_text=True,
))

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

Wie behandelt die Bibliothek Prüfziffern für EAN- und UPC-Barcodes?

Standardmäßig berechnet die Bibliothek die Prüfziffer automatisch. Geben Sie nur die Nutzdatenziffern an (12 für EAN-13, 7 für EAN-8, 11 für UPC-A):

bc = barcode.ean13("590123412345")  # 12 digits — check digit computed

Um eine vorkalkulierte Prüfziffer anzugeben, setzen Sie allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

bc = barcode.ean13(
    "5901234123457",  # 13 digits with check digit
    encode=Ean13Options(allow_check_digit_input=True),
)

Bekannte Einschränkungen

Wird PDF-Ausgabe unterstützt?

Nein. Die Methode to_pdf() und die Klasse PdfRenderer existieren in der API-Oberfläche, werfen jedoch NotImplementedError. Verwenden Sie stattdessen to_svg() oder to_png(). SVG-Ausgabe kann mithilfe externer Werkzeuge in PDF-Dokumente eingebettet werden.

Werden die Standards ECI und GS1 unterstützt?

Noch nicht. Die Klassen EciHelper und Gs1Helper besitzen Methoden-Stubs, die NotImplementedError auslösen. Die Eigenschaften eci_assignment_number und gs1_enabled auf EncodeOptions sind vorhanden, funktionieren jedoch in der aktuellen Version nicht.

Kann die Bibliothek Barcodes lesen oder scannen?

Nr. Aspose.BarCode FOSS für Python ist eine rein generierende Bibliothek. Sie erzeugt Barcodes aus Daten, beinhaltet jedoch keine Barcode-Erkennung oder Scan-Funktionen.

Siehe auch

 Deutsch