Funktioner och funktioner

Funktioner och funktioner

Aspose.BarCode FOSS for Python provides a high-level API for generating seven barcode symbologies with per-symbology encode options and rendering controls. This page is the primary reference for all feature areas.

Stödda symbologier

Biblioteket stöder sju symboler genom dedikerade hjälparfunktioner och generiska funktioner. generate() Inträde punkt:

import aspose_barcode_foss as barcode

# Per-symbology helpers
bc_128 = barcode.code128("ABC123")
bc_qr = barcode.qr("https://example.com")

# Generic API
bc_gen = barcode.generate("ean13", "590123412345")

128 koden för kodning

Code128Options kontroller som kod 128 tecken ställer kodaren använder. encode_mode Fastigheten accepterar A Code128EncodeMode Enum värde:

• AUTO - Väljer den mest kompakta kodningen automatiskt
• CODE_A, CODE_B, CODE_C - begränsas till en enda tecken uppsättning
• CODE_AB, CODE_AC, CODE_BC - tillåta växling mellan två tecken uppsättningar

from aspose_barcode_foss import Code128Options, Code128EncodeMode

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

39 kodning

Code39Options Kontrollera om kodaren använder bas 43-figuren eller full ASCII förlängning:

• full_ascii - Sätt till True för att kodera det fullständiga 128-karaktär ASCII-området med hjälp av växelkoppar
• add_check_digit - Anslut en modul-43 checkdigent

from aspose_barcode_foss import Code39Options

bc = barcode.code39(
    "Hello",
    encode=Code39Options(full_ascii=True, add_check_digit=True),
)

QR kod konfiguration

QrOptions ger den mest konfigurerade bland alla symboler:

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

EAN och UPC Check Digits

Ean13Options, Ean8Options, UpcaOptions,och UpceOptions Var och en har ett allow_check_digit_input För standard beräknar biblioteket checknumret automatiskt. allow_check_digit_input=True Om dina data redan innehåller det.

from aspose_barcode_foss import Ean13Options

# Automatic check digit (12 digits in, library appends the 13th)
bc = barcode.ean13("590123412345")

# Pre-computed check digit (13 digits, library validates)
bc2 = barcode.ean13(
    "5901234123457",
    encode=Ean13Options(allow_check_digit_input=True),
)

Rendering kontroller

RenderOptions gäller alla symboler och kontrollerar den visuella utgången. to_svg() eller to_png():

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

Utgångsformat

Båda metoderna accepterar ett valfritt RenderOptions Parameter är.

Felhantering

Alla kodningsalternativ validering sker vid tidpunkten. biblioteket lyfter typade undantag innan kodning börjar:

Alla undantagsklasser ärvda från BarcodeError.

from aspose_barcode_foss import InvalidInputError

try:
    bc = barcode.ean13("ABC")
except InvalidInputError as e:
    print(f"Invalid input: {e}")

Inträde Validering

Varje symbol har en dedikerad InputParser Parser kontrollerar karaktärsets, längdens och formatkrav specifika för varje symbol. Code128InputParser, Code39InputParser, Ean13InputParser, Ean8InputParser, QrInputParser, UpcaInputParser,och UpceInputParser De används internalt av sina respektive hjälpfunktioner.

Barkod Objekt

Den Barcode objektet som returneras av alla hjälparfunktioner ger:

• to_svg(options) - Renderar till SVG sträng
• to_png(options) - Renderar till PNG byter
• render(renderer, options) - att använda en specifik Renderer genomförandet
• symbol - den EncodedSymbol Innehåller modulsmatrix och metadata
• profile - den SymbologyProfile med förluster och kapacitet

API Referens sammanfattning

Se även

• Aspose.BarCode for Python — Enterprise Documentation