set_pixel — Setzen eines Index in der Farbtabelle.
set_pixel ist veraltet und wird nur aus Gründen
der Rückwärtskompatibilität zur Verfügung gestellt.
set_pixel( : : WindowHandle, Pixel : )
set_pixel setzt die Pixelwerte, die mit get_pixel
abgefragt wurden. Farben (set_color, set_rgb, etc.)
und Grauwert (set_gray) 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_pixel abgefragt und kann mit
set_pixel 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.
WindowHandle (input_control) window → (handle)
Fenster-Handle.
Pixel (input_control) integer(-array) → (integer)
Index in der aktuellen Farbtabelle.
Default: 128
Wertebereich:
0
≤
Pixel
≤
255
set_pixel liefert den Wert 2 (
H_MSG_TRUE)
, falls der Parameter korrekt ist
und das Fenster gültig ist.
Ansonsten wird eine Fehlerbehandlung durchgeführt.
get_pixel,
set_lut,
disp_region,
disp_image,
disp_color
Foundation