Как настроить новые режимы отрисовки QR-кода в FastReport .NET
По умолчанию QR-код состоит из квадратных модулей (точек). В новой версии FastReport .NET добавлена возможность их кастомизации.
Рассмотрим, как заменить стандартные модули на декоративные фигуры: круги, звёзды, шестиугольники и другие. Разберём свойства, необходимые для настройки – всего несколько опций для уникального результата.
Для изменения внешнего вида модулей QR-кода используются три свойства: Shape, Angle и UseThinModules. Рассмотрим каждое из них.
Shape свойство QR-кода
Первое и главное свойство – Shape. Оно определяет форму модулей. Сейчас доступно 10 вариантов фигур:
1. Квадрат (Rectangle) – стандартный вид QR-кода
2. Круг (Circle)
3. Ромб (Diamond)
4. Скругленный квадрат (RoundedSquare)
5. Горизонтальная капсула (PillHorizontal)
6. Вертикальная капсула (PillVertical)
7. Плюс (Plus)
8. Шестиугольник (Hexagon)
9. Звезда (Star)
10. Снежинка (Snowflake)
Примеры QR-кодов со всеми поддерживаемыми декоративными фигурами доступны на второй странице демо-отчета Qr-Codes.frx.
Angle свойство QR-кода
Это свойство задает угол поворота (в градусах) для каждого модуля QR-кода. Работает только для фигур: Hexagon (шестиугольник), Star (звезда) и Snowflake (снежинка). Для остальных фигур данное свойство игнорируется.
UseThinModules свойство QR-кода
Свойство UseThinModules управляет визуальной плотностью модулей (точек) в QR-коде. При UseThinModules = false (по умолчанию) модули занимают всё доступное пространство в своей ячейке, точки соприкасаются друг с другом без промежутков – QR-код выглядит сплошным и плотным. При UseThinModules = true размер модулей уменьшается, между ними появляются видимые промежутки – QR-код выглядит более разреженным, создаётся эффект «сетки» или «точечного узора».
Что влияет на считывание QR‑кода
- Поисковые паттерны (Finder Patterns — большие квадраты в углах QR-кода, которые помогают сканеру определить положение, размер и ориентацию кода) НЕ изменяются при использовании свойства UseThinModules. Они всегда остаются полноразмерными, чтобы сканер мог надёжно распознать код.
- Декоративные модули улучшают внешний вид QR-кода, но могут влиять на надёжность считывания. Не все сканеры одинаково хорошо распознают фигурные модули – стандартные квадратные модули поддерживаются всеми сканерами без исключений, тогда как декоративные фигуры (особенно сложные, такие как Snowflake и Star) могут плохо считываться старыми моделями сканеров и некоторыми мобильными приложениями. Обязательно проверяйте считывание кода на разных устройствах.
- Для надёжного сканирования необходим чёткий контраст между модулями и фоном. Хорошо работают чёрные модули на белом фоне или тёмно-синие на светло-сером. Плохо считываются светло-серые модули на белом фоне и цветные модули на цветном фоне с низким контрастом. Запомните правило: модули должны быть значительно темнее фона.
- Фигуры Snowflake и Star имеют сложную геометрию с мелкими деталями. При маленьком размере эти детали сливаются, и сканер не может корректно распознать модули. Используйте Snowflake и Star для крупных кодов. Для маленьких кодов выбирайте Square, Circle или RoundedSquare. Используйте свойство UseThinModules с осторожностью – промежутки между модулями могут ухудшить считывание на маленьком размере.
-
Уровень коррекции ошибок (свойство ErrorCorrection) также влияет на надёжность. Для декоративных модулей рекомендуется уровень Q или H. Учтите, что высокий уровень коррекции увеличит размер кода, но повысит надёжность считывания.
Подведем итог. Декоративные модули – это баланс между красотой и функциональностью. Чем сложнее фигура, тем больше требований к размеру, контрасту и качеству печати. Всегда тестируйте готовый код перед массовым использованием.
