get_pixelT_get_pixelGetPixelget_pixelGetPixelGetPixel (Operator)

Name

get_pixelT_get_pixelGetPixelget_pixelGetPixelGetPixel — Abfragen des aktuellen Farbtabellenindex.

get_pixelget_pixelGetPixelget_pixelGetPixelGetPixel gibt die Kodierung des Ausgabegrauwerts bzw. der Ausgabefarbe für das Ausgabefenster aus. Wird mit den Operatoren set_colorset_colorSetColorset_colorSetColorSetColor oder set_grayset_graySetGrayset_graySetGraySetGray der Modus für die Ausgabe (disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, disp_ellipsedisp_ellipseDispEllipsedisp_ellipseDispEllipseDispEllipse, etc.) auf Farbe(n) bzw. Grauwert(e) gesetzt, dann wird der angegebene Werte in einen internen Code umgewandelt. Dieser Code wird dann (physikalisch) bei der Darstellung auf dem Bildschirm verwendet. Die Umsetzung ist von den Abbildungseigenschaften und dem Zustand des Ausgabegerätes abhängig und kann bei verschiedenen Programmläufen unterschiedlich ausfallen. Der Begriff „Pixel“ ist nicht mit dem des „Pixels“ in der Bildverarbeitung zu verwechseln (hierfür gibt es den Operator get_grayvalget_grayvalGetGrayvalget_grayvalGetGrayvalGetGrayval). Ein Pixel ist hier i.a. der Index in der Farbtabelle.

get_pixelget_pixelGetPixelget_pixelGetPixelGetPixel erlaubt es, die Ausgabeart zu sichern, ohne dass man wissen muss, ob Farbe(n) oder Grauwert(e) gesetzt wurden. Zurückgesetzt wird der Parameter mit dem Operator set_pixelset_pixelSetPixelset_pixelSetPixelSetPixel.

Parallelisierung

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control) window → (integer)

Fenster-Handle.

PixelPixelPixelPixelPixelpixel (output_control) integer-array → (integer)

Index in der aktuellen Farbtabelle.

Ergebnis

get_pixelget_pixelGetPixelget_pixelGetPixelGetPixel liefert den Wert 2 (H_MSG_TRUE), falls das Fenster gültig ist. Ansonsten wird eine Fehlerbehandlung durchgeführt.

Nachfolger

set_pixelset_pixelSetPixelset_pixelSetPixelSetPixel, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, disp_imagedisp_imageDispImagedisp_imageDispImageDispImage

Siehe auch

set_pixelset_pixelSetPixelset_pixelSetPixelSetPixel, set_fixset_fixSetFixset_fixSetFixSetFix

Modul

Foundation

Operatoren