Funkcje i funkcjonalności

Funkcje i możliwości

Aspose.BarCode FOSS dla Python zapewnia wysokopoziomowy API do generowania siedmiu symbologii kodów kreskowych z opcjami kodowania dla każdej symbologii oraz kontrolami renderowania. Ta strona jest głównym odniesieniem dla wszystkich obszarów funkcji.

Obsługiwane symbologie

Biblioteka obsługuje siedem symbologii poprzez dedykowane funkcje pomocnicze oraz ogólny punkt wejścia generate():

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

Code 128 Tryby kodowania

Code128Options kontroluje, które zestawy znaków Code 128 używa enkoder. Właściwość encode_mode przyjmuje wartość wyliczeniową Code128EncodeMode:

• AUTO — automatycznie wybiera najgęstsze kodowanie
• CODE_A, CODE_B, CODE_C — ogranicz do jednego zestawu znaków
• CODE_AB, CODE_AC, CODE_BC — zezwalaj na przełączanie między dwoma zestawami znaków

from aspose_barcode_foss import Code128Options, Code128EncodeMode

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

Code 39 Kodowanie

Code39Options kontroluje, czy enkoder używa podstawowego zestawu 43 znaków, czy rozszerzenia Full ASCII:

• full_ascii — ustaw na True, aby zakodować pełny zakres 128 znaków ASCII przy użyciu par przesunięć
• add_check_digit — dodaje cyfrę kontrolną modulo-43

from aspose_barcode_foss import Code39Options

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

QR Code Konfiguracja

QrOptions zapewnia najwięcej konfiguracji spośród wszystkich symboli:

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

Cyfry kontrolne EAN i UPC

Ean13Options, Ean8Options, UpcaOptions i UpceOptions mają własność allow_check_digit_input. Domyślnie biblioteka oblicza cyfrę kontrolną automatycznie. Ustaw allow_check_digit_input=True, jeśli twoje dane już ją zawierają.

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

Kontrolki renderowania

RenderOptions ma zastosowanie do wszystkich symboli i kontroluje wyjście wizualne. Przekaż go do to_svg() lub 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,
))

Formaty wyjściowe

Obie metody akceptują opcjonalny parametr RenderOptions.

Obsługa błędów

Wszystkie walidacje opcji kodowania odbywają się w czasie parsowania. Biblioteka wyrzuca typowane wyjątki przed rozpoczęciem kodowania:

Wszystkie klasy wyjątków dziedziczą po BarcodeError.

from aspose_barcode_foss import InvalidInputError

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

Walidacja danych wejściowych

Każda symbologia ma dedykowany InputParser, który weryfikuje dane przed kodowaniem. Parser sprawdza zestaw znaków, długość oraz wymagania formatowe specyficzne dla każdej symbologii. Code128InputParser, Code39InputParser, Ean13InputParser, Ean8InputParser, QrInputParser, UpcaInputParser i UpceInputParser są używane wewnętrznie przez ich odpowiednie funkcje pomocnicze.

Obiekt kodu kreskowego

Obiekt Barcode zwracany przez wszystkie funkcje pomocnicze zapewnia:

• to_svg(options) — renderowanie do łańcucha SVG
• to_png(options) — renderowanie do bajtów PNG
• render(renderer, options) — renderowanie przy użyciu konkretnej implementacji Renderer
• symbol — EncodedSymbol zawierający macierz modułu i metadane
• profile — SymbologyProfile z domyślnymi ustawieniami i możliwościami

Podsumowanie API Reference

Zobacz także

• Aspose.BarCode for Python — Enterprise Documentation