MediaBox, CropBox, BleedBox: на какой прямоугольник страницы я смотрю?
PDF хранит MediaBox, CropBox, BleedBox и TrimBox. PDF123 Crop задаёт MediaBox и CropBox одним прямоугольником, чтобы просмотрщики и размер носителя совпадали.

Страница PDF — не один прямоугольник. Формат хранит несколько рамок страницы, чтобы типографии, просмотрщики и редакторы могли расходиться в понимании «размера страницы». Когда обрезка выглядит неправильно или типография просит вылеты, спор обычно идёт о том, какая рамка сейчас в игре.
Рамки простыми словами
- MediaBox: полный холст страницы; самая большая рамка, задающая размер носителя. Ожидается, что она есть у каждой страницы.
- CropBox: область, которую просмотрщики показывают как видимую страницу. Если она опущена, по умолчанию берётся MediaBox.
- BleedBox: область, включающая вылет за линию обрезки для коммерческой печати.
- TrimBox: предполагаемый конечный размер после резки.
- ArtBox: границы значимого содержимого (реже встречается в офисных PDF).
Просмотрщики почти всегда отрисовывают CropBox. Допечатное ПО работает с BleedBox и TrimBox. Их путаница порождает классическую жалобу «я обрезал, а типография всё ещё видит старые поля»: окно на экране сдвинулось, но MediaBox или TrimBox по-прежнему описывают старый холст.
Координаты задаются в пользовательском пространстве PDF. Один пункт равен 1/72 дюйма. Начало отсчёта — левый нижний угол описываемой рамки, а не левый верхний угол экранного окна. Инструменты, принимающие «X, Y, ширина, высота», описывают прямоугольник в этом пространстве.
Обрезка меняет видимую границу
В PDF123 Crop принимает X, Y, ширину и высоту в пунктах и записывает этот прямоугольник в обе рамки, MediaBox и CropBox, на каждой странице. Поэтому просмотрщики, уважающие CropBox, и инструменты, читающие MediaBox, после операции видят одинаковый размер страницы. Содержимое за пределами новой рамки скрыто из вида; сам поток содержимого при этом не обязательно удаляется. Сначала геометрия; измельчение неиспользуемых операторов рисования — отдельная задача.
Другие приложения иногда меняют только CropBox, оставляя MediaBox нетронутым. Если открыть такой файл в другом месте, это может выглядеть как «неудавшаяся» обрезка, хотя на деле это несовпадение рамок. Прежде чем считать файл сломанным, посмотрите, какую рамку показывает каждый инструмент.
Crop не переписывает BleedBox, TrimBox или ArtBox. Если печатный процесс всё ещё читает эти словари, они могут описывать страницу до обрезки, пока допечатный инструмент их не обновит. Офисные задачи вроде «обрезать поле для письма» обычно заботятся только о согласовании MediaBox и CropBox — именно его и задаёт этот путь Crop.
Масштаб — другой рычаг
Масштабирование страниц меняет размер страницы (A4, Letter, коэффициент масштаба), а не вырезает окно внутри текущего холста. Оно тоже задаёт MediaBox и CropBox равными целевому размеру и оборачивает содержимое страницы в преобразование масштаба, чтобы рисунок поместился на новом холсте. Используйте crop, когда нужно сохранить область и скрыть остальное. Используйте scale, когда вся страница должна отобразиться в целевой бумажный размер.
Обрезать страницу Letter до окна 200×200 pt и масштабировать ту же страницу Letter до A4 — не одно и то же. Первое отбрасывает (из вида) всё за пределами прямоугольника; второе переносит всю страницу в новый размер носителя.
Диагностика файла «неправильного размера»
Когда типография говорит, что страница всё ещё размера Letter после того, как вы «обрезали» её в другом приложении, выгрузите или проверьте MediaBox и CropBox по отдельности. Изменение только CropBox может выглядеть правильным в просмотрщике, тогда как MediaBox всё ещё сообщает старый холст программе спуска полос. PDF123 Crop избегает этого расхождения, записывая один и тот же прямоугольник в обе рамки.
Если после слияния или импорта страницы выглядят обрезанными, проверьте, не задал ли вышестоящий инструмент CropBox меньше MediaBox, не обновив обе рамки. Get Info сообщает число страниц и шифрование, а не координаты рамок: когда нужны числа, воспользуйтесь инспектором PDF или полями в пунктах в интерфейсе обрезки.
Практический вывод
Спросите «на какую рамку я смотрю?», прежде чем доверять миллиметрам на экране. Если два инструмента расходятся в размере страницы, сравните MediaBox и CropBox, прежде чем винить повреждение. Для интерактивной обрезки: Обрезать PDF, аккаунт не нужен. Для автоматизации те же поля геометрии есть в POST /api/v1/general/crop; см. Разработчикам.