Как создать штрихкод в формате PNG из текста или номера

Что подготовить перед созданием штрихкода

Генератор создаёт изображение штрихкода в формате PNG из переданных данных и возвращает его как данные изображения в кодировке Base64. Такой способ подходит, когда нужно подготовить штрихкод из текста или номера для последующего отображения либо передачи в другой процесс. Если отдельный формат не выбран, используется Code 128. Подпись, то есть текстовое представление данных рядом со штрихкодом, можно включить или отключить.

Перед началом подготовьте строку, которую должен содержать штрихкод. Для числовых форматов проверьте требования к количеству цифр: из входа удаляются нецифровые символы, после чего значение ограничивается числом цифр, предусмотренным выбранным форматом. В некоторых случаях контрольную цифру добавляет библиотека штрихкодов. Для обычного текста удобнее начать с Code 128, если другой формат не требуется.

Как создать PNG-штрихкод

Откройте генератор штрихкодов и найдите поле для исходных данных. Введите текст, номер или другую строку, которую нужно закодировать. Поле необязательно по определению, но без данных изображение не создаётся: результат будет успешным с указанием ошибки и без PNG.
Выберите формат штрихкода, если Code 128 по умолчанию вам не подходит. Название формата нормализуется: регистр не учитывается, а дефисы и пробелы удаляются; некоторые варианты с подчёркиванием также приводятся к соответствующей форме. Это позволяет вводить название в нескольких распространённых вариантах, но само по себе не делает формат поддерживаемым.
При необходимости задайте ширину и высоту. Значение ширины преобразуется в целое число и ограничивается диапазоном от 100 до 2000, а высота проходит такую же обработку в диапазоне от 40 до 600. Если преобразовать введённую ширину нельзя, применяется значение 400; для высоты резервное значение составляет 100. Эти правила применяются при непустых данных.
Определите, нужно ли показывать текст под или рядом со штрихкодом, с помощью настройки отображения текста. По умолчанию она включена. Отключите её, если нужен графический штрихкод без напечатанного представления исходной строки.
Запустите создание изображения. При успешной генерации результат содержит данные PNG в формате Base64. Их можно использовать там, где принимаются данные изображения в таком представлении. Если выбранный формат не поддерживается библиотекой, генерация не выполняется, а результат остаётся успешным только с указанием ошибки. При недоступности зависимости штрихкодов или исключении во время создания результат может быть неуспешным и также содержать ошибку.
Для числового формата проверьте вход до запуска. Если после удаления нецифровых символов цифр недостаточно, инструмент возвращает указание ошибки и не создаёт изображение. Поэтому номер, в котором не хватает обязательных цифр, нужно исправить, а не пытаться решить проблему изменением размера или подписи.

Как проверить результат и понять ошибку

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

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

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

Для карточки складского товара нужно получить штрихкод из буквенно-цифрового номера INV-2048.

Введите строку INV-2048, оставьте формат Code 128, сохраните отображение текста и запустите генерацию.

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

Ограничения

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

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

Причина: в числовом формате после удаления нецифровых символов осталось меньше обязательного количества цифр. Исправьте исходный номер и повторите генерацию; изменение размеров изображения эту проверку не заменяет.

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

Можно ли получить штрихкод в PNG?

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

Какой формат штрихкода выбрать?

Если формат не выбран, используется Code 128. Для другого варианта выберите формат явно и учитывайте, что название нормализуется, но поддержка самого формата не гарантируется.

Как изменить размер штрихкода?

Можно задать ширину от 100 до 2000 и высоту от 40 до 600 для непустых данных. Инструмент нормализует эти параметры, поэтому готовое PNG-изображение может иметь другие размеры в пикселях.