set_fixT_set_fixSetFixSetFix (Operator)

Name

set_fixT_set_fixSetFixSetFix — Set fixing of “look-up-table” (lut)

Warning

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

Description

Behaviour for ModeModeModeModemode = 'true'"true""true""true""true": set_fixset_fixSetFixSetFixSetFix fixes that pixel lastly ascertained by one of the operators set_grayset_graySetGraySetGraySetGray, set_colorset_colorSetColorSetColorSetColor, set_hsiset_hsiSetHsiSetHsiSetHsi or set_rgbset_rgbSetRgbSetRgbSetRgb (Remark: Here a pixel is the index within the current look-up-table). To assign a new color to a fixed pixel set a color or gray value by using set_colorset_colorSetColorSetColorSetColor, set_rgbset_rgbSetRgbSetRgbSetRgb, set_hsiset_hsiSetHsiSetHsiSetHsi or set_grayset_graySetGraySetGraySetGray. This makes it possible to define any color (set_colorset_colorSetColorSetColorSetColor), any gray value (set_grayset_graySetGraySetGraySetGray) and any color combination (set_rgbset_rgbSetRgbSetRgbSetRgb, set_hsiset_hsiSetHsiSetHsiSetHsi) at any position of the look-up-table.

ModeModeModeModemode set to 'false' reset the fixing. To modify or create a look-up-table process set_pixelset_pixelSetPixelSetPixelSetPixel, set_fix(::WindowHandle,'true':)set_fix(WindowHandle,"true")SetFix(WindowHandle,"true")SetFix(WindowHandle,"true")SetFix(WindowHandle,"true"), set_rgbset_rgbSetRgbSetRgbSetRgb and set_fix(::WindowHandle,'false':)set_fix(WindowHandle,"false")SetFix(WindowHandle,"false")SetFix(WindowHandle,"false")SetFix(WindowHandle,"false") one after another.

Attention

As a side effect set_fixset_fixSetFixSetFixSetFix can change colors of “non-HALCON windows”.

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 → (handle)

Window handle.

ModeModeModeModemode (input_control) string → (string)

Mode of fixing.

Default value: 'true' "true" "true" "true" "true"

List of values: 'false'"false""false""false""false", 'true'"true""true""true""true"

Result

set_fixset_fixSetFixSetFixSetFix returns 2 (H_MSG_TRUE) if the window is valid, the hardware supports a look-up-table and all parameters are correct. Otherwise an exception is raised.