dev_set_lut ( : : LutName : )

Set ``look-up-table'' (lut).

dev_set_lut sets look-up-table of the the output window. A look-up-table defines the transformation of a ``gray value'' within an image into a gray value or color on the screen. It describes the screen gray value/color as a combination of red, green and blue for any image gray value (0..255) (so it is a 'table' to 'look up' the screen gray value/color for each image gray value: look-up-table). Transformation into screen-colors is performed in real-time at every time the screen is displayed new (typically this happens about 60 - 70 times per second). So it is possible to change the look-up-table to get a new look of images or regions. Please remind that not all machines support changing the look-up-table (e.g., monochrome resp. truecolor).

For common monitors only one look-up-table can be loaded per screen. Whereas dev_set_lut can be activated separately for each window. There is the following solution for this problem: It will always be activated the look-up-table that is assigned to the ``active window'' (a window is set into the state ``active'' by placing the mouse inside the window).

look-up-tables can also be used with truecolor displays. In this case the look-up-table will be simulated in software. This means, that the look-up-table will be used each time an image is displayed.

query_lut lists the names of all look-up-tables.


Attention

If dev_set_lut should be used for exported Code (C++), please note the description of set_lut due to the different semantics in C++.


Parameters

LutName (input_control)
string -> string
Name of look-up-table, values of look-up-table (RGB) or file name.
Default value: 'default'
Suggested values: 'default', 'linear', 'inverse', 'sqr', 'inv_sqr', 'cube', 'inv_cube', 'sqrt', 'inv_sqrt', 'cubic_root', 'inv_cubic_root', 'color1', 'color2', 'color3', 'color4', 'three', 'six', 'twelfe', 'twenty_four', 'rainbow', 'temperature', 'cyclic_gray', 'cyclic_temperature', 'hsi', 'change1', 'change2', 'change3'


Example
read_image(Image,'mreut')
dev_set_lut('inverse')
* For true color only:
dev_display(Image)

Result

dev_set_lut always returns 2 (H_MSG_TRUE)


Parallelization Information

dev_set_lut is local and processed completely exclusively without parallelization.


Possible Successors

dev_display


See also

set_lut


Module

System



Copyright © 1996-2005 MVTec Software GmbH