draw_lutdraw_lutdraw_lutDrawLutDrawLut (Operator)

Name

draw_lutdraw_lutdraw_lutDrawLutDrawLut — Manipulate look-up-table (lut) interactively.

Signature

Description

draw_lutdraw_lutdraw_lutDrawLutDrawLut allows interactive manipulation of the look-up-table of the device currently displaying the output window.

By pressing and holding down the left mouse button one can change (from “left to right”) the red-, green- and blue-intensity displayed in a 2 dimensional diagram with the gray values on the x-axis. The left mouse button also is used for choosing the color channel that should be changed. As an alternative, one can map pure gray levels (gray “color channel”) to the gray values on the x-axis. The right mouse button is used for terminating the change-process. The modified look-up-table can be saved by write_lutwrite_lutwrite_lutWriteLutWriteLut and reloaded later by set_lutset_lutset_lutSetLutSetLut. get_lutget_lutget_lutGetLutGetLut succeeding draw_lutdraw_lutdraw_lutDrawLutDrawLut returns directly the RGB tuple of the look-up-table. These are suitable as input of set_lutset_lutset_lutSetLutSetLut.

Attention

draw_lutdraw_lutdraw_lutDrawLutDrawLut is only suitable for displays with a color depth of 8 bits. Furthermore, it can only be used on hardware supporting look-up-tables for the output and allowing dynamic changes of the tables.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: local (may only be called from the same thread in which the window, model, or tool instance was created).
• Processed without parallelization.

Parameters

read_image(Image,'fabrik')
disp_image(Image,WindowHandle)
draw_lut(WindowHandle)
write_lut(WindowHandle,'my_lut')
* ...
read_image(Image,'fabrik')
set_lut(WindowHandle,'my_lut')

read_image(&Image,"fabrik") ;
disp_image(Image,WindowHandle) ;
draw_lut(WindowHandle) ;
write_lut(WindowHandle,"my_lut") ;
/* ... */
read_image(&Image,"fabrik") ;
set_lut(WindowHandle,"my_lut") ;

read_image(Image,'fabrik')
disp_image(Image,WindowHandle)
draw_lut(WindowHandle)
write_lut(WindowHandle,'my_lut')
* ...
read_image(Image,'fabrik')
set_lut(WindowHandle,'my_lut')

read_image(Image,'fabrik')
disp_image(Image,WindowHandle)
draw_lut(WindowHandle)
write_lut(WindowHandle,'my_lut')
* ...
read_image(Image,'fabrik')
set_lut(WindowHandle,'my_lut')

read_image(Image,'fabrik')
disp_image(Image,WindowHandle)
draw_lut(WindowHandle)
write_lut(WindowHandle,'my_lut')
* ...
read_image(Image,'fabrik')
set_lut(WindowHandle,'my_lut')

Result

draw_lutdraw_lutdraw_lutDrawLutDrawLut returns 2 (H_MSG_TRUE) if the window is valid. Otherwise, an exception is raised.

Possible Successors

set_lut_styleset_lut_styleset_lut_styleSetLutStyleSetLutStyle, set_lutset_lutset_lutSetLutSetLut, write_lutwrite_lutwrite_lutWriteLutWriteLut, disp_lutdisp_lutdisp_lutDispLutDispLut

Alternatives

set_fixset_fixset_fixSetFixSetFix, set_rgbset_rgbset_rgbSetRgbSetRgb

See also

write_lutwrite_lutwrite_lutWriteLutWriteLut, set_lutset_lutset_lutSetLutSetLut, get_lutget_lutget_lutGetLutGetLut, disp_lutdisp_lutdisp_lutDispLutDispLut

Module

Foundation