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:
| Symbology | Typ | Options-Klasse |
|---|---|---|
| Code 128 | 1D | Code128Options |
| Code 39 | 1D | Code39Options |
| EAN-13 | 1D | Ean13Options |
| EAN-8 | 1D | Ean8Options |
| QR Code | 2D | QrOptions |
| UPC-A | 1D | UpcaOptions |
| UPC-E | 1D | UpceOptions |
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ückto_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 computedUm 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.