set_rgbaT_set_rgbaSetRgbaSetRgbaset_rgba (Operator)

Name

set_rgbaT_set_rgbaSetRgbaSetRgbaset_rgba — Setzen der Ausgabefarbe durch RGBA-Werte.

Signatur

set_rgba( : : WindowHandle, Red, Green, Blue, Alpha : )

Beschreibung

set_rgbaset_rgbaSetRgbaSetRgbaSetRgbaset_rgba setzt für das Ausgabefenster die Farbe(n), bzw. die Grauwerte, in der die Regionen dargestellt werden sollen. Die gewünschten Werte werden durch die drei Farbanteile: rot, grün und blau und den Alphawert festgelegt. Wird nur eine Kombination 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.

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) wird so lange verwendet, bis erneut set_colorset_colorSetColorSetColorSetColorset_color, set_rgbset_rgbSetRgbSetRgbSetRgbset_rgb, set_rgbaset_rgbaSetRgbaSetRgbaSetRgbaset_rgba 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, disp_rectangle2disp_rectangle2DispRectangle2DispRectangle2DispRectangle2disp_rectangle2, disp_arrowdisp_arrowDispArrowDispArrowDispArrowdisp_arrow, etc.

Achtung

set_rgbaset_rgbaSetRgbaSetRgbaSetRgbaset_rgba benötigt die Bibliothek libcanvas, die auf Embedded-Systemen möglicherweise nicht verfügbar ist.

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 → (handle)

Fenster-Handle.

RedRedRedRedredred (input_control) integer(-array) → (integer)

Rotanteil der Farbe.

Defaultwert: 255

Typischer Wertebereich: 0 ≤ Red Red Red Red red red ≤ 255

Restriktion: 0 <= Red && Red <= 255

GreenGreenGreenGreengreengreen (input_control) integer(-array) → (integer)

Grünanteil der Farbe.

Defaultwert: 0

Typischer Wertebereich: 0 ≤ Green Green Green Green green green ≤ 255

Restriktion: 0 <= Green && Green <= 255

BlueBlueBlueBlueblueblue (input_control) integer(-array) → (integer)

Blauanteil der Farbe.

Defaultwert: 0

Typischer Wertebereich: 0 ≤ Blue Blue Blue Blue blue blue ≤ 255

Restriktion: 0 <= Blue && Blue <= 255

AlphaAlphaAlphaAlphaalphaalpha (input_control) integer(-array) → (integer)

Alphawert der Farbe.

Defaultwert: 255

Typischer Wertebereich: 0 ≤ Alpha Alpha Alpha Alpha alpha alpha ≤ 255

Restriktion: 0 <= Alpha && Alpha <= 255

Ergebnis

set_rgbaset_rgbaSetRgbaSetRgbaSetRgbaset_rgba liefert den Wert TRUE, falls das Fenster gültig ist und alle Farben verfügbar sind. Ansonsten wird eine Fehlerbehandlung durchgeführt.

Nachfolger

disp_objdisp_objDispObjDispObjDispObjdisp_obj

Alternativen

set_rgbset_rgbSetRgbSetRgbSetRgbset_rgb, set_colorset_colorSetColorSetColorSetColorset_color

Modul

Foundation

Operatoren