set_fix (Operator)

Name

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

Synopsis

set_fix( : : WindowHandle, Mode : )

Description

Behaviour for Mode = 'true': set_fix fixes that pixel lastly ascertained by one of the operators set_gray, set_color, set_hsi or set_rgb (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_color, set_rgb, set_hsi or set_gray. This makes it possible to define any color (set_color), any gray value (set_gray) and any color combination (set_rgb, set_hsi) at any position of the look-up-table.

Mode set to 'false' reset the fixing. To modify or create a look-up-table process set_pixel, set_fix(::WindowHandle,'true':), set_rgb and set_fix(::WindowHandle,'false':) one after another.

Attention

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

Parameters

WindowHandle (input_control)	window → (integer)
Window identifier.

Mode (input_control)	string → (string)
Mode of fixing.
Default value: 'true'
List of values: 'true', 'false'

Result

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

Parallelization Information

set_fix is reentrant, local, and processed without parallelization.

Possible Predecessors

get_fix

Possible Successors

set_pixel, set_rgb

See also

get_fix, set_pixel, set_rgb, set_color, set_hsi, set_gray

Module

Foundation