set_pixel ( : : WindowHandle, Pixel : )

Define a color lookup table index.

set_pixel sets pixel values: colors (set_color, set_rgb, etc.) and grayvalues (set_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 grayvalue).

The current value can be queried with get_pixel.


Parameters

WindowHandle (input_control)
window -> integer
Window_id.

Pixel (input_control)
integer(-array) -> integer
Color lookup table index.
Default value: 128
Typical range of values: 0 <= Pixel <= 255


Result

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


Parallelization Information

set_pixel is reentrant, local, and processed without parallelization.


Possible Predecessors

get_pixel


Possible Successors

disp_image, disp_region


Alternatives

set_rgb, set_color, set_hsi


See also

get_pixel, set_lut, disp_region, disp_image, disp_color


Module

System



Copyright © 1996-2005 MVTec Software GmbH