Bildrand hinzufügen
Ein Rand verändert die Leinwandgröße eines Bildes, obwohl das ursprüngliche Motiv darin unverändert bleibt.
Im Browser ausführen – kostenlos
Dieser Rechner übernimmt die ursprüngliche Breite und Höhe in Pixeln, fügt oben, rechts, unten und links dieselbe Randbreite hinzu und gibt die genauen Außenmaße zurück. Auch die angegebene Farbe bleibt im Ergebnis erhalten, sodass die Berechnung zusammen mit einer Designvorgabe, einem Exportauftrag oder einem automatisierten Bildablauf weitergegeben werden kann.
Berechnen Sie die Leinwandgröße vor dem Export
Ein Rand beansprucht außerhalb jeder Kante des Originalbildes zusätzlichen Platz. Ein 20 Pixel breiter Rand fügt der Breite oder Höhe daher nicht nur 20 Pixel hinzu: Links kommen 20 Pixel und rechts weitere 20 Pixel hinzu, ebenso oben und unten. Geben Sie die ursprüngliche Breite und Höhe in Pixeln, die Breite einer Randseite sowie die gewünschte Farbe ein. Der Rechner liefert neben den Ausgangsmaßen die neue Außenbreite und Außenhöhe, sodass sich die Änderung leicht prüfen lässt. Das ist hilfreich, bevor Sie einen Bildeditor öffnen, eine Regel für die Stapelverarbeitung vorbereiten oder Platz in einem Layout reservieren. Die Berechnung skaliert, beschneidet, streckt oder kodiert kein Bild. Sie beantwortet ausschließlich die Maßfrage, sodass eindeutig bleibt, ob sich die ursprüngliche Inhaltsfläche geändert hat. Eine Randbreite von null ist zulässig und lässt beide Außenmaße unverändert. Dadurch kann Software auch dann denselben Berechnungsweg verwenden, wenn kein sichtbarer Rand benötigt wird.
So funktioniert die Randformel
Die Formel ist bewusst einfach und vorhersehbar: Die Außenbreite entspricht der ursprünglichen Breite plus der doppelten Randbreite, und die Außenhöhe wird auf die gleiche Weise berechnet. Die Multiplikation mit zwei berücksichtigt die beiden gegenüberliegenden Seiten jeder Achse. Ein Bild mit 1200 Pixel Breite und 800 Pixel Höhe wird bei einem 24 Pixel breiten Rand beispielsweise 1248 mal 848 Pixel groß. Die Farbe beeinflusst die Maße nicht, wird aber zurückgegeben, damit nachgelagerter Code die visuelle Einstellung gemeinsam mit den Abmessungen speichern kann. Ausgangsbreite und Ausgangshöhe müssen positive ganze Zahlen sein, weil Pixelmaße eine reale Rasterleinwand beschreiben. Die Randbreite darf null oder eine positive endliche Zahl sein und unterstützt damit sowohl gebräuchliche ganze Pixel als auch gebrochene Layoutmaße. Negative Werte werden abgelehnt, da sie einen Beschnitt oder eine nach innen gerichtete Geometrie statt eines äußeren Randes beschreiben. Wenn Sie Pixel an den Kanten entfernen möchten, verwenden Sie eine separate Beschnittberechnung.
Nutzen Sie das Ergebnis für Design und Automatisierung
Die berechneten Außenmaße lassen sich direkt für die Layoutplanung, Leinwanderstellung, Prüfung von Medien oder Abschätzung des Speicherbedarfs einsetzen. In der Entwicklung können Sie die erforderliche Leinwand bestimmen, bevor das Originalbild um die Randbreite versetzt gezeichnet wird. Im Design lässt sich prüfen, ob eine gerahmte Vorschau weiterhin in eine feste Karte oder einen Marktplatzbereich passt. Ein Produktionsteam kann das Ergebnis mit einer maximalen Uploadgröße vergleichen, bevor Tausende Dateien verarbeitet werden. Da der Vorgang ausschließlich deterministische Arithmetik verwendet, erzeugen identische Eingaben stets dasselbe Ergebnis – ohne Netzwerkanfrage, Dateiübertragung, Zufallswert oder verborgene Bildbearbeitung. Die eingegebene Farbe wird als Bezeichnung behandelt und weder interpretiert noch umgewandelt. Ein Hexadezimalcode, CSS-Farbname oder interner Bezeichner bleibt somit erhalten; lediglich äußerer Leerraum entfällt. Der API-Preis beträgt $0.002 pro Anfrage. Die Antwort enthält Ausgangs- und Außenmaße, wodurch Protokolle verständlich bleiben und Verwechslungen zwischen Quelle und fertiger Leinwand vermieden werden.
Anwendungsfälle
Leinwand mit Rand vorbereiten
Berechnen Sie die genaue Leinwandgröße, bevor Sie das unveränderte Originalbild innerhalb eines neuen farbigen Randes platzieren.
Marktplatzbilder prüfen
Prüfen Sie, ob ein Produktbild nach dem Hinzufügen eines gleichmäßigen Randes weiterhin die Upload- oder Layoutgrenze einhält.
Bildaufträge im Stapel planen
Ermitteln Sie verlässliche Ausgabemaße für automatisierte Abläufe, bevor Sie Ressourcen für das Rendern aller Bilder einsetzen.
Häufige Fragen
Wie werden die neuen Abmessungen berechnet?
Zu beiden Maßen wird die doppelte Randbreite addiert, weil der Rand an jeweils zwei Seiten jeder Achse liegt.
Wird mein Bild dabei verändert oder hochgeladen?
Nein. Die Funktion erhält nur Maße und Randeinstellungen und gibt berechnete Werte zurück, ohne eine Bilddatei zu lesen oder zu verändern.
Darf die Randbreite null betragen?
Ja. Eine Randbreite von null ist gültig und liefert Außenmaße, die den ursprünglichen Abmessungen entsprechen.
Was geschieht bei einer negativen Randbreite?
Die Anfrage endet mit einem Fehler für ungültige Eingaben, da ein negativer Wert das Entfernen oder Einrücken von Fläche und keinen Außenrand beschreibt.
Welche Farbformate kann ich angeben?
Sie können jede nicht leere Farbbezeichnung verwenden, darunter CSS-Namen, Hexadezimalwerte oder interne Bezeichner. Der Wert wird unverändert übernommen, nicht interpretiert.
Was kostet eine Berechnung über die API?
Jede API-Anfrage kostet $0.002. Die Berechnung eignet sich auch für die Browserausführung, da kein Netzwerkzugriff erforderlich ist.
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
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/image/add-border \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"width":1200,"height":800,"border_width":24,"color":"#1d4ed8"}'const res = await fetch("https://api.kit.forhosting.com/image/add-border", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"width": 1200,
"height": 800,
"border_width": 24,
"color": "#1d4ed8"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/image/add-border",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"width": 1200,
"height": 800,
"border_width": 24,
"color": "#1d4ed8"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/add-border", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"width":1200,"height":800,"border_width":24,"color":"#1d4ed8"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"width":1200,"height":800,"border_width":24,"color":"#1d4ed8"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/add-border", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"width": 1200,
"height": 800,
"border_width": 24,
"color": "#1d4ed8"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "image.add_border",
"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
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Limits
max_mb | 15 |
max_megapixels | 12 |
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. |