Riferimento tecnico PDF · Testato il 28 agosto 2026

PDF MediaBox e CropBox

MediaBox descrive il limite fisico completo della pagina. CropBox descrive l’area normalmente visualizzata o stampata da un lettore.

Modificare CropBox cambia di solito ciò che si vede, non ciò che rimane nel PDF.

Vedi il test di recupero ↓
01 · Modello di una pagina

Cinque riquadri possono descrivere una pagina PDF

I riquadri sono coordinate nello spazio utente predefinito. Guidano visualizzazione, stampa, rifilo e prestampa; non sono cinque livelli di contenuto indipendenti.

Riquadri di pagina PDF annidatiDiagramma con MediaBox come limite esterno e riquadri illustrativi progressivamente più piccoli per CropBox, BleedBox, TrimBox e ArtBox.MediaBoxCropBoxBleedBoxTrimBoxArtBox
L’annidamento è un modello esplicativo, non una regola: non tutti i PDF contengono cinque riquadri espliciti e CropBox non deve trovarsi sempre in quest’ordine. Se manca, il valore predefinito è MediaBox.
MediaBox

Il limite completo della pagina

Definisce il supporto fisico della pagina. Il contenuto esterno può essere scartato senza modificare la pagina PDF prevista.

CropBox

Il normale ritaglio di visualizzazione e stampa

Indica ai lettori conformi quale rettangolo mostrare o stampare. Impone un clipping, ma non riscrive il flusso di contenuto.

BleedBox

Abbondanza di produzione

Può includere area immagine aggiuntiva per tollerare variazioni di taglio e finitura.

TrimBox + ArtBox

Pagina finita e contenuto significativo

TrimBox descrive le dimensioni finali previste; ArtBox l’estensione del contenuto significativo stabilito dall’autore.

02 · Cosa cambia un ritaglio

Un dizionario di pagina, due rettangoli

Nel nostro esempio Letter, MediaBox è rimasto fisso mentre CropBox si è spostato verso l’interno. Il flusso di contenuto e le risorse incorporate sono rimasti nel file.

Prima
MediaBox [0 0 612 792]
CropBox  [0 0 612 792]
Dopo il ritaglio Doruni
MediaBox [0 0 612 792]
CropBox  [55.08 63.36 556.92 728.64]

L’array PDF memorizza le coordinate in basso a sinistra e in alto a destra. Doruni presenta i margini, legge il CropBox esistente e scrive il nuovo rettangolo con setCropBox(). Non modifica MediaBox e non esegue alcun oscuramento.

03 · Test originale di recupero

Nascosto alla vista. Ancora nel file.

Abbiamo generato un PDF innocuo con indicatori rossi fuori dall’area di ritaglio. Dopo il ritaglio sono spariti dal rendering. Reimpostando CropBox su MediaBox, gli stessi indicatori sono tornati visibili.

PDF di test originale con indicatori rossi esterni visibili
01 · OriginaleMediaBox = CropBox

Gli indicatori esterni sono visibili.

PDF di test ritagliato con indicatori esterni nascosti
02 · RitagliatoCropBox spostato verso l’interno

Gli indicatori esterni non sono visibili.

PDF di test ripristinato con indicatori di nuovo visibili
03 · RipristinatoCropBox reimpostato su MediaBox

Gli indicatori originali ricompaiono.

MediaBox invariato

Tutti e tre gli esempi hanno mantenuto lo stesso MediaBox dopo il ritaglio.

Contenuto ancora estraibile

pdftotext ha trovato l’indicatore sintetico esterno in ogni file ritagliato, anche se il rendering normale lo nascondeva.

Rendering ripristinato identico

Reimpostando CropBox, la prima pagina di tutti e tre gli esempi ha ottenuto SSIM 1,0 rispetto all’originale.

04 · Risultati misurati

Il ritaglio non ha ridotto questi file

Ogni file ritagliato è diventato leggermente più grande: il dizionario modificato ha aggiunto un piccolo overhead di serializzazione, lasciando intatti contenuto e risorse.

EsempioStatoByteMediaBox (pt)CropBox x, y, l×h (pt)
PDF-TEXTOriginale1,3 KB612×7920, 0, 612×792
PDF-TEXTRitagliato1,4 KB612×79255.08, 63.36, 501.84×665.28
PDF-TEXTRipristinato1,3 KB612×7920, 0, 612×792
PDF-IMAGEOriginale48,3 KB595.28×841.890, 0, 595.28×841.89
PDF-IMAGERitagliato48,3 KB595.28×841.8959.53, 75.77, 476.22×690.35
PDF-IMAGERipristinato48,3 KB595.28×841.890, 0, 595.28×841.89
PDF-MULTIOriginale2,4 KB612×7920, 0, 612×792
PDF-MULTIRitagliato2,5 KB612×79248.96, 55.44, 514.08×681.12
PDF-MULTIRipristinato2,4 KB612×7920, 0, 612×792

Metodo: Tre PDF di proprietà del progetto—testo, immagine incorporata e pagine di dimensioni miste—sono stati ritagliati con la stessa operazione getCropBox()/setCropBox() di Doruni. I riquadri sono stati verificati con pdfinfo -box, la visibilità con Poppler e la presenza del testo con pdftotext.

05 · Scegli l’operazione corretta

Ritaglio, oscuramento, eliminazione e compressione sono operazioni diverse

Cambiare l’area visibile o stampataRitaglio / CropBoxSupportato da Doruni
Rimuovere definitivamente dati sensibiliOscuramento verificato o rimozione sicuraNon supportato
Ridurre i byte del fileCompressione e ottimizzazione delle risorseNon supportato da Ritaglia PDF
Ridimensionare la pagina fisica e trasformare il contenutoRidimensionamento pagina / trasformazioneNon supportato
Usa CropBox per
  • Rimuovere margini bianchi dalla vista normale
  • Concentrare la pagina sull’area visiva rilevante
  • Preparare un’inquadratura per schermo o stampa
Non usare CropBox per
  • Nascondere dati personali o riservati
  • Eliminare clausole contrattuali o annotazioni
  • Garantire un PDF più piccolo
06 · Lista di verifica

Come controllare un PDF ritagliato

  1. 01

    Aprilo in più lettori

    Lettori e flussi di stampa possono interpretare diversamente i limiti di pagina. Verifica il risultato dove il file sarà usato.

  2. 02

    Controlla i riquadri, non solo lo screenshot

    Gli utenti tecnici possono eseguire pdfinfo -box file.pdf e confrontare MediaBox con CropBox.

  3. 03

    Considera i dati sensibili ancora presenti

    Se un’informazione deve diventare irrecuperabile, usa un flusso di oscuramento verificato e controlla il risultato finale separatamente.

Riferimenti principali

Definizioni verificate sulla specifica PDF

Cambia la vista

Ritaglia un PDF nel browser

Doruni modifica localmente l’area visibile della pagina. Il file non viene caricato, ma l’operazione è un ritaglio, non oscuramento o compressione.

Apri Ritaglia PDF