Parent Topic: IWORKS

LUT Editing

The LUT Editing panel contains functions for modifying the in-memory Lookup Tables and image planes according to a specified LUT. The LUT Editing panel can be launched by selecting ``LUT'' from the ``Edit'' menu on the main ImageWorks window.

The launched LUT Editing panel will contain small (``postage stamp'' sized) LUT graphs. These graphs are output only and can not be edited directly. The number of graphs available will vary depending on the screen and font size of the system. This panel is meant to provide a quick overview of the LUTs currently being applied to the image planes.

Each graph has two elements: an option menu and a drawn area showing the LUT. The option menu is used to tie the graph to a particular channel. By selecting ``Channel X'' (where X is a channel number), the graph will show the LUT currently being applied to that channel. If the graph should be tied to a particular colour gun, choose ``Red'', ``Green'', or ``Blue''. The graph will then show the LUT for the image plane currently tied to that colour gun. Changing the gun mappings will cause these graphs to update appropriately.

The LUT Graphs contain three different pieces of information. The black line is a representation of the current LUT. The grey histogram in the background is a histogram of the image data without the LUT applied and the coloured histogram in the foreground is the image data with the LUT applied. If the graph is tied to a colour gun, the foreground histogram is drawn in this colour. A graph that is tied to a specific channel has its foreground histogram drawn in dark grey.

To actually edit an LUT, click any of the mouse buttons in the drawn LUT area. This will cause an LUT Editor to be launched that will allow the editing of that LUT. There can be more than one LUT Editor on screen simultaneously. Each graph can launch a different LUT Editor.

The editor size can be chosen with the radio buttons at the bottom of the LUT Editing panel. A large editor is useful for having finer control when editing the LUT. A small editor might be required if the size of the screen cannot accommodate the larger editor size. If there is already an LUT editor on screen and another is requested of a different size, the old one is popped down and a new one reflecting the new size is displayed.

LUT Editor

The LUT Editor is an interactive panel that allows the direct editing of an image plane's lookup table.

It is composed of several areas. There is a section for controlling which histograms are shown in the drawing area, as well as how the histogram is computed. The main editing area contains a large graphical representation of the LUT for interactive editing with the mouse. To the right of the main editing area is a another LUT graph showing a backup LUT copy. Below this is an area for applying a mathematical function to the LUT. Finally, there are textfields that can be used to enter LUT values directly. The panel features a button at the bottom of the panel which will apply the lookup table to the image plane, changing the image data permanently.

Histogram Area
There are two option menus in this area. The first one, titled ``Showing'', is used to select which histograms are drawn in the main editing area. The second option menu, titled ``Computed From'', is used to select a mask which will be used to define an area of the image plane from which the histogram is computed.

There are two histograms of interest: the original image data histogram, with no LUT applied, and the new histogram, with the LUT applied. Using the ``Showing'' option menu, it is possible to choose which of these histograms is drawn in the main editing area. This option does not apply to the LUT Editing panel with the ``postage stamp'' LUTs.

Using the ``Compute From'' option menu, the user may select a mask from under which to compute the raw or (pre-LUT) histogram. Possible selections include ``All Data'' for a histogram of the entire image plane, ``Viewed Data'' for a histogram of the area currently showing in the main image window, or a specific graphic plane for a histogram of the imagery underneath that graphic plane. The histograms shown in the LUT graphs are intended as an aid in setting function end points, and visualizing data distribution.

Editing Graph
The graph contains three different pieces of information. The black line is a representation of the current LUT. The grey histogram in the background is a histogram of the image data without the LUT applied and the coloured histogram in the foreground is the image data with the LUT applied. If the graph is tied to a colour gun, the foreground histogram is drawn in this colour. A graph that is tied to a specific channel has its foreground histogram drawn in dark grey.

The black line represents the values in the lookup table, with the left side of the graph representing an input value of 0, and the right side of the graph an input value of 255. The height of the white line above the bottom of the graph corresponds to the output value. At the bottom the output value is 0, while at the top the output value is 255.

Interactive Editing
There are three methods of interactively editing the LUTs (black lines) directly in the LUT graph displays.

The first is to click and drag the left mouse button in the graph area to trace out a section of the LUT. When the left button is released the modified LUT will be applied to the imagery in the main image window. This technique is called direct tracing. While the mouse is moved through the graph, the current position of the cursor is shown in the title bar for the lookup table.

The second method, piecewise interpolation, is performed by pressing the middle button at one point, and dragging out a straight line to a second point.

The third technique allows the user to drag the entire LUT to the left or the right. This is done by pressing the right mouse button in the graph area, and dragging the whole graph left or right before releasing the mouse button. This can also be accomplished in single step increments using the ``left arrow'' and ``right arrow'' buttons while the editing area has input focus.

On motif systems, the drawing area can usually be given input focus by clicking the mouse in it. Alternately, the tab key can be used to traverse the tab groups until the drawing area is selected. Unfortunately, the drawing area will not be highlighted in any special way when it is selected so the user may have to experiment with the arrow keys until it is clear that the drawing area has input focus.

Currently there is no provision for moving the whole LUT up or down.

Secondary LUT
To the right of the main editing area is another graph showing a backup copy of the LUT. When the LUT Editor panel is launched, a backup copy of the LUT is saved. The ``Copy'' button will copy the current LUT being edited over the saved LUT. The "Toggle" button will switch between the currently editing LUT and the saved one. These two buttons create a sort of ``undo'' function as well as allowing easy comparison of two sets of LUTs via the toggle.

Applying Functions
The ``Apply'' button is used to apply a mathematical function as part of the LUT. The function is applied within bounds defined by the markers along the bottom and sides of the main editing graph.

The markers along the left side of the graph determine the minimum and maximum output grey level values, while the markers along the bottom of the graph determine the range of input data values within which the function is applied. The markers can be moved by clicking on them and dragging them. The values can also be entered directly with textfields.

If the function name ends with ``w/Tail'', this means for regions outside of the minimum and maximum grey level values (i.e. horizontal markers), the tails will be set to the end point values. If the function names ends with ``Piece'', this means that only the LUT values between the minimum and maximum grey level values will be affected. All other parts of the LUT will remain unchanged.

Direct Entry
The two textfields labelled ``X:'' and ``LUT(X):'' can be used to enter lookup table values directly for a particular input/output pair. These fields are also updated while the mouse is in the main editing graph.

Permanent Apply LUT
The panel contains a ``Permanent Apply LUT->Image'' button. This button allows the user to create a new image from the specified LUT. That is, the result of the image data with the applied LUT is written to the image plane. Once the ``Permanent Apply LUT->Image'' button is pressed, the original data of the image plane is lost.


Parent Topic: IWORKS
About PCI Help Gateway