Quickstart

Quickstart Aspose.BarCode FOSS pentru Python

Acest ghid vă prezintă generarea codurilor de bare folosind cele mai comune trei simboluri: Codul 128, Code-ul QR și EAN-13. Fiecare exemplu demonstrează API la nivel înalt, opțiunile de codificare per-simbologie și controalele de renderizare.

Genera un cod de bară 128

Codul 128 este o simbolologie 1D de lungime variabilă utilizată în logistică și transport maritim. code128() Helper acceptă un șir de date și opțional Code128Options:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import Code128Options, Code128EncodeMode

bc = barcode.code128(
    "1234567890",
    encode=Code128Options(encode_mode=Code128EncodeMode.CODE_C),
)
svg = bc.to_svg()

with open("code128.svg", "w") as f:
    f.write(svg)

Code128EncodeMode.CODE_C este optimizat pentru datele cu doar cifre codifică perechi de cifere ca puncte unice, producând un cod de bare mai scurt.

Generați un cod QR

Codul QR este o simbolologie 2D care susține corectarea erorilor și mai multe moduri de codificare. QrOptions controleaza nivelul de corectare a erorilor, modul de codificare, versiunea și modelul mascării:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel, QrEncodeMode

bc = barcode.qr(
    "https://example.com/product/12345",
    encode=QrOptions(
        error_correction_level=QrErrorCorrectionLevel.Q,
        encoding_mode=QrEncodeMode.BYTE,
    ),
)

with open("qr.png", "wb") as f:
    f.write(bc.to_png())

Niveluri de corectare a erorilor: L (recuperare de 7%), M (15%), Q (25%), H (30%).

Generați un cod de bare EAN-13

EAN-13 este o simbolologie 1D de lungime fixă utilizată în comerțul cu amănuntul. Furnizarea a 12 cifre utile biblioteca calculează automat cea de-a 13-a cifra:

import aspose_barcode_foss as barcode

bc = barcode.ean13("590123412345")
svg = bc.to_svg()

with open("ean13.svg", "w") as f:
    f.write(svg)

Pentru a furniza propria dvs. cifră de verificare pre-computată (total 13 cifre), setarea allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

bc = barcode.ean13(
    "5901234123457",
    encode=Ean13Options(allow_check_digit_input=True),
)

Customizați renderizarea

RenderOptions Se aplică tuturor simbolurilor şi controlează rezultatul vizual. to_svg() sau de: to_png():

import aspose_barcode_foss as barcode
from aspose_barcode_foss import RenderOptions

bc = barcode.upca("01234567890")
png = bc.to_png(options=RenderOptions(
    scale=3.0,
    dpi=300,
    foreground_color="#1a1a1a",
    background_color="#ffffff",
    show_text=True,
    font_family="Courier New",
))

with open("upca.png", "wb") as f:
    f.write(png)

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

Utilizați generate Generic (Generic) API

În ceea ce priveşte generate() funcția acceptă un șir de nume simbolic în loc să cheme un ajutor dedicat:

import aspose_barcode_foss as barcode

bc = barcode.generate("code128", "ABC123")
svg = bc.to_svg()

Numele de simbolologie valabile: "code128", "code39", "ean13", "ean8", "qr", "upca", "upce".

Gestionarea erorilor

Dacă sunt furnizate date nevaloroase sau opțiuni incompatibile, biblioteca ridică o excepție tipărită:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import InvalidInputError

try:
    bc = barcode.ean13("ABC")  # EAN-13 requires digits
except InvalidInputError as e:
    print(f"Invalid input: {e}")

Ierarhia excepțiilor:

Toate clasele de excepție moștenesc din: BarcodeError.

Simboluri susținute

Formatul de ieșire: SVG și PNG.

Următoarele paşi

• Ghidul dezvoltatorilor:Opțiuni de codificare per-simbologie, controale de renderizare și arhitectură
• Features: O prezentare completă a caracteristicilor cu exemple de cod
• KB Articole:Ghiduri de instrucţiune şi întrebări frecvente

See Also

• Aspose.BarCode for Python — Enterprise Documentation