Генератор макетов в браузере: миллиметры в пиксели 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).
Эти шаги не обещают, что макет совпадёт с ожиданием типографии до последнего пикселя, — но убирают самые частые причины пустого и мыльного файла. Остальное проверяется на реальном макете и реальных требованиях печати.