pyzbar не читает DataMatrix: чем читать коды «Честного знака» на Python
На вопрос «чем прочитать DataMatrix на Python» часто советуют pyzbar. Он не подходит: ZBar, на котором он построен, DataMatrix не поддерживает вовсе. Хуже всего то, что ошибки нет — decode() возвращает пустой список, и кажется, что виновата картинка. Ниже — что работает, на одном и том же коде «Честного знака».
Опыт: один код, четыре библиотеки
Код — GS1 DataMatrix с FNC1 и разделителем GS, как на упаковке: (01)04601234567893(21)5Abc12Xyz!-(93)dGVz. Картинка 208×208 пикселей, чистая, без шума. Python 3.13.
| Библиотека | Результат | Что важно |
|---|---|---|
| pyzbar 0.1.9 | пустой список | DataMatrix не поддерживается; ошибки нет |
| pylibdmtx 0.1.10 | прочитан, GS на месте | на Python 3.12 и новее не импортируется без пакета setuptools (нужен модуль distutils) |
| zxing-cpp 3.1.1 | прочитан, помечен как GS1 | строку с GS брать из bytes, а не из text |
| dmr 1.2.4 (libscanner) | прочитан, GS на месте | сделан под кадры промышленной камеры на линии |
pyzbar: почему пусто
ZBar читает EAN/UPC, Code 128, Code 39, Code 93, Codabar, Interleaved 2 of 5, DataBar и QR. DataMatrix в этом списке нет, поэтому никакая настройка не поможет:
from pyzbar import pyzbar
from PIL import Image
print(pyzbar.decode(Image.open("cz.png")))
# []Если в том же проекте нужны и штрихкоды EAN, и DataMatrix — pyzbar для штрихкодов можно оставить, а DataMatrix читать одной из библиотек ниже. Или взять одну библиотеку, которая читает всё сразу.
pylibdmtx: работает, но проверьте версию Python
pylibdmtx — обёртка над libdmtx. Код читает, разделитель GS (байт 29) сохраняет. Но последний выпуск импортирует distutils, которого с Python 3.12 нет в стандартной библиотеке, и падает с ModuleNotFoundError: No module named 'distutils'. Лечится установкой setuptools:
# pip install pylibdmtx setuptools
from pylibdmtx import pylibdmtx
from PIL import Image
print(pylibdmtx.decode(Image.open("cz.png"))[0].data)
# b'0104601234567893215Abc12Xyz!-\x1d93dGVz'zxing-cpp: бесплатно и надёжно, но не перепутайте text и bytes
Пакет zxing-cpp (лицензия Apache 2.0) читает DataMatrix, QR и линейные коды и сам распознаёт GS1. Ловушка в том, что text — это строка для человека, со скобками вокруг идентификаторов применения и без GS. Для учётной системы и для проверки в «Честном знаке» нужна строка с GS — она в bytes:
# pip install zxing-cpp pillow
import zxingcpp
from PIL import Image
r = zxingcpp.read_barcodes(Image.open("cz.png"))[0]
print(r.content_type) # ContentType.GS1
print(r.text) # (01)04601234567893(21)5Abc12Xyz!-(93)dGVz
print(r.bytes) # b'0104601234567893215Abc12Xyz!-\x1d93dGVz'Если нужно иногда прочитать код со снимка или со скана — zxing-cpp хватит, платная библиотека не нужна.
dmr: для потока кадров с камеры на линии
dmr из libscanner решает другую задачу: конвейер, промышленная камера, тысячи кадров в час, код мелкий, смазанный или под наклоном, а ложное чтение недопустимо. На корпусе из 8959 снимков производственной линии он прочитал 99,6 % кадров без единого ложного чтения, медианное время — 7 мс на кадр на одном ядре, вместе с декодированием JPEG.
# pip install libscanner-dmr
import dmr
scanner = dmr.Scanner()
r = scanner.scan(dmr.Image("cz.png", dmr.LoadAs.GRAY).view())
if r.ok:
print(r.text) # b'0104601234567893215Abc12Xyz!-\x1d93dGVz'Библиотека платная, первый месяц на машине работает без лицензии и без сети — этого хватает, чтобы проверить её на своих кадрах.
Что выбрать
- Прочитать код с фото или скана время от времени — zxing-cpp, строку с GS брать из
bytes. - Старый проект на pylibdmtx — оставить, на Python 3.12+ добавить setuptools.
- Линия с камерой, нужна скорость и ноль ложных чтений — dmr; проверить на своих кадрах в пробный месяц.
- pyzbar — только для штрихкодов и QR, не для DataMatrix.
Что делать с прочитанной строкой дальше — разобрать поля и проверить разделители — описано в статьях про разделитель GS и про проверку кода.
Попробовать
Проверить, как читается ваш код со снимка, можно в онлайн-сканере — без установки и регистрации. Документация dmr для Python — на сайте, пакет — libscanner-dmr на PyPI.
«Честный знак» — товарный знак ООО «Оператор-ЦРПТ», «GS1» — GS1 AISBL; продукт не связан с их владельцами и ими не сертифицирован.