Quickstart

Quickstart — Aspose.BarCode FOSS för Python

Denna guide går igenom generera barkoder med hjälp av de tre vanligaste symbolerna: Code 128, QR Code och EAN-13. Varje exempel visar den högnivå API, per-symbolologi kodalternativ, och rendering kontroller.

Skapa en kod 128 barkod

Koden 128 är en variabel längd 1D symbol som används i logistik och frakt. code128() Hjälpmedlem accepterar en data sträng och valfri 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 är optimerad för digitala data – den kodar par av siffror som enhetliga kodpunkter, vilket ger en kortare barkod.

Skapa en QR kod

QR Code är en 2D-symbol som stöder felkorrigering och flera kodningslägen. QrOptions kontrollerar fel korrigering nivå, kodning läge, version och masker mönster:

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

Felkorrigering nivåer: L 7 % återhämtning, M 15 % av, Q 25 % av, H 30 procent ).

Skapa en EAN-13 barkod

EAN-13 är en fast längd 1D symbol som används i detaljhandeln. Leverera 12 lastkonton - biblioteket beräknar den 13: e checkkranen automatiskt:

import aspose_barcode_foss as barcode

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

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

För att leverera din egen pre-computerade checkdikt (13 siffror totalt), ställ in allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

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

Customiserad rendering

RenderOptions gäller alla symboler och kontrollerar den visuella utgången. to_svg() eller 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)

Tillgängliga egenskaper: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

Använd generiska generat() API

Den generate() Funktionen accepterar en symbolisk namnsträng istället för att ringa en dedikerad hjälper:

import aspose_barcode_foss as barcode

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

Valid symboliska namn: "code128", "code39", "ean13", "ean8", "qr", "upca", "upce".

Felhantering

Alla valideringar sker innan kodning.Om olagliga data eller inkompatibla alternativ tillhandahålls, uppger biblioteket ett typiskt undantag:

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

Undantag för hierarkin:

Alla undantagsklasser ärvda från BarcodeError.

Stödda symbologier

Utgångsformat: SVG och PNG.

Nästa steg

• Utvecklingsguide: Per-symbologi kodningsalternativ, rendering kontroller och arkitektur
• egenskaper: Fullständig funktion översikt med kodexempel
• KB artiklar:Hur man gör guider och FAQ

Se även

• Aspose.BarCode for Python — Enterprise Documentation