Как создать QR-код из текста или URL в формате PNG

Для каких задач подходит QR-генератор

Генератор превращает непустой текст или URL в изображение QR-кода. Такой результат подходит для ссылки на меню, страницы с контактами, короткой инструкции или другого содержимого, которое нужно представить в графическом виде.

Содержимое можно передать через основное поле данных либо через поддерживаемый вариант text, url или content. Если значение не задано, основное поле получает пустое содержимое, поэтому изображение не формируется. Успешный ответ содержит PNG в виде непустой строки Base64.

Перед началом определите, что именно должен содержать код: полный адрес страницы или обычный текст. Для ссылки передавайте сам URL как значение, а не только название страницы. Для сообщения используйте текст без замены его на описание. Это помогает заранее понимать, какое содержимое будет закодировано.

Размер, уровень коррекции и цвета можно оставить стандартными либо настроить под задачу. При этом настройки меняют параметры создаваемого изображения, но не превращают пустой ввод в QR-код. Наличие результата нужно оценивать по возвращённым данным, а не по тому, что операция была запущена.

Порядок передачи данных и настройки параметров

Подготовьте непустое значение. Вставьте URL целиком или введите текст, который должен быть закодирован. Перед запуском убедитесь, что поле не осталось пустым.
Передайте содержимое через основное поле данных. Если для вашей формы удобнее отдельное имя, используйте text, url или content. Выберите один способ и проверьте, что значение действительно попало в соответствующий ввод.
При необходимости задайте размер изображения. Если размер не указан, используется 256. Перед обработкой введённое значение преобразуется в целое число; при ошибке такого преобразования применяется 256. Затем нормализованный размер ограничивается диапазоном от 64 до 1024.
Учитывайте, что число размера не обязано совпадать с итоговой шириной или высотой PNG в пикселях. После нормализации рассчитывается целочисленный масштаб модулей QR-кода, поэтому фактические пиксельные размеры могут отличаться от запрошенного значения.
При необходимости выберите строковый уровень коррекции L, M, Q или H. Значение переводится в верхний регистр, а неподдерживаемый вариант заменяется на M. Если настройка отсутствует, также используется M.
При необходимости настройте цвет переднего плана и фон. Стандартная комбинация использует чёрный передний план и белый фон.
Запустите обработку и рассмотрите ответ. При успешной генерации возвращается непустая строка Base64, из которой получается PNG. Пустое содержимое или сбой генерации могут привести к отсутствию изображения, поэтому при таком результате сначала проверьте ввод, а затем учитывайте обе возможные причины.

Проверка PNG и трактовка отсутствующего результата

Сначала проверьте, что ответ содержит непустую строку Base64. Успешный результат имеет именно такую форму, а декодирование этой строки даёт PNG с изображением QR-кода. Само наличие ответа без изображения ещё не подтверждает, что генерация завершилась успешно.

Сопоставьте итоговый файл с выбранными параметрами. Если вы указали размер, его значение могло быть преобразовано в целое число и ограничено диапазоном 64-1024. Кроме того, расчёт масштаба модулей способен изменить фактическое число пикселей, поэтому отличие размеров файла от введённого числа не обязательно означает ошибку.

Если изображение отсутствует при пустом вводе, это ожидаемая граница работы: обработка без содержимого не выполняется. Когда содержимое было передано, но изображения нет, по одному этому признаку нельзя установить причину, поскольку возможен сбой генерации или недоступная зависимость.

Уровень L, M, Q или H описывает выбранную настройку коррекции ошибок. Приведённые сведения не подтверждают конкретные характеристики считывания, соответствие стандартам или успешное декодирование для каждого содержимого. Поэтому оцените сам PNG и проверьте его пригодность в том сценарии, где он будет использоваться.

Практический пример

Владелец кафе хочет превратить ссылку на онлайн-меню в изображение QR-кода для печати на стойке и выбирает стандартный размер.

Для страницы меню кафе передайте полный адрес меню через вариант url, не задавайте размер и запустите создание изображения. Затем проверьте, что ответ содержит непустую строку Base64, и декодируйте её в PNG для дальнейшей проверки файла на выбранном носителе или в нужном приложении.

После успешной обработки ответ содержит непустую строку Base64, декодирование которой даёт PNG с изображением QR-кода; итоговые пиксельные размеры могут отличаться от 256.

Ограничения

Пустой ввод не даёт изображения, фактические размеры PNG могут отличаться от запрошенного числа, а сбой генерации может оставить результат без изображения.

Частые ошибки

Причина: значение не передано через основное поле или поддерживаемый вариант ввода. Исправление: укажите непустой текст либо URL, выберите соответствующее поле и проверьте его перед запуском.

Частые вопросы

Можно ли создать QR-код из URL?

Если URL передан как непустое содержимое через основное поле или вариант url, успешная обработка возвращает PNG в непустой строке Base64. Пустое значение не создаёт изображение, поэтому сначала проверьте сам адрес.

Какой размер изображения выбрать?

При отсутствии настройки используется размер 256. Введённое значение преобразуется в целое число и ограничивается пределами от 64 до 1024, а итоговые пиксельные размеры PNG могут отличаться из-за расчёта масштаба модулей.

Что произойдёт, если оставить поле пустым?

Изображение не создаётся, когда содержимое не передано. Введите непустой текст или URL; если значение присутствует, но результата нет, причиной может быть сбой генерации или недоступная зависимость, а не только ошибка ввода.