Herror ::disp_lut (
    const HTuple &WindowHandle,
    const HTuple &Row,
    const HTuple &Column,
    const HTuple &Scale
)
void HWindow::DispLut (
    const HTuple &Row,
    const HTuple &Column,
    const HTuple &Scale
) const

Graphical view of the look-up-table (lut).

::disp_lut displays a graphical view of the look-up-table (lut) in the valid window. A look-up-table defines the transformation of image gray values to colors/gray levels on the screen. On most systems this can be modified. ::disp_lut creates a graphical view of the table assigned to the output window with the logical window number WindowHandle and displays it for every basic color (red, green, blue). Row and Column define the position of the centre of the graphic. Scale allows scaling of the graphic, whereas 1 means displaying all 256 values, 2 means displaying 128 values, 3 means displaying only 64 values, etc. Tables for monochrome-representations are displayed in the currently set color (see ::set_color, ::set_rgb, etc.). Tables for displaying "false colors" are viewed with red, green and blue for each color component.


Attention

::draw_lut can only be used on hardware supporting look-up-tables for the output.


Parameters

WindowHandle (input_control)
window -> HTuple.long
Window identifier.

Row (input_control)
point.y -> HTuple.long
Row of centre of the graphic.
Default value: 128
Typical range of values: 0 <= Row <= 511

Column (input_control)
point.x -> HTuple.long
Column of centre of the graphic.
Default value: 128
Typical range of values: 0 <= Column <= 511

Scale (input_control)
integer -> HTuple.long
Scaling of the graphic.
Default value: 1
List of values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
Typical range of values: 0 <= Scale <= 20


Example
set_lut(WindowHandle,"color") ;
disp_lut(WindowHandle,256,256,1) ;
get_mbutton(WindowHandle,_,_,_) ;
set_lut(WindowHandle,"sqrt") ;
disp_lut(WindowHandle,128,128,2) ;

Result

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


Possible Predecessors

::set_lut


See also

::open_window, ::open_textwindow, ::draw_lut, ::set_lut, ::set_fix, ::set_pixel, ::write_lut, ::get_lut, ::set_color


Module

System



Copyright © 1996-2002 MVTec Software GmbH