ForHosting KIT · Dokumente & PDF

Raster für PDF-Seitenvorschaubilder erstellen

Wandeln Sie die Seitenzahl einer PDF-Datei und die gewünschte Spaltenzahl in eine exakte Rasterspezifikation um.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Der Rechner liefert die erforderlichen Zeilen, die Gesamtzahl der Rasterzellen und die Anzahl der Seitenvorschaubilder in der letzten Reihe. Das hilft bei PDF-Betrachtern, Kontaktbögen, Prüfoberflächen, Druckplanungen und allen Ansichten, die einen berechenbaren Bereich reservieren müssen, bevor die einzelnen Seitenbilder verfügbar sind.

Planen Sie das Raster vor der Vorschaubilderzeugung

Eine Oberfläche für PDF-Vorschaubilder benötigt ihre Struktur häufig schon, bevor alle Bilder gerendert sind. Geben Sie die Seitenzahl des Dokuments und die gewünschte Spaltenzahl an; der Rechner liefert sofort die genaue Anzahl der Zeilen. Zusätzlich nennt er die gesamte Kapazität des Rechtecks und die Zahl der echten Vorschaubilder in der letzten Reihe. Mit diesen drei Werten können Sie stabilen Platz reservieren, Platzhalter erzeugen, einen Scrollbereich dimensionieren oder die Verarbeitung aufteilen, ohne die PDF-Datei zu öffnen oder zu verändern. Ein Dokument mit 23 Seiten in fünf Spalten benötigt beispielsweise fünf Zeilen, besitzt 25 Zellen und belegt drei Plätze in der letzten Reihe. Die Berechnung verwendet deterministische Ganzzahlarithmetik, sodass gleiche Eingaben stets gleiche Ergebnisse erzeugen. Die Funktion rendert keine Bilder, untersucht keine PDF-Bytes, wählt keine Bildgrößen und setzt keine visuellen Stile. Sie löst ausschließlich die Rasterplanung – ohne Netzwerk, Dateiübertragung oder verborgene Darstellungsannahmen.

Deuten Sie Zeilen, Zellen und letzte Reihe richtig

Der Wert rows ist die kleinste ganze Zeilenzahl, die bei der gewünschten Spaltenzahl alle Seiten aufnehmen kann. Total cells ist das Produkt aus Zeilen und Spalten und beschreibt die Kapazität des vollständigen Rechtecks, einschließlich ungenutzter Plätze hinter dem letzten Vorschaubild. Last-row fill zählt die tatsächlich belegten Plätze der letzten Reihe. Ist die Seitenzahl ohne Rest durch die Spaltenzahl teilbar, ist die letzte Reihe voll und ihre Belegung entspricht der Spaltenzahl; der Wert ist nicht null. Diese Konvention erleichtert Schleifen, barrierefreie Beschriftungen und die Gestaltung der Abschlussreihe. Beide Eingaben müssen positive sichere Ganzzahlen sein. Bruchwerte, fehlende Angaben, Text, unendliche, nullwertige oder negative Zahlen werden abgelehnt, statt gerundet oder stillschweigend umgewandelt zu werden. Weniger als eine Spalte ist ungültig, weil keine endliche Zeilenzahl Seiten in einem Raster ohne Spalten aufnehmen kann.

Nutzen Sie das Ergebnis in Ansichten und Dokumentabläufen

In einem Betrachter können Sie aus der Zeilenzahl, der bekannten Vorschaubildhöhe und dem Reihenabstand die gesamte Galeriehöhe schätzen. Die Gesamtzellen eignen sich für eine Platzhalterliste fester Größe. Ein Vergleich mit der Seitenzahl zeigt freie Plätze; für die Gestaltung der letzten Reihe ist deren Belegung meist noch hilfreicher. In einer serverseitig erzeugten Prüfoberfläche teilen dieselben Werte Seiten in planbare Gruppen oder schaffen Navigationsmarken, bevor die Bildprozesse abgeschlossen sind. Kontaktbogen-Werkzeuge können anhand der Zeilen die Papierausrichtung wählen, und Tests können Grenzfälle wie eine Seite, ein vollständig belegtes Raster oder nur ein Bild in der letzten Reihe prüfen. Da diese Funktion Metadaten statt einer PDF-Datei erhält, müssen Sie die verlässliche Seitenzahl anderweitig bestimmen. Jede API-Berechnung kostet $0.002; im Browser steht dieselbe reine Berechnung interaktiv bereit.

Anwendungsfälle

Galerie eines PDF-Betrachters reservieren

Berechnen Sie die Zeilen vor Abschluss des Renderns, damit störende Layoutverschiebungen vermieden werden.

Kontaktbogen vorbereiten

Bestimmen Sie Rechteckkapazität und Schlussreihenbelegung für die ausgewählte Spaltenzahl.

Responsive Umbruchpunkte prüfen

Vergleichen Sie exakte Raster für verschiedene Spaltenzahlen und testen Sie Grenzfälle automatisiert.

Häufige Fragen

Was kostet eine Berechnung?

Jede Berechnung über die API kostet $0.002. Die interaktive Berechnung ist ebenfalls auf dieser Seite verfügbar.

Entspricht total_cells immer page_count?

Nein. Die Gesamtzellen beschreiben das vollständige Rechteck und können freie Plätze in einer teilweise belegten Schlussreihe enthalten.

Was geschieht bei einer vollständig belegten letzten Reihe?

Ihre Belegung entspricht der Spaltenzahl. Eine volle letzte Reihe wird als voll und nicht als null ausgegeben.

Darf die Spaltenzahl null sein?

Nein. Sie muss eine positive Ganzzahl sein; Werte unter 1 führen zu einem Fehler wegen ungültiger Eingabe.

Liest oder rendert diese Funktion die PDF-Datei?

Nein. Sie verwendet nur die angegebene Seitenzahl und liefert Rasterwerte; PDF-Bytes werden weder empfangen noch in Bilder umgewandelt.

Für Entwickler — API-Zugang

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.

Endpunkt

POSThttps://api.kit.forhosting.com/pdf/page-thumbnail-grid-layout

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

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/pdf/page-thumbnail-grid-layout \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_count":23,"columns":5}'

const res = await fetch("https://api.kit.forhosting.com/pdf/page-thumbnail-grid-layout", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "page_count": 23,
    "columns": 5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/page-thumbnail-grid-layout",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "page_count": 23,
    "columns": 5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/page-thumbnail-grid-layout", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"page_count":23,"columns":5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"page_count":23,"columns":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/page-thumbnail-grid-layout", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "page_count": 23,
  "columns": 5
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.page_thumbnail_grid_layout",
  "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.

Preis

pro Anfrage$0.002

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

Limits

`max_mb`	25
`max_pages`	200

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →