Робота з варіантами кодування

Кожна символіка штрих-коду в Aspose.BarCode FOSS для Python має спеціальний клас опцій, який контролює поведінку кодування. Всі класи опції успадковують від EncodeOptions, що забезпечує: gs1_enabled і eci_assignment_number властивості, які поділяються між символіками.

Code128Options

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

Mode	Description
`AUTO`	Автоматично вибирає найкомп’ктніший кодування .
`CODE_A`	Великими буквами, цифрами та знаками керування
`CODE_B`	Великі, малі і цифри
`CODE_C`	Пара цифр оптимізована для даних лише з числами
`CODE_AB`	Перемикає між кодом А та коду Б.
`CODE_AC`	Перемикає між кодом А та коду С.
`CODE_BC`	Перемикає між кодом B і коду C.

import aspose_barcode_foss as barcode
from aspose_barcode_foss import Code128Options, Code128EncodeMode

# AUTO mode — library picks the most compact encoding
bc_auto = barcode.code128("ABC123", encode=Code128Options(encode_mode=Code128EncodeMode.AUTO))

# CODE_C mode — compact encoding for digit-only data
bc_c = barcode.code128("9876543210", encode=Code128Options(encode_mode=Code128EncodeMode.CODE_C))

# CODE_B mode — full alphanumeric support
bc_b = barcode.code128("Hello World", encode=Code128Options(encode_mode=Code128EncodeMode.CODE_B))

Code39Options

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

Property	Type	Default	Description
`full_ascii`	`bool`	`None`	Запустити режим ASCII (диапазон 128 символів через парні переміщення)
`add_check_digit`	`bool`	`None`	Додавати номер модуля-43

from aspose_barcode_foss import Code39Options

# Base mode — uppercase letters, digits, and a few special characters
bc_base = barcode.code39("CODE 39")

# Full ASCII mode — encodes the full 128-character ASCII range
bc_full = barcode.code39(
    "Hello, World!",
    encode=Code39Options(full_ascii=True, add_check_digit=True),
)

QrOptions (Оптиційні варіанти)

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

Property	Type	Values
`error_correction_level`	`QrErrorCorrectionLevel`	`L` (7%), `M` (15%), `Q` (25%), `H` (30%)
`encoding_mode`	`QrEncodeMode`	`AUTO`, `NUMERIC`, `ALPHANUMERIC`, `BYTE`, `KANJI`
`version`	`int`	1–40 (controls symbol dimensions)
`mask`	`int`	0–7 (manual mask pattern selection)

from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel, QrEncodeMode

# High error correction with byte encoding
bc = barcode.qr(
    "https://example.com",
    encode=QrOptions(
        error_correction_level=QrErrorCorrectionLevel.H,
        encoding_mode=QrEncodeMode.BYTE,
    ),
)

# Numeric mode for digit-only data — most compact QR
bc_num = barcode.qr(
    "0123456789",
    encode=QrOptions(encoding_mode=QrEncodeMode.NUMERIC),
)

# Explicit version and mask
bc_v5 = barcode.qr(
    "TEST",
    encode=QrOptions(version=5, mask=3),
)

Ean13Options

Ean13Options контрольні знаки для обробки номерів EAN-13.

Property	Type	Default	Description
`allow_check_digit_input`	`bool`	`None`	Приймати 13-значний вхід з попередньо обчисленим знаком перевірки.

from aspose_barcode_foss import Ean13Options

# 12 digits — library computes the 13th check digit
bc = barcode.ean13("590123412345")

# 13 digits — library validates the provided check digit
bc2 = barcode.ean13(
    "5901234123457",
    encode=Ean13Options(allow_check_digit_input=True),
)

Ean8Options

Ean8Options працює ідентично до Ean13Options Достачайте 7 цифр корисної навантаження (бібліотека обчислює 8-й), або встановлюйте: allow_check_digit_input=True для 8-значного входу.

from aspose_barcode_foss import Ean8Options

bc = barcode.ean8("1234567")
bc2 = barcode.ean8("12345670", encode=Ean8Options(allow_check_digit_input=True))

УпкОпціони і упчОПЦіоні

UpcaOptions і UpceOptions слідувати тому ж. allow_check_digit_input модель як опції EAN. UpceOptions також має number_system майно.

from aspose_barcode_foss import UpcaOptions, UpceOptions

# UPC-A: 11 digits, library adds check digit
bc_a = barcode.upca("01234567890")

# UPC-E with pre-computed check digit
bc_e = barcode.upce(
    "01234565",
    encode=UpceOptions(allow_check_digit_input=True),
)

Базові властивості EncodeOptions

Всі класи опцій успадковують ці властивості від: EncodeOptions:

Property	Type	Description
`gs1_enabled`	`bool	None`
`eci_assignment_number`	`int	None`

Поради та найкращі практики

Використання Code128EncodeMode.AUTO Якщо у вас немає конкретної причини обмежувати набори символів, він виробляє найкоротший штрих-код для будь-якого входу.
Набір QrErrorCorrectionLevel.H для QR-кодів, які будуть друковані на поверхнях, схильних до пошкодження.
Нехай бібліотека обчислює цифри перевірки за замовчуванням тільки встановлено allow_check_digit_input=True при отриманні попередньо підтверджених даних з іншої системи.
Використання QrEncodeMode.NUMERIC для даних QR тільки з цифрами, щоб мінімізувати розмір символу.

Загальні питання

Issue	Cause	Виправлення
`InvalidInputError` про код 39	Вхід містить малі букви.	Набір `full_ascii=True` в `Code39Options`
QR-код занадто великий.	Вибірка версії, встановлена занадто низькою для довжини даних	Видалення ясного `version` або збільшити його.
Неправильна цифра на EAN-13	13-digit input without `allow_check_digit_input=True`	Передайте 12 цифр (авто) або встановити опцію на `True`
`SymbologyNotFoundError`	Неправильно написана назва символіки в `generate()`	Використовуйте одну з: `code128`, `code39`, `ean13`, `ean8`, `qr`, `upca`, `upce`

Робота з варіантами кодування