8. Namensraum fix:: — Normalisierung

← codes:: · Inhalt · Weiter: data:: →

19 Operationen, die das PDF verändern und unter einem neuen Namen speichern. Die Ausgangsdatei wird nie angerührt.

8.1 Wie man es benutzt

fix:: ist der einzige Namensraum, der schreibt, und hat deshalb einen eigenen Befehl:

pdfl fix eingabe.pdf skript.pdfl --output korrigiert.pdf

Ein fix::-Aufruf unter pdfl run erzeugt einen Fehler, der den richtigen Befehl nennt — damit niemand eine Datei verändert, während er glaubt, sie nur zu prüfen.

Wie die Operationen ablaufen

// Dieses Skript braucht keine checks: Das sind Befehle,
// die der Reihe nach ausgeführt werden.
fix::set_trim_box(8.5, 8.5, 586.5, 833.5)
fix::add_page_numbers()
fix::add_watermark("DRAFT")

Jeder Aufruf wird an Ort und Stelle geprüft (nicht vorhandene Seite, ungültige Drehung, fehlende Datei), bevor er angewandt wird. Der Bericht hält im Feld fixes fest, was geschehen ist:

"fixes": [
  "TrimBox set to [8.5, 8.5, 586.5, 833.5]",
  "page numbering added",
  "watermark \"DRAFT\" added"
]

Prüfungen und Änderungen im selben Skript zu mischen, ist völlig in Ordnung:

// Erst prüfen, dann ändern — hält die Bedingung nicht, steht es im Bericht
check "Preconditions" {
  require doc.page_count > 0
  assert !struct::check_encryption(), "file is encrypted, cannot fix it"
}

fix::add_page_numbers()

8.2 Seitenrahmen

Koordinaten in Punkt, von unten links nach oben rechts.

// Mit Einheiten schreiben, die Umrechnung geschieht von selbst
fix::set_page_size(210mm, 297mm)

// Die Datei vom Verlag hat keine Produktionsrahmen:
// TrimBox = Endformat, BleedBox = mit 3 mm Anschnitt
fix::set_trim_box(8.5, 8.5, 586.5, 833.5)
fix::set_bleed_box(0, 0, 595, 842)

8.3 Seiten

Die einzige Seite eines Dokuments zu löschen, wird ausdrücklich abgelehnt.

fix::rotate_page(90)        // alle Seiten
fix::rotate_page(3, 180)    // nur Seite 3
fix::delete_page(1)         // entfernt den Entwurfsumschlag
fix::reorder_pages([4, 1, 2, 3])

// Umschlag und Innenteil gehen an zwei verschiedene Lieferanten
fix::split_document(1, 2, "umschlag.pdf")
fix::split_document(3, 50, "innenteil.pdf")

fix::merge_documents("anhaenge/garantie.pdf")

8.4 Inhalt

fix::add_watermark("DRAFT — DO NOT PRINT")
fix::add_stamps("APPROVED 2026-08-02")
fix::add_page_numbers()

// Vor dem Druck: Korrekturkommentare dürfen nicht mit,
// und Anhänge machen die Datei nur schwerer
fix::remove_annotations()
fix::remove_attachments()

// Verhindert, dass eine abgeschaltete Ebene „englische Fassung“
// in der Druckerei wieder eingeschaltet wird
fix::flatten_layers()

8.5 Optimierung

Die Operationen dieses Abschnitts schreiben nur, wenn die Datei kleiner wird. Fällt das Ergebnis größer aus, bleibt das Original erhalten.

Die DPI-Angabe berechnet sich aus der tatsächlich gedruckten Größe auf der Seite.

CMYK-Bilder bleiben unangetastet. Sie neu abzutasten hieße, über RGB zu gehen, und das zerstörte die Separation für die Druckvorstufe. In einer Druckdatei kommt die Ersparnis von den RGB-Bildern.

// Eine Fassung zur Freigabe per E-Mail braucht keine 300 DPI
fix::downsample_images(96)
fix::compress_images(70)
fix::remove_unused_resources()

Was es hier nicht gibt

subset_fonts und linearize_document sind keine fix::-Operationen; ein Aufruf liefert den Fehler „unbekannte Funktion“.

• subset_fonts: Umgesetzt und dann gemessen. Professionelle Werkzeuge betten ohnehin nur die benutzten Glyphen ein; der gemessene Gewinn lag bestenfalls bei 0,5 % und sonst bei null — das Risiko, eine Schrift zu beschädigen, ist das nicht wert. Um zu prüfen, ob Schriften Teilmengen sind, nehmen Sie prepress::subset_fonts().
• linearize_document: verlangt das Erzeugen der Hinweistabellen (§ 7.14 der PDF-Spezifikation). Keine Rust-Bibliothek leistet das, und eine Teilimplementierung erkennen Betrachter nicht als „Fast Web View“.

8.6 Vollständige Beispiele

// druck_vorbereiten.pdfl — bereitet eine Verlagsdatei für die Druckerei auf
// Aufruf: pdfl fix verlag.pdf druck_vorbereiten.pdfl --output druck.pdf

check "Preconditions" {
  require doc.page_count > 0
  assert !struct::check_encryption(),
    "file is encrypted — ask the publisher for the open version"
}

// Produktionsrahmen, die der Verlag nicht gesetzt hat
fix::set_trim_box(8.5, 8.5, 586.5, 833.5)
fix::set_bleed_box(0, 0, 595, 842)

// Aufräumen: weder Korrekturanmerkungen noch Anhänge gehen in den Druck
fix::remove_annotations()
fix::remove_attachments()
fix::flatten_layers()
fix::remove_unused_resources()

// email_fassung.pdfl — leichte Fassung zur Freigabe per E-Mail
// Aufruf: pdfl fix final.pdf email_fassung.pdfl --output freigabe.pdf

fix::downsample_images(96)
fix::compress_images(70)
fix::add_watermark("PROOF — NOT THE FINAL VERSION")
fix::add_page_numbers()

Prüfen Sie das Ergebnis mit pdfl selbst:

pdfl fix final.pdf email_fassung.pdfl --output freigabe.pdf
pdfl inspect freigabe.pdf          # Größe, DPI und Warnungen der neuen Datei

← codes:: · Inhalt · Weiter: data:: →