На главную

DF-ВЕБ-027 · Контент и сайты

Генератор макетов в браузере: миллиметры в пиксели Canvas

Редакция Deskforge · 13 ноября 2026 · 6 мин чтения
Генератор макетов в браузере: миллиметры в пиксели Canvas
Из статьи вы узнаете
  • Как считать пиксели битмапа из миллиметров и плотности печати
  • Чем размер битмапа отличается от CSS-размера и координат контекста
  • Зачем нужен devicePixelRatio и где он подводит
  • Как проверить результат перед экспортом и не потерять рисунок

Печатный макет задан в миллиметрах: визитка 90×50, постер A3, обложка под резку. Canvas же ничего не знает про миллиметры — у него есть только битмап в пикселях. Если открыть документацию впервые, легко решить, что достаточно подставить размеры как есть и нарисовать. Дальше выясняется, что картинка на экране и файл на выгрузке — разные вещи, и обе надо свести к одному числу.

Ниже — порядок решений для генератора макетов, который работает целиком в браузере, без сервера. Разберём, что именно задают атрибуты canvas, как считать пиксели из миллиметров и плотности, зачем нужен devicePixelRatio и как проверить результат до экспорта. Это редакционный разбор по спецификации и документации, а не отчёт об испытании продукта и не клиентский кейс: числа и шаги нужно адаптировать к вашему макету.

Смежная тема — этапы разработки сайта: от задачи до запуска, а варианты работ с сайтами и кабинетами собраны на странице контента и сайтов.

Задача: макет в миллиметрах, а Canvas считает в пикселях

Canvas API даёт средство рисования графики через JavaScript и элемент canvas; его применяют, среди прочего, для визуализации данных и обработки фото (F14). Для генератора макетов это удобно: весь рисунок собирается на клиенте, сервер не нужен. Но единицы измерения у Canvas свои.

Атрибуты width и height задают размеры битмапа и должны быть неотрицательными целыми числами (F1). Миллиметров среди них нет. Значит, первым делом нужно перевести физический размер в пиксели — и уже это число отдать атрибутам.

Перевод опирается на плотность печати: пиксели = миллиметры ÷ 25,4 × dpi. Для визитки 90 мм при 300 dpi это примерно 1063 пикселя по ширине. Округление обязательно: атрибут принимает только целое, а дробное значение браузер приведёт к целому сам, и вы потеряете контроль над результатом.

Что именно задают width и height: битмап, а не CSS-размер

Самая частая путаница: считать, что width и height — это размер элемента на экране. Нет. Эти атрибуты задают битмап, а размер элемента на странице задаёт CSS. Спецификация прямо говорит: canvas можно произвольно менять размером через таблицу стилей, и тогда его битмап подчиняется свойству object-fit (F3).

Если атрибуты не заданы вовсе, действуют значения по умолчанию — 300 и 150 (F2). Генератор, который забыл их выставить, нарисует макет в этом маленьком битмапе, а CSS растянет его до нужного размера на экране. Картинка будет мыльной, и никакая плотность печати этого не исправит.

В спецификации есть наглядный пример: canvas с width=200 и height=200 и стилем 100×100 CSS-пикселей имеет выходной битмап 200×200, но отображается как 100×100 CSS-пикселей (F6). То есть в памяти вдвое больше точек, чем видно на экране. Для печати это как раз то, что нужно: запас детализации хранится в битмапе, а не размазывается по экрану.

Координаты контекста и внутренние битмапы — не одно и то же

Когда вы рисуете прямоугольник в контексте, вы работаете в координатах контекста. Спецификация описывает их так: правый край равен ширине выходного битмапа в CSS-пикселях, нижний — высоте в CSS-пикселях (F4). Это удобно для интеграции с вёрсткой, но не равно физическому размеру печати.

Дальше — важная оговорка. Размер координатного пространства не обязательно совпадает с размером битмапов, которые браузер использует внутренне или при рендеринге (F5). Иными словами, вы задаёте одно, браузер может держать в памяти другое, а на экран выводить третье. Полагаться на то, что все три числа совпадут, нельзя.

Практический вывод для генератора: считайте пиксели битмапа сами, из миллиметров и dpi, и не выводите их обратно из координат контекста. Так у вас будет одно проверяемое число, а не догадка о том, что сделал браузер.

Плотность пикселей: devicePixelRatio и его ограничения

На экране к пикселям добавляется ещё один множитель. devicePixelRatio возвращает отношение разрешения в физических пикселях к разрешению в CSS-пикселях для текущего устройства отображения (F10). На обычном мониторе это часто 1, на экранах с высокой плотностью — 2 и больше.

MDN предлагает для canvas на таких экранах задавать CSS-размер, умножать размер в памяти на devicePixelRatio и масштабировать контекст через ctx.scale(scale, scale) (F12). Тогда рисунок остаётся чётким, а координаты в коде можно писать в CSS-пикселях.

Но у этого множителя есть ловушки. Масштабирование страницы (zoom) влияет на значение devicePixelRatio, а pinch-zoom — нет (F11). Значит, значение может измениться прямо во время работы, и рисунок нужно пересобрать. MDN предлагает отслеживать изменение через matchMedia с медиазапросом вида (resolution: Ndppx) и событием change (F13).

И главное для печати: devicePixelRatio — про экран, а не про бумагу. Плотность печати (dpi) вы задаёте сами, из требований типографии. Смешивать эти два множителя в одной формуле нельзя: получите макет, который хорош на мониторе автора и неверен в файле.

Переустановка размеров очищает canvas: как не потерять макет

Отдельная неприятность поджидает при изменении размеров. При установке, изменении или повторной установке атрибутов width и height браузер выполняет действие, зависящее от режима контекста (F7). В режиме 2d изменение размеров битмапа сбрасывает контекст рендеринга в состояние по умолчанию (F8).

Проще говоря, всё нарисованное исчезает. В спецификации есть пример: строка canvas.width = canvas.width очищает canvas, поэтому из трёх нарисованных квадратов остаётся только последний (F9). Присвоение того же значения — уже повод для сброса.

Для генератора это значит: порядок операций важен. Сначала выставляете размеры битмапа, потом масштаб контекста, потом рисуете. Если пользователь поменял формат макета, вы пересобираете всё заново, а не пытаетесь дорисовать поверх. И не «оптимизируйте» лишним присвоением width — оно сотрёт работу.

Проверка перед экспортом: пустой битмап и ограничения безопасности

Экспорт в браузере делается через toBlob: метод создаёт Blob с изображением из canvas и вызывает колбэк с этим объектом (F17). Перед вызовом стоит проверить, что битмап вообще не пустой.

Крайний случай описан в спецификации: если у битмапа нет пикселей, то есть одно из измерений равно нулю, toDataURL возвращает строку "data:," (F18). Пустой файл вместо макета — типичный результат ошибки в расчёте миллиметров или dpi. Проверяйте ширину и высоту до экспорта, а не после.

Второе ограничение — безопасность. Если флаг origin-clean битмапа равен false, toDataURL выбрасывает SecurityError (F19). Так бывает, когда на canvas попали изображения с чужого домена без разрешения. Для генератора это практический вопрос: откуда берутся картинки, которые пользователь кладёт в макет.

Читаемость и доступность результата

Canvas — это битмап, и его содержимое не раскрывается инструментам доступности так, как семантический HTML (F15). Для генератора макетов это ограничение стоит держать в голове: подписи, поля и кнопки управления лучше держать обычной вёрсткой, а canvas оставить сам рисунок.

Ещё одно свойство растровой природы: пиксели внутри canvas не масштабируются как вектор и при увеличении могут становиться размытыми (F16). Поэтому запас пикселей под печать закладывается заранее, при расчёте битмапа, а не растягиванием готового рисунка.

Чек-лист проверки масштаба перед выгрузкой

Соберём порядок в короткий список, который можно пройти перед экспортом.

  • Посчитайте пиксели из миллиметров и dpi, округлите до целого и проверьте, что оба числа больше нуля — иначе получите пустой битмап (F18).
  • Выставьте width и height битмапа до рисования и не переустанавливайте их без пересборки: контекст сбросится (F8).
  • Отделите экранный множитель от печатного: devicePixelRatio — про дисплей (F10), dpi — про бумагу.
  • Проверьте координаты контекста: они в CSS-пикселях и не равны физическому размеру печати (F4).
  • Убедитесь, что на canvas нет чужих изображений без разрешения, иначе экспорт упадёт с SecurityError (F19).
  • Если страница часто читает данные из canvas, рассмотрите willReadFrequently=true: это подсказка браузеру, что выгоден программный canvas (F20).

Эти шаги не обещают, что макет совпадёт с ожиданием типографии до последнего пикселя, — но убирают самые частые причины пустого и мыльного файла. Остальное проверяется на реальном макете и реальных требованиях печати.

Источники

Назад