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 zu einer
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.
Default: 255
Wertebereich:
0
≤
Red
≤
255
Green (input_control) integer(-array) → (integer)
Grünanteil der Farbe.
Default: 0
Wertebereich:
0
≤
Green
≤
255
Blue (input_control) integer(-array) → (integer)
Blauanteil der Farbe.
Default: 0
Wertebereich:
0
≤
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