Herror ::set_pixel (
    const HTuple &WindowHandle,
    const HTuple &Pixel
)
void HWindow::SetPixel (
    const HTuple &Pixel
) const

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 -> HTuple.long
Window_id.

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


Result

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


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-2002 MVTec Software GmbH