ForHosting KIT · Bilder bearbeiten & analysieren

Farbe begrenzen

Holen Sie RGB-Werte außerhalb des Bereichs zurück auf die Skala von 0 bis 255: Rot 300, Grün −20 und Blau 127.5 werden zu 255, 0 und 127.5, und Sie sehen, welche Kanäle sich geändert haben. Gerundet wird dabei nichts. Kostenlos in Ihrem Browser.

  • Kostenlos
  • Läuft in Ihrem Browser
  • Ohne Anmeldung
  • Ihre Daten bleiben auf Ihrem Gerät
Nutzen Sie es über WebAPIE-MailTelegramApp bald
Wenn Sie eingeben
Widerstand (Ω)
300
G
-20
B
127,5
Erhalten Sie
Widerstand (Ω)
255
G
0
Rgb
rgb(255, 0, 127.5)
Geänderte Kanäle
r, g

Begrenzen Sie eine Farbe auf den gültigen Farbraum, wenn RGB-Daten Kanäle unter null oder über 255 enthalten. Dieses deterministische Werkzeug prüft Rot, Grün und Blau und setzt jeden Kanal unabhängig auf die nächstgelegene Grenze des üblichen Acht-Bit-Bereichs. Werte innerhalb des Bereichs bleiben unverändert, auch wenn sie Nachkommastellen haben, denn Begrenzen ist nicht dasselbe wie Runden. Die Antwort enthält die korrigierten Kanäle, eine lesbare RGB-Zeichenfolge, einen Änderungshinweis und die Namen aller reparierten Kanäle.

Was das Begrenzen einer RGB-Farbe auf den Farbraum bedeutet

Eine Acht-Bit-RGB-Farbe beschreibt Rot, Grün und Blau normalerweise auf einer einschließlich geltenden Skala von 0 bis 255. Daten außerhalb dieser Grenzen lassen sich in diesem Bereich nicht unmittelbar darstellen: Ein Rotkanal mit 300 ist zu hoch, ein Grünkanal mit -20 zu niedrig. Die Begrenzung behebt genau dieses Problem, indem jeder Wert unter 0 zu 0, jeder Wert über 255 zu 255 und jeder Zwischenwert unverändert wird.

Die Kanäle werden unabhängig behandelt; eine Korrektur von Rot verändert daher weder Grün noch Blau. Das Werkzeug gibt die begrenzten Werte r, g und b sowie eine rgb-Funktionszeichenfolge mit demselben Ergebnis zurück. Damit können Sie einwandfreie von reparierten Eingaben unterscheiden, ohne die Werte selbst vergleichen zu müssen.

Diese Operation ist enger gefasst als eine Farbraumkonvertierung, perceptuelle Kompression oder Gamut-Abbildung zwischen Farbräumen. Sie wandelt weder HSL, Lab, Display P3 noch CMYK um und versucht nicht, nach einer Konvertierung den wahrgenommenen Farbton zu erhalten. Ihre Aufgabe besteht darin, drei numerische Kanäle zu prüfen und transparent sowie reproduzierbar in den zulässigen Bereich von 0 bis 255 zu bringen.

Validierung, Nachkommastellen und deterministische Ergebnisse

Alle drei Kanäle sind erforderlich und müssen endliche Zahlen enthalten. Streng numerische Zeichenfolgen aus Formularen, CSV-Datensätzen oder Abfrageparametern sind zulässig. Wissenschaftliche Schreibweise ist erlaubt, sofern sie eine endliche Zahl ergibt.

Nach der Prüfung verwendet der Algorithmus das Minimum aus 255 und dem Maximum aus 0 und dem Kanalwert. Diese Formel besitzt keine versteckten Schwellen, Gebietsschema-Regeln oder plattformabhängigen Zweige. Nachkommawerte im Bereich bleiben erhalten: 127.5 bleibt 127.5.

Das ist beabsichtigt, weil Begrenzen und Runden unterschiedliche Vorgänge sind. Die Implementierung verwendet weder Netzwerk noch Datum, Zufall, gemeinsamen Zustand oder externe Modelle. Gleiche gültige Eingaben erzeugen daher immer dieselben serialisierten Daten.

Wo die RGB-Begrenzung in einen Arbeitsablauf gehört

Farbwerte durchlaufen häufig Systeme mit unterschiedlichen Annahmen. Eine Shader-Berechnung kann beim Hinzufügen von Licht übersteuern, ein Bildanalyse-Export kann einen kleinen negativen Anteil enthalten, eine Tabellenformel kann 255.2 liefern und eine Animationsinterpolation kann ihr Ziel kurz überschreiten. Die Begrenzung ist dort sinnvoll, wo solche Werte zu gewöhnlichen RGB-Kanälen für Canvas, CSS-Generatoren, Vorschaubilder, Geräteprotokolle oder Design-Tokens werden müssen.

Setzen Sie sie nach der potenziell überschreitenden Berechnung und vor dem Verbraucher ein, der begrenzte Kanäle voraussetzt. Die Änderungsfelder können Protokolle und Qualitätskennzahlen speisen: Sie übernehmen die korrigierte Farbe für einen robusten Ablauf und halten zugleich fest, dass Quelldaten repariert wurden. Verwenden Sie die Begrenzung nicht zum Verschleiern systematisch fehlerhafter Eingaben und nicht als perzeptuelle Gamut-Abbildung für Wide-Gamut-Farbräume.

Importierte RGB-Datensätze reparieren

Begrenzen Sie Kanäle aus Tabellen, CSV oder APIs, bevor Sie sie als Standard-RGB-Daten speichern.

Rendering-Pipelines stabilisieren

Korrigieren Sie Rechenergebnisse, bevor sie an Canvas, CSS-Generatoren oder Bildrenderer übergeben werden.

Was geschieht mit einem Kanal unter null?

Er wird zu 0. Die anderen Kanäle werden getrennt geprüft und bleiben unverändert, wenn sie bereits im Bereich liegen.

Was geschieht mit einem Kanal über 255?

Er wird zu 255, der oberen Grenze des unterstützten RGB-Kanalbereichs.

Werden RGB-Werte mit Nachkommastellen gerundet?

Nein. Endliche Werte von 0 bis 255 bleiben erhalten, weil diese Funktion Grenzen setzt und nicht die Genauigkeit rundet.

Welche Werte werden abgelehnt statt begrenzt?

Fehlende Kanäle, Wörter, leere Einträge und alles, was keine endliche Zahl ist, werden abgelehnt. Zahlen als Text und wissenschaftliche Schreibweise werden angenommen, wenn sie eine echte Zahl ergeben.

Woran erkenne ich, welche Kanäle korrigiert wurden?

Das Ergebnis zeigt, ob sich etwas geändert hat, und nennt die angepassten Kanäle der Reihe nach. Bei Rot 300, Grün −20 und Blau 127.5 erscheinen nur Rot und Grün, denn Blau lag bereits im Bereich.

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/color/clamp-gamut

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/color/clamp-gamut \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"r":300,"g":-20,"b":127.5}'
{
  "r": 300,
  "g": -20,
  "b": 127.5
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "color.clamp_gamut",
  "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.

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.

Für einzelne Korrekturen können Sie das Browserwerkzeug verwenden; für wiederholbare Farb-Pipelines, Importe, Tests und Designsysteme steht die API für $0.002 je Anfrage bereit.

Was das Begrenzen einer RGB-Farbe auf den Farbraum bedeutet

Zusätzlich erhalten Sie den booleschen Wert changed und die geordnete Liste channels_changed.

Validierung, Nachkommastellen und deterministische Ergebnisse

Die bevorzugten Eingabefelder heißen r, g und b; zusätzlich werden die beschreibenden Aliasnamen red, green und blue akzeptiert. Leere Zeichenfolgen, Wörter, boolesche Werte, Arrays, Objekte, Infinity und NaN werden dagegen mit invalid_input abgelehnt. Negativ null wird zu null, sodass im JSON keine unnötige Vorzeichendarstellung entsteht. changed ist nur dann wahr, wenn mindestens ein Wert eine Grenze überschreitet; channels_changed nennt die betroffenen Kurznamen stets in der stabilen Reihenfolge Rot, Grün und Blau.

Wo die RGB-Begrenzung in einen Arbeitsablauf gehört

Prüfen Sie in Tests sowohl die Kanäle als auch channels_changed, damit spätere Änderungen kein Umlaufen, Runden oder vollständiges Ablehnen der Farbe einführen. Im Browser läuft dieselbe reine Implementierung; bei Automatisierung kostet jede erfolgreiche API-Anfrage $0.002.

Deterministische Test-Fixtures erstellen

Prüfen Sie Grenzfälle und erfassen Sie genau, welche RGB-Kanäle eine Pipeline korrigieren musste.

Was kostet eine API-Anfrage?

Eine erfolgreiche API-Anfrage kostet $0.002. Dieselbe deterministische Operation können Sie auch im Browser ausführen.

Welche Eingaben werden abgelehnt?

Fehlende, leere, nicht numerische oder nicht endliche Kanäle ergeben invalid_input. Alle drei RGB-Kanäle sind erforderlich.

Vollständige KIT-Dokumentation lesen →