Чтение DataMatrix в C++: zxing-cpp, libdmtx или dmr — сборка и кадр с камеры
Программа на C++ получает кадр с камеры или снимок с диска, и из него нужно достать строку кода DataMatrix — например, код «Честного знака» с разделителем GS. Ниже — из чего выбрать, как собрать и подключить нашу библиотеку dmr и на что обратить внимание, чтобы не потерять разделитель и не сорвать темп линии.
Из чего выбрать
| Библиотека | Лицензия | Когда брать |
|---|---|---|
| zxing-cpp | Apache 2.0 | чистые коды со снимков и сканов, много символик, сборка CMake и MSVC; строку с GS брать из bytes(), а не из text() |
| libdmtx | BSD | только DataMatrix, простой C API; медленнее zxing-cpp (в нашем сравнении 12 мс на кадр против 2 мс) |
| dmr (libscanner) | коммерческая | кадры промышленной камеры на линии: мелкий модуль, смаз, блик; ноль ложных чтений; срок на кадр |
Цифры на открытых наборах снимков — в сравнении библиотек. На корпусе из 8959 кадров производственной линии dmr прочитал 99,6 % кадров без ложных чтений, медиана — 7 мс на кадр на одном ядре вместе с декодированием JPEG.
dmr: снимок с диска
Поставка — архив для Windows (MinGW-w64) или Linux (x86-64, ARM64, ARMv7) из раздела «Загрузки» личного кабинета: заголовки, статическая библиотека C++, динамическая библиотека C ABI и утилита. Минимальная программа — один заголовок:
#include <dmr/Dmr.h>
#include <iostream>
int main() {
dmr::Image frame;
if (dmr::loadImage("kadr.jpg", frame) != dmr::LoadStatus::Ok) {
std::cerr << "не удалось прочитать файл\n";
return 1;
}
dmr::Scanner scanner; // поток кадров одной этикетки
const dmr::ScanResult r = scanner.scan(frame);
if (r.ok())
std::cout << r.text() << "\n"; // строка с настоящим GS (0x1D)
else if (r.status == dmr::Status::NotFound)
std::cout << "символа на кадре нет\n";
else
std::cout << "символ есть, прочитать не вышло\n";
}Сборка в Linux (нужен GCC 12 или новее):
g++ -std=c++20 main.cpp -o read -I/opt/dmr/include /opt/dmr/lib/libdmr.a -pthread -ldl
# или через pkg-config:
export PKG_CONFIG_PATH=/opt/dmr/lib/pkgconfig
g++ -std=c++20 main.cpp -o read $(pkg-config --static --cflags --libs dmr)В Windows статическая библиотека собрана MinGW-w64 GCC, и программа собирается тем же тулчейном (MSYS2, CLion с профилем MinGW). Пример с Meson — в документации.
Кадр с камеры, без копирования
SDK камеры отдаёт буфер в памяти — его не нужно сохранять в файл. ImageView — вид на чужой буфер: библиотека его не копирует и не освобождает.
// buf, width, height, stride — из SDK камеры; монохромная камера — Gray8
const dmr::ImageView view{ buf, width, height, stride, dmr::PixelFormat::Gray8 };
auto s = dmr::Settings::stream(); // поток кадров: подсказка с прошлого кадра
s.budgetMs = 120.0; // срок на кадр под темп линии
const dmr::Scanner scanner(s); // создать один раз, а не на каждый кадр
const dmr::ScanResult r = scanner.scan(view);Шаг строки (stride) передавайте тот, что даёт камера: строки кадра почти всегда выровнены, и ноль («плотно») здесь ошибка. Для монохромной камеры кадр передавайте как Gray8, а не размноженным в три канала — ответ тот же, а работает быстрее. Кадр OpenCV передаётся так же: { m.data, m.cols, m.rows, (int)m.step, dmr::PixelFormat::Bgr8 }.
MSVC, C#, Delphi: C ABI
Если программа собирается MSVC или написана не на C++, подключайте динамическую библиотеку с интерфейсом C (dmr_c): она не зависит ни от компилятора, ни от стандартной библиотеки C++. Текст кода в ней приходит с длиной, а не нуль-терминированной строкой: в коде бывают байты 0x1D и даже 0x00, поэтому strlen() здесь нельзя. Полный пример на C — в документации, раздел C ABI.
На что обратить внимание
- Разделитель GS. Код «Честного знака» без GS не пройдёт проверку. Не обрезайте строку по нулевому байту и не выводите её через функции, которые заменяют управляющие символы. Подробнее — в статье о разделителе GS.
- Один сканер на поток кадров. Сканер создают один раз: в режиме потока он помнит подсказку с прошлых кадров, и следующие кадры той же этикетки читаются быстрее. Для параллельной обработки заведите по сканеру на поток.
- Несколько кодов.
dmr::Settings::multi(0)читает все коды на кадре; для DataMatrix, QR и штрихкодов в одном кадре есть unir. Подробнее — в статье о нескольких кодах на снимке. - Лицензия. Первый месяц библиотека работает на машине без лицензии и без интернета; дальше ключ, в том числе для машин без сети и контейнеров.
Попробовать
Полная документация C++ — dmr и unir. Проверить свой снимок без установки — в онлайн-сканере. Если библиотека не подходит по условиям (MSVC без C ABI, macOS, мобильные платформы, открытый код), честный список альтернатив — в статье о том, когда мы не подходим.
«Честный знак» — товарный знак ООО «Оператор-ЦРПТ», «GS1» — GS1 AISBL; продукт не связан с их владельцами и ими не сертифицирован.