ColorScale_AddUser

ColorScale_AddUser erzeugt oder ersetzt eine Benutzer-Farbskala. Die Farbskala wird im User-Verzeichnis gespeichert und steht auch nach einem Neustart und nach einem Update von UniPlot zur Verfügung.

bool = ColorScale_AddUser(ssName, svColor)

Returnwert

bool ist TRUE (1), wenn die Farbskala gespeichert wurde, und FALSE (0), wenn ein Fehler aufgetreten ist. Die Fehlermeldung wird in die Ereignisanzeige geschrieben.

Parameter

ssName

ssName ist der Name der Farbskala. Der Name darf nicht länger als 31 Zeichen sein und darf nicht der Name einer vordefinierten Farbskala sein (siehe ColorScale_GetNames). Falls eine Benutzer-Farbskala mit demselben Namen existiert, wird sie ersetzt.

svColor

svColor ist ein String-Vektor mit mindestens zwei HTML-Farben im Format "#RRGGBB", z. B. ["#00FF00", "#FF0000"], oder eine reelle Matrix mit drei Spalten (Rot-, Grün- und Blauanteil im Bereich 0 bis 255) und einer Zeile pro Farbe, z. B. [0,255,0; 255,0,0].

Kommentar

Die Benutzer-Farbskalen werden in der Datei Settings\user_color_scales.rgb im UniPlot-User-Verzeichnis gespeichert (siehe GetUserDirectory). Die Farbskalen können mit Extras=>Farben=>Benutzer-Farbskalen bearbeitet werden.

Beispiel

ColorScale_AddUser("MynewColorMap", ["#00FF00", "#FF0000"]);
rmColor = ColorScale_GetColors("MynewColorMap", 10);

History

Version	Beschreibung
R2026.5	Neu.

Siehe auch

Extras=>Farben=>Benutzer-Farbskalen, ColorScale_DeleteUser, ColorScale_GetUserNames, ColorScale_GetNames, ColorScale_GetColors

_id-1102328