Farbe auf den nächstgelegenen Paletteneintrag quantisieren

Quantisieren Sie eine Farbe auf eine feste Palette, wenn ein indiziertes Bild, ein Terminaldesign, eine LED-Steuerung, ein Design-Token-Satz oder ein eingeschränktes Exportformat nur freigegebene Farben verwenden darf. Geben Sie eine hexadezimale Ausgangsfarbe und eine geordnete Palette an. Die Funktion prüft jeden Wert, vergleicht exakte RGB-Abstände und liefert die nächste normalisierte Palettenfarbe, ihren nullbasierten Index und den quadrierten Abstand. Bei Gleichstand wird stets der frühere Eintrag gewählt, sodass wiederholte Ausführungen dasselbe Ergebnis erzeugen.

Stellen Sie eine bewusst geordnete feste Palette zusammen

Die Farbquantisierung beginnt mit den Farben, die das Ziel tatsächlich speichern oder anzeigen kann. Tragen Sie diese in einer stabilen, bewusst gewählten Reihenfolge als #RGB oder #RRGGBB in das Palettenarray ein. Kurzformen werden vor dem Vergleich erweitert; Groß- und Kleinschreibung beeinflussen das Ergebnis nicht.

Für die Ausgangsfarbe gilt dieselbe Schreibweise. Eine Palette darf zwischen einem und 256 Einträgen enthalten. Damit eignet sie sich für kleine Markenfarbsätze, Terminalfarben, klassische Tabellen indizierter Bilder, Stickgarnsortimente und zahlreiche gerätespezifische Farbkarten.

Die Reihenfolge spielt nur dann eine Rolle, wenn zwei Einträge genau gleich weit von der Ausgangsfarbe entfernt sind. In diesem Fall gewinnt der frühere. Diese klare Regel macht Gleichstände vorhersehbar und lässt Sie eine Präferenz ausdrücken, ohne Farbwerte zu verändern.

Verwenden Sie für einen gesamten Stapel dieselbe Palette, wenn die indizierte Ausgabe konsistent bleiben soll. Wird die Palette zwischen Aufträgen unbemerkt umsortiert, kann sich der zurückgegebene Index ändern, obwohl derselbe Farbwert ausgewählt wird. Die Prüfung weist leere oder übergroße Arrays, fehlende Präfixe, Alphakanäle, ungültige Ziffern und Werte zurück, die keine Zeichenketten sind, anstatt die beabsichtigte Eingabe zu erraten.

So funktioniert die deterministische Abstandsberechnung

Jede gültige Farbe wird auf sechs Hexadezimalstellen erweitert und in Rot-, Grün- und Blauwerte von 0 bis 255 zerlegt. Der Algorithmus zieht jeden Palettenkanal vom entsprechenden Ausgangskanal ab, quadriert die drei Differenzen und addiert sie. Gewählt wird der Paletteneintrag mit der kleinsten Summe.

Eine Quadratwurzel ist nicht erforderlich, weil sie die Reihenfolge nicht negativer Abstände nicht verändern kann. Es handelt sich um den gewöhnlichen euklidischen Abstand im codierten RGB-Raum. Er wurde für eine transparente, reproduzierbare Indexumwandlung gewählt und nicht als Modell der menschlichen Farbwahrnehmung.

Ein Kandidat wird nur bei einem strikt kleineren Wert ersetzt; ein gleicher Abstand verdrängt daher niemals den früheren Eintrag. Dieses Detail sorgt auch bei symmetrischen Paletten oder Duplikaten für eindeutige Ergebnisse. So können Sie den Index direkt speichern und den gewählten Hexadezimalwert zugleich für Protokolle, Vorschauen oder nachgelagerte Prüfungen behalten.