Quickstart

Quickstart Aspose.BarCode FOSS для Python

У цьому керівництві проходить генерація штрих-кодів з використанням трьох найбільш поширених символіки: код 128, QR Code та EAN-13. Кожен приклад демонструє API високого рівня, варіанти кодування за кожну символогію і керування рендерингом.

Створення штрих-коду 128

Код 128 - це 1D-символіка змінної довжини, що використовується в логістиці та судноплавстві. code128() Helper приймає струнку даних і опціональний 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 оптимізована для даних лише з цифрами кодує пари цифр як єдині точки коду, що створює коротший штрих-код.

Створення QR-коду

QR-код - це 2D символіка, яка підтримує виправлення помилок та кілька режимів кодування. QrOptions контролює рівень корекції помилок, режим кодування, версію та масковий шаблон:

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

Рівни виправлення помилок: L (7% відновлення), M (15%), Q (25%), H (30%).

Створення штрих-кода EAN-13

EAN-13 - це фіксована 1D символіка, що використовується в роздрібному секторі. Постачайте 12 цифр корисної навантаження бібліотека автоматично обчислює 13-у перевірку:

import aspose_barcode_foss as barcode

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

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

Для надання власного попередньо обчисленої цифри (13 цифр загалом), встановлюйте allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

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

Налаштувати вигляд

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

Доступні властивості: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

Використовуйте Generic generate (АПІ)

У. generate() функція приймає символічний ряд назви замість покликання спеціального помічника:

import aspose_barcode_foss as barcode

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

Дійсні символічні назви: "code128", "code39", "ean13", "ean8", "qr", "upca", "upce".

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

Якщо надані недійсні дані або несумісні опції, бібліотека піднімає введене виняток:

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

Ієрархія винятків:

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

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

Формати виходу: SVG і PNG.

Наступні кроки

• Посібник розробників: Пер-символогія варіанти кодування, керування рендерингом та архітектура
• Features: Повний огляд функцій з прикладами коду
• KB Статті:Як діяти і часто задані запитання

See Also

• Aspose.BarCode for Python — Enterprise Documentation