set_rgba
— Setzen der Ausgabefarbe durch RGBA-Werte.
set_rgba( : : WindowHandle, Red, Green, Blue, Alpha : )
set_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_color
, set_rgb
, set_rgba
oder
set_gray
aufgerufen wird. Verwendet wird dieser
Darstellungsparameter bei Operatoren wie
disp_region
, disp_line
,
disp_rectangle1
, disp_rectangle2
,
disp_arrow
, etc.
set_rgba
benötigt die Bibliothek libcanvas, die auf Embedded-Systemen
möglicherweise nicht verfügbar ist.
WindowHandle
(input_control) window →
(handle)
Fenster-Handle.
Red
(input_control) integer(-array) →
(integer)
Rotanteil der Farbe.
Defaultwert: 255
Typischer Wertebereich: 0
≤
Red
≤
255
Restriktion: 0 <= Red && Red <= 255
Green
(input_control) integer(-array) →
(integer)
Grünanteil der Farbe.
Defaultwert: 0
Typischer Wertebereich: 0
≤
Green
≤
255
Restriktion: 0 <= Green && Green <= 255
Blue
(input_control) integer(-array) →
(integer)
Blauanteil der Farbe.
Defaultwert: 0
Typischer Wertebereich: 0
≤
Blue
≤
255
Restriktion: 0 <= Blue && Blue <= 255
Alpha
(input_control) integer(-array) →
(integer)
Alphawert der Farbe.
Defaultwert: 255
Typischer Wertebereich: 0
≤
Alpha
≤
255
Restriktion: 0 <= Alpha && Alpha <= 255
set_rgba
liefert den Wert 2 (H_MSG_TRUE), falls das Fenster gültig ist und alle
Farben verfügbar sind. Ansonsten wird eine Fehlerbehandlung durchgeführt.
Foundation