Bild-Unschärferadius und Gauß-Kernel berechnen
Dieser Rechner wandelt eine nicht negative Unschärfestärke in praktische Abmessungen für eine Gauß-Faltung um.
Im Browser ausführen – kostenlos
Die Stärke wird als Gaußsche Standardabweichung, also Sigma, in Pixeln verstanden. Das Ergebnis nennt den Radius, der auf jeder Seite drei Standardabweichungen abdeckt, und die zugehörige ungerade Kernelgröße. Das Werkzeug unterstützt Sie beim Konfigurieren von Bildbibliotheken, Shadern, Canvas-Filtern und Verarbeitungsketten mit unterschiedlichen Unschärfereglern. Es wird kein Bild hochgeladen oder untersucht, und dieselbe Eingabe liefert stets dasselbe Ergebnis.
Von der Stärke zu technischen Abmessungen
Bildwerkzeuge beschreiben dieselbe Gaußsche Unschärfe häufig mit unterschiedlichen Parametern. Eine Oberfläche verlangt Sigma, eine andere einen Radius, und eine Faltungsfunktion benötigt möglicherweise die vollständige Kernelbreite. Dieser Rechner setzt die Darstellungen eindeutig zueinander in Beziehung. Er versteht die Stärke als Sigma in Pixeln und wählt einen Radius vom negativen dreifachen bis zum positiven dreifachen Sigma. Dieser Bereich erfasst fast das gesamte nutzbare Gewicht der Gauß-Verteilung, hält die Faltung aber endlich. Der Radius wird auf die nächste ganze Zahl über dem Dreifachen der Stärke aufgerundet, weil auch eine gebrochene Grenze eine vollständige Pixelposition benötigt. Die Kernelgröße entspricht anschließend dem doppelten Radius plus eins: eine Seite, das mittlere Pixel und die entsprechenden Positionen auf der anderen Seite. Eine Stärke von zwei ergibt beispielsweise den Radius sechs und einen dreizehn Pixel breiten Kernel. So erhalten Implementierungen eine nachvollziehbare Regel statt eines undokumentierten Schiebereglers.
Radius und Kernelgröße richtig lesen
Das Ergebnis `gaussian_radius` gibt an, wie viele benachbarte Pixelpositionen in jeder Richtung von der Mitte aus erfasst werden; es ist nicht die Gesamtbreite. Ein Radius von sechs reicht bei einem horizontalen Durchlauf sechs Pixel nach links und rechts beziehungsweise bei einem vertikalen Durchlauf sechs Pixel nach oben und unten. `kernel_size` umfasst beide Seiten und die Mitte und ist deshalb stets eine positive ungerade Ganzzahl. Manche Bildbibliotheken übernehmen diese vollständige Größe direkt, andere erwarten Radius oder Sigma und erzeugen eigene Koeffizienten. Prüfen Sie daher die Vorgabe der Ziel-API. Die ausgegebenen Zahlen beschreiben die Geometrie, nicht die Gauß-Gewichte. Um Gewichte zu erzeugen, werten Sie die Gauß-Funktion an jedem ganzzahligen Versatz aus und normalisieren die Werte auf die Summe eins. Für zweidimensionale Unschärfe werden meist getrennte horizontale und vertikale Durchläufe verwendet; sie liefern dasselbe Ergebnis mit deutlich weniger Aufwand als eine vollständige quadratische Faltung.
Null, Bruchteile und sichtbare Unterschiede
Eine Stärke von null bedeutet keine Unschärfe. Sie liefert den Radius null und die Kernelgröße eins, also eine Identitätsoperation nur mit dem mittleren Pixel. Positive Bruchteile sind zulässig und eignen sich für dezente Glättung. Da der Radius aufgerundet wird, ändert sich die Kernelgröße erst, wenn das Dreifache der Stärke eine Ganzzahl überschreitet, obwohl sich die Gauß-Koeffizienten dazwischen stetig verändern. Negative Stärken werden abgelehnt, weil eine Standardabweichung nicht negativ sein kann; der Rechner bildet weder stillschweigend den Betrag noch begrenzt er den Wert. Die Drei-Sigma-Grenze ist ein verbreiteter praktischer Ausgleich zwischen Genauigkeit und Rechenaufwand. Andere Anwendungen können zwei oder vier Sigma wählen, den Radius begrenzen oder eigene Näherungen einsetzen. Farbraum, Randbehandlung, Alphakanal, Präzision und Skalierung beeinflussen das sichtbare Ergebnis ebenfalls. Dokumentieren Sie diese Entscheidungen zusammen mit den Abmessungen, wenn eine exakte Reproduktion wichtig ist.
Anwendungsfälle
Faltungsfunktion konfigurieren
Wandeln Sie einen Sigma-Regler in die ungerade Breite um, die eine Bildverarbeitungsbibliothek verlangt.
Shader-Abtastung planen
Ermitteln Sie, wie viele benachbarte Texel ein separierbarer Gauß-Shader auf jeder Seite abtasten muss.
Verarbeitungskette dokumentieren
Halten Sie Radius und Größe zusammen mit der Stärke fest, damit Implementierungen dieselbe Grenzregel nutzen.
Häufige Fragen
Was kostet eine API-Anfrage?
Jede API-Anfrage kostet $0.002. Der deterministische Rechner ist im Browser auch kostenlos verfügbar.
Was bedeutet die Stärke?
Sie wird als Gaußsche Standardabweichung, üblicherweise Sigma genannt, in Pixeln interpretiert.
Wie wird der Radius berechnet?
Bei positiver Stärke wird das Dreifache aufgerundet; so werden auf jeder Seite drei Standardabweichungen abgedeckt.
Warum ist die Kernelgröße immer ungerade?
Der Kernel enthält das mittlere Pixel und gleich viele Positionen auf beiden Seiten: doppelter Radius plus eins.
Was geschieht bei der Stärke null?
Das Ergebnis lautet Radius null und Größe eins und entspricht einer Identitätsoperation ohne Unschärfe.
Verarbeitet der Rechner ein Bild?
Nein. Er schätzt nur die Geometrie des Gauß-Kernels und lädt, dekodiert, verändert oder speichert keine Bilder.
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/blur-estimate \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"strength":2}'const res = await fetch("https://api.kit.forhosting.com/image/blur-estimate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"strength": 2
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/image/blur-estimate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"strength": 2
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/blur-estimate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"strength":2}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"strength":2}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/blur-estimate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"strength": 2
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "image.blur_estimate",
"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. |