Quickstart

Quickstart Aspose.BarCode FOSS за Python

Това ръководство разглежда генерирането на баркодове, използвайки трите най-често срещани символи: код 128, QR код и EAN-13. Всеки пример демонстрира API от високо ниво, опции за кодиране по симбология и контроли за рендеринг.

Създаване на код 128 баркод

Код 128 е 1D символика с променлива дължина, използвана в логистиката и корабоплаването. code128() помощник приема данни и опционално 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.

Използвайте API на 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: Пълен преглед на функциите с примери за код
• КБ Статии: Указания за начина на работа и често задавани въпроси

See Also

• Aspose.BarCode for Python — Enterprise Documentation