MediaBox, CropBox, BleedBox: qual caixa de página você está vendo?

Uma página de PDF não é um único retângulo. O formato guarda várias caixas de página para que impressoras, visualizadores e editores possam discordar sobre "o tamanho da página". Quando um recorte parece errado, ou a gráfica pede sangria, normalmente a discussão é sobre qual caixa está valendo.

As caixas, em termos simples

• MediaBox: a área total da página; a maior caixa, que define o tamanho da mídia. Toda página deve ter uma.
• CropBox: a região que os visualizadores mostram como página visível. Se for omitida, o padrão é a MediaBox.
• BleedBox: a região que inclui a sangria além da borda de corte, para impressão comercial.
• TrimBox: o tamanho final pretendido depois do corte.
• ArtBox: a extensão do conteúdo significativo (menos comum em PDFs de escritório).

Os visualizadores quase sempre desenham a CropBox. Softwares de pré-impressão se importam com BleedBox e TrimBox. Confundir as duas produz o clássico relato "recortei, mas a impressora ainda vê as margens antigas": a janela na tela mudou, mas a MediaBox ou a TrimBox ainda anunciam a área antiga.

As coordenadas ficam no user space do PDF. Um ponto equivale a 1/72 de polegada. A origem é o canto inferior esquerdo da caixa descrita, não o canto superior esquerdo de uma janela na tela. Ferramentas que recebem "X, Y, largura, altura" estão descrevendo um retângulo nesse espaço.

Recortar muda o limite visível

No PDF123, o Crop recebe X, Y, largura e altura em pontos e grava esse retângulo em ambas, MediaBox e CropBox, em todas as páginas. Assim, visualizadores que respeitam a CropBox e ferramentas que leem a MediaBox enxergam o mesmo tamanho de página depois da operação. O conteúdo fora da nova caixa fica escondido, mas o fluxo de conteúdo por baixo não é necessariamente apagado. Primeiro a geometria; eliminar operadores de desenho que ninguém mais usa é outro trabalho.

Outros aplicativos às vezes alteram só a CropBox e deixam a MediaBox intacta. Reabrir esse arquivo em outro lugar pode parecer um recorte "que falhou" quando na verdade é divergência entre caixas. Antes de concluir que o arquivo está quebrado, verifique qual caixa cada ferramenta exibe.

O Crop não reescreve BleedBox, TrimBox nem ArtBox. Se um fluxo de impressão ainda lê esses dicionários, eles podem continuar descrevendo a página de antes do recorte até que uma ferramenta de pré-impressão os atualize. Trabalhos do tipo "apare esta margem para mandar por e-mail" normalmente só se importam com o alinhamento entre MediaBox e CropBox, que é exatamente o que este caminho de Crop define.

Escalar é outra alavanca

Escalar páginas muda o tamanho da página (A4, Letter, um fator de escala) em vez de recortar uma janela dentro da área atual. Ele também define MediaBox e CropBox no tamanho de destino e envolve o conteúdo da página numa transformação de escala, para que o desenho caiba na nova área. Use o crop quando quiser manter uma região e esconder o resto. Use o scale quando a página inteira precisar ir para um tamanho de papel de destino.

Recortar uma página letter para uma janela de 200×200 pt e escalar essa mesma página letter para A4 não são operações intercambiáveis. Uma descarta da vista tudo o que está fora do retângulo; a outra remapeia a página inteira para um novo tamanho de mídia.

Diagnosticar um arquivo com “tamanho errado”

Quando a gráfica diz que a página continua letter depois que você "recortou" em outro aplicativo, exporte ou inspecione MediaBox e CropBox separadamente. Uma alteração apenas na CropBox pode parecer correta no visualizador enquanto a MediaBox ainda informa a área antiga ao software de imposição. O Crop do PDF123 evita essa divergência gravando o mesmo retângulo nas duas.

Se as páginas parecem cortadas depois de um merge ou de uma importação, verifique se alguma ferramenta anterior definiu uma CropBox menor que a MediaBox sem atualizar as duas. O Get Info informa a contagem de páginas e a criptografia, não as coordenadas das caixas; quando precisar dos números, use uma ferramenta de inspeção de PDF ou os campos em pontos da interface de crop.

O que fica disso

Pergunte "qual caixa estou vendo?" antes de confiar nos milímetros da tela. Se duas ferramentas discordam do tamanho da página, compare MediaBox e CropBox antes de culpar corrupção. Para recortar de forma interativa: Recortar um PDF, sem conta. Para automação, os mesmos campos de geometria existem em POST /api/v1/general/crop; veja Desenvolvedores.