KlassenKlassenKlassenKlassen | | | | Operatoren

set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi (Operator)

Name

set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi — Festlegen der Ausgabefarbe in der HSI-Kodierung.

Signatur

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

Herror set_hsi(const Hlong WindowHandle, const Hlong Hue, const Hlong Saturation, const Hlong Intensity)

Herror T_set_hsi(const Htuple WindowHandle, const Htuple Hue, const Htuple Saturation, const Htuple Intensity)

Herror set_hsi(const HTuple& WindowHandle, const HTuple& Hue, const HTuple& Saturation, const HTuple& Intensity)

void HWindow::SetHsi(const HTuple& Hue, const HTuple& Saturation, const HTuple& Intensity) const

void SetHsi(const HTuple& WindowHandle, const HTuple& Hue, const HTuple& Saturation, const HTuple& Intensity)

void HWindow::SetHsi(const HTuple& Hue, const HTuple& Saturation, const HTuple& Intensity) const

void HWindow::SetHsi(Hlong Hue, Hlong Saturation, Hlong Intensity) const

void HOperatorSetX.SetHsi(
[in] VARIANT WindowHandle, [in] VARIANT Hue, [in] VARIANT Saturation, [in] VARIANT Intensity)

void HWindowX.SetHsi(
[in] VARIANT Hue, [in] VARIANT Saturation, [in] VARIANT Intensity)

static void HOperatorSet.SetHsi(HTuple windowHandle, HTuple hue, HTuple saturation, HTuple intensity)

void HWindow.SetHsi(HTuple hue, HTuple saturation, HTuple intensity)

void HWindow.SetHsi(int hue, int saturation, int intensity)

Beschreibung

set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi setzt für das Ausgabefenster die Farbe(n), bzw. die Grauwerte, in der Regionen dargestellt werden sollen. Die gewünschten Werte werden durch HueHueHueHueHuehue (Farbwert), SaturationSaturationSaturationSaturationSaturationsaturation (Sättigung) und IntensityIntensityIntensityIntensityIntensityintensity (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_colorSetColorset_colorSetColorSetColor, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb oder set_grayset_graySetGrayset_graySetGraySetGray aufgerufen wird. Verwendet wird dieser Darstellungsparameter bei Operatoren wie disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, disp_linedisp_lineDispLinedisp_lineDispLineDispLine, disp_rectangle1disp_rectangle1DispRectangle1disp_rectangle1DispRectangle1DispRectangle1, disp_rectangle2disp_rectangle2DispRectangle2disp_rectangle2DispRectangle2DispRectangle2, disp_arrowdisp_arrowDispArrowdisp_arrowDispArrowDispArrow, etc. Die Farbe wird aber auch bei der graphischen Darstellung von Grauwerten verwendet (z.B.: '3d_plot_lines','histogram', 'contourline', etc.; siehe hierzu set_paintset_paintSetPaintset_paintSetPaintSetPaint).

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.

Parallelisierung

Parameter

WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window HWindow, HTupleHTupleHTupleHWindowX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Fenster-Handle.

HueHueHueHueHuehue (input_control)  integer(-array) HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Farbwert der aktuellen Zeichenfarbe.

Defaultwert: 30

Typischer Wertebereich: 0 ≤ Hue Hue Hue Hue Hue hue ≤ 255

Restriktion: 0 <= Hue && Hue <= 255

SaturationSaturationSaturationSaturationSaturationsaturation (input_control)  integer(-array) HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Sättigung der aktuellen Zeichenfarbe.

Defaultwert: 255

Typischer Wertebereich: 0 ≤ Saturation Saturation Saturation Saturation Saturation saturation ≤ 255

Restriktion: 0 <= Saturation && Saturation <= 255

IntensityIntensityIntensityIntensityIntensityintensity (input_control)  integer(-array) HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Intensität der aktuellen Zeichenfarbe.

Defaultwert: 84

Typischer Wertebereich: 0 ≤ Intensity Intensity Intensity Intensity Intensity intensity ≤ 255

Restriktion: 0 <= Intensity && Intensity <= 255

Ergebnis

set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi 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_hsiGetHsiget_hsiGetHsiGetHsi

Nachfolger

disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion

Siehe auch

get_hsiget_hsiGetHsiget_hsiGetHsiGetHsi, trans_from_rgbtrans_from_rgbTransFromRgbtrans_from_rgbTransFromRgbTransFromRgb, trans_to_rgbtrans_to_rgbTransToRgbtrans_to_rgbTransToRgbTransToRgb, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren