Особливості та функції

Особливості та функції

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.

Підтримані символіки

Бібліотека підтримує сім символіки через спеціальні функції помічника і загальний 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")

Код 128 Моди шифрування

Code128Options Код 128 визначає, який код використовується кодером. encode_mode нерухомість приймає Code128EncodeMode значення enum:

• AUTO автоматично вибирає найкомп’ктніший кодування.
• CODE_A, CODE_B, CODE_C обмежені одним набором символів
• CODE_AB, CODE_AC, CODE_BC дозволяти перемикання між двома наборами символів

from aspose_barcode_foss import Code128Options, Code128EncodeMode

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

Код 39 - кодування

Code39Options контролює, чи використовує кодер базовий набір 43 символів або розширення Full ASCII:

• full_ascii встановлено на: True кодування всього діапазону 128 символів ASCII за допомогою пар змін.
• add_check_digit додає номер модуля-43

from aspose_barcode_foss import Code39Options

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

Конфігурація QR-коду

QrOptions забезпечує найбільшу конфігурацію серед усіх символіки:

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 та UPC

Ean13Options, Ean8Options, UpcaOptions, і UpceOptions кожна з них має allow_check_digit_input По умові, бібліотека обчислює цифри перевірки автоматично. Назначити allow_check_digit_input=True якщо ваші дані вже включають це.

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

Контрольні елементи відтворення

RenderOptions застосовується до всіх символіки і контролює візуальний вихід. Передайте його на to_svg() або 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,
))

Формати виходу

Обидва методи приймають факультативний метод. RenderOptions параметр.

Обробка помилок

Всі варіанти кодування підтверджуються під час аналізу. Бібліотека виводить завантажені винятки перед початком кодирування:

Всі класи винятків успадковують від: BarcodeError.

from aspose_barcode_foss import InvalidInputError

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

Вхідна валідація

Кожна символіка має спеціальний InputParser Розмірник перевіряє набір символів, довжину та формат вимог для кожної симвології. Code128InputParser, Code39InputParser, Ean13InputParser, Ean8InputParser, QrInputParser, UpcaInputParser, і UpceInputParser використовуються внутрішньо за їх відповідними допоміжними функціями.

Об’єкт штрих-кода

У. Barcode об’єкт, який повертається усіма функціями-поможниками, надає:

• to_svg(options) відтворення на SVG-струнку
• to_png(options) відтворення на PNG байти
• render(renderer, options) викладання за допомогою специфічного Renderer реалізація
• symbol в EncodedSymbol що містить матрицю модуля та метадані;
• profile в SymbologyProfile з умовними параметрами та можливостями

Реферат на API

Дивіться також

• Aspose.BarCode for Python — Enterprise Documentation