| MIL 10 Reference
| Customize Help
| Save Settings

MdispLut


See also
Availability
Available in MIL-Lite
Available in MIL

Available on Windows
Available on Linux

Available on Non-Matrox computer
Available on Matrox 4Sight-X
Available on Matrox 4Sight GP
Available on Matrox Supersight
function map Function map
Examples
MdispInquire
MdispPan
Synopsis
Associate a LUT buffer with a display.
Syntax
void MdispLut(
MIL_ID DisplayId, //in
MIL_ID LutBufId //in
)
Description

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 20: Lookup tables and the Mapping 1-band images through a LUT upon display section of Chapter 21: 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 if there is complementary information.
Parameters
This function is not supported on the selected boards.
Parameters
DisplayId

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
CollapseValue Description
Collapse M_DEFAULT

Specifies that any association to a LUT buffer is removed from the specified display.
Collapse 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.

(summarize)
Collapse 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).

Note that you cannot use a custom LUT buffer with a network display.

(summarize)
Compilation information
Header Include mil.h.
Library Use mil.lib.
DLL Requires mil.dll; mildisplay.dll.
AUTO SCALE MULTI BYTES DEFAULT PSEUDO