set_fixSetFixSetFixset_fixT_set_fix

HALCON ScriptCpp++.NETPythonC

Short description

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

Warning

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

Signature

set_fix( window WindowHandle, string Mode )void SetFix( const HTuple& WindowHandle, const HTuple& Mode )static void HOperatorSet.SetFix( HTuple windowHandle, HTuple mode )def set_fix( window_handle: HHandle, mode: str ) -> None

Herror T_set_fix( const Htuple WindowHandle, const Htuple Mode )

void HWindow::SetFix( const HString& Mode ) const

void HWindow::SetFix( const char* Mode ) const

void HWindow::SetFix( const wchar_t* Mode ) const (Windows only)

void HWindow.SetFix( string mode )

Description

Behavior for Modemodemode = 'true'"true": set_fixSetFix fixes that pixel lastly ascertained by one of the operators set_graySetGray, set_colorSetColor, set_hsiSetHsi or set_rgbSetRgb (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_colorSetColor, set_rgbSetRgb, set_hsiSetHsi or set_graySetGray. This makes it possible to define any color (set_colorSetColor), any gray value (set_graySetGray) and any color combination (set_rgbSetRgb, set_hsiSetHsi) at any position of the look-up-table.

Modemodemode set to ‘false’ reset the fixing. To modify or create a look-up-table process set_pixelSetPixel, set_fix(::WindowHandle,'true':), set_rgbSetRgb and set_fix(::WindowHandle,'false':) one after another.

Attention

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

Execution information

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

WindowHandlewindowHandlewindow_handle (input_control) window → (handle)HTuple (HHandle)HWindow, HTuple (IntPtr)HHandleHtuple (handle)

Window handle.

Modemodemode (input_control) string → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Mode of fixing.

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

Result

set_fixSetFix 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.

Combinations with other operators

Combinations

Possible predecessors

get_fixGetFix

Possible successors

set_pixelSetPixel, set_rgbSetRgb

See also

get_fixGetFix, set_pixelSetPixel, set_rgbSetRgb, set_colorSetColor, set_hsiSetHsi, set_graySetGray

Module

Foundation