Často kladené otázky
Licencování & Open Source
Jaká licence používá Aspose.BarCode FOSS pro Python?
Aspose.BarCode FOSS pro Python je vydán pod licencí MIT License. Úplný text licence je zahrnut v souboru LICENSE distribuovaném s balíčkem. Můžete knihovnu používat, upravovat a redistribuovat jak v open-source, tak v proprietárních projektech.
Mohu použít Aspose.BarCode FOSS v komerčních produktech?
Ano. Licence MIT umožňuje komerční použití bez poplatků ani požadavků na uvedení autorství, kromě zahrnutí původního licenčního oznámení. Nemusíte svou aplikaci zveřejňovat jako open source.
Instalace & Požadavky
Jak nainstaluji Aspose.BarCode FOSS pro Python?
Nainstalujte jej pomocí následujícího příkazu:
git clone https://github.com/aspose-barcode-foss/Aspose.BarCode-FOSS-for-Python.git
cd Aspose.BarCode-FOSS-for-Python
pip install -e .Knihovna vyžaduje Python 3.12 nebo novější.
Jsou vyžadovány nějaké nativní závislosti nebo systémové balíčky?
Ne. Aspose.BarCode FOSS pro Python je čistý Python balíček. Nemá žádná nativní rozšíření, žádné C závislosti a nevyžaduje žádné systémové balíčky k instalaci. Funguje na Windows, macOS a Linuxu — včetně odlehčených Docker images, jako je python:3.12-slim.
Podpora symbologie
Jaké symbologie čárových kódů jsou podporovány?
Knihovna podporuje sedm symbologií:
| Symbology | Typ: | Třída Options |
|---|---|---|
| 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 |
Každá symbologie má dedikovanou pomocnou funkci (code128(), code39(), ean13(), ean8(), qr(), upca(), upce()) a obecnou funkci generate(), která přijímá řetězec se jménem symbologie.
Jaké výstupní formáty jsou k dispozici?
Knihovna vykresluje čárové kódy do SVG a PNG:
to_svg()— vrací řetězec SVGto_png()— vrací bajty PNG
Obě metody přijímají volitelný parametr RenderOptions pro nastavení měřítka, DPI, barev, tichého pásma a čitelného textu.
API Usage
Jak vygenerovat čárový kód?
Použijte pomocnou funkci pro každou symbologii:
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)Nebo použijte obecnou funkci generate():
bc = barcode.generate("qr", "https://example.com")Jak mohu nastavit možnosti kódování?
Každá symbologie má vlastní třídu možností. Předávejte ji jako parametr encode:
from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel
bc = barcode.qr(
"https://example.com",
encode=QrOptions(error_correction_level=QrErrorCorrectionLevel.H),
)Jak mohu ovládat vizuální vzhled čárového kódu?
Použijte RenderOptions s to_svg() nebo 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,
))Dostupné vlastnosti: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.
Jak knihovna zpracovává kontrolní číslice pro čárové kódy EAN a UPC?
Ve výchozím nastavení knihovna automaticky vypočítá kontrolní číslici. Zadejte pouze číslice užitečného zatížení (12 pro EAN-13, 7 pro EAN-8, 11 pro UPC-A):
bc = barcode.ean13("590123412345") # 12 digits — check digit computedChcete-li zadat předem vypočítanou kontrolní číslici, nastavte 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),
)Známá omezení
Je podporován výstup PDF?
Ne. Metoda to_pdf() a třída PdfRenderer existují v rozhraní API, ale vyvolávají NotImplementedError. Použijte místo toho to_svg() nebo to_png(). Výstup SVG lze vložit do PDF dokumentů pomocí externích nástrojů.
Jsou podporovány standardy ECI a GS1?
Zatím ne. Třídy EciHelper a Gs1Helper obsahují kostry metod, které vyvolávají NotImplementedError. Vlastnosti eci_assignment_number a gs1_enabled na EncodeOptions jsou přítomny, ale v aktuálním vydání nefungují.
Umí knihovna číst nebo skenovat čárové kódy?
Č. Aspose.BarCode FOSS pro Python je knihovna jen pro generování. Vytváří čárové kódy z dat, ale neobsahuje rozpoznávání čárových kódů ani funkce skenování.