Die vollständige Seitengrenze
Sie definiert das physische Medium der Seite. Inhalte außerhalb können verworfen werden, ohne die beabsichtigte PDF-Seite zu verändern.
Die MediaBox beschreibt die vollständige physische Seitengrenze. Die CropBox beschreibt den Bereich, auf den ein Viewer die Anzeige oder Ausgabe normalerweise beschneidet.
Eine geänderte CropBox verändert meist nur das Sichtbare—nicht den Inhalt der PDF-Datei.
Wiederherstellungstest ansehen ↓Die Boxen sind Koordinaten im Standard-Benutzerraum. Sie steuern Anzeige, Druck, Beschnitt und Druckvorstufe; sie sind keine fünf unabhängigen Inhaltsebenen.
Sie definiert das physische Medium der Seite. Inhalte außerhalb können verworfen werden, ohne die beabsichtigte PDF-Seite zu verändern.
Sie sagt konformen Viewern, welches Rechteck angezeigt oder gedruckt wird. Sie beschneidet die Ansicht, schreibt aber den Inhaltsstrom nicht neu.
Sie kann zusätzliche Bildfläche enthalten, die Toleranzen beim Schneiden und Verarbeiten auffängt.
TrimBox beschreibt das gewünschte Endformat; ArtBox den vom Ersteller als relevant markierten Inhaltsbereich.
In unserem Letter-Beispiel blieb die MediaBox unverändert, während die CropBox nach innen rückte. Inhaltsstrom und eingebettete Ressourcen blieben in der Datei.
MediaBox [0 0 612 792]
CropBox [0 0 612 792]MediaBox [0 0 612 792]
CropBox [55.08 63.36 556.92 728.64]Das PDF-Array speichert die Koordinaten links unten und rechts oben. Doruni zeigt Ränder an, liest die vorhandene CropBox und schreibt das neue Rechteck mit setCropBox(). Die MediaBox wird nicht geändert und es findet keine Schwärzung statt.
Wir erzeugten eine harmlose PDF mit roten Markierungen außerhalb des gewünschten Ausschnitts. Nach dem Zuschneiden verschwanden sie aus der gerenderten Ansicht. Nach dem Zurücksetzen der CropBox auf die MediaBox waren dieselben Markierungen wieder sichtbar.

Äußere Markierungen sind sichtbar.

Äußere Markierungen sind ausgeblendet.

Die ursprünglichen Markierungen kehren zurück.
Alle drei Beispiele behielten nach dem Zuschneiden dieselbe MediaBox.
pdftotext fand die synthetische Außenmarkierung in jeder zugeschnittenen Datei, obwohl die normale Ansicht sie verbarg.
Nach dem Zurücksetzen der CropBox erreichte die erste Seite bei allen drei Beispielen SSIM 1,0 gegenüber dem Original.
Jede zugeschnittene Datei wurde sogar geringfügig größer: Das geänderte Seitenwörterbuch erzeugte zusätzlichen Serialisierungsaufwand, während Inhalte und Ressourcen erhalten blieben.
| Beispiel | Zustand | Bytes | MediaBox (pt) | CropBox x, y, B×H (pt) |
|---|---|---|---|---|
| PDF-TEXT | Original | 1,3 KB | 612×792 | 0, 0, 612×792 |
| PDF-TEXT | Zugeschnitten | 1,4 KB | 612×792 | 55.08, 63.36, 501.84×665.28 |
| PDF-TEXT | Wiederhergestellt | 1,3 KB | 612×792 | 0, 0, 612×792 |
| PDF-IMAGE | Original | 48,3 KB | 595.28×841.89 | 0, 0, 595.28×841.89 |
| PDF-IMAGE | Zugeschnitten | 48,3 KB | 595.28×841.89 | 59.53, 75.77, 476.22×690.35 |
| PDF-IMAGE | Wiederhergestellt | 48,3 KB | 595.28×841.89 | 0, 0, 595.28×841.89 |
| PDF-MULTI | Original | 2,4 KB | 612×792 | 0, 0, 612×792 |
| PDF-MULTI | Zugeschnitten | 2,5 KB | 612×792 | 48.96, 55.44, 514.08×681.12 |
| PDF-MULTI | Wiederhergestellt | 2,4 KB | 612×792 | 0, 0, 612×792 |
Methode: Drei projekteigene PDFs—Text, eingebettetes Bild und gemischte Seitengrößen—wurden mit derselben getCropBox()/setCropBox()-Operation wie Doruni zugeschnitten. Die Boxen wurden mit pdfinfo -box gegengeprüft, die Sichtbarkeit mit Poppler gerendert und Text mit pdftotext gesucht.
Viewer und Druckabläufe können Seitengrenzen unterschiedlich auswerten. Prüfe das Ergebnis dort, wo die Datei verwendet wird.
Technische Nutzer können pdfinfo -box file.pdf ausführen und MediaBox mit CropBox vergleichen.
Müssen Informationen unwiederbringlich sein, nutze eine geprüfte Schwärzung und kontrolliere das Endergebnis unabhängig.
Doruni ändert den sichtbaren Seitenbereich lokal. Die Datei wird nicht hochgeladen—die Operation ist jedoch Zuschneiden, keine Schwärzung oder Komprimierung.