RGB-Bildpixel nach Luminanz in Graustufen umwandeln
Machen Sie aus Rot-, Grün- und Blauwerten ein Grau, das der Helligkeitswahrnehmung des Auges folgt: Reines Rot wird 76, reines Grün 150 und reines Blau 29, ein neutrales Grau von 128 bleibt 128. Kostenlos in Ihrem Browser.
- Kostenlos
- Läuft in Ihrem Browser
- Ohne Anmeldung
- Ihre Daten bleiben auf Ihrem Gerät
Im Browser ausführen – kostenlos
Wandeln Sie RGB-Abtastwerte eines Bildes in Graustufen um, ohne eine Datei hochzuladen oder einen Bilddecoder zu benötigen. Übergeben Sie eine geordnete Liste von Pixeln mit Rot-, Grün- und Blaukanal. Sie erhalten gleich viele Pixel zurück, deren drei Kanäle jeweils den luminanzgewichteten Grauwert enthalten. Die Berechnung gewichtet Grün stärker als Rot und Blau und bildet die wahrgenommene Helligkeit deshalb besser als ein einfacher Mittelwert ab. Jeder Kanal wird geprüft; unvollständige Pixel, nicht numerische Werte und Werte außerhalb von 0 bis 255 führen zu einem eindeutigen Fehler.
Bereiten Sie vollständige RGB-Datensätze vor
Es muss ein nicht leeres Array sein, dessen Elemente Objekte mit den kanonischen Namen r, g und b sind. Kanalwerte dürfen ganzzahlig oder gebrochen sein, müssen jedoch endlich sein und einschließlich zwischen 0 und 255 liegen. Der Konverter verlangt jeden Kanal in jedem Datensatz.
Es wird weder null angenommen noch ein anderer Kanal kopiert oder ein Pixel übersprungen, da dies Helligkeit und Positionszuordnung verändern würde. Behalten Sie die ursprüngliche Reihenfolge bei; die Ausgabe bewahrt sie für Puffer, Matrizen und Testdaten. Teilen Sie größere Bilder in deterministische Blöcke.
Die Schnittstelle verarbeitet bereits decodierte Werte, keine PNG-, JPEG- oder WebP-Bytes.
Verstehen Sie die gewichtete Berechnung
Für jeden Abtastwert ist Grau die nächste ganze Zahl zu 0.299 mal Rot plus 0.587 mal Grün plus 0.114 mal Blau. Die Koeffizienten ergeben eins, lassen neutrale Pixel neutral und berücksichtigen die höhere visuelle Empfindlichkeit für Grün. Ein einfacher Mittelwert kann Blau zu hell und Grün zu dunkel darstellen.
Nach genau einer Rundung wird derselbe Wert in r, g und b geschrieben, sodass neutrales RGB-Grau entsteht. Die Antwort enthält außerdem Anzahl und Formel zur Nachvollziehbarkeit. Die Funktion ist rein: Sie nutzt weder Netzwerk, Zufall, Uhrzeit, externes Modell noch veränderlichen Zustand.
Gleiche Eingaben ergeben stets gleiche Ausgaben. Gamma-Linearisierung, ICC-Profile, HDR, Alpha und Dithering gehören nicht zu diesem eng definierten Vorgang und müssen bei Bedarf in einer spezialisierten Verarbeitung erfolgen.
Verwenden Sie das Ergebnis sicher
Nutzen Sie samples als positionsgleichen Ersatz für das gesendete Array. Jeder Datensatz behält drei Kanäle und ist daher ohne Sonderformat für gewöhnliche RGB-Verbraucher geeignet. Vergleichen Sie count mit der gesendeten Menge, bevor Sie Zeilen, Kacheln oder Raster zusammensetzen.
Breite, Höhe, Zeilenschritt, Ausrichtung, Alpha und Metadaten bleiben Aufgabe des Aufrufers. Bewahren Sie Alpha getrennt auf und kombinieren Sie es beim Codieren erneut. Behandeln Sie fehlende Kanäle, nicht endliche Zahlen, Bereichs- und Größenfehler als Datenprobleme, nicht als wiederholbare Dienstausfälle.
Prüfen Sie Schwarz, Weiß, Primärfarben, neutrales Grau, Bruchwerte und einen unvollständigen Datensatz.
Anwendungsfälle
Graustufenpuffer aufbauen
Wandeln Sie decodierte RGB-Werte um und setzen Sie sie vor dem Codieren in das ursprüngliche Raster ein.
Deterministische Testdaten erzeugen
Erstellen Sie exakte Sollwerte für Tests von Filtern, Canvas-Werkzeugen und Pixelpipelines.
Häufige Fragen
Welche Graustufenformel wird verwendet?
Das Ergebnis ist round(0.299 × r + 0.587 × g + 0.114 × b) und wird anschließend allen drei Kanälen zugewiesen.
Akzeptiert der Dienst eine Bilddatei?
Nein. Er nimmt bereits decodierte RGB-Werte an; Decodierung und Codierung erfolgen außerhalb des Dienstes.
Bleibt Transparenz erhalten?
Alpha gehört nicht zum Vertrag. Bewahren Sie es getrennt auf und verbinden Sie es danach mit den umgewandelten Kanälen.
Warum wird reines Blau so viel dunkler als reines Grün?
Weil das Auge Grün viel heller wahrnimmt als Blau. Die Formel gibt Grün deshalb das Gewicht 0,587 und Blau nur 0,114, sodass reines Grün zu 150, reines Rot zu 76 und reines Blau zu 29 wird.
Was passiert, wenn einem Pixel eine Farbe fehlt?
Die Umrechnung stoppt und nennt den betroffenen Pixel und den fehlenden Kanal. Sie nimmt nie an, dass ein fehlender Wert null ist, und kopiert keinen anderen Kanal, weil das die Helligkeit verfälschen und die Reihenfolge zerstören würde.
Verwandte Tools
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/grayscale-convert \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"samples":[{"r":255,"g":0,"b":0},{"r":0,"g":128,"b":255}]}'const res = await fetch("https://api.kit.forhosting.com/image/grayscale-convert", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"samples": [
{
"r": 255,
"g": 0,
"b": 0
},
{
"r": 0,
"g": 128,
"b": 255
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/image/grayscale-convert",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"samples": [
{
"r": 255,
"g": 0,
"b": 0
},
{
"r": 0,
"g": 128,
"b": 255
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/grayscale-convert", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"samples":[{"r":255,"g":0,"b":0},{"r":0,"g":128,"b":255}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"samples":[{"r":255,"g":0,"b":0},{"r":0,"g":128,"b":255}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/grayscale-convert", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"samples": [
{
"r": 255,
"g": 0,
"b": 0
},
{
"r": 0,
"g": 128,
"b": 255
}
]
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "image.grayscale_convert",
"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_samples | 100000 |
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. |
Technische Hinweise
Bereiten Sie vollständige RGB-Datensätze vor
Übergeben Sie die Pixel im JSON-Feld samples. Fehlt beispielsweise Grün, nennt invalid_input den Index und den fehlenden Kanal. Pro Anfrage sind höchstens hunderttausend Abtastwerte möglich.
Verwenden Sie das Ergebnis sicher
Der Browser verwendet dieselbe deterministische Funktion wie die API. Die Browserausführung ist kostenlos; eine API-Anfrage kostet $0.002.
Integrationsbeispiele
Kleine Stapel kontrollieren
Prüfen Sie repräsentative RGB-Werte im Browser, bevor Sie den Ablauf per API automatisieren.
Technische Fragen
Was geschieht bei einem fehlenden Kanal?
Die Anfrage schlägt mit invalid_input fehl und nennt den nullbasierten Index sowie den fehlenden Kanal r, g oder b.
Was kostet eine API-Anfrage?
Eine Anfrage kostet $0.002; dieselbe Umwandlung können Sie im Browser kostenlos ausführen.