Snelstart

Snelstart — Aspose.BarCode FOSS voor Python

Deze gids loopt door het genereren van barcodes met behulp van de drie meest voorkomende symbologieën: Code 128, QR Code en EAN-13. Elk voorbeeld toont de hoog-niveau API, per-symbologie encode-opties en renderingsbesturingselementen.

Genereer een Code 128 barcode

Code 128 is een variabele-lengte 1D-symbologie die wordt gebruikt in logistiek en verzending. De code128() helper accepteert een gegevensreeks en optionele 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 is geoptimaliseerd voor alleen-cijfergegevens — het codeert paren van cijfers als enkele codepunten, waardoor een kortere barcode ontstaat.

Genereer een QR Code

QR Code is een 2D-symbologie die foutcorrectie en meerdere coderingsmodi ondersteunt. QrOptions regelt het foutcorrectieniveau, de coderingsmodus, de versie en het maskerpatroon:

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

Foutcorrectieniveaus: L (7% herstel), M (15%), Q (25%), H (30%).

Genereer een EAN-13 Barcode

EAN-13 is een vaste-lengte 1D-symbool dat in de detailhandel wordt gebruikt. Geef 12 payloadcijfers op — de bibliotheek berekent automatisch het 13e controlecijfer:

import aspose_barcode_foss as barcode

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

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

Om uw eigen vooraf berekende controlecijfer te leveren (in totaal 13 cijfers), stel allow_check_digit_input=True in:

from aspose_barcode_foss import Ean13Options

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

Weergave aanpassen

RenderOptions geldt voor alle symbolen en bestuurt de visuele output. Geef het door aan to_svg() of 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)

Beschikbare eigenschappen: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

Gebruik de generieke generate() API

De generate() functie accepteert een symbologie-naam string in plaats van een speciale helper aan te roepen:

import aspose_barcode_foss as barcode

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

Geldige symbologie-namen: "code128", "code39", "ean13", "ean8", "qr", "upca", "upce".

Foutafhandeling

Alle validatie vindt plaats vóór het coderen. Als ongeldige gegevens of incompatibele opties worden opgegeven, werpt de bibliotheek een getypeerde exception:

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

Exception-hiërarchie:

Alle exception-klassen erven van BarcodeError.

Ondersteunde symbologieën

Uitvoerformaten: SVG en PNG.

Volgende stappen

• Ontwikkelaarsgids: Per-symboolcodeeropties, weergavecontroles en architectuur
• Features: Volledig overzicht van functies met codevoorbeelden
• KB-artikelen: Stapsgewijze handleidingen en FAQ

Zie ook

• Aspose.BarCode for Python — Enterprise Documentation