Если этикетка выходит боком, сначала уберите из цепочки приложение и драйвер: отправьте на принтер минимальный формат с рамкой, подписью «TOP» и координатами. Если он печатается правильно, механика и базовая ориентация понятны, а поворот добавляет драйвер или шаблон. Если неверно уже здесь, проверяйте формат, размеры в точках и настройки самого принтера.
Ниже команды относятся к принтерам, которые понимают ZPL. Для другой модели используйте её язык и руководство: похожая кнопка в драйвере не гарантирует одинаковой семантики. Перед тестом сохраните текущую конфигурацию и не отправляйте команды сброса — ориентацию можно проверить обычной одноразовой этикеткой.
Поворот может появиться на четырёх уровнях
| Слой | Характерный признак | Контрольный тест |
|---|---|---|
| носитель и датчик | сдвиг между этикетками, печать через зазор | калибровка и configuration label |
| драйвер/страница | preview верен, физическая печать повернута | raw job в обход драйвера |
| формат ZPL | каждая копия повёрнута одинаково | минимальный ^XA…^XZ с ^PON |
| отдельное поле | текст боком, рамка и штрихкод верны | проверить ^FW и orientation конкретной команды |
Запишите точный физический размер, направление подачи, DPI и размер шаблона в dots. Для 203 и 300 dpi одна и та же ширина в миллиметрах превращается в разное количество точек. Ошибка здесь часто выглядит как поворот: координаты уходят за печатную область, а оператор пытается «вернуть» содержимое галочкой Landscape.
Минимальный ZPL отделяет общую ориентацию от полей
^XA
^PON
^PW800
^LL400
^LH0,0
^FO20,20^GB760,360,3^FS
^FO40,40^A0N,42,42^FDTOP / X=40 Y=40^FS
^FO40,110^GB200,100,2^FS
^XZ`^PO` задаёт ориентацию всего формата: `N` — normal, `I` — инверсия на 180 градусов. Это не команда поворота на 90 градусов. `^FW` задаёт ориентацию полей по умолчанию, а некоторые команды штрихкодов имеют собственный параметр orientation. Поэтому не добавляйте одновременно поворот страницы в Windows, `^POI` и `^FWR`: несколько преобразований маскируют первопричину.
- `^PW` задаёт ширину печати в точках и не должен превышать возможности принтера.
- `^LL` задаёт длину этикетки; она сверяется с фактической подачей носителя.
- `^LH` переносит начало координат всего формата.
- `^FO` размещает конкретное поле относительно начала координат.
- `^FW` меняет ориентацию полей по умолчанию, но у отдельных типов полей есть свои правила.
Raw-печать и печать через драйвер сравниваются одним файлом
Сохраните минимальный ZPL как неизменяемый тестовый артефакт и отправьте его способом, который не преобразует данные в PDF или bitmap. Затем тот же макет проведите через production-путь. Если raw-результат правильный, сравните spool format, настройки Portrait/Landscape, page size и наличие «rotate 90°» в драйвере. Если оба результата неверны одинаково, вернитесь к ZPL и конфигурации принтера.
При PDF-печати добавляется ещё один слой: размер страницы PDF, автоматический поворот и масштабирование «Fit to page». Для этикеток отключите автоориентацию и проверьте печать 100%, иначе драйвер может вписать портретную страницу в альбомный носитель. Сырой файл задания и скриншот настроек сохраняйте вместе с фотографией результата.
Смещение после поворота объясняется координатами
По документации Zebra `^POI` инвертирует координаты, поэтому после поворота на 180 градусов может понадобиться другой `^LH`, чтобы вернуть печать в физическую область. Не компенсируйте это случайными отрицательными смещениями в каждом поле. Сначала задайте правильные `^PW`, `^LL` и общий home, затем расставляйте элементы.
Протокол одной пробы:
printer=ZD421d, dpi=203
media=100x50 mm, gap, feed=short-edge
source=minimal-orientation-v1.zpl
path=raw TCP 9100
^PO=N, ^PW=800, ^LL=400, ^LH=0,0
result=TOP у передней кромки, рамка целиком
next=повторить через production driver без rotation/fitПриёмка проводится на реальном наборе форматов
- Распечатать configuration label и записать модель, DPI, media type и текущий язык.
- Проверить минимальную рамку на рабочем рулоне после штатной калибровки.
- Напечатать production-шаблон напрямую и через приложение, сравнить ориентацию и обрезание.
- Повторить на каждом поддерживаемом размере этикетки, не переиспользуя width/length вслепую.
- Перезагрузить принтер и повторить одну пробу, чтобы обнаружить непреднамеренно сохранённую настройку.
Исправление завершено, когда ориентация задаётся в одном выбранном слое, рамка не обрезается, текст и штрихкод читаются, а результат воспроизводится после перезапуска. Контрольный ZPL остаётся рядом с документацией интеграции: по нему новый принтер проверяется до подключения сложного шаблона.