| Customize Help
| Save Settings


Function Map
Associate a LUT buffer with a display.
void MdispLut(
MIL_ID DisplayId, //in
MIL_ID LutBufId //in

This function associates a LUT buffer with the specified display. It can also be used to disassociate a LUT from the display.

If and when the display is selected (MdispSelect()), the change required to produce the display (LUT) effect occurs. MIL checks the target display to determine whether or not a LUT is supported. If not, an error is generated.

When displaying using a LUT, note the following:

  • If the LUT buffer values are changed while the image is selected on the display, the changes will not take effect until the next call is made to MdispLut(). That is, the LUT is not automatically updated when the LUT buffer is modified.

  • You cannot select a 3-band image buffer to a display that is associated with a LUT buffer. In addition, the image buffer must be an 8- or 16-bit buffer. If these conditions are not respected, an error is generated.

  • The view mode of the display cannot be set to M_AUTO_SCALE or M_MULTI_BYTES.

  • The number of LUT buffer entries must be the same as the maximum number of intensities that can be represented in the displayed buffer. In other words, if you want to map an 8-bit 1-band image (that is, an image that can have 256 intensities), your LUT must also have 256 entries.

To disassociate a LUT buffer from a display, call MdispLut() with M_DEFAULT.

For more information, see the Lookup tables in general section of Chapter 22: Lookup tables and the Mapping 1-band images through a LUT upon display section of Chapter 23: Displaying an image.

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see which MIL system’s documentation you should use in its place and any possible differences.
This function is not supported on the selected boards.
This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.

Specifies the identifier of the display with which to associate the LUT buffer.

LutBufId INQ

Specifies a LUT buffer. This parameter should be set to one of the following values:

function map For the identifier of the previously allocated LUT buffer
Click to summarizeValue Description
Click to summarize M_DEFAULT

Specifies that any association to a LUT buffer is removed from the specified display.

Click to summarize M_PSEUDO

Specifies the default pseudo-color LUT buffer as the LUT buffer to associate with the display. When this LUT is used and displaying an 8-bit image buffer, each gray intensity is displayed in a different color.

Click to summarize MIL LUT buffer identifier

Specifies the identifier of the custom LUT buffer (allocated with MbufAlloc1d() or MbufAllocColor() with M_LUT) to associate with the display.

If you associate a three-band LUT buffer (RGB) with the display, and then select an image buffer to the display, the same image data is mapped through each band of the LUT, typically resulting in a color display effect (depends on the LUT values).

Compilation information
Header Include mil.h.
Library Use mil.lib.
DLL Requires mil.dll; mildisplay.dll.