set_pixelset_pixelSetPixelSetPixel (Operator)

Name

set_pixelset_pixelSetPixelSetPixel — Define a color lookup table index.

Warning

set_pixelset_pixelSetPixelSetPixelSetPixel is obsolete and is only provided for reasons of backward compatibility.

Signature

set_pixel( : : WindowHandle, Pixel : )

set_pixelset_pixelSetPixelSetPixelSetPixel sets pixel values: colors (set_colorset_colorSetColorSetColorSetColor, set_rgbset_rgbSetRgbSetRgbSetRgb, etc.) and gray values (set_grayset_graySetGraySetGraySetGray) are coded together into a number, called pixel. This 'pixel' is an index in the color lookup table. It ranges from 0 to 1 in b/w images and 0 to 255 color images with 8 bit planes. It is different from the 'pixel' ("picture element") in image processing. Therefore HALCON distinguishes between pixel and image element (or gray value).

The current value can be queried with get_pixelget_pixelGetPixelGetPixelGetPixel.

Execution Information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control) window → (integer)

Window handle.

PixelPixelPixelPixelpixel (input_control) integer(-array) → (integer)

Color lookup table index.

Default value: 128

Typical range of values: 0 ≤ Pixel Pixel Pixel Pixel pixel ≤ 255

Result

set_pixelset_pixelSetPixelSetPixelSetPixel returns 2 (H_MSG_TRUE) if the parameter is correct and the window is valid. Otherwise an exception is raised.