set_pixelset_pixelSetPixelset_pixelSetPixelSetPixel (Operator)

Name

set_pixelset_pixelSetPixelset_pixelSetPixelSetPixel — Setzen eines Index in der Farbtabelle.

Signatur

set_pixel( : : WindowHandle, Pixel : )

set_pixelset_pixelSetPixelset_pixelSetPixelSetPixel setzt die Pixelwerte, die mit get_pixelget_pixelGetPixelget_pixelGetPixelGetPixel abgefragt wurden. Farben (set_colorset_colorSetColorset_colorSetColorSetColor, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, etc.) und Grauwert (set_grayset_graySetGrayset_graySetGraySetGray) werden gemeinsam in eine ganze Zahl kodiert. Diese Zahl wird Pixel genannt. Ein Pixel ist ein Index in der Farbtabelle und hat einen Wertebereich von 0,1 bei S/W-Bildschirmen und 0..255 bei Farbbildschirmen mit 8 Bildebenen. Dieses Pixel ist also nicht mit dem Pixel („picture element“) der Bildverarbeitung (Bildpunkt) zu verwechseln. Deshalb wird bei HALCON immer zwischen Pixel und Bildpunkt (oder auch Grauwert) unterschieden.

Dieser Code (Pixel) wird mit get_pixelget_pixelGetPixelget_pixelGetPixelGetPixel abgefragt und kann mit set_pixelset_pixelSetPixelset_pixelSetPixelSetPixel wieder zurückgesetzt werden. Der Wertebereich des Parameters beginnt bei Null und läuft bis zu einer oberen Grenze, wobei diese der Anzahl darstellbarer Graustufen bzw. Farbwerte der Ausgabegeräte entspricht.

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 (input_control) integer(-array) → (integer)

Index in der aktuellen Farbtabelle.

Defaultwert: 128

Typischer Wertebereich: 0 ≤ Pixel Pixel Pixel Pixel Pixel pixel ≤ 255

Ergebnis

set_pixelset_pixelSetPixelset_pixelSetPixelSetPixel liefert den Wert 2 (H_MSG_TRUE), falls der Parameter korrekt ist und das Fenster gültig ist. Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

get_pixelget_pixelGetPixelget_pixelGetPixelGetPixel

Nachfolger

disp_imagedisp_imageDispImagedisp_imageDispImageDispImage, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion

Alternativen

set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_colorset_colorSetColorset_colorSetColorSetColor, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi

Siehe auch

get_pixelget_pixelGetPixelget_pixelGetPixelGetPixel, set_lutset_lutSetLutset_lutSetLutSetLut, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, disp_imagedisp_imageDispImagedisp_imageDispImageDispImage, disp_colordisp_colorDispColordisp_colorDispColorDispColor

Modul

Foundation

Operatoren