Quickstart

Gyorsindítás Aspose.BarCode FOSS Python-hoz

Ez a útmutató az alábbi három leggyakoribb szimbólum használatával generált vonalkódokat mutatja be: 128-as kód, QR-kód és EAN-13. Minden példa bemutatja a magas szintű API-t, a szimbolikus kódolási lehetőségeket és a renderizációs vezérlők.

128 kód generálása

A kód 128 egy változó hosszúságú 1D szimbólum, amelyet a logisztikában és a hajózásban használnak. code128() a helper elfogad egy adatláncot és opcionális 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 optimalizált csak számjegyű adatokra a számegyetek párját egyetlen kódpontként kódolja, így rövidebb vonalkódot termel.

QR-kód létrehozása

A QR kód egy 2D szimbólum, amely hibakorrekciót és többszörös kódolási módot támogat. QrOptions a hibakorrigálási szint, kódolási mód, változat és maszkminták ellenőrzése:

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

A hibajavítási szintek: L (7%-os helyreállítás), M (15%), Q (25%), H (30%).

EAN-13 vonalkód létrehozása

Az EAN-13 egy fix hosszúságú 1D szimbólum, amelyet a kiskereskedelemben használnak. 12 hasznos teherjegyet adjon a könyvtár automatikusan kiszámítja a 13. ellenőrző számot:

import aspose_barcode_foss as barcode

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

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

A saját előre kiszámított ellenőrzési számjegyének (13 számegység összesen) megadására, a következőket kell beállítani: allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

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

Kiszolgálás testreszabása

RenderOptions Minden szimbólógiai jelzésre vonatkozik, és irányítja a vizuális kimenetet. to_svg() vagy a következő: 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)

A rendelkezésre álló tulajdonságok: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

Használja a generikus API-t.

A Bizottság generate() a funkció elfogadja egy szimbólógiai névsorot, ahelyett hogy hívna egy dedikált segédszemélyt:

import aspose_barcode_foss as barcode

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

Helyes szimbólumnév: "code128", "code39", "ean13", "ean8", "qr", "upca", "upce".

Hibakezelés

A validanyozás a kódolás előtt történik. Ha nem érvényes adatok vagy összeférhetetlen opciók kerülnek megadásra, a könyvtár egy betűzött kivételt hoz létre:

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

Kivételes hierarchiák:

Minden kivételosztály örököl a következőkből: BarcodeError.

Támogatott szimbólumok

Kiviteli formátumok: SVG és PNG.

Következő lépések

• Készítő útmutató: Per-szimbólógiai kódolási lehetőségek, megjelenítési vezérlők és architektúra
• Features: Teljes funkció áttekintése kód példákkal
• KB cikkek:Könyv és FAQ:

See Also

• Aspose.BarCode for Python — Enterprise Documentation