ANSI-Truecolor-Generator

Geben Sie einen kurzen oder vollständigen Hexadezimalwert oder eine rgb()-Farbe ein und wählen Sie Vorder- oder Hintergrund. Das Ergebnis enthält das echte Escape-Zeichen zur direkten Nutzung, eine sichtbar maskierte Form für Quellcode und Konfiguration, die normalisierten Kanäle sowie die standardmäßige Rücksetzsequenz. Die Umwandlung ist deterministisch, schnell und für Shell-Werkzeuge, Build-Skripte, Protokollsysteme und Befehlszeilenoberflächen geeignet.

Wählen Sie Farbe und den zu ändernden Terminalbereich

Beginnen Sie mit einer Farbe in einem der unterstützten Formate: dreistelliges Hexadezimalformat wie <code>#3af</code>, sechsstelliges Hexadezimalformat wie <code>#33AAFF</code>, dieselben sechs Stellen ohne Raute oder eine RGB-Funktion wie <code>rgb(51, 170, 255)</code>. Bei hexadezimalen Buchstaben spielt die Groß- und Kleinschreibung keine Rolle; Leerzeichen innerhalb der RGB-Funktion sind erlaubt. Jeder RGB-Kanal muss eine ganze Zahl zwischen null und 255 sein. Wählen Sie anschließend, ob die Farbe für den Vordergrund, normalerweise den Text, oder für den Hintergrund dahinter gelten soll. Standardmäßig wird der Vordergrund verwendet, da dies für Befehlsausgaben am häufigsten benötigt wird. Der Generator erweitert verkürzte Hexadezimalwerte, normalisiert die endgültige Farbe als sechsstelligen Hexadezimalwert in Großbuchstaben und gibt den roten, grünen und blauen Kanal dezimal zurück. Dadurch können Sie das Ergebnis leicht prüfen, bevor Sie es in ein Skript einsetzen. Alphakanäle, CSS-Farbnamen, Prozentwerte und Kanäle außerhalb des gültigen Bereichs werden bewusst abgelehnt, weil ANSI-Truecolor-Sequenzen genau drei 8-Bit-Farbkanäle und keine Alphakomponente codieren. Die eindeutige Validierung verhindert, dass ein versehentlich eingegebener CSS-Wert unbemerkt eine unerwartete Terminalfarbe erzeugt.

Verwenden Sie die erzeugte Escape-Sequenz sicher

Eine 24-Bit-ANSI-Farbe besteht aus einem Escape-Zeichen und einer anschließenden SGR-Parameterliste. Vordergrundfarben beginnen mit <code>38;2</code>, Hintergrundfarben dagegen mit <code>48;2</code>; danach folgen die drei Dezimalkanäle in der Reihenfolge Rot, Grün und Blau, und <code>m</code> schließt die Sequenz ab. Die Antwort stellt dieselbe Anweisung in zwei Darstellungen bereit. Das Feld <code>sequence</code> enthält das tatsächliche ESC-Steuerzeichen, sodass ein Programm es direkt mit Text verknüpfen kann. Das Feld <code>escaped</code> beginnt mit den sichtbaren Zeichen <code>\x1b</code>. Diese lassen sich meist leichter in JavaScript, Shell, JSON-Vorlagen oder Dokumentation kopieren, in denen ein wörtliches Steuerzeichen verwirrend wäre. Wie eine maskierte Zeichenfolge interpretiert wird, hängt von der verwendeten Sprache ab; wählen Sie deshalb die passende Darstellung für Ihre Umgebung. Hängen Sie den zurückgegebenen Rücksetzwert an den farbigen Abschnitt an, damit spätere Eingabeaufforderungen und Protokollzeilen den Stil nicht übernehmen. Der konzeptionelle Aufbau lautet Farbsequenz, Nachricht und Rücksetzung. Verzichten Sie bei maschinenlesbaren Ausgaben auf Farbcodes, sofern die Empfänger sie nicht ausdrücklich unterstützen, denn unsichtbare Steuerzeichen können Vergleiche, Parser und Snapshots beeinträchtigen.

Berücksichtigen Sie Terminalunterstützung und Produktionsbetrieb

Truecolor wird von modernen Terminalemulatoren weitgehend unterstützt, doch das ANSI-Protokoll verpflichtet nicht jedes Ausgabeziel dazu, 24-Bit-Farben darzustellen. Eine umgeleitete Datei, ein einfaches Terminal, eine Protokollansicht für kontinuierliche Integration oder eine Anwendung mit deaktivierter Formatierung zeigt möglicherweise keine Farbe oder macht die Steuerzeichen sichtbar. Behandeln Sie Farbe als Darstellung und nicht als Information: Bezeichnungen, Schweregrade und Statusmeldungen müssen auch dann verständlich bleiben, wenn die Gestaltung entfernt wird. Viele Befehlszeilenprogramme aktivieren Farbe nur, wenn die Standardausgabe mit einem interaktiven Terminal verbunden ist, und bieten eine Option oder Umgebungsvariable zum Erzwingen oder Abschalten an. Dieser Generator prüft das Terminal des Aufrufers nicht, weil ein reines API-Ergebnis sonst von einer sachfremden Laufzeitumgebung abhinge. Er erzeugt ausschließlich die korrekte Bytefolge für die gewünschte Farbe. Der Algorithmus stellt keine Netzwerkanfragen, verwendet keinen Zufall und speichert keine Eingaben. Gleiche Eingaben liefern daher identisches JSON. Die API-Nutzung kostet $0.002 je Anfrage; die Browserausführung verwendet dieselbe reine Konvertierungslogik. Fügen Sie Sequenzen in Protokollsystemen möglichst erst im abschließenden, für Menschen bestimmten Renderer ein, statt sie in strukturierten Ereignissen zu speichern. So bleiben Suche und spätere Exporte sauber, während die Konsolenausgabe ansprechend formatiert werden kann.