Herror ::set_fix (
    const HTuple &WindowHandle,
    const HTuple &Mode
)
void HWindow::SetFix (
    const HTuple &Mode
) const

Set fixing of "look-up-table" (lut)

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 -> HTuple.long
Window identifier.

Mode (input_control)
string -> HTuple.char *
Mode of fixing.
Default value: 'true'
List of values: 'true', 'false'


Result

::set_fix returns H_MSG_TRUE if the window is valid, the hardware supports a look-up-table and all parameters are correct. Otherwise an exception handling is raised.


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

System



Copyright © 1996-2002 MVTec Software GmbH