Rychlý start

Quickstart — Aspose.BarCode FOSS pro Python

Tento průvodce vás provede generováním čárových kódů pomocí tří nejčastějších symbologií: Code 128, QR Code a EAN-13. Každý příklad ukazuje vysoce úrovňové API, možnosti kódování podle symbologie a ovládací prvky renderování.

Vytvořit Code 128 čárový kód

Code 128 je symbologie 1D proměnné délky používaná v logistice a přepravě. Pomocník code128() přijímá řetězec dat a volitelný 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 je optimalizováno pro data pouze s číslicemi — kóduje páry číslic jako jediný kódový bod, což vytváří kratší čárový kód.

Vytvořit QR Code

QR Code je 2D symbologie podporující opravu chyb a více kódovacích režimů. QrOptions řídí úroveň opravy chyb, kódovací režim, verzi a maskovací vzor:

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())

Úrovně opravy chyb: L (obnova 7%), M (15%), Q (25%), H (30%).

Vygenerujte čárový kód EAN-13

EAN-13 je symbologie s pevnou délkou 1D používaná v maloobchodě. Zadejte 12 číslic dat — knihovna automaticky spočítá 13. kontrolní číslici:

import aspose_barcode_foss as barcode

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

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

Chcete-li zadat vlastní předpočítanou kontrolní číslici (celkem 13 číslic), nastavte allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

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

Přizpůsobte vykreslování

RenderOptions se vztahuje na všechny symbologie a řídí vizuální výstup. Předávejte jej do to_svg() nebo 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)

Dostupné vlastnosti: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

Použijte obecnou generate() API

Funkce generate() přijímá řetězec s názvem symbologie místo volání dedikované pomocné funkce:

import aspose_barcode_foss as barcode

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

Platné názvy symbologií: "code128", "code39", "ean13", "ean8", "qr", "upca", "upce".

Zpracování chyb

Veškerá validace probíhá před kódováním. Pokud jsou poskytnuta neplatná data nebo nekompatibilní možnosti, knihovna vyvolá typovou výjimku:

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}")

Hierarchie výjimek:

Všechny třídy výjimek dědí z BarcodeError.

Podporované symbologie

Výstupní formáty: SVG a PNG.

Další kroky

• Příručka pro vývojáře: Možnosti kódování per-symbologie, ovládací prvky vykreslování a architektura
• Features: Kompletní přehled funkcí s ukázkami kódu
• Články KB: Návody a FAQ

Viz také:

• Aspose.BarCode for Python — Enterprise Documentation