Aspose.BarCode FOSS
Python
Întrebări frecvente

Întrebări frecvente

Licențiere & Open Source

Ce licență folosește Aspose.BarCode FOSS pentru Python?

Aspose.BarCode FOSS pentru Python este lansat sub MIT License. Textul complet al licenței este inclus în fișierul LICENSE distribuit cu pachetul. Sunteți liber să utilizați, modificați și redistribuiți biblioteca atât în proiecte open-source, cât și în proiecte proprietare.

Pot folosi Aspose.BarCode FOSS în produse comerciale?

Da. MIT License permite utilizarea comercială fără redevențe sau cerințe de atribuire, în afara includerii notificării originale a licenței. Nu trebuie să faceți open-source aplicația dumneavoastră.

Instalare & Cerințe

Cum să instalez Aspose.BarCode FOSS pentru Python?

Instalați-l cu comanda de mai jos:

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

Biblioteca necesită Python 3.12 sau o versiune ulterioară.

Există dependențe native sau pachete de sistem necesare?

Nu. Aspose.BarCode FOSS pentru Python este un pachet pure-Python. Nu are extensii native, nu are dependențe C și nu necesită pachete la nivel de sistem pentru instalare. Rulează pe Windows, macOS și Linux — inclusiv imagini Docker subțiri precum python:3.12-slim.

Suport pentru simboluri

Ce simboluri de coduri de bare sunt suportate?

Biblioteca suportă șapte simboluri:

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

Fiecare simbol are o funcție ajutătoare dedicată (code128(), code39(), ean13(), ean8(), qr(), upca(), upce()) și o funcție generică generate() care acceptă un șir cu numele simbolului.

Ce formate de ieșire sunt disponibile?

Biblioteca generează coduri de bare în SVG și PNG:

  • to_svg() — returnează un șir SVG
  • to_png() — returnează octeți PNG

Ambele metode acceptă un parametru opțional RenderOptions pentru controlul scalării, DPI-ului, culorilor, zonei de liniște și a textului lizibil pentru oameni.

API Usage

Cum generez un cod de bare?

Folosiți funcția ajutătoare per-symbology:

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)

Sau folosiți funcția generică generate():

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

Cum pot configura opțiunile de codare?

Fiecare simbolistică are o clasă de opțiuni dedicată. Transmiteți-o ca parametru encode:

from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel

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

Cum pot controla aspectul vizual al codului de bare?

Folosiți RenderOptions cu to_svg() sau 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,
))

Proprietăți disponibile: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

Cum gestionează biblioteca cifrele de control pentru codurile de bare EAN și UPC?

Implicit, biblioteca calculează cifra de control automat. Furnizați doar cifrele de sarcină utilă (12 pentru EAN-13, 7 pentru EAN-8, 11 pentru UPC-A):

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

Pentru a furniza o cifră de control pre-calculată, setaţi 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),
)

Limitări cunoscute

Este suportat output-ul PDF?

Nu. Metoda to_pdf() și clasa PdfRenderer există în suprafața API, dar generează NotImplementedError. Utilizaţi to_svg() sau to_png() în schimb. Output-ul SVG poate fi încorporat în documente PDF folosind instrumente externe.

Sunt suportate standardele ECI și GS1?

Încă nu. Clasele EciHelper și Gs1Helper au şabloane de metodă care generează NotImplementedError. Proprietăţile eci_assignment_number și gs1_enabled pe EncodeOptions sunt prezente, dar nefuncţionale în versiunea curentă.

Poate biblioteca să citească sau să scaneze coduri de bare?

Nr. Aspose.BarCode FOSS pentru Python este o bibliotecă doar de generare. Creează coduri de bare din date, dar nu include recunoașterea codurilor de bare sau capacitățile de scanare.

Vezi și:

 Română