set_pixelT_set_pixelSetPixelSetPixelset_pixel (Operator)

Name

set_pixelT_set_pixelSetPixelSetPixelset_pixel — Define a color lookup table index.

Warning

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

Signature

set_pixel( : : WindowHandle, Pixel : )

Description

set_pixelset_pixelSetPixelSetPixelset_pixel sets pixel values: colors (set_colorset_colorSetColorSetColorset_color, set_rgbset_rgbSetRgbSetRgbset_rgb, etc.) and gray values (set_grayset_graySetGraySetGrayset_gray) 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_pixelGetPixelGetPixelget_pixel.

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

WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → (handle)

Window handle.

PixelPixelPixelpixelpixel (input_control) integer(-array) → (integer)

Color lookup table index.

Default: 128

Value range: 0 ≤ Pixel Pixel Pixel pixel pixel ≤ 255

Result

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