← Статьи

Чтение DataMatrix в C++: zxing-cpp, libdmtx или dmr — сборка и кадр с камеры

Программа на C++ получает кадр с камеры или снимок с диска, и из него нужно достать строку кода DataMatrix — например, код «Честного знака» с разделителем GS. Ниже — из чего выбрать, как собрать и подключить нашу библиотеку dmr и на что обратить внимание, чтобы не потерять разделитель и не сорвать темп линии.

Из чего выбрать

БиблиотекаЛицензияКогда брать
zxing-cppApache 2.0чистые коды со снимков и сканов, много символик, сборка CMake и MSVC; строку с GS брать из bytes(), а не из text()
libdmtxBSDтолько 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; продукт не связан с их владельцами и ими не сертифицирован.