set_colorT_set_colorSetColorSetColorset_color (Operator)
Name
set_colorT_set_colorSetColorSetColorset_color — Setzen der Ausgabefarbe(n).
Signatur
Beschreibung
set_colorset_colorSetColorSetColorSetColorset_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_colorquery_colorQueryColorQueryColorQueryColorquery_color abgefragt werden. Darüberhinaus kann
ColorColorColorColorcolorcolor auch über ein RGB-Tripel oder RGBA-Quadrupel in der Form
'#rrggbb'"#rrggbb""#rrggbb""#rrggbb""#rrggbb""#rrggbb" bzw. '#rrggbbaa'"#rrggbbaa""#rrggbbaa""#rrggbbaa""#rrggbbaa""#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 ColorColorColorColorcolorcolor 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_colorset_colorSetColorSetColorSetColorset_color, set_rgbset_rgbSetRgbSetRgbSetRgbset_rgb,
set_hsiset_hsiSetHsiSetHsiSetHsiset_hsi oder set_grayset_graySetGraySetGraySetGrayset_gray aufgerufen wird.
Verwendet wird dieser Darstellungsparameter bei Operatoren wie
disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region,disp_linedisp_lineDispLineDispLineDispLinedisp_line, disp_rectangle1disp_rectangle1DispRectangle1DispRectangle1DispRectangle1disp_rectangle1,
oder disp_arrowdisp_arrowDispArrowDispArrowDispArrowdisp_arrow.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Fenster-Handle.
ColorColorColorColorcolorcolor (input_control) string(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Namen der Ausgabefarben.
Defaultwert:
'white'
"white"
"white"
"white"
"white"
"white"
Wertevorschläge: 'black'"black""black""black""black""black", 'white'"white""white""white""white""white", 'red'"red""red""red""red""red", 'green'"green""green""green""green""green", 'blue'"blue""blue""blue""blue""blue", 'cyan'"cyan""cyan""cyan""cyan""cyan", 'magenta'"magenta""magenta""magenta""magenta""magenta", 'yellow'"yellow""yellow""yellow""yellow""yellow", 'dim gray'"dim gray""dim gray""dim gray""dim gray""dim gray", 'gray'"gray""gray""gray""gray""gray", 'light gray'"light gray""light gray""light gray""light gray""light gray", 'medium slate blue'"medium slate blue""medium slate blue""medium slate blue""medium slate blue""medium slate blue", 'coral'"coral""coral""coral""coral""coral", 'slate blue'"slate blue""slate blue""slate blue""slate blue""slate blue", 'spring green'"spring green""spring green""spring green""spring green""spring green", 'orange red'"orange red""orange red""orange red""orange red""orange red", 'orange'"orange""orange""orange""orange""orange", 'dark olive green'"dark olive green""dark olive green""dark olive green""dark olive green""dark olive green", 'pink'"pink""pink""pink""pink""pink", 'cadet blue'"cadet blue""cadet blue""cadet blue""cadet blue""cadet blue", '#003075'"#003075""#003075""#003075""#003075""#003075", '#e53019'"#e53019""#e53019""#e53019""#e53019""#e53019", '#ffb529'"#ffb529""#ffb529""#ffb529""#ffb529""#ffb529", '#f28d26bb'"#f28d26bb""#f28d26bb""#f28d26bb""#f28d26bb""#f28d26bb"
Beispiel (HDevelop)
set_color(WindowHandle, ['red', '#00ff00a0'])
disp_circle(WindowHandle, [100,200,300], [200,300,100], [100,100,100])
Ergebnis
set_colorset_colorSetColorSetColorSetColorset_color liefert den Wert TRUE, falls das Fenster gültig ist
und für dieses die angegebene Farbe(n) darstellbar sind.
Ansonsten wird eine Fehlerbehandlung durchgeführt.
Vorgänger
query_colorquery_colorQueryColorQueryColorQueryColorquery_color
Nachfolger
disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region
Alternativen
set_rgbset_rgbSetRgbSetRgbSetRgbset_rgb,
set_hsiset_hsiSetHsiSetHsiSetHsiset_hsi
Siehe auch
get_rgbget_rgbGetRgbGetRgbGetRgbget_rgb,
disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region,
set_paintset_paintSetPaintSetPaintSetPaintset_paint
Modul
Foundation