ForHosting KIT · Dokumente & PDF

PDF-Seiten zuschneiden und neue Maße berechnen

Planen Sie den Zuschnitt einer PDF-Datei, bevor Sie das Dokument bearbeiten. Geben Sie für jede Seite die ursprüngliche Breite und Höhe sowie einen in PDF-Punkten gemessenen Zuschneiderahmen an.

● BetaKostenlos · im Browser
Nutzen Sie es über WebAPIE-MailTelegramApp bald

Der Rechner liefert daraufhin die neuen Maße jeder Seite. Außerdem prüft er, ob jedes Rechteck vollständig innerhalb seiner Ausgangsseite liegt. So erkennen Sie ungültige Geometrien, bevor sie eine PDF-Bibliothek, einen Druckablauf oder eine Dokumentenverarbeitung erreichen. Die Berechnung ist deterministisch und unterstützt unterschiedliche Seitenformate in einer Anfrage.

Beschreiben Sie Seiten und Rahmen in PDF-Punkten

PDF-Seiten werden in Punkten gemessen; 72 Punkte entsprechen einem Zoll. Geben Sie für jede Seite zuerst die ursprüngliche Breite und Höhe an und beschreiben Sie anschließend das Rechteck mit crop_x, crop_y, crop_width und crop_height. Die x-Koordinate beginnt am linken Rand, die y-Koordinate am unteren Rand. Dies entspricht dem üblichen Koordinatensystem von PDF-Dateien. Breite und Höhe des Rahmens bezeichnen den Bereich, der sichtbar bleibt, und nicht abzuziehende Ränder. Eine US-Letter-Seite misst beispielsweise üblicherweise 612 mal 792 Punkte. Ein Rahmen mit dem Ursprung 36, 54 und den Maßen 540 mal 684 passt in diese Seite und erzeugt ein Ergebnis von 540 mal 684 Punkten. Führen Sie die Seiten in Dokumentreihenfolge auf. Die Antwort nummeriert sie in derselben Reihenfolge, sodass sich die berechnete Geometrie leicht einem Prüfbericht oder einem nachfolgenden Auftrag zuordnen lässt. Hochformat, Querformat und benutzerdefinierte Größen dürfen gemeinsam vorkommen.

Verstehen Sie die Grenzprüfungen

Alle ursprünglichen Maße und sämtliche Bestandteile des Zuschneiderahmens müssen endliche Zahlen sein. Breite und Höhe der Seite sowie des Rahmens müssen größer als null sein. Die Ursprungskoordinaten dürfen null, aber nicht negativ sein. Der Rechner prüft den rechten Rand, indem er crop_x und crop_width addiert und das Ergebnis mit der ursprünglichen Breite vergleicht. Für den oberen Rand verwendet er entsprechend crop_y, crop_height und die ursprüngliche Höhe. Überschreitet einer dieser Ränder die Ausgangsseite, schlägt die Anfrage mit einem Eingabefehler fehl, der die betroffene Seite nennt. Das exakte Berühren eines Außenrands ist zulässig: Das Rechteck darf genau an der Seitenbreite oder Seitenhöhe enden. Diese Prüfung ist wichtig, weil ein Rechteck trotz plausibler Maße durch seinen Ursprung außerhalb der Seite liegen kann. Sämtliche Seiten werden geprüft; bereits ein ungültiger Datensatz verhindert ein nur teilweise verwendbares Ergebnis.

Nutzen Sie die Maße in Ihrem PDF-Ablauf

Das Ergebnis enthält für jede Seite die ursprüngliche Größe, den Ursprung des Zuschnitts sowie die neue Breite und Höhe. Es verändert oder überträgt keine PDF-Datei, sondern berechnet und validiert die Geometrie, die ein PDF-Editor oder eine Bibliothek anschließend anwenden kann. Diese Trennung hilft Ihnen, Änderungen vorab zu beurteilen, Benutzereingaben zu prüfen, das spätere Layout abzuschätzen oder Anweisungen vor einem aufwendigen Dokumentenauftrag zu vereinheitlichen. Für eine Umrechnung in Zoll teilen Sie die Werte durch 72; während der PDF-Verarbeitung vermeiden Punkte jedoch unnötige Rundungen. Wenn mehrere Seiten dieselbe Größe und Regel verwenden, wiederholen Sie die Werte für jede Seite, damit die Ausgabe eindeutig an der Dokumentreihenfolge ausgerichtet bleibt. Prüfen Sie vor der Anwendung, ob Ihre Bibliothek x, y, Breite und Höhe oder linke, untere, rechte und obere Koordinaten erwartet. Im zweiten Fall ist rechts crop_x plus new_width und oben crop_y plus new_height. Die API kostet $0.002 pro Anfrage.

Einstellungen vor der Verarbeitung prüfen

Lehnen Sie einen Auftrag frühzeitig ab, wenn ein angeforderter Rahmen über seine Ausgangsseite hinausragt.

PDF-Ausgabe mit Mischformaten planen

Berechnen Sie Endmaße von Hochformat-, Querformat- und Sonderseiten in einer geordneten Antwort.

Geometrie für eine PDF-Bibliothek vorbereiten

Überführen Sie geprüfte Seiten- und Zuschnittmaße in zuverlässige Eingaben für einen getrennten Bearbeitungsschritt.

Wird die PDF-Datei durch diese Funktion verändert?

Nein. Sie validiert die Geometrie und berechnet die neuen Maße; ein separates PDF-Werkzeug kann die Werte anwenden.

Welche Einheiten soll ich verwenden?

Verwenden Sie PDF-Punkte für Maße, Ursprünge und Rahmen. Ein Zoll entspricht 72 Punkten.

Wo liegt der Ursprung des Rahmens?

crop_x wird vom linken und crop_y vom unteren Rand der ursprünglichen Seite gemessen.

Darf der Rahmen den Seitenrand berühren?

Ja. Er darf genau an der ursprünglichen Breite oder Höhe enden, sie jedoch nicht überschreiten.

Sind unterschiedliche Seitengrößen möglich?

Ja. Jede Seite besitzt eigene Maße und einen eigenen Rahmen, sodass Mischformate unterstützt werden.

Was kostet die Nutzung?

Die API kostet $0.002 pro Anfrage; dieselbe deterministische Berechnung ist im Browser kostenlos.

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

POSThttps://api.kit.forhosting.com/pdf/crop-pages

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

curl -X POST https://api.kit.forhosting.com/pdf/crop-pages \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pages":[{"width":612,"height":792,"crop_x":36,"crop_y":54,"crop_width":540,"crop_height":684},{"width":842,"height":595,"crop_x":20,"crop_y":15,"crop_width":800,"crop_height":560}]}'
{
  "pages": [
    {
      "width": 612,
      "height": 792,
      "crop_x": 36,
      "crop_y": 54,
      "crop_width": 540,
      "crop_height": 684
    },
    {
      "width": 842,
      "height": 595,
      "crop_x": 20,
      "crop_y": 15,
      "crop_width": 800,
      "crop_height": 560
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.crop_pages",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

max_mb25
max_pages200
HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →