Vanliga frågor
Licensiering & öppen källkod
Vilken licens använder Aspose.BarCode FOSS för Python?
Aspose.BarCode FOSS för Python är släppt under MIT License. Den fullständiga licenstexten finns i LICENSE-filen som distribueras med paketet. Du får fritt använda, modifiera och distribuera biblioteket i både öppen källkod och proprietära projekt.
Kan jag använda Aspose.BarCode FOSS i kommersiella produkter?
Ja. MIT License tillåter kommersiell användning utan royalties eller krav på namnuppgift förutom att inkludera den ursprungliga licensnotisen. Du behöver inte öppna källkoden för din applikation.
Installation & krav
Hur installerar jag Aspose.BarCode FOSS för Python?
Installera det med kommandot nedan:
git clone https://github.com/aspose-barcode-foss/Aspose.BarCode-FOSS-for-Python.git
cd Aspose.BarCode-FOSS-for-Python
pip install -e .Biblioteket kräver Python 3.12 eller senare.
Finns det några inhemska beroenden eller systempaket som krävs?
Nej. Aspose.BarCode FOSS för Python är ett rent-Python paket. Det har inga inhemska tillägg, inga C-beroenden och inga systempaket att installera. Det körs på Windows, macOS och Linux — inklusive tunna Docker-bilder som python:3.12-slim.
Stöd för symboler
Vilka streckkodssymboler stöds?
Biblioteket stödjer sju symbologier:
| Symbology | Typ | Options-klass |
|---|---|---|
| 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 |
Varje symbologi har en dedikerad hjälpfunktion (code128(), code39(), ean13(), ean8(), qr(), upca(), upce()) och en generisk generate()-funktion som accepterar en symbologinamnsträng.
Vilka utdataformat är tillgängliga?
Biblioteket renderar streckkoder till SVG och PNG:
to_svg()— returnerar en SVG-strängto_png()— returnerar PNG-bytes
Båda metoderna accepterar en valfri RenderOptions-parameter för att kontrollera skala, DPI, färger, tyst zon och människoläsbar text.
API Usage
Hur genererar jag en streckkod?
Använd en hjälpfunktion per symbologi:
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)Eller använd den generiska generate()-funktionen:
bc = barcode.generate("qr", "https://example.com")Hur konfigurerar jag kodningsalternativ?
Varje symbologi har en dedikerad alternativklass. Skicka den som encode-parametern:
from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel
bc = barcode.qr(
"https://example.com",
encode=QrOptions(error_correction_level=QrErrorCorrectionLevel.H),
)Hur styr jag det visuella utseendet på streckkoden?
Använd RenderOptions med to_svg() eller 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,
))Tillgängliga egenskaper: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.
Hur hanterar biblioteket kontrollsiffror för EAN- och UPC-streckkoder?
Som standard beräknar biblioteket kontrollsiffran automatiskt. Ange endast nyttolastsiffrorna (12 för EAN-13, 7 för EAN-8, 11 för UPC-A):
bc = barcode.ean13("590123412345") # 12 digits — check digit computedFör att ange en förberäknad kontrollsiffra, sätt 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),
)Kända begränsningar
Stöds PDF-utmatning?
Nej. to_pdf()-metoden och PdfRenderer-klassen finns i API-ytan men kastar NotImplementedError. Använd to_svg() eller to_png() istället. SVG-utmatning kan bäddas in i PDF-dokument med externa verktyg.
Stöds ECI- och GS1-standarderna?
Inte ännu. EciHelper- och Gs1Helper-klasserna har metodstubb som kastar NotImplementedError. eci_assignment_number- och gs1_enabled-egenskaperna på EncodeOptions finns men är icke-funktionella i den aktuella releasen.
Kan biblioteket läsa eller skanna streckkoder?
No. Aspose.BarCode FOSS för Python är ett enbart genereringsbibliotek. Det skapar streckkoder från data men inkluderar inte streckkodigenkänning eller skanningsfunktioner.