set_color
— Setzen der Ausgabefarbe(n).
set_color( : : WindowHandle, Color : )
set_color
setzt für das Ausgabefenster die Farbe(n), in der die
Regionen dargestellt werden sollen. Ein Tupel aller verfügbaren Farben kann
mit dem Operator query_color
abgefragt werden. Darüberhinaus kann
Color
auch über ein RGB-Tripel oder RGBA-Quadrupel in der Form
'#rrggbb' bzw. '#rrggbbaa' gesetzt werden, wobei 'rr',
'gg', 'bb' und 'aa' jeweils hexadezimale Zahlen zwischen '00' und 'ff' sind.
'aa' ist der Alphawert der Farbe und kann genutzt werden, um
transparente Regionen anzuzeigen.
Der Parameter Color
kann eine einzelne Farbe oder ein Tupel mit
bis zu 256 Farben enthalten.
Wird eine einzige Farbe angegeben, dann erfolgen alle Ausgaben in dieser
Farbe. Wird ein Tupel von Werten übergeben, dann erfolgt die Darstellung
von Tupeln von Regionen und geometrischen Objekten modulo dieser Farben.
Im Beispiel (s.u.) wird der erste Kreis in Rot, der zweite in einem
transparenten Grün und der dritte wieder in Rot ausgegeben.
Bei jedem Aufruf einer Ausgabeprozedur wird mit der ersten Farbe begonnen.
Es ist dabei zu beachten, dass es auf die Anzahl der Objekte ankommt, die
bei einem Aufruf ausgegeben werden sollen: Wird immer nur ein Objekt pro
Aufruf ausgegeben, dann erfolgt dies immer in der ersten Farbe. Dies gilt
auch für Objekte, die aus mehreren Zusammenhangskomponenten bestehen.
Die gesetzte(n) Farbe(n) werden so lange verwendet, bis erneut
set_color
, set_rgb
,
set_hsi
oder set_gray
aufgerufen wird.
Verwendet wird dieser Darstellungsparameter bei Operatoren wie
disp_region
,disp_line
, disp_rectangle1
,
oder disp_arrow
.
WindowHandle
(input_control) window →
(handle)
Fenster-Handle.
Color
(input_control) string(-array) →
(string)
Namen der Ausgabefarben.
Defaultwert: 'white'
Wertevorschläge: 'black' , 'white' , 'red' , 'green' , 'blue' , 'cyan' , 'magenta' , 'yellow' , 'dim gray' , 'gray' , 'light gray' , 'medium slate blue' , 'coral' , 'slate blue' , 'spring green' , 'orange red' , 'orange' , 'dark olive green' , 'pink' , 'cadet blue' , '#003075' , '#e53019' , '#ffb529' , '#f28d26bb'
set_color(WindowHandle, ['red', '#00ff00a0']) disp_circle(WindowHandle, [100,200,300], [200,300,100], [100,100,100])
set_color
liefert den Wert 2 (H_MSG_TRUE), falls das Fenster gültig ist
und für dieses die angegebene Farbe(n) darstellbar sind.
Ansonsten wird eine Fehlerbehandlung durchgeführt.
get_rgb
,
disp_region
,
set_paint
Foundation