set_hsiT_set_hsiSetHsiSetHsiset_hsi (Operator)

Name

set_hsiT_set_hsiSetHsiSetHsiset_hsi — Festlegen der Ausgabefarbe in der HSI-Kodierung.

Signatur

set_hsi( : : WindowHandle, Hue, Saturation, Intensity : )

Beschreibung

set_hsiset_hsiSetHsiSetHsiset_hsi setzt für das Ausgabefenster die Farbe(n), bzw. die Grauwerte, in der Regionen dargestellt werden sollen. Die gewünschten Werte werden durch HueHueHuehuehue (Farbwert), SaturationSaturationSaturationsaturationsaturation (Sättigung) und IntensityIntensityIntensityintensityintensity (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_colorset_colorSetColorSetColorset_color, set_rgbset_rgbSetRgbSetRgbset_rgb oder set_grayset_graySetGraySetGrayset_gray aufgerufen wird. Verwendet wird dieser Darstellungsparameter bei Operatoren wie disp_regiondisp_regionDispRegionDispRegiondisp_region, disp_linedisp_lineDispLineDispLinedisp_line, disp_rectangle1disp_rectangle1DispRectangle1DispRectangle1disp_rectangle1, disp_rectangle2disp_rectangle2DispRectangle2DispRectangle2disp_rectangle2, disp_arrowdisp_arrowDispArrowDispArrowdisp_arrow, etc. Die Farbe wird aber auch bei der grafischen Darstellung von Grauwerten verwendet (z.B.: '3d_plot'"3d_plot""3d_plot""3d_plot""3d_plot", etc.; siehe hierzu set_paintset_paintSetPaintSetPaintset_paint).

Achtung

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.

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

WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → (handle)

Fenster-Handle.

HueHueHuehuehue (input_control) integer(-array) → (integer)

Farbwert der aktuellen Zeichenfarbe.

Default: 30

Wertebereich: 0 ≤ Hue Hue Hue hue hue ≤ 255

SaturationSaturationSaturationsaturationsaturation (input_control) integer(-array) → (integer)

Sättigung der aktuellen Zeichenfarbe.

Default: 255

Wertebereich: 0 ≤ Saturation Saturation Saturation saturation saturation ≤ 255

IntensityIntensityIntensityintensityintensity (input_control) integer(-array) → (integer)

Intensität der aktuellen Zeichenfarbe.

Default: 84

Wertebereich: 0 ≤ Intensity Intensity Intensity intensity intensity ≤ 255

Ergebnis

set_hsiset_hsiSetHsiSetHsiset_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.

Vorgänger

get_hsiget_hsiGetHsiGetHsiget_hsi

Nachfolger

disp_regiondisp_regionDispRegionDispRegiondisp_region

Siehe auch

get_hsiget_hsiGetHsiGetHsiget_hsi, trans_from_rgbtrans_from_rgbTransFromRgbTransFromRgbtrans_from_rgb, trans_to_rgbtrans_to_rgbTransToRgbTransToRgbtrans_to_rgb, disp_regiondisp_regionDispRegionDispRegiondisp_region

Modul

Foundation

Operatoren