Veelgestelde vragen
Licenties & Open source
Welke licentie gebruikt Aspose.BarCode FOSS voor Python?
Aspose.BarCode FOSS voor Python wordt uitgebracht onder de MIT License. De volledige licentietekst is opgenomen in het LICENSE-bestand dat met het pakket wordt verspreid. Je bent vrij om de bibliotheek te gebruiken, te wijzigen en te herdistribueren in zowel open-source als propriëtaire projecten.
Kan ik Aspose.BarCode FOSS gebruiken in commerciële producten?
Ja. De MIT License staat commercieel gebruik toe zonder royalty’s of attributieverplichtingen, behalve het opnemen van de oorspronkelijke licentieverklaring. Je hoeft je toepassing niet open source te maken.
Installatie & vereisten
Hoe installeer ik Aspose.BarCode FOSS voor Python?
Installeer het met het onderstaande commando:
git clone https://github.com/aspose-barcode-foss/Aspose.BarCode-FOSS-for-Python.git
cd Aspose.BarCode-FOSS-for-Python
pip install -e .De bibliotheek vereist Python 3.12 of hoger.
Zijn er native afhankelijkheden of systeempakketten vereist?
Nee. Aspose.BarCode FOSS voor Python is een zuiver-Python pakket. Het heeft geen native extensies, geen C-afhankelijkheden en geen systeem-pakketten die geïnstalleerd moeten worden. Het werkt op Windows, macOS en Linux — inclusief slanke Docker-images zoals python:3.12-slim.
Symbologieondersteuning
Welke barcode-symbologieën worden ondersteund?
De bibliotheek ondersteunt zeven symbologieën:
| Symbology | Type | Optiesklasse |
|---|---|---|
| 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 |
Elke symbologie heeft een toegewijde hulpfunctie (code128(), code39(), ean13(), ean8(), qr(), upca(), upce()) en een generieke generate() functie die een symbologie-naamstring accepteert.
Welke uitvoerformaten zijn beschikbaar?
De bibliotheek rendert barcodes naar SVG en PNG:
to_svg()— retourneert een SVG-stringto_png()— retourneert PNG-bytes
Beide methoden accepteren een optionele RenderOptions parameter voor het regelen van schaal, DPI, kleuren, stille zone en leesbare tekst.
API Usage
Hoe genereer ik een barcode?
Gebruik een per-symbologie hulpfunctie:
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)Of gebruik de algemene generate() functie:
bc = barcode.generate("qr", "https://example.com")Hoe configureer ik encode-opties?
Elke symbologie heeft een eigen opties-klasse. Geef deze door als de encode parameter:
from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel
bc = barcode.qr(
"https://example.com",
encode=QrOptions(error_correction_level=QrErrorCorrectionLevel.H),
)Hoe beheer ik het visuele uiterlijk van de barcode?
Gebruik RenderOptions met to_svg() of 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,
))Beschikbare eigenschappen: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.
Hoe behandelt de bibliotheek controlecijfers voor EAN- en UPC-barcodes?
Standaard berekent de bibliotheek het controlecijfer automatisch. Geef alleen de payloadcijfers op (12 voor EAN-13, 7 voor EAN-8, 11 voor UPC-A):
bc = barcode.ean13("590123412345") # 12 digits — check digit computedOm een vooraf berekend controlecijfer op te geven, stel allow_check_digit_input=True in:
from aspose_barcode_foss import Ean13Options
bc = barcode.ean13(
"5901234123457", # 13 digits with check digit
encode=Ean13Options(allow_check_digit_input=True),
)Bekende beperkingen
Wordt PDF-uitvoer ondersteund?
Nee. De to_pdf() methode en PdfRenderer klasse bestaan in de API laag maar geven NotImplementedError terug. Gebruik to_svg() of to_png() in plaats daarvan. SVG-uitvoer kan in PDF-documenten worden ingebed met externe tools.
Worden ECI- en GS1-normen ondersteund?
Nog niet. De EciHelper en Gs1Helper klassen hebben methode-stubs die NotImplementedError veroorzaken. De eci_assignment_number en gs1_enabled eigenschappen op EncodeOptions zijn aanwezig maar niet functioneel in de huidige release.
Kan de bibliotheek barcodes lezen of scannen?
Nr. Aspose.BarCode FOSS voor Python is een alleen-generatie bibliotheek. Het maakt barcodes van data, maar bevat geen barcodeherkenning of scanmogelijkheden.