set_rgb
— Setzen der Ausgabefarbe durch RGB-Werte.
set_rgb( : : WindowHandle, Red, Green, Blue : )
set_rgb
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 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
oder
set_gray
aufgerufen wird. Verwendet wird dieser
Darstellungsparameter bei Operatoren wie
disp_region
, disp_line
,
disp_rectangle1
, disp_rectangle2
,
disp_arrow
, etc.
Falls die angegebene Farbe nicht verfügbar ist, führt dies die einem Exception. Nach dem Aufruf von set_check(::'~color':) sucht HALCON die nächste Farbe zu der angegebenen und unterdrückt den Fehler.
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
set_rgb
liefert den Wert 2 (H_MSG_TRUE), falls das Fenster gültig ist und
für dieses die angegebene(n) Farbe(n) darstellbar sind.
Ansonsten wird eine Fehlerbehandlung durchgeführt.
Foundation