Operator Reference

HALCON Operator Reference / Legacy / Graphics
ClassesClasses | | Operators

set_pixelT_set_pixelSetPixelSetPixelset_pixel (Operator)

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 : )

Herror T_set_pixel(const Htuple WindowHandle, const Htuple Pixel)

void SetPixel(const HTuple& WindowHandle, const HTuple& Pixel)

void HWindow::SetPixel(const HTuple& Pixel) const

void HWindow::SetPixel(Hlong Pixel) const

static void HOperatorSet.SetPixel(HTuple windowHandle, HTuple pixel)

void HWindow.SetPixel(HTuple pixel)

void HWindow.SetPixel(int pixel)

def set_pixel(window_handle: HHandle, pixel: MaybeSequence[int]) -> None

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 → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Window handle.

PixelPixelPixelpixelpixel (input_control)  integer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

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.

Possible Predecessors

get_pixelget_pixelGetPixelGetPixelget_pixel

Possible Successors

disp_imagedisp_imageDispImageDispImagedisp_image, disp_regiondisp_regionDispRegionDispRegiondisp_region

Alternatives

set_rgbset_rgbSetRgbSetRgbset_rgb, set_colorset_colorSetColorSetColorset_color, set_hsiset_hsiSetHsiSetHsiset_hsi

See also

get_pixelget_pixelGetPixelGetPixelget_pixel, set_lutset_lutSetLutSetLutset_lut, disp_regiondisp_regionDispRegionDispRegiondisp_region, disp_imagedisp_imageDispImageDispImagedisp_image, disp_colordisp_colorDispColorDispColordisp_color

Module

Foundation

ClassesClasses | | Operators