set_hsi
— Festlegen der Ausgabefarbe in der HSI-Kodierung.
set_hsi( : : WindowHandle, Hue, Saturation, Intensity : )
set_hsi
setzt für das Ausgabefenster die Farbe(n), bzw.
die Grauwerte, in der Regionen dargestellt werden sollen.
Die gewünschten Werte werden durch Hue
(Farbwert),
Saturation
(Sättigung) und Intensity
(Intensität)
festgelegt.
Die Umrechnung von HSI nach RGB erfolgt mit der Formel:
Der Wertebereich wird auf 0 bis 255 begrenzt.
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 Region 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 Farbe(n) werden 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. Die Farbe wird aber auch bei der graphischen
Darstellung von Grauwerten verwendet (z.B.: '3d_plot_lines','histogram',
'contourline', etc.; siehe hierzu set_paint
).
Die Farben werden intern als RGB Tripel gespeichert. Manche HSI Tripel können nicht durch ein gültiges RGB Tripel (im Bereich 0..255) repräsentiert werden. In diesem Fall wird die der gewünschten Farbe nächste repräsentierbare Farbe verwendet.
WindowHandle
(input_control) window →
(handle)
Fenster-Handle.
Hue
(input_control) integer(-array) →
(integer)
Farbwert der aktuellen Zeichenfarbe.
Defaultwert: 30
Typischer Wertebereich: 0
≤
Hue
≤
255
Restriktion: 0 <= Hue && Hue <= 255
Saturation
(input_control) integer(-array) →
(integer)
Sättigung der aktuellen Zeichenfarbe.
Defaultwert: 255
Typischer Wertebereich: 0
≤
Saturation
≤
255
Restriktion: 0 <= Saturation && Saturation <= 255
Intensity
(input_control) integer(-array) →
(integer)
Intensität der aktuellen Zeichenfarbe.
Defaultwert: 84
Typischer Wertebereich: 0
≤
Intensity
≤
255
Restriktion: 0 <= Intensity && Intensity <= 255
set_hsi
liefert den Wert 2 (H_MSG_TRUE), falls das Fenster gültig ist
und für dieses die angegebene Farbe(n) darstellbar sind.
Ansonsten wird eine Fehlerbehandlung durchgeführt.
get_hsi
,
trans_from_rgb
,
trans_to_rgb
,
disp_region
Foundation